deepinitlisted

# deepinit — hierarchical AGENTS.md across a tree Writes one AGENTS.md per significant directory, each carrying a parent link, so an agent that enters any subdirectory can walk up to the root. **It writes files across the whole tree** — which is why only the user starts it. To orient yourself without writing anything, use `orient`. ## The template Every file except the root opens with a parent tag. That tag *is* the hierarchy. ```markdown <!-- Parent: ../AGENTS.md --> <!-- Generated: {date} | Updated: {date} --> # {Directory Name} ## Purpose {One paragraph: what lives here, and what role it plays in the whole.} ## Key Files | File | Description | |------|-------------| | `file.ts` | one line, what it is for | ## Subdirectories | Directory | Purpose | |-----------|---------| | `subdir/` | what it holds (see `subdir/AGENTS.md`) | ## For AI Agents ### Working in this directory {Conventions that differ from the obvious. Omit the section when there are none.} ### Testing requirements {How to test a change made here — the actual command.} ### Common patterns {Patterns actually used here, each with a file that demonstrates one.} ## Dependencies ### Internal ### External <!-- MANUAL: notes below this line survive regeneration --> ``` Write nothing generic. "Contains utility functions" describes every `utils/` ever written and is worth less than an absent section — a reader who trusts it has been misled, and one who does not has paid for it anyway. ## Run 1. **Map the t