Seed an AI-legible project memory map that stays small
One file (AGENTS.md) that bootstraps the rest: rules, the file map to create, what belongs in each file, the first-session interview order, and the list of anti-patterns that killed the previous map (1,308-line guide, 63 task files, narrative history inline, sessions skimming 56k tokens of context). Separates four kinds of content by read frequency: rules/invariants -> AGENTS.md (every session) subsystem truth -> docs/ai/<topic>.md (only the matching one) lookups -> environment.md (grepped, never read) retired decisions -> decisions.md (only when re-opening one) Caps are enforced, not promised: scripts/verify.sh checks doc budgets before the build, so a commit that pads a capped file fails. Proven both ways — it passes clean and exits 1 on an over-cap file. scripts/scope-check.sh blocks edits outside the declared file list. templates/ holds fill-in skeletons for the seven files a project must create. CC0: copy it, rename it, sell it, no attribution needed.
This commit is contained in:
@@ -0,0 +1,22 @@
|
||||
# TASKS — the active queue
|
||||
|
||||
> One line per live item; detail lives elsewhere. Done work goes to [`TASKS/archive.md`](TASKS/archive.md).
|
||||
> Markers: ☐ queued · 🔶 in progress · ⏳ blocked · ⏸ deferred · ❌ retired.
|
||||
|
||||
## Next up
|
||||
|
||||
**<Task>** — <five lines: what exists today, what is missing, the one unit, its test.>
|
||||
|
||||
## Queue
|
||||
|
||||
| Task | Status | Scope | Detail |
|
||||
|---|---|---|---|
|
||||
| <id> | ☐ | <one line> | <link> |
|
||||
|
||||
## Pending the user (not programming)
|
||||
|
||||
- <hands-on check / decision / take>
|
||||
|
||||
## Release gates (before the first shipped build)
|
||||
|
||||
- <gate — one line each>
|
||||
Reference in New Issue
Block a user