/docs contains shared documentation that both humans and agents rely on.
It exists for two purposes:
- Store essential and critical documentation for this repository
- Organize templates and living specs used during development
Start in README.md in this folder for documentation structure and conventions.
Before starting work, read the docs that apply to your task:
- Any task:
ai/— hierarchical, AI-navigable docs that point to the right source files - New feature or product change:
PRD.md— current product requirements and scope - Architecture or technical work:
system-design.md— system architecture and tech stack - Feature implementation:
specs/— find the relevant feature spec - System-level decision:
adrs/— existing architecture decisions - Coding standards:
rules/— engineering conventions and practices - Prior knowledge:
knowledge/— gotchas, non-obvious findings, hard-won insights