project-knowledge-harness
Installation
SKILL.md
project-knowledge-harness
A lightweight, file-based memory harness for any software project.
Three surfaces, sharply separated by time direction and access pattern:
| Surface | Time | Question it answers | Access pattern |
|---|---|---|---|
TODO.md |
Future | "What might we do later?" | Read top to bottom (priority lanes) |
backlog/<slug>.md |
Future | "What was the analysis behind this idea?" | Indexed from TODO.md |
pitfalls/<slug>.md |
Past | "I see error X — has this happened before?" | Grep symptom keywords |
Plus, in projects that already have agent contracts, AGENTS.md Hard
invariants answer "What rules MUST agents follow?". Pitfalls graduate to
Hard invariants when serious enough — see
references/when-to-add-docs.md.