generate-context

Generate CONTEXT.md

You are generating a CONTEXT.md file for this repository.

This file captures domain knowledge - what the application does, who uses it, what the core entities are, and what business rules govern them. It is read by AI tools to reduce hallucination on domain-specific behavior and to prevent suggestions that contradict business rules.

The goal is to document what the application actually does, not what a similar application might do.

---

Step 1 - Read the Repository

Gather information from the codebase before writing anything.

Primary sources (read these):

1. Any existing documentation: README.md, docs/, CONTEXT.md, wiki files
2. Entity and model definitions - files in domain/entities/, models/, types/, or equivalent. These reveal the core domain vocabulary.
3. Use cases or service layer - files in domain/usecases/, services/, interactors/, or equivalent. These reveal business operations and rules.
4. Repository or API interfaces - reveal what data operations exist
5. Auth-related files - reveal user roles and permissions
6. Routing configuration - reveals what screens/views exist (= what workflows exist)
7. Validation logic - reveals business rules as code

Secondary sources (read if primary sources are sparse):

• UI screens/components - reveal user workflows from the user's perspective
• API client code - reveals backend capabilities and data structures
• Test files - often contain realistic domain examples and edge cases

---

Reference Example (Optional)

Check for a reference example in this order:

1. .ai/reference/*/CONTEXT.md - if the user copied one during setup
2. node_modules/awesome-ai-setup/examples/*/CONTEXT.md - if the package is installed locally

If neither path exists, skip this section entirely and proceed to Step 2.

Use it as a structural guide only - what sections to include and how to format them. Do not copy its content; it describes a different project. All content must come from reading this codebase in Step 1.