DocsConcepts
Knowledge Files (.athena/)
The role and structure of each markdown file generated in your repository.
Athena generates structured knowledge files inside .athena/:
- `project.md`: What this project is, its technologies, structure, entry points, commands and development workflow.
- `architecture.md`: System and module architecture, service relationships, data flow and external services.
- `database.md`: Database technologies, schemas, entities, relationships, indexes and migrations.
- `api.md`: API style, endpoints, specifications, and authentication/error-handling expectations.
- `auth.md`: Authentication mechanisms, sessions/tokens, roles and permissions, and security assumptions.
- `security.md`: Attack surface, security controls, secret handling, tooling, and known/potential issues.
- `testing.md`: Test frameworks, commands, layout, coverage configuration and detectable gaps.
- `debugging.md`: Known bugs, common errors, debugging commands, logs and troubleshooting procedures.
- `performance.md`: Performance-sensitive areas, caching, queues, background jobs and performance rules.
- `code-review.md`: Project-specific review checklist covering architecture, security, testing and performance.
- `deployment.md`: Deployment architecture, environments, containers, CI/CD, hosting and environment variables.
- `rules.md`: Developer-defined rules that AI agents must follow. Owned by the developer.