Files
ss-tools/.ai/ROOT.md
2026-02-19 17:43:45 +03:00

1.9 KiB

[DEF:Project_Knowledge_Map:Root]

@TIER: CRITICAL

@PURPOSE: Global navigation map for AI-Agent (GRACE Knowledge Graph).

@LAST_UPDATE: 2026-02-19

1. SYSTEM STANDARDS (Rules of the Game)

Strict policies and formatting rules.

  • Constitution: High-level architectural and business invariants.
    • Ref: .ai/standards/constitution.md -> [DEF:Std:Constitution]
  • 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]

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]

3. DOMAIN MAP (Modules)

  • Project Map: .ai/PROJECT_MAP.md -> [DEF:Project_Map]
  • 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]