3.4 KiB
3.4 KiB
[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]
- Ref:
- Constitution: High-level architectural and business invariants.
- Ref:
.ai/standards/constitution.md->[DEF:Std:Constitution:Standard]
- Ref:
- Architecture: Service boundaries and tech stack decisions.
- Ref:
.ai/standards/architecture.md->[DEF:Std:Architecture]
- Ref:
- Plugin Design: Rules for building and integrating Plugins.
- Ref:
.ai/standards/plugin_design.md->[DEF:Std:Plugin]
- Ref:
- API Design: Rules for FastAPI endpoints and Pydantic models.
- Ref:
.ai/standards/api_design.md->[DEF:Std:API_FastAPI]
- Ref:
- UI Design: SvelteKit and Tailwind CSS component standards.
- Ref:
.ai/standards/ui_design.md->[DEF:Std:UI_Svelte]
- Ref:
- Semantic Mapping: Using
[DEF:]and belief scopes.- Ref:
.ai/standards/semantics.md->[DEF:Std:Semantics:Standard]
- Ref:
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]
- Ref:
- Svelte Component: Reference implementation of a sidebar/navigation component.
- Ref:
.ai/shots/frontend_component.svelte->[DEF:Shot:Svelte_Component]
- Ref:
- Plugin Module: Reference implementation of a task plugin.
- Ref:
.ai/shots/plugin_example.py->[DEF:Shot:Plugin_Example]
- Ref:
- Critical Module: Core banking transaction processor with ACID guarantees.
- Ref:
.ai/shots/critical_module.py->[DEF:Shot:Critical_Module]
- Ref:
3. DOMAIN MAP (Modules)
- High-level Module Map:
.ai/MODULE_MAP.md->[DEF:Module_Map] - Canonical Project Map Ownership:
.ai/PROJECT_MAP.md->[DEF:Project_Map:Root] - Generated Project Map Snapshot:
.ai/structure/PROJECT_MAP.md(backing generated artifact) - 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
- Superset OpenAPI Sections:
- 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]