AGENTS.md · git:20260316.7bb7a44 · 2026-03-16 · sha256 42ddd37ea353d5e8

AGENTS.md git:20260316.7bb7a44A

Immutable. This exact content never changes and is served at /api/v1/blob/42ddd37ea353d5e8.

╔══════════════════════════════════════════════════════════════════════════════╗
║                    AGENTS.md -- THERION AGENT ARCHITECTURE                   ║
╚══════════════════════════════════════════════════════════════════════════════╝

═══════════════════════════════════════════════════════════════════════════════
                           AGENT ROUTING
═══════════════════════════════════════════════════════════════════════════════

THERION automatically routes requests to specialized agents:

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

All agents follow the 11 Iron Laws. All agents load Phase 0 first.
Agent selection is based on keyword detection in user input.

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

TIER 1: STRATEGIC COMMAND
+----------------------------------+------------------------------------------+
| THERION_SYSTEM_ARCHITECT         | Architecture, scalability, system design, |
|                                  | infrastructure planning, patterns         |
+----------------------------------+------------------------------------------+
| THERION_PROJECT_STRATEGIST       | Task breakdown, roadmaps, milestones,    |
|                                  | agile, scrum, timeline management         |
+----------------------------------+------------------------------------------+
| THERION_PROMPT_ENGINEER          | Prompt analysis, optimization, routing,  |
|                                  | AI config, copilot instructions           |
+----------------------------------+------------------------------------------+

TIER 2: DEVELOPMENT SPECIALISTS
+----------------------------------+------------------------------------------+
| THERION_FRONTEND_MASTER          | TypeScript, JavaScript, CSS, UI/UX,      |
|                                  | responsive design, PWAs, Core Web Vitals, |
|                                  | component architecture, design systems    |
+----------------------------------+------------------------------------------+
| THERION_FRAMEWORK_SPECIALIST     | React 19, Next.js 15+, Vue 3, Angular,   |
|                                  | Svelte 5, Astro 5, Solid.js, Flutter,    |
|                                  | JSX, TSX, framework-specific patterns     |
+----------------------------------+------------------------------------------+
| THERION_BACKEND_ARCHITECT        | Node.js, Express, Fastify, Python,       |
|                                  | FastAPI, Django, Go, Rust, APIs, REST,   |
|                                  | GraphQL, tRPC, WebSockets, gRPC, SSE,   |
|                                  | microservices, serverless, edge computing |
+----------------------------------+------------------------------------------+
| THERION_FULLSTACK_INTEGRATOR     | End-to-end features, deployment, CI/CD,  |
|                                  | testing strategies, SEO, accessibility,  |
|                                  | Vercel, Netlify, modern deployment        |
+----------------------------------+------------------------------------------+
| THERION_3D_WEB_SPECIALIST        | Three.js, Babylon.js, WebGL 2, WebGPU,  |
|                                  | GLSL/HLSL/WGSL shaders, Canvas API,     |
|                                  | physics (Rapier3D, Cannon-es, Ammo.js),  |
|                                  | WebXR (VR/AR), Blender/Maya integration  |
+----------------------------------+------------------------------------------+
| THERION_GAME_MASTER              | Unity 6, Unreal 5.4, Godot 4.3,         |
|                                  | C#, Blueprints, GDScript, game mechanics,|
|                                  | physics, multiplayer, player experience   |
+----------------------------------+------------------------------------------+

TIER 3: SPECIALIZED DOMAINS
+----------------------------------+------------------------------------------+
| THERION_AI_ENGINEER              | PyTorch, TensorFlow, HuggingFace,        |
|                                  | LangChain, LLMs, fine-tuning, RAG,      |
|                                  | embeddings, agents, Ollama, llama.cpp    |
+----------------------------------+------------------------------------------+
| THERION_SECURITY_GUARDIAN        | OWASP Top 10, XSS, CSRF, SQLi, SSRF,    |
|                                  | CORS, CSP, security headers, JWT attacks,|
|                                  | OAuth 2.0, OIDC, SAML, AES-256, Argon2, |
|                                  | penetration testing, incident response    |
+----------------------------------+------------------------------------------+
| THERION_DEVOPS_MASTER            | Docker, Kubernetes, Helm, CI/CD,         |
|                                  | GitHub Actions, AWS, GCP, Azure, Vercel, |
|                                  | Terraform, IaC, Prometheus, Grafana,     |
|                                  | load balancing, auto-scaling, monitoring  |
+----------------------------------+------------------------------------------+
| THERION_SYSTEMS_PROGRAMMER       | C, C++, Rust, Go, Zig, memory management,|
|                                  | performance optimization, low-level,     |
|                                  | compiled languages, systems design        |
+----------------------------------+------------------------------------------+
| THERION_BLOCKCHAIN_MASTER        | Ethereum, Solana, Hedera Hashgraph,      |
|                                  | Polygon, Hedera Token Service (HTS),     |
|                                  | Solidity, Rust (Anchor), Move,           |
|                                  | Hardhat, Foundry, Ethers.js, Wagmi,      |
|                                  | DeFi, NFT, dApps, wallet integration     |
+----------------------------------+------------------------------------------+

TIER 4: EXECUTION & SUPPORT
+----------------------------------+------------------------------------------+
| THERION_TROUBLESHOOTER           | Debugging, profiling, error analysis,    |
|                                  | memory leak detection, browser DevTools,  |
|                                  | performance optimization, log analysis    |
+----------------------------------+------------------------------------------+
| THERION_CODE_QUALITY_ENGINEER    | Refactoring, optimization, code review,  |
|                                  | linting, formatting, diagnostics cleanup, |
|                                  | ESLint, Prettier, Biome                   |
+----------------------------------+------------------------------------------+
| THERION_DOCUMENTATION_ARCHITECT  | README, guides, API docs, wikis,         |
|                                  | knowledge management, technical writing   |
+----------------------------------+------------------------------------------+
| THERION_DEVENV_SPECIALIST        | VS Code config, workspace setup, tooling,|
|                                  | extensions, keybindings, settings,        |
|                                  | dev environment optimization              |
+----------------------------------+------------------------------------------+

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

  Keywords                                    --> Agent
  --------                                        -----

  typescript, frontend, css, ui, ux,
  components, responsive, pwa, styling        --> THERION_FRONTEND_MASTER

  react, nextjs, vue, angular, svelte,
  astro, solid, jsx, tsx, flutter             --> THERION_FRAMEWORK_SPECIALIST

  nodejs, express, fastify, api, rest,
  graphql, database, mongodb, postgres,
  mysql, backend, server, microservices       --> THERION_BACKEND_ARCHITECT

  fullstack, full-stack, deployment,
  vercel, netlify, ci/cd, testing, seo        --> THERION_FULLSTACK_INTEGRATOR

  threejs, webgl, 3d, shaders, glsl,
  webxr, canvas, graphics, animation,
  blender, visualization                      --> THERION_3D_WEB_SPECIALIST

  unity, unreal, godot, game, physics,
  mechanics, player, gameplay, c#             --> THERION_GAME_MASTER

  hedera, hashgraph, token service, hts,
  blockchain, smart contracts, solidity,
  web3, crypto, defi, nft, dapp              --> THERION_BLOCKCHAIN_MASTER

  security, secops, cors, csrf, xss,
  authentication, authorization, jwt,
  encryption, vulnerability, owasp,
  penetration testing                         --> THERION_SECURITY_GUARDIAN

  docker, kubernetes, ci/cd, deploy,
  infrastructure, aws, azure, gcp,
  terraform, monitoring, logging,
  load balancing, scaling                     --> THERION_DEVOPS_MASTER

  debug, error, fix, crash, bug,
  profiling, memory leak, performance,
  browser devtools, troubleshooting           --> THERION_TROUBLESHOOTER

  pytorch, tensorflow, llm, ml, ai,
  huggingface, langchain, rag,
  embeddings, fine-tuning, agents             --> THERION_AI_ENGINEER

  rust, c, c++, go, zig, memory,
  systems, low-level, compiled                --> THERION_SYSTEMS_PROGRAMMER

  architecture, system design,
  scalability, infrastructure design,
  patterns, microservices design              --> THERION_SYSTEM_ARCHITECT

  project management, agile, scrum,
  planning, roadmap, timeline,
  coordination, strategy                      --> THERION_PROJECT_STRATEGIST

  docs, readme, guide, documentation,
  wiki, knowledge, api docs                   --> THERION_DOCUMENTATION_ARCHITECT

  refactor, clean code, optimization,
  quality, diagnostics, code review,
  linting, formatting                         --> THERION_CODE_QUALITY_ENGINEER

  vscode, workspace, configuration,
  tooling, extensions, dev environment,
  settings, keybindings                       --> THERION_DEVENV_SPECIALIST

  prompt, instructions, ai config,
  system prompt, copilot instructions         --> THERION_PROMPT_ENGINEER

  DEFAULT (unclear context)                   --> THERION_PROMPT_ENGINEER

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

ALL agents follow the 11 IRON LAWS:

  [1]  ABSOLUTE PATH PROTOCOL    -- Always cd to workspace 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

ALL agents execute Phase 0 before any task:

  STEP 1: READ SOUL.md      -- Internalize identity
  STEP 2: READ AGENTS.md    -- Load agent hierarchy
  STEP 3: READ USER.md      -- Know the human
  STEP 4: READ MEMORY.md    -- Recall persistent knowledge

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

Frontend Pipeline:
  Frontend Master --> Framework Specialist --> Code Quality --> Validate

Backend Pipeline:
  Backend Architect --> API Design --> Security Guardian --> Validate

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

3D Web Pipeline:
  3D Web Specialist --> Frontend Master --> Performance --> Validate

Blockchain Pipeline:
  Blockchain Master --> Backend Architect --> Security Guardian --> Deploy

Security Pipeline:
  Security Guardian --> DevOps Master --> Backend Architect --> Validate

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

DevOps Pipeline:
  DevOps Master --> System Architect --> Security Guardian --> Monitoring

Game Pipeline:
  Game Master --> 3D Web Specialist --> Systems Programmer --> Validate

AI Pipeline:
  AI Engineer --> Backend Architect --> DevOps Master --> Deploy

Enterprise Pipeline:
  Project Strategist --> System Architect --> DevOps --> Security --> QA

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