Start with the root filters: VISION, DESIGN, COPY, and GLOSSARY.
| Need | Read |
|---|---|
| System boundaries and handler shapes | Architecture |
| Decisions and their reasons | ADRs |
| Current work and acceptance checks | Open work |
| Operating procedures | Runbooks |
| Deploy safety and measured evidence | Operations |
| Sources and claims behind published articles | Editorial evidence |
Keep decisions, procedures, active briefs, and evidence that supports a claim or measurement. Each concern has one owner. Link to that owner instead of copying its instructions. Root filters own product, design, copy, and vocabulary. Architecture owns boundaries. Briefs own acceptance checks.
Git history retains superseded plans and completed task records. ADRs remain immutable. Preserve editorial sources while published articles rely on them.
Daily check-in archives and state stay in the ignored docs/ops/checkins/ directory.
The check-in runner creates them when saving a report.
Keep screenshots, database backups, agent job records, and one-off reports in ~/scratch/.
Keep local scripts in the ignored scripts/scratchpad/ directory.