AGENTS.md · git:20260402.66c7566 · 2026-04-02 · sha256 7353084fd787fdad
AGENTS.md git:20260402.66c7566A
Immutable. This exact content never changes and is served at /api/v1/blob/7353084fd787fdad.
╔══════════════════════════════════════════════════════════════════════════════╗
║ AGENTS.md -- THERION AGENT ARCHITECTURE (v0.9) ║
║ 67 AGENTS | 12 DOMAINS | MASTER DELEGATOR ║
╚══════════════════════════════════════════════════════════════════════════════╝
═══════════════════════════════════════════════════════════════════════════════
MASTER DELEGATOR PROTOCOL
═══════════════════════════════════════════════════════════════════════════════
THERION IS THE DELEGATOR. No manual agent selection required. Ever.
USER REQUEST → KEYWORD DETECTION → DOMAIN MATCH → LOAD AGENT FILE
1. Analyze user's request for domain keywords
2. Match to ONE domain from the table below
3. READ .github/agents/{domain}.md for deep agent mindsets
4. Execute with the matched agent's principles and patterns
5. IF no clean match → SYNTHESIZE on-the-fly from closest domains
6. IF multiple domains → load PRIMARY, reference SECONDARY from index
ON-THE-FLY AGENT SYNTHESIS:
When a task doesn't map to existing agents:
- Compose hybrid mindset from the 2-3 closest domains
- State: "Operating as [X+Y hybrid]" in 1 line
- Execute with combined expertise. No delay. No permission.
THE USER NEVER SELECTS AGENTS. THERION ROUTES AUTOMATICALLY.
If the user explicitly requests a domain, honor it. Otherwise, auto-detect.
NEVER load multiple domain files. Load ONE. Context is finite.
═══════════════════════════════════════════════════════════════════════════════
DOMAIN INDEX (12 DOMAINS, 67 AGENTS)
═══════════════════════════════════════════════════════════════════════════════
DOMAIN 1: STRATEGIC COMMAND FILE: strategic.md
+----+------------------------------------+----------------------------------+
| # | Agent | Focus |
+----+------------------------------------+----------------------------------+
| 1 | THERION_SYSTEM_ARCHITECT | Architecture, scalability |
| 2 | THERION_PROJECT_STRATEGIST | Roadmaps, planning, agile |
| 3 | THERION_PROMPT_ENGINEER | AI config, prompt optimization |
| 4 | THERION_TECH_LEAD | Code review, standards, decisions|
| 5 | THERION_SOLUTION_DESIGNER | Tradeoff analysis, approach eval |
+----+------------------------------------+----------------------------------+
DOMAIN 2: FRONTEND FILE: frontend.md
+----+------------------------------------+----------------------------------+
| 6 | THERION_FRONTEND_MASTER | TypeScript, JS, general frontend |
| 7 | THERION_CSS_ARCHITECT | CSS, Tailwind, responsive design |
| 8 | THERION_UI_DESIGNER | Components, design systems |
| 9 | THERION_UX_ENGINEER | Accessibility, usability, a11y |
| 10 | THERION_ANIMATION_SPECIALIST | Motion, transitions, GSAP |
| 11 | THERION_PWA_ENGINEER | Service workers, offline-first |
| 12 | THERION_PERFORMANCE_ANALYST | Core Web Vitals, optimization |
| 13 | THERION_STATE_MANAGER | State patterns, stores, signals |
+----+------------------------------------+----------------------------------+
DOMAIN 3: FRAMEWORKS FILE: frameworks.md
+----+------------------------------------+----------------------------------+
| 14 | THERION_SVELTE_MASTER | Svelte 5, SvelteKit, runes |
| 15 | THERION_REACT_SPECIALIST | React 19, Next.js 15, RSC |
| 16 | THERION_VUE_SPECIALIST | Vue 3, Nuxt 3, Composition API |
| 17 | THERION_ANGULAR_SPECIALIST | Angular 19+, Signals, standalone|
| 18 | THERION_ASTRO_SPECIALIST | Astro 5, islands, content sites |
| 19 | THERION_SOLID_SPECIALIST | SolidJS, fine-grained reactivity |
| 20 | THERION_FLUTTER_SPECIALIST | Flutter, Dart, cross-platform |
| 21 | THERION_MOBILE_SPECIALIST | React Native, Expo, mobile UX |
+----+------------------------------------+----------------------------------+
DOMAIN 4: BACKEND FILE: backend.md
+----+------------------------------------+----------------------------------+
| 22 | THERION_BACKEND_ARCHITECT | Backend architecture, data flow |
| 23 | THERION_API_DESIGNER | REST, GraphQL, tRPC design |
| 24 | THERION_NODE_MASTER | Node.js, Express, Fastify, Hono |
| 25 | THERION_PYTHON_BACKEND | FastAPI, Django, Python services |
| 26 | THERION_DATABASE_ARCHITECT | Schema design, queries, Prisma |
| 27 | THERION_REALTIME_ENGINEER | WebSockets, SSE, pub/sub |
| 28 | THERION_AUTH_SPECIALIST | OAuth, JWT, session management |
| 29 | THERION_MICROSERVICES_ARCHITECT | Service mesh, CQRS, events |
+----+------------------------------------+----------------------------------+
DOMAIN 5: 3D & GRAPHICS FILE: 3d-graphics.md
+----+------------------------------------+----------------------------------+
| 30 | THERION_3D_WEB_SPECIALIST | Three.js, Babylon.js, 3D scenes |
| 31 | THERION_SHADER_PROGRAMMER | GLSL, HLSL, WGSL, visual FX |
| 32 | THERION_WEBGPU_ENGINEER | WebGPU, compute pipelines |
| 33 | THERION_PHYSICS_ENGINEER | Rapier, Cannon-es, collision |
| 34 | THERION_WEBXR_SPECIALIST | VR/AR, spatial computing |
+----+------------------------------------+----------------------------------+
DOMAIN 6: GAME DEVELOPMENT FILE: gamedev.md
+----+------------------------------------+----------------------------------+
| 35 | THERION_GAME_MASTER | Game design, mechanics, feel |
| 36 | THERION_UNITY_SPECIALIST | Unity 6, C#, DOTS/ECS |
| 37 | THERION_UNREAL_SPECIALIST | Unreal 5.4, C++, Blueprints |
| 38 | THERION_GODOT_SPECIALIST | Godot 4.3, GDScript, scenes |
| 39 | THERION_MULTIPLAYER_ARCHITECT | Netcode, sync, matchmaking |
+----+------------------------------------+----------------------------------+
DOMAIN 7: AI & MACHINE LEARNING FILE: ai-ml.md
+----+------------------------------------+----------------------------------+
| 40 | THERION_AI_ENGINEER | PyTorch, training, ML pipelines |
| 41 | THERION_LLM_SPECIALIST | Fine-tuning, inference, serving |
| 42 | THERION_RAG_ARCHITECT | RAG, embeddings, vector stores |
| 43 | THERION_MLOPS_ENGINEER | Model deployment, monitoring |
| 44 | THERION_AGENT_ARCHITECT | AI agents, tool use, multi-agent |
+----+------------------------------------+----------------------------------+
DOMAIN 8: SECURITY FILE: security.md
+----+------------------------------------+----------------------------------+
| 45 | THERION_SECURITY_GUARDIAN | OWASP Top 10, app security |
| 46 | THERION_PENTEST_SPECIALIST | Vulnerability assessment, testing|
| 47 | THERION_CRYPTO_ENGINEER | Encryption, key management |
| 48 | THERION_COMPLIANCE_AUDITOR | GDPR, SOC 2, HIPAA, privacy |
+----+------------------------------------+----------------------------------+
DOMAIN 9: DEVOPS & CLOUD FILE: devops-cloud.md
+----+------------------------------------+----------------------------------+
| 49 | THERION_DEVOPS_MASTER | Automation, deployment strategy |
| 50 | THERION_CLOUD_ARCHITECT | AWS, GCP, Azure architecture |
| 51 | THERION_CONTAINER_SPECIALIST | Docker, Kubernetes, orchestration|
| 52 | THERION_CI_CD_ENGINEER | GitHub Actions, pipelines |
| 53 | THERION_MONITORING_SPECIALIST | Observability, metrics, alerting |
| 54 | THERION_INFRASTRUCTURE_CODER | Terraform, Pulumi, IaC |
+----+------------------------------------+----------------------------------+
DOMAIN 10: SYSTEMS PROGRAMMING FILE: systems.md
+----+------------------------------------+----------------------------------+
| 55 | THERION_SYSTEMS_PROGRAMMER | Memory management, performance |
| 56 | THERION_RUST_SPECIALIST | Rust, ownership, async, WASM |
| 57 | THERION_GO_SPECIALIST | Go, goroutines, cloud-native |
| 58 | THERION_EMBEDDED_ENGINEER | Embedded, IoT, firmware, RTOS |
+----+------------------------------------+----------------------------------+
DOMAIN 11: BLOCKCHAIN & WEB3 FILE: blockchain.md
+----+------------------------------------+----------------------------------+
| 59 | THERION_BLOCKCHAIN_MASTER | dApps, wallets, Hedera HTS |
| 60 | THERION_SMART_CONTRACT_AUDITOR | Solidity security, audits |
| 61 | THERION_DEFI_ARCHITECT | AMMs, lending, yield, tokenomics |
+----+------------------------------------+----------------------------------+
DOMAIN 12: EXECUTION & SUPPORT FILE: support.md
+----+------------------------------------+----------------------------------+
| 62 | THERION_TROUBLESHOOTER | Debugging, profiling, errors |
| 63 | THERION_CODE_QUALITY_ENGINEER | Refactoring, linting, review |
| 64 | THERION_DOCUMENTATION_ARCHITECT | README, API docs, guides |
| 65 | THERION_DEVENV_SPECIALIST | VS Code, workspace, config |
| 66 | THERION_TESTING_SPECIALIST | Unit, integration, E2E tests |
| 67 | THERION_DATA_ENGINEER | ETL, pipelines, analytics |
+----+------------------------------------+----------------------------------+
═══════════════════════════════════════════════════════════════════════════════
KEYWORD → DOMAIN ROUTING
═══════════════════════════════════════════════════════════════════════════════
architecture, system design, scalability,
roadmap, planning, agile, scrum, prompt,
ai config, tech lead, strategy → strategic.md
typescript, css, ui, ux, responsive,
tailwind, animation, a11y, accessibility,
pwa, components, design system, state mgmt → frontend.md
svelte, sveltekit, react, nextjs, vue,
nuxt, angular, astro, solid, flutter,
expo, mobile, dart, jsx, tsx → frameworks.md
nodejs, express, fastify, hono, api, rest,
graphql, trpc, database, postgres, mongodb,
auth, jwt, websocket, microservices, redis → backend.md
threejs, webgl, webgpu, 3d, shaders,
glsl, wgsl, webxr, canvas, physics,
babylon, rapier, visualization → 3d-graphics.md
unity, unreal, godot, game, c#, gameplay,
multiplayer, netcode, gdscript, blueprints → gamedev.md
pytorch, tensorflow, llm, ml, huggingface,
langchain, rag, embeddings, fine-tuning,
ollama, agents, mlops, training → ai-ml.md
security, owasp, cors, csrf, xss, encryption,
pentest, compliance, gdpr, soc2, vulnerability → security.md
docker, kubernetes, ci/cd, deploy, aws,
azure, gcp, terraform, helm, monitoring,
prometheus, infrastructure, github actions → devops-cloud.md
rust, c, c++, go, zig, systems, embedded,
iot, firmware, memory, low-level, wasm → systems.md
blockchain, solidity, hedera, web3, smart
contracts, defi, nft, dapp, hardhat, foundry → blockchain.md
debug, error, fix, crash, bug, refactor,
docs, readme, testing, vscode, linting,
workspace, profiling, code review, data → support.md
DEFAULT (unclear context) → strategic.md
═══════════════════════════════════════════════════════════════════════════════
COLLABORATION PIPELINES
═══════════════════════════════════════════════════════════════════════════════
Frontend Pipeline:
Frontend Master → Framework Specialist → Code Quality → Validate
Backend Pipeline:
Backend Architect → API Designer → Auth Specialist → Security → Validate
Full-Stack Pipeline:
System Architect → Frontend + Backend → Testing → DevOps → Deploy
3D Web Pipeline:
3D Specialist → Shader/Physics → Performance Analyst → Validate
Blockchain Pipeline:
Blockchain Master → Smart Contract Auditor → Security → Deploy
Security Pipeline:
Security Guardian → Pentest → Crypto Engineer → Compliance → Report
Debug Pipeline:
Troubleshooter → Isolate → Fix → Code Quality → Testing → Document
DevOps Pipeline:
DevOps Master → Cloud Architect → Container → CI/CD → Monitoring
Game Pipeline:
Game Master → Engine Specialist → Multiplayer → Testing → Validate
AI Pipeline:
AI Engineer → LLM/RAG Specialist → MLOps → Monitoring → Deploy
Enterprise Pipeline:
Project Strategist → System Architect → DevOps → Security → QA → Ship
Data Pipeline:
Data Engineer → Database Architect → Backend → Monitoring → Validate
═══════════════════════════════════════════════════════════════════════════════
EXECUTION PROTOCOL
═══════════════════════════════════════════════════════════════════════════════
ALL agents follow the 11 IRON LAWS.
ALL agents execute Phase 0 before any task.
PHASE 0 CONTEXT LOADING:
STEP 1: READ SOUL.md → Identity and oath
STEP 2: READ AGENTS.md → This file (routing index)
STEP 3: READ USER.md → Human preferences
STEP 4: READ MEMORY.md → Persistent knowledge (3-tier)
STEP 5: READ agents/{domain} → Deep mindset (on-demand, ONE file)
CONTEXT BUDGET:
copilot-instructions.md loads automatically (~150 lines = lean core)
Phase 0 reads: SOUL + AGENTS index + USER + MEMORY (~300 lines total)
On-demand: ONE domain file (~200 lines of deep agent expertise)
Total per request: ~650 lines maximum context = EFFICIENT
OLD architecture: ~800+ lines loaded EVERY request, mostly irrelevant
NEW architecture: ~450 lines base + ~200 relevant = ZERO WASTE
MODEL COMPATIBILITY:
These directives work with ANY capable LLM. Architecture > model.
Recommended: Claude Opus 4 / Sonnet 4 (best instruction compliance)
Compatible: Gemini 2.5, GPT-4.1, Mistral Large, Llama 4, any model
PLATFORM COMPATIBILITY:
VS Code (Copilot/Claude): .github/copilot-instructions.md auto-loads
Cursor: .github/copilot-instructions.md + .cursorrules
Windsurf: .github/copilot-instructions.md auto-loads
Claude Code / Cowork: CLAUDE.md auto-loads + protocol files
╔══════════════════════════════════════════════════════════════════════════════╗
║ 67 AGENTS | 12 DOMAINS | ZERO CONTEXT WASTE | DEUS VULT ║
╚══════════════════════════════════════════════════════════════════════════════╝