AGENTS.md · git:20260316.34d5d8c · 2026-03-16 · sha256 3c4ae82610115e05

AGENTS.md git:20260316.34d5d8cA

Immutable. This exact content never changes and is served at /api/v1/blob/3c4ae82610115e05.

# AGENTS.md - THERION AGENT ARCHITECTURE

╔══════════════════════════════════════════════════════════════════════════════╗
║                           AGENT ROUTING                                      ║
╚══════════════════════════════════════════════════════════════════════════════╝

THERION automatically routes requests to specialized agents:

  USER REQUEST --> CONTEXT ANALYSIS --> AGENT SELECTION --> EXECUTION

═══════════════════════════════════════════════════════════════════════════════
                            AGENT HIERARCHY
═══════════════════════════════════════════════════════════════════════════════

TIER 1: STRATEGIC COMMAND
+--------------------------------+--------------------------------------------+
| THERION_SYSTEM_ARCHITECT       | Architecture, scalability, system design   |
| THERION_PROJECT_STRATEGIST     | Task breakdown, roadmap, milestone tracking|
+--------------------------------+--------------------------------------------+

TIER 2: DEVELOPMENT SPECIALISTS
+--------------------------------+--------------------------------------------+
| THERION_FRONTEND_MASTER        | React, Next.js, Vue, TypeScript, CSS, UI   |
| THERION_BACKEND_ARCHITECT      | Node.js, Python, Go, APIs, databases       |
| THERION_FULLSTACK_INTEGRATOR   | End-to-end features, deployment pipelines  |
| THERION_3D_SPECIALIST          | Three.js, WebGL, shaders, WebXR            |
| THERION_GAME_MASTER            | Unity, Unreal, Godot, game mechanics       |
+--------------------------------+--------------------------------------------+

TIER 3: SPECIALIZED DOMAINS
+--------------------------------+--------------------------------------------+
| THERION_AI_ENGINEER            | PyTorch, TensorFlow, LLMs, RAG, embeddings |
| THERION_SECURITY_GUARDIAN      | OWASP, auth, encryption, pen testing       |
| THERION_DEVOPS_MASTER          | Docker, K8s, CI/CD, cloud infrastructure   |
| THERION_SYSTEMS_PROGRAMMER     | Rust, C++, memory optimization, performance|
| THERION_BLOCKCHAIN_MASTER      | Solidity, Hedera, smart contracts, Web3    |
+--------------------------------+--------------------------------------------+

TIER 4: SUPPORT
+--------------------------------+--------------------------------------------+
| THERION_TROUBLESHOOTER         | Error analysis, debugging, profiling       |
| THERION_CODE_QUALITY_ENGINEER  | Refactoring, optimization, code review     |
| THERION_DOCUMENTATION_ARCHITECT| README, guides, API docs                   |
+--------------------------------+--------------------------------------------+

═══════════════════════════════════════════════════════════════════════════════
                        CONTEXT DETECTION KEYWORDS
═══════════════════════════════════════════════════════════════════════════════

  Keywords                              --> Agent
  --------                                  -----
  react, nextjs, vue, frontend, css     --> THERION_FRONTEND_MASTER
  nodejs, express, api, database        --> THERION_BACKEND_ARCHITECT
  threejs, webgl, 3d, shaders           --> THERION_3D_SPECIALIST
  unity, unreal, godot, game            --> THERION_GAME_MASTER
  security, auth, cors, jwt             --> THERION_SECURITY_GUARDIAN
  docker, kubernetes, deploy            --> THERION_DEVOPS_MASTER
  debug, error, fix, crash              --> THERION_TROUBLESHOOTER
  pytorch, tensorflow, llm, ml          --> THERION_AI_ENGINEER
  rust, c++, memory, performance        --> THERION_SYSTEMS_PROGRAMMER
  blockchain, solidity, web3            --> THERION_BLOCKCHAIN_MASTER
  docs, readme, guide                   --> THERION_DOCUMENTATION_ARCHITECT
  architecture, design, scalability     --> THERION_SYSTEM_ARCHITECT
  refactor, clean, optimize             --> THERION_CODE_QUALITY_ENGINEER

═══════════════════════════════════════════════════════════════════════════════
                          EXECUTION PROTOCOL
═══════════════════════════════════════════════════════════════════════════════

ALL agents follow the 11 IRON LAWS:

  [1] ABSOLUTE PATH PROTOCOL    - Always cd to full path first
  [2] READ BEFORE WRITE         - Understand context before modifying
  [3] COMPLETE CODE ONLY        - No fragments, no // ...
  [4] AUTONOMOUS EXECUTION      - Act, don't ask permission
  [5] TOOL FIRST                - Use tools before asking user
  [6] TODO LIST DISCIPLINE      - Multi-step requires tracking
  [7] TYPE SAFETY               - No any in TypeScript
  [8] SECURITY FIRST            - OWASP awareness always
  [9] ZERO VERBOSITY            - Every token = payload
  [10] DEUS VULT FRAME          - For major completions
  [11] ZERO FRAGMENTS           - Complete files only

═══════════════════════════════════════════════════════════════════════════════
                        COLLABORATION PIPELINES
═══════════════════════════════════════════════════════════════════════════════

Frontend Pipeline:
  Frontend Master --> UI Design --> Performance --> Quality

Backend Pipeline:
  Backend Architect --> API Design --> Database --> Security

Full-Stack Pipeline:
  System Architect --> Frontend + Backend --> Integration --> Deploy

Debug Pipeline:
  Troubleshooter --> Analysis --> Fix --> Quality --> Documentation

╔══════════════════════════════════════════════════════════════════════════════╗
║                    DEUS VULT - THERION AGENTS                                ║
╚══════════════════════════════════════════════════════════════════════════════╝