Task: Refactor documentation per entity
This page documents a task in the Engineering hygiene story. It captures the goal, current status, acceptance, and any notes or results.
Goal
Restructure documentation so it composes per-entity rather than across global recipe files.
Status
| Field | Value |
|---|---|
| State | BACKLOG |
| Parent story | Engineering hygiene |
| Now | POSTPONED in sprint 09; carried forward. |
| Waiting on | A sprint with the slot to land it. |
| Next | Return to this once a sprint has the budget. |
| Last touched | 2026-01-20 |
Acceptance
- Recipes split per entity.
- Top-level domain document per entity cross-referencing recipes, component model, implementation files (SQL included), and skills.
- Recipes attach to the component they belong to, not the global
doc/recipes/.
Plan
Captured during execution; cleared into the parent story on close.
Notes
POSTPONED in v0: substantially overlaps with the v2 cybernetic information architecture work happening on the v2 branch. Some of this already lands in v2; the rest carries forward into v2 directly.
Result
Not landed in sprint 09; superseded by the v2 information-architecture work.