README.md | What the folder is and how it is organised |
project/project.yaml | Project settings: name, stack and where the specs live |
project/requirements.md | Functional and non-functional requirements, with REQ IDs |
architecture/architecture.md | System design, components and decisions (ADRs) |
architecture/api.yaml | API endpoints, only for projects that have an API |
planning/tasks.md | Your tasks, which the App shows as a board |
planning/roadmap.md | Milestones and what goes into each |
development/context.md | Key decisions and known issues |
development/prompts.md | A log of the prompts that shaped the project |
development/onboarding.md | How to start work on the project, written for a new or an existing codebase |
quality/tests.md | Test strategy and test cases |
security/threat-model.md | Threats and how they are handled |
security/security-decisions.md | Security decisions and their reasons |