Docs / The generated project / File-by-file contract
File-by-file contract
What shows up in a generated project, which builder wrote it, and why it is there.
docs/ setup, architecture, roadmap, costs, deployment,
testing, coding-standards, release
prompts/ nine reusable prompts
checklists/ release, plus whatever the technologies contribute
.github/ CI workflow
.env.example every variable from every module, deduplicated
package.json merged dependencies, version conflicts resolved
README.md CLAUDE.md AGENTS.md GEMINI.md
ai-project.config.jsonThe builder registry, in order
10
folder
The project folder tree from every module's folders.json
20
package
Merged package.json — dependencies and scripts
30
env
.env.example, merged and deduplicated
40
docs
setup, deployment, testing, coding-standards, release
50
architecture
docs/architecture.md
60–70
cursor · copilot · continue · cline · roo · claude
One rule file per technology, per selected AI tool
90
checklists
checklists/*.md
110
hygiene
eslint, prettier, husky, lint-staged, commitlint, .editorconfig
115
templates
Arbitrary per-module template content
120
readme
README.md, CLAUDE.md, AGENTS.md, GEMINI.md
140
gitkeep
.gitkeep for any folder that would otherwise be empty
150
config
ai-project.config.json — the saved selection plus fingerprints
The nine prompts
→create-feature · create-screen · create-api · create-hook
→fix-bug · write-tests · review-code · performance · release
What is in docs/architecture.md
→A component diagram built from your resolved stack — a node per module, edges from requires, plus a frontend → backend → database backbone.
→A sequence diagram per module that ships one. Every auth provider has a real sign-in flow naming that provider, not a generic placeholder.
→A starter entity-relationship diagram if you selected a database — explicitly a starting point, since nothing here scaffolds real tables.
docs/roadmap.md is a suggestion
A build order for exactly your stack, grouped into weeks capped at three items, reusing the category ordering — backend and auth before payments, deployment last. Reorder it freely.