55 lines
3.1 KiB
Markdown
55 lines
3.1 KiB
Markdown
# [DEF:Project_Knowledge_Map:Root]
|
|
# @COMPLEXITY: 5
|
|
# @PURPOSE: Canonical GRACE navigation map for repository standards and semantic context.
|
|
# @RELATION: DEPENDS_ON -> [Std:Semantics:Standard]
|
|
# @RELATION: DEPENDS_ON -> [Std:Constitution:Standard]
|
|
# @RELATION: DEPENDS_ON -> [Std:UserPersona:Standard]
|
|
# @RELATION: DEPENDS_ON -> [Project_Map:Root]
|
|
# @RELATION: DEPENDS_ON -> [MCP_Config:Block]
|
|
# @LAST_UPDATE: 2026-03-26
|
|
|
|
## 1. SYSTEM STANDARDS (Rules of the Game)
|
|
Strict policies and formatting rules.
|
|
* **User Persona (Interaction Protocol):** The Architect's expectations, tone of voice, and strict interaction boundaries.
|
|
* Ref: `.ai/PERSONA.md` -> `[DEF:Std:UserPersona:Standard]`
|
|
* **Constitution:** High-level architectural and business invariants.
|
|
* Ref: `.ai/standards/constitution.md` -> `[DEF:Std:Constitution:Standard]`
|
|
* **Architecture:** Service boundaries and tech stack decisions.
|
|
* Ref: `.ai/standards/architecture.md` -> `[DEF:Std:Architecture]`
|
|
* **Plugin Design:** Rules for building and integrating Plugins.
|
|
* Ref: `.ai/standards/plugin_design.md` -> `[DEF:Std:Plugin]`
|
|
* **API Design:** Rules for FastAPI endpoints and Pydantic models.
|
|
* Ref: `.ai/standards/api_design.md` -> `[DEF:Std:API_FastAPI]`
|
|
* **UI Design:** SvelteKit and Tailwind CSS component standards.
|
|
* Ref: `.ai/standards/ui_design.md` -> `[DEF:Std:UI_Svelte]`
|
|
* **Semantic Mapping:** Using `[DEF:]` and belief scopes.
|
|
* Ref: `.ai/standards/semantics.md` -> `[DEF:Std:Semantics:Standard]`
|
|
|
|
## 2. FEW-SHOT EXAMPLES (Patterns)
|
|
Use these for code generation (Style Transfer).
|
|
* **FastAPI Route:** Reference implementation of a task-based route.
|
|
* Ref: `.ai/shots/backend_route.py` -> `[DEF:Shot:FastAPI_Route]`
|
|
* **Svelte Component:** Reference implementation of a sidebar/navigation component.
|
|
* Ref: `.ai/shots/frontend_component.svelte` -> `[DEF:Shot:Svelte_Component]`
|
|
* **Plugin Module:** Reference implementation of a task plugin.
|
|
* Ref: `.ai/shots/plugin_example.py` -> `[DEF:Shot:Plugin_Example]`
|
|
* **Critical Module:** Core banking transaction processor with ACID guarantees.
|
|
* Ref: `.ai/shots/critical_module.py` -> `[DEF:Shot:Critical_Module]`
|
|
|
|
## 3. DOMAIN MAP (Modules)
|
|
* **Normalized MCP Configuration:** `.kilo/mcp.json` -> `[DEF:MCP_Config:Block]`
|
|
* **Apache Superset OpenAPI Source:** `.ai/openapi/superset_openapi.json` -> `[DEF:Doc:Superset_OpenAPI]`
|
|
* **Apache Superset OpenAPI Split Index:** `.ai/openapi/superset/README.md` -> `[DEF:Doc:Superset_OpenAPI]`
|
|
* **Superset OpenAPI Sections:**
|
|
* `.ai/openapi/superset/meta.json`
|
|
* `.ai/openapi/superset/components/responses.json`
|
|
* `.ai/openapi/superset/components/schemas.json`
|
|
* `.ai/openapi/superset/components/securitySchemes.json`
|
|
* `.ai/openapi/superset/paths`
|
|
* **Backend Core:** `backend/src/core` -> `[DEF:Module:Backend_Core]`
|
|
* **Backend API:** `backend/src/api` -> `[DEF:Module:Backend_API]`
|
|
* **Frontend Lib:** `frontend/src/lib` -> `[DEF:Module:Frontend_Lib]`
|
|
* **Specifications:** `specs/` -> `[DEF:Module:Specs]`
|
|
|
|
# [/DEF:Project_Knowledge_Map:Root]
|