AGENTS Context Map

AGENTS Context Map

Project scope

  • This project teaches CS 101 for:
    • Highschool students.
    • Highschool teachers.

Current status

  • Active teaching project.
  • Content and terminology should remain classroom-oriented and beginner-friendly.

Sibling alignment (Jekyll infra)

  • Keep Jekyll infrastructure reasonably aligned across the 3 sibling repos:
    • BeautifulYesodot (this repo)
    • BeautifulMivney
    • mathBeautifulFork
  • Alignment targets usually include:
    • Front matter conventions.
    • Shared markdown style patterns.
    • Similar site-level configuration approach where practical.

Cross-repo references

  • BeautifulYesodot (this repo):
    • WSL: /home/stra/repos/BeautifulYesodot
    • Windows: \\wsl.localhost\Ubuntu\home\stra\repos\BeautifulYesodot
  • BeautifulMivney:
    • WSL: /home/stra/repos/BeautifulMivney
    • Windows: \\wsl.localhost\Ubuntu\home\stra\repos\BeautifulMivney
  • mathBeautifulFork:
    • WSL: /home/stra/sites/mathBeautifulFork
    • Windows: \\wsl.localhost\Ubuntu\home\stra\sites\mathBeautifulFork
  • Shared utility often relevant for bagrut workflows:
    • bag_splitter (WSL): /home/stra/repos/bag_splitter

Cross-filesystem access fallback (important)

  • When direct PowerShell access to sibling repos or /mnt/c/... paths fails with permission/IO errors, use direct WSL shell commands instead.
  • Preferred pattern:
    • wsl bash -lc "ls /mnt/c/Users/3stra/AndroidStudioProjects/Presence"
    • wsl bash -lc "sed -n '1,200p' /mnt/c/Users/3stra/AndroidStudioProjects/TasksONAlbertsFB/app/src/main/java/com/example/tasks/FBRef.java"
    • wsl bash -lc "find /mnt/c/Users/3stra/AndroidStudioProjects -name FBRef.java"
  • This fallback should be used for read/search operations across sibling projects when UNC or mounted-path access is blocked from the current shell context.

Tutorial language/style convention

  • Default language direction should lean Hebrew unless explicitly decided otherwise for a specific page.
  • For English markdown tutorials, add this block near the top (after frontmatter and initial note):
<style>
main {
  direction: ltr !important;
  text-align: left !important;
}
</style>
  • Do not retroactively rewrite in-progress tutorials between Hebrew/English unless explicitly requested.

Tutorial layout pattern convention

  • When a step and a visual (screenshot/diagram) are best understood side-by-side, prefer the two-columns pattern instead of stacking.
  • Encourage this for GUI walkthroughs (step text on one side, screenshot on the other).
  • Reusable pattern:
<div class="two-columns">
<div markdown="1" class="column">
...step text...
</div>
<div markdown="1" class="column">
...image...
</div>
</div>