Capability node
Documentation
Write the files that let humans and agents understand, use, and maintain the work.
Why this capability exists
Undocumented work is unmaintainable. Documentation is the interface between the builder, the user, and the next agent that inherits the project.
Input
- The built thing and its conventions
- Reader profiles (user, maintainer, agent)
Output
- README with run instructions
- Maintenance and contribution notes
- Machine-readable context files
Risks
- Docs that describe intentions instead of current reality
- Assuming readers know what the author knew
- Duplicating knowledge that then drifts apart
Acceptance criteria
- A new person can run and extend the project from docs alone
- Docs are updated in the same change that updates code
- Agents have a designated context file to read first