Documentation
README
Capture what matters before the session ends. Save decisions, procedures, and learnings as durable memories that any connected AI tool can find later.
What to distill
- Decisions with rationale ("we chose PostgreSQL because ACID is required")
- Procedures: non-obvious steps, workarounds, setup sequences
- Learnings: surprises, gotchas, corrections to prior assumptions
- Preferences: user's stated preferences for future reference
- Plans that future sessions will need to resume
- Context that would be lost when the session ends
What to skip
- Routine code changes, obvious fixes, standard operations
- Work in progress that will change before it matters
- Generic information already widely known
- Simple Q&A answerable from documentation
Workflow
This is the opening of the README. Read the full README on GitHub.