Files you own
| File | Purpose |
|---|---|
blueprint/project-plan.md |
Product problem, users, MVP, data, stack, monetization, and UI direction |
blueprint/build-plan.md |
Ordered checkbox list of feature-sized outcomes |
blueprint/context/coding-standards.md |
Project conventions and testing expectations |
blueprint/context/ai-interaction.md |
Review, communication, and workflow preferences |
Generated context
| File | Generated by | Purpose |
|---|---|---|
context/project-overview.md |
/overview |
Compact project context derived from the plans |
context/current-feature.md |
/feature or /fix |
One active buildable scope with steps and proof |
Edit upstream plans and regenerate the overview instead of patching downstream context by hand.
History
blueprint/history/features/ and blueprint/history/fixes/ store completed specs. They preserve the intent and done-when criteria that shaped the code without retaining chat transcripts.
Tool adapters
Codex project skills live under .agents/skills/. Claude Code project skills live under .claude/skills/. Projects using only one tool can remove the unused adapter after onboarding confirms the choice.