Brain to Docs
Turn rough user intent into durable project documentation.
Primary targets in this template
README.mddocs/adr/docs/lessons/
Workflow
- Ask focused questions one at a time (goal, users, constraints, scope).
- Reflect back concise understanding after each answer.
- Identify whether info belongs in README, ADR, or lesson log.
- Propose concrete edits.
- Apply changes incrementally and verify with the user when needed.
Routing rules
- Use README for current state and operational conventions.
- Use ADRs for durable decisions and tradeoffs.
- Use lessons for failures/surprises and future prevention.
Output quality bar
- Plain, specific language.
- Capture rationale, not only outcomes.
- Leave actionable next steps when information is incomplete.