AGENTS.md · diff
git:20260316.7bb7a44 to git:20260328.1738d09
188 added, 179 removed. Audit A to A.
What this update changes in the checks
No check changed: every fixed check gives the same answer before and after this update.
A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.
╔══════════════════════════════════════════════════════════════════════════════╗
║ AGENTS.md -- THERION AGENT ARCHITECTURE ║
+ ║ 67 AGENTS | 12 DOMAINS | NESTED LOADING ║
╚══════════════════════════════════════════════════════════════════════════════╝
═══════════════════════════════════════════════════════════════════════════════
- AGENT ROUTING
+ ROUTING PROTOCOL
═══════════════════════════════════════════════════════════════════════════════
- THERION automatically routes requests to specialized agents:
+ USER REQUEST → KEYWORD DETECTION → DOMAIN MATCH → LOAD AGENT FILE
- USER REQUEST --> CONTEXT ANALYSIS --> AGENT SELECTION --> EXECUTION
+ 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
- All agents follow the 11 Iron Laws. All agents load Phase 0 first.
- Agent selection is based on keyword detection in user input.
+ NEVER load multiple domain files. Load ONE. Context is finite.
═══════════════════════════════════════════════════════════════════════════════
- AGENT HIERARCHY
+ DOMAIN INDEX (12 DOMAINS, 67 AGENTS)
═══════════════════════════════════════════════════════════════════════════════
- 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
- ═══════════════════════════════════════════════════════════════════════════════
+ 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 |
+ +----+------------------------------------+----------------------------------+
- Keywords --> Agent
- -------- -----
+ 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 |
+ +----+------------------------------------+----------------------------------+
- typescript, frontend, css, ui, ux,
- components, responsive, pwa, styling --> THERION_FRONTEND_MASTER
+ 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 |
+ +----+------------------------------------+----------------------------------+
- react, nextjs, vue, angular, svelte,
- astro, solid, jsx, tsx, flutter --> THERION_FRAMEWORK_SPECIALIST
+ 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 |
+ +----+------------------------------------+----------------------------------+
- nodejs, express, fastify, api, rest,
- graphql, database, mongodb, postgres,
- mysql, backend, server, microservices --> THERION_BACKEND_ARCHITECT
+ 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 |
+ +----+------------------------------------+----------------------------------+
- fullstack, full-stack, deployment,
- vercel, netlify, ci/cd, testing, seo --> THERION_FULLSTACK_INTEGRATOR
+ 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 |
+ +----+------------------------------------+----------------------------------+
- threejs, webgl, 3d, shaders, glsl,
- webxr, canvas, graphics, animation,
- blender, visualization --> THERION_3D_WEB_SPECIALIST
+ 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 |
+ +----+------------------------------------+----------------------------------+
- unity, unreal, godot, game, physics,
- mechanics, player, gameplay, c# --> THERION_GAME_MASTER
+ 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 |
+ +----+------------------------------------+----------------------------------+
- hedera, hashgraph, token service, hts,
- blockchain, smart contracts, solidity,
- web3, crypto, defi, nft, dapp --> THERION_BLOCKCHAIN_MASTER
+ 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 |
+ +----+------------------------------------+----------------------------------+
- security, secops, cors, csrf, xss,
- authentication, authorization, jwt,
- encryption, vulnerability, owasp,
- penetration testing --> THERION_SECURITY_GUARDIAN
+ 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 |
+ +----+------------------------------------+----------------------------------+
- docker, kubernetes, ci/cd, deploy,
- infrastructure, aws, azure, gcp,
- terraform, monitoring, logging,
- load balancing, scaling --> THERION_DEVOPS_MASTER
+ 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 |
+ +----+------------------------------------+----------------------------------+
- debug, error, fix, crash, bug,
- profiling, memory leak, performance,
- browser devtools, troubleshooting --> THERION_TROUBLESHOOTER
+ 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 |
+ +----+------------------------------------+----------------------------------+
- pytorch, tensorflow, llm, ml, ai,
- huggingface, langchain, rag,
- embeddings, fine-tuning, agents --> THERION_AI_ENGINEER
+ ═══════════════════════════════════════════════════════════════════════════════
+ KEYWORD → DOMAIN ROUTING
+ ═══════════════════════════════════════════════════════════════════════════════
- rust, c, c++, go, zig, memory,
- systems, low-level, compiled --> THERION_SYSTEMS_PROGRAMMER
+ architecture, system design, scalability,
+ roadmap, planning, agile, scrum, prompt,
+ ai config, tech lead, strategy → strategic.md
- architecture, system design,
- scalability, infrastructure design,
- patterns, microservices design --> THERION_SYSTEM_ARCHITECT
+ typescript, css, ui, ux, responsive,
+ tailwind, animation, a11y, accessibility,
+ pwa, components, design system, state mgmt → frontend.md
- project management, agile, scrum,
- planning, roadmap, timeline,
- coordination, strategy --> THERION_PROJECT_STRATEGIST
+ svelte, sveltekit, react, nextjs, vue,
+ nuxt, angular, astro, solid, flutter,
+ expo, mobile, dart, jsx, tsx → frameworks.md
- docs, readme, guide, documentation,
- wiki, knowledge, api docs --> THERION_DOCUMENTATION_ARCHITECT
+ nodejs, express, fastify, hono, api, rest,
+ graphql, trpc, database, postgres, mongodb,
+ auth, jwt, websocket, microservices, redis → backend.md
- refactor, clean code, optimization,
- quality, diagnostics, code review,
- linting, formatting --> THERION_CODE_QUALITY_ENGINEER
+ threejs, webgl, webgpu, 3d, shaders,
+ glsl, wgsl, webxr, canvas, physics,
+ babylon, rapier, visualization → 3d-graphics.md
- vscode, workspace, configuration,
- tooling, extensions, dev environment,
- settings, keybindings --> THERION_DEVENV_SPECIALIST
+ unity, unreal, godot, game, c#, gameplay,
+ multiplayer, netcode, gdscript, blueprints → gamedev.md
- prompt, instructions, ai config,
- system prompt, copilot instructions --> THERION_PROMPT_ENGINEER
+ pytorch, tensorflow, llm, ml, huggingface,
+ langchain, rag, embeddings, fine-tuning,
+ ollama, agents, mlops, training → ai-ml.md
- DEFAULT (unclear context) --> THERION_PROMPT_ENGINEER
+ security, owasp, cors, csrf, xss, encryption,
+ pentest, compliance, gdpr, soc2, vulnerability → security.md
- ═══════════════════════════════════════════════════════════════════════════════
- EXECUTION PROTOCOL
- ═══════════════════════════════════════════════════════════════════════════════
+ docker, kubernetes, ci/cd, deploy, aws,
+ azure, gcp, terraform, helm, monitoring,
+ prometheus, infrastructure, github actions → devops-cloud.md
- ALL agents follow the 11 IRON LAWS:
+ rust, c, c++, go, zig, systems, embedded,
+ iot, firmware, memory, low-level, wasm → systems.md
- [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
+ blockchain, solidity, hedera, web3, smart
+ contracts, defi, nft, dapp, hardhat, foundry → blockchain.md
- ALL agents execute Phase 0 before any task:
+ debug, error, fix, crash, bug, refactor,
+ docs, readme, testing, vscode, linting,
+ workspace, profiling, code review, data → support.md
- 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
+ DEFAULT (unclear context) → strategic.md
═══════════════════════════════════════════════════════════════════════════════
COLLABORATION PIPELINES
═══════════════════════════════════════════════════════════════════════════════
Frontend Pipeline:
- Frontend Master --> Framework Specialist --> Code Quality --> Validate
+ Frontend Master → Framework Specialist → Code Quality → Validate
Backend Pipeline:
- Backend Architect --> API Design --> Security Guardian --> Validate
+ Backend Architect → API Designer → Auth Specialist → Security → Validate
Full-Stack Pipeline:
- System Architect --> Frontend + Backend --> Fullstack Integrator --> Deploy
+ System Architect → Frontend + Backend → Testing → DevOps → Deploy
3D Web Pipeline:
- 3D Web Specialist --> Frontend Master --> Performance --> Validate
+ 3D Specialist → Shader/Physics → Performance Analyst → Validate
Blockchain Pipeline:
- Blockchain Master --> Backend Architect --> Security Guardian --> Deploy
+ Blockchain Master → Smart Contract Auditor → Security → Deploy
Security Pipeline:
- Security Guardian --> DevOps Master --> Backend Architect --> Validate
+ Security Guardian → Pentest → Crypto Engineer → Compliance → Report
Debug Pipeline:
- Troubleshooter --> Analysis --> Fix --> Code Quality --> Documentation
+ Troubleshooter → Isolate → Fix → Code Quality → Testing → Document
DevOps Pipeline:
- DevOps Master --> System Architect --> Security Guardian --> Monitoring
+ DevOps Master → Cloud Architect → Container → CI/CD → Monitoring
Game Pipeline:
- Game Master --> 3D Web Specialist --> Systems Programmer --> Validate
+ Game Master → Engine Specialist → Multiplayer → Testing → Validate
AI Pipeline:
- AI Engineer --> Backend Architect --> DevOps Master --> Deploy
+ AI Engineer → LLM/RAG Specialist → MLOps → Monitoring → Deploy
Enterprise Pipeline:
- Project Strategist --> System Architect --> DevOps --> Security --> QA
+ 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
+ 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
+
╔══════════════════════════════════════════════════════════════════════════════╗
- ║ DEUS VULT -- THERION AGENTS ║
+ ║ 67 AGENTS | 12 DOMAINS | ZERO CONTEXT WASTE | DEUS VULT ║
╚══════════════════════════════════════════════════════════════════════════════╝