Jf Documentation

Mandatory conventions

1. Write documentation in Org mode.
2. Every generated file name must start with the current date in the format YYYY_MM_DD, e.g. 2026_02_18_my-topic.org.
3. Store documentation in ~/icloud/org.
   • If the user asks to "org-doc as research", store in ~/icloud/org/_research.
4. If a diagram is requested, use D2.
5. If code snippets are useful, include them.
6. When including snippets, use org-transclusion with narrow line ranges.
7. Every snippet section must include:
   • A short description of what the snippet shows
   • A GitHub permalink to the exact file + line range
   • A transclusion statement with focused ranges

Snippet format

Use this structure for each snippet: