AGENTS Context Map

AGENTS Context Map

Project scope

  • This project teaches Israeli 5-unit Bagrut mathematics:
    • 35571
    • 35572
  • Target audience: grades 10-12 (highschool).

Current status

  • Dormant recently (current teaching year focuses on CS).
  • Keep the project healthy and ready for reactivation.

Sibling alignment (Jekyll infra)

  • Keep Jekyll infrastructure reasonably aligned across the 3 sibling repos:
    • mathBeautifulFork (this repo)
    • BeautifulMivney
    • BeautifulYesodot
  • Even while dormant, avoid drifting far from sibling infra conventions.

Cross-repo references

  • mathBeautifulFork (this repo):
    • WSL: /home/stra/sites/mathBeautifulFork
    • Windows: \\wsl.localhost\Ubuntu\home\stra\sites\mathBeautifulFork
  • BeautifulMivney:
    • WSL: /home/stra/repos/BeautifulMivney
    • Windows: \\wsl.localhost\Ubuntu\home\stra\repos\BeautifulMivney
  • BeautifulYesodot:
    • WSL: /home/stra/repos/BeautifulYesodot
    • Windows: \\wsl.localhost\Ubuntu\home\stra\repos\BeautifulYesodot
  • 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>