# Documentation

- `guides/` contains user guides and practical project workflows.
- `architecture/` describes implemented systems and maintained technical references.
- `specs/` contains feature specifications, including completed phase specs.
- `ideas/` contains the live backlog of future feature ideas.
- `plans/` contains accepted phase design briefs and active or future implementation plans.
- `archive/` preserves older project references and completed plan drafts.
- `known_issues.md` tracks current bugs and deferred fixes.

Keep `README.md` and `AGENTS.md` at the repository root for project onboarding and implementation rules.

## Architecture references

- [Repository organization](architecture/repository_organization.md) documents the feature-based folder layout, legacy content-path mapping, and serialized file-format compatibility contract.