This directory is the single source of truth for how this project is built, organized, and evolved by agents.
project/— project overview, goals, architecture, and boundaries.frontend/— Feature-Sliced Design (FSD) conventions.backend/— Domain-Driven Design (DDD) layered conventions.operations/— local development, CI/CD, and deployment.quality/— testing strategy and code-review expectations.decisions/— architecture decision records (ADRs).
- If you are new to the project, read
project/README.mdandproject/architecture.mdfirst. - Before writing frontend code, read
frontend/README.md. - Before writing backend code, read
backend/README.md. - Before changing deployment, build, or operational behavior, read
operations/README.md. - If you change behavior, architecture, or conventions, update the relevant doc in the same change set.