thevoidforge 21.0.11 → 21.0.12

package/dist/VERSION.md

@@ -0,0 +1,123 @@
+# Version
+
+**Current:** 21.0.0
+
+## Versioning Scheme
+
+This project uses [Semantic Versioning](https://semver.org/):
+
+- **MAJOR** — Breaking changes to method doc structure, agent naming conventions, build protocol phases, or distribution model
+- **MINOR** — New method docs, new agents/characters, new features to VoidForge
+- **PATCH** — Typo fixes, clarifications, minor doc improvements
+
+## Version History
+
+| Version | Date | Summary |
+|---------|------|---------|
+| 21.0.0 | 2026-04-08 | The Extraction — wizard becomes standalone npm package. Monorepo (packages/voidforge + packages/methodology). CLI router with 12 commands. .voidforge marker file. Project creation (headless init). Extension system (danger-room + cultivation). Methodology update (replaces /void git-fetch). Daemon aggregator for multi-project heartbeat. v20.x migration with rollback. 675 tests (618→675). ADR-038. |
+| 20.2.0 | 2026-04-03 | Graceful Tier Degradation — scaffold cleanup (408→134 files), Spring Cleaning /void migration, tier gate sentinel fix, /grow Phase 1-3 fallback, /cultivation graceful skip, 6 field reports triaged (#271-#276, 11 methodology fixes). |
+| 20.1.1 | 2026-04-02 | Parallel Agent Standard, ID Space Audit, Safety Parameter Audit, Maul mandatory gate, 7 field report triages (#264-#270). |
+| 20.1.0 | 2026-04-02 | Kongo Engine Integration — 10 modules, 119 tests, 37th pattern, Infinity Gauntlet (3 Critical + 10 High fixed), 5 field reports triaged (14 methodology fixes), Operational Learnings system activated. |
+| 19.5.0 | 2026-03-31 | The Blueprint Path — Fourth entry path for pre-written specs: /blueprint command, document discovery, CLAUDE.md merge, PRD validation, wizard auto-detection, PRD template. 499 tests (454→499). Gauntlet: path traversal fix, route registration, UX dead-end fix. |
+| 19.4.0 | 2026-03-30 | The Last Mile — Campaign execution wiring: 4 campaign adapters (sandbox, Google, Meta, TikTok), 5 heartbeat stubs → real handlers, status polling, Danger Room live metrics. 454 tests (406→454). Victory Gauntlet: GAQL injection fix, path traversal fix, sandbox cache. |
+| 19.3.0 | 2026-03-30 | The Field Surgeon — 22 field reports triaged, 13 fixes promoted into 6 method docs, 5 patterns documented (35 total), System Protocol identity headers, assessment remediation (18→6 findings). |
+| 19.2.0 | 2026-03-26 | The Wider Net — TikTok billing adapter, AdPlatform type widened to 7 platforms, adapter factory extensibility proven. 385 total tests. |
+| 19.1.0 | 2026-03-26 | The Live Wire — production intelligence: adapter factory, Mercury/billing wiring, auto-funding execution, WAL recovery, 66 new financial tests (380 total). All 9 Muster-identified gaps resolved. |
+| 19.0.0 | 2026-03-25 | The Funding Rail — Stablecoin treasury to ad billing: Circle, Mercury, Google/Meta billing adapters, 8 heartbeat jobs, 6 circuit breakers, funding policy engine, treasury planner, reconciliation, reporting. 14 new financial modules, 3 new patterns (35 total). |
+| 18.2.0 | 2026-03-25 | The Dogfood — browser intelligence on VoidForge: 6 a11y heading fixes, CDN fallback for tower, security verified clean |
+| 18.1.0 | 2026-03-25 | The Eyes — browser-review.ts pattern, console error capture, behavioral walkthroughs, security inspection. Browser intelligence in QA, UX, Security, Gauntlet method docs. 32 patterns. |
+| 18.0.0 | 2026-03-24 | The Proving Ground — Playwright E2E + axe-core a11y (21 browser tests), browser verification in 6 method docs, e2e-test.ts pattern, 315 total tests |
+| 17.3.0 | 2026-03-24 | The Muster — --muster flag (full 9-universe deployment), flag nomenclature (8 fixes across 13 files), CLAUDE.md flag taxonomy (3 tiers) |
+| 17.2.0 | 2026-03-24 | The Security Test Pass — 101 new tests for 7 P0 security modules (294 total), 0 TypeScript errors |
+| 17.1.0 | 2026-03-24 | The Gauntlet Cleanup — HMAC vault comparison, negative spend clamping, TypeScript 0 errors, tsc in CI, 26 new tests (193 total), 3 ADRs, sandbox instance scoping |
+| 17.0.0 | 2026-03-24 | The Complete Implementation — No Stubs Doctrine, P0/P1 security fixes, Cultivation activation (sandbox + Stripe adapters, heartbeat wiring, growth tabs), 74 new tests (167 total), 8 stub files deleted |
+| 16.1.0 | 2026-03-24 | The Hardened Methodology — migration safety, data pipelines, backtest/execution patterns, dependency health, load testing, branch CI |
+| 16.0.0 | 2026-03-24 | The Psychohistorians — AI Intelligence Layer: Foundation universe, Hari Seldon, /ai command, 6 AI patterns, AI_INTELLIGENCE.md, integrated into 8 commands |
+| 15.3.0 | 2026-03-23 | The Chronicle — 9 public docs updated to v15.2.1 (76 staleness issues fixed) |
+| 15.2.1 | 2026-03-23 | Inbox triage #147-#148: 4 methodology fixes + 3 lessons from field reports |
+| 15.2.0 | 2026-03-23 | The Cleanup — tower-auth split (636→3 modules), SSH SG restriction post-provisioning |
+| 15.1.0 | 2026-03-23 | The Hardening — Infinity Gauntlet (47 fixes), vault rate-limit + auto-lock, HMAC key rotation, sendJson consolidation, pattern proxy modules, batch health poller, TOTP clock skew recovery, vitest (91 tests), UX enchantments |
+| 15.0.0 | 2026-03-22 | The Last Mile — /deploy command, campaign auto-deploy, /git --deploy, drift detector |
+| 14.0.0 | 2026-03-22 | The Day-0 Engine — Cultivation onboarding redesign: treasury, revenue, ad platforms, budget, creatives, tracking, launch |
+| 13.1.0 | 2026-03-22 | Dashboard Polish — break circular import, CORS/CSP LAN, header context gauge, consolidate private IP |
+| 13.0.0 | 2026-03-22 | The Living Dashboard — consolidation, 3-tier UX, LAN mode, Status Line bridge, agent ticker, new panels |
+| 12.6.4 | 2026-03-22 | Inbox triage #130-131 — encryption egress audit, GROUP BY compatibility, v14.0 Day-0 Engine roadmap |
+| 12.6.3 | 2026-03-22 | Inbox triage #129 — acceptance criteria enforcement, gitignore warning, blitz pre-flight, --adr-only mode |
+| 12.6.2 | 2026-03-22 | v13.0 roadmap — LAN mode, Danger Room bug fixes + feature proposals from field reports #127-128 |
+| 12.6.1 | 2026-03-22 | Inbox triage #126 — Learned Rules for campaign checkpoints, historical data validation, PRD evolution workflow |
+| 12.6.0 | 2026-03-22 | Inbox triage #123-125 — /assess command, --assess gauntlet flag, stub detection, migration check, auth-from-day-one, process manager discipline |
+| 12.5.0 | 2026-03-19 | The Full Roster — agent deployment manifests: /review gets 20+ agents, /devops gets 16, /assemble gets 80+ documented |
+| 12.4.2 | 2026-03-19 | Tier-gating: auto-pull wizard/ for Full-tier commands, CLAUDE.md integrity checks, 5 methodology improvements from field reports |
+| 12.4.1 | 2026-03-18 | Missing /dangerroom command, community health files, WORKSHOP.md, inbox triage (#104), branch sync |
+| 12.4.0 | 2026-03-18 | The Autonomy — route optimizer, Tier 2/3 autonomy, circuit breakers, kill switch, deploy freeze |
+| 12.3.0 | 2026-03-18 | The Navigator — Paris's route optimization (included in v12.4 release) |
+| 12.2.0 | 2026-03-18 | The Bridge — Chakotay's correlation engine, prediction tracking, cross-pipeline data flow |
+| 12.1.0 | 2026-03-18 | The Analyst — Seven's gap analysis, campaign proposal generator, Tier 1 advisory, Deep Current Danger Room tab |
+| 12.0.0 | 2026-03-18 | The Scanner — Deep Current: autonomous campaign intelligence, /current command, site scanner, situation model, cold start intake |
+| 11.3.0 | 2026-03-18 | The Heartbeat — /portfolio command, Mercury/Brex adapters, anomaly detection, encrypted backup, service install, desktop notifications, Heartbeat tab |
+| 11.2.0 | 2026-03-18 | The Distribution — 6 ad platform adapters, campaign state machine, spend execution pipeline, compliance framework, Ad Campaigns tab |
+| 11.1.0 | 2026-03-18 | The Treasury — Dockson's financial operations: heartbeat daemon, reconciliation engine, revenue adapters, /treasury command, Treasury tab |
+| 11.0.0 | 2026-03-18 | The Consciousness — Cosmere Growth Universe: 18 agents, /grow 6-phase protocol, /cultivation install, financial vault + TOTP 2FA, safety tiers, Danger Room growth tabs |
+| 10.2.0 | 2026-03-17 | Unbuilt features: Natural Language Deploy, Methodology A/B Testing, Prophecy Visualizer |
+| 10.1.0 | 2026-03-17 | Danger Room data feeds + feature enforcement: live WebSocket, confidence scoring in commands, agent debates, Living PRD gates |
+| 10.0.1 | 2026-03-17 | Frontier features: confidence scoring, agent debates, adversarial PRD, living PRD, cross-project memory, build archaeology |
+| 10.0.0 | 2026-03-17 | The Danger Room — mission control dashboard with 5 core panels, WebSocket real-time feed, agent activity ticker |
+| 9.3.0 | 2026-03-17 | The Game Forge — game build protocol, 3 game patterns, game QA/UX checklists, 4 game agents. Distribution BLOCKED. |
+| 9.2.0 | 2026-03-17 | The Mobile Forge — iOS/Android methodology, mobile patterns, 3 conditional agents. Provisioner BLOCKED (needs real API integration). |
+| 9.1.0 | 2026-03-17 | The Multi-Language Forge (Python) — Django + FastAPI deep dives in all 8 patterns + build protocol Python path |
+| 9.0.0 | 2026-03-17 | The Field-Tested Forge — META_WORKFLOW.md, pattern evolution data collection, /imagine API key persistence |
+| 8.3.0 | 2026-03-16 | The Autonomy — /campaign --autonomous with git tags, critical-finding rollback, 5-mission checkpoints |
+| 8.2.0 | 2026-03-16 | The Evolution — self-improving methodology (Wong promotion analysis), custom sub-agents (CUSTOM_AGENTS.md) |
+| 8.1.2 | 2026-03-16 | Deep Roster command wiring — extended agents integrated into /qa, /security, /ux, /architect, /gauntlet, /assemble, /campaign commands |
+| 8.1.1 | 2026-03-16 | The Deep Roster Phase 2 — 40+ extended agents across DC, Star Wars, Tolkien, Anime, Marvel, Star Trek |
+| 8.1.0 | 2026-03-16 | The Deep Roster Phase 1 — 10 agents activated: Troi, Padmé, Celeborn, Worf, Riker, Torres, Cyborg, Raven, Wonder Woman, Valkyrie |
+| 8.0.1 | 2026-03-16 | Victory Gauntlet hardening — 16 fixes, engines >=20.11.0, Quality Reduction Anti-Pattern, 9 methodology fixes from #46-#53 |
+| 8.0.0 | 2026-03-16 | The Hive Mind — Agent Memory (active LESSONS.md read-back), Conflict Prediction (Phase 0.5), /prd command |
+| 7.7.0 | 2026-03-16 | The Housekeeping — architecture doc refresh, server auto-restart detection, COMPATIBILITY.md, context pressure fix |
+| 7.6.0 | 2026-03-16 | The Vault Pipeline — deploy --env-only, standalone vault reader, PTY cleanup, engines field |
+| 7.5.3 | 2026-03-16 | Triage #42-#44 — vault key naming, outbound URL safety, accordion a11y, v7.7 roadmap |
+| 7.5.2 | 2026-03-16 | HOLOCRON credentials flow docs + v7.6 Vault Pipeline roadmap |
+| 7.5.1 | 2026-03-16 | 19 fixes from #36-#40 — vault awareness, anonymity invariant, deployment verification, cross-file deps, WCAG contrast |
+| 7.5.0 | 2026-03-16 | Thumper Command Center — inline keyboard, bot personalization, water-rings fix, command↔doc sync |
+| 7.4.1 | 2026-03-16 | 15 fixes from #31-#34 — thumper sync, parallel agents, cascade review, crypto check, proxy SSRF, campaign end debrief |
+| 7.4.0 | 2026-03-16 | The Field Hardening — 20 methodology fixes from 5 field reports, runtime smoke test, first-run checklist, campaign-mode pipeline |
+| 7.3.2 | 2026-03-16 | 13 methodology fixes from field reports #21-#25 — blitz gate, tier UI audit, auth retrofit, timestamps |
+| 7.3.1 | 2026-03-16 | Blitz auto-debrief — /campaign --blitz files field reports after every mission |
+| 7.3.0 | 2026-03-16 | Avengers Tower Overhaul — ws library, vault unlock, build-state Lobby, /campaign --blitz, IPv6 fix |
+| 7.2.1 | 2026-03-15 | Fix Avengers Tower terminal crash on Node.js v24 (node-pty 1.1.0 → 1.2.0-beta.12) |
+| 7.2.0 | 2026-03-15 | The Gauntlet Forging — 31 code fixes, 11 methodology fixes, 7 enchantments, WCAG AA, v8.0+ roadmap |
+| 7.1.0 | 2026-03-15 | The Redesign — three-act wizard flow, operations menu, Resilience Pack, simple/advanced eliminated |
+| 7.0.1 | 2026-03-15 | Three-act wizard redesign plan, Resilience Pack reclassification, 9 methodology fixes from field reports |
+| 7.0.0 | 2026-03-15 | The Penthouse — multi-user RBAC, per-project ACLs, linked services, coordinated deploys, rollback, cost tracker, agent memory |
+| 6.5.1 | 2026-03-15 | The Arthurian Retcon — Merlin→Gandalf, Camelot→Avengers Tower, Great Hall→The Lobby, Round Table→The Penthouse |
+| 6.5.0 | 2026-03-15 | Avengers Tower Remote — 5-layer security, TOTP 2FA, self-deploy, audit trail, two-password architecture |
+| 6.0.0 | 2026-03-15 | Avengers Tower Multi — The Lobby dashboard, project registry, health poller, import flow, SSRF protection |
+| 4.4.0 | 2026-03-15 | The Imagination Release — /imagine (Celebrimbor), /debrief (Bashir), 2 new leads, 7 new sub-agents |
+| 4.2.0 | 2026-03-14 | The DX Release — Prisma types, OpenAPI docs, ERD generation, integration templates, database seeding |
+| 4.1.0 | 2026-03-14 | The Observability Release — deploy logs, cost estimation, health monitoring, Sentry integration |
+| 4.0.0 | 2026-03-14 | The Reliability Release — pre-deploy build step, CI/CD generation, env validation, Railway API migration, credential scoping |
+| 3.9.1 | 2026-03-14 | Roadmap + VoidForge PRD + /campaign --plan mode for roadmap updates |
+| 3.9.0 | 2026-03-14 | Sisko's Danger Room — /campaign command, autonomous PRD-to-product mission sequencing, 11th lead agent |
+| 3.8.0 | 2026-03-14 | Haku's Last Mile — end-to-end deploy automation for all 6 targets, GitHub integration, SSH deploy with rollback |
+| 3.7.0 | 2026-03-14 | Fury's Initiative — /assemble full pipeline, /thumper Telegram bridge, Dune universe, 10 leads, 12 commands |
+| 3.6.0 | 2026-03-14 | Chani's Worm Rider — /thumper Telegram bridge, Dune universe, Kongo.io methodology upgrades |
+| 3.5.3 | 2026-03-14 | /thumper rename + cross-methodology hardening + Kongo.io lessons |
+| 3.5.0 | 2026-03-14 | Chani's Worm Rider — /thumper Telegram bridge with Gom Jabbar auth, Dune universe (9th lead), 170+ characters |
+| 3.4.0 | 2026-03-13 | 1M Context Adaptation — double-pass reviews, 3 new sub-agents, /test and /review commands, parallelized analysis |
+| 3.3.1 | 2026-03-13 | Fix silent PRD truncation — model-aware max tokens, truncation detection and UI warning |
+| 3.3.0 | 2026-03-13 | The Last Mile Complete — async resource polling, domain registration, security hardening (43 review findings resolved) |
+| 3.2.0 | 2026-03-13 | Bombadil's Forge Sync — /void self-update command, Forge Keeper method doc, 8th lead agent |
+| 3.1.0 | 2026-03-13 | The Last Mile — EC2 instance sizing, Cloudflare DNS wiring, platform domain registration |
+| 3.0.0 | 2026-03-12 | The VoidForge Holocron, three-tier distribution (main/scaffold/core), README as system reference |
+| 2.8.0 | 2026-03-12 | Gandalf/Haku wizard split, architecture review docs, security audit with SG hardening |
+| 2.7.0 | 2026-03-12 | Real provisioning for all 6 targets, hardened infra scripts, SSE keepalive, crash recovery loop complete |
+| 2.6.0 | 2026-03-12 | Auto-provisioning — Docker, AWS VPS (EC2/RDS/ElastiCache), config stubs, crash recovery manifest, atomic vault writes |
+| 2.5.0 | 2026-03-12 | /git command — Coulson's version & release management with semver, changelog, and commit automation |
+| 2.4.0 | 2026-03-12 | Wizard cloud providers, deploy targets, security hardening, UI overhaul |
+| 2.3.0 | 2026-03-12 | Interactive setup wizard — browser-based onboarding with encrypted credential vault, PRD generation, project scaffolding |
+| 2.2.0 | 2026-03-12 | Rename project to VoidForge — "from nothing, everything" |
+| 2.1.1 | 2026-03-12 | Fix PostToolUse hook format — migrate from flat `command` to nested `hooks` array per Claude Code schema |
+| 2.1.0 | 2026-03-10 | Build journal, context management, enriched slash commands, specific verification gates, test timeline, framework adaptations, rollback strategy, conflict resolution, new patterns (job-queue, multi-tenant, error-handling), regression checklist template, first-deploy checklist, dedup CLAUDE.md/README, parallel phase marking, Batman scope clarification |
+| 2.0.0 | 2026-03-10 | Slash commands, testing protocol, code patterns, conditional build phases, Agent tool orchestration, troubleshooting, hooks, MCP guide, personality calibration, feedback loop, PRD frontmatter, CLAUDE.md restructure |
+| 1.1.0 | 2026-03-10 | Rename DevOps lead agent from Motoko to Kusanagi |
+| 1.0.0 | 2026-03-10 | Initial release — 6 agent protocols, 150+ named characters, 13-phase build protocol |

package/dist/docs/NAMING_REGISTRY.md

@@ -0,0 +1,478 @@
+# AGENT NAMING REGISTRY
+## The Canon
+
+> When agents spin up, they pick a name from their universe's pool. No duplicates. First claim wins.
+
+---
+
+## Rules
+
+1. **Lead agents have fixed names** — Galadriel, Stark, Batman, Kenobi, Picard, Kusanagi, Coulson, Bombadil, Chani, Fury, Thanos, Sisko, Celebrimbor, Bashir, Kelsier, Tuvok, Dockson, Hari Seldon, Haku, Gandalf. These never change.
+2. **Sub-agents pick from their universe's Available Pool** in order of relevance to their role.
+3. **No name may be used twice across ANY active session.** If Vegeta is taken, pick the next character.
+4. **When spinning up additional agents of the same type**, pick the next unused name from the pool.
+5. **Log which names are active** in your session to prevent collisions.
+6. **Names in the Reserved column** are held for lead agents or have cross-universe conflicts. Don't use them as sub-agents.
+7. **Custom sub-agents** (defined in `docs/CUSTOM_AGENTS.md`) must use the `[BaseName]-[Specialty]` format to avoid collisions with this registry. Check both this registry AND the custom agents file before claiming a name.
+
+---
+
+## Universe Assignments
+
+| Universe | Domain | Lead Agent |
+|----------|--------|-----------|
+| **Tolkien** | Frontend, UX, Design | Galadriel |
+| **Marvel** | Backend Engineering | Stark |
+| **Marvel** | Release Management | Coulson |
+| **Marvel** | The Initiative | Fury |
+| **Marvel** | The Gauntlet | Thanos |
+| **DC Comics** | QA & Bug Hunting | Batman |
+| **Star Wars** | Security Auditing | Kenobi |
+| **Star Trek** | Systems Architecture | Picard |
+| **Star Trek** | Campaign Command | Sisko |
+| **Dune** | Worm Rider | Chani |
+| **Tolkien** | Forge Sync & Updates | Bombadil |
+| **Tolkien** | Image Generation | Celebrimbor |
+| **Star Trek** | Field Reports & Feedback | Bashir |
+| **Anime** (from Tom's list) | DevOps & Infrastructure | Kusanagi |
+| **Anime** (from Tom's list) | Deploy Wizard | Haku |
+| **Cosmere** (Brandon Sanderson) | Growth & Marketing | Kelsier |
+| **Foundation** (Isaac Asimov) | AI Intelligence | Hari Seldon |
+
+---
+
+## 🧝 TOLKIEN — Frontend & UX
+
+**Leads:** Galadriel (Frontend & UX), Bombadil (Forge Sync & Updates), Gandalf (Setup Wizard)
+
+**Available Pool (use in order, skip if taken):**
+1. Radagast — Edge cases, QA, notices things at the boundaries others overlook
+2. Aragorn — Leadership, orchestration, the ranger who sees everything
+3. Legolas — Precision, elegance, clean frontend code
+4. Samwise — Accessibility, loyalty, never leaves anyone behind
+5. Elrond — Wisdom, UX strategy, long-term thinking
+6. Arwen — Beauty, UI polish, visual consistency
+7. Gimli — Sturdiness, performance, reliability
+8. Bilbo — Storytelling, microcopy, content
+9. Frodo — The one carrying the hardest task
+10. Éowyn — **Delight Architect**: enchantment review, micro-moments, motion language, brand resonance, emotional design. "I am no mere auditor."
+11. Faramir — Judgment, quality over glory
+12. Pippin — Curiosity, edge case discovery (sometimes breaks things)
+13. Merry — Pippin's partner, pair review
+14. Treebeard — Slow, deliberate, doesn't rush decisions
+15. Boromir — Strong but flawed, catches hubris in design
+16. Théoden — Rallying, bringing teams together
+17. Haldir — Border guard, catches things at boundaries
+18. (Radagast — moved to #1)
+19. Celeborn — Quiet authority, design system governance
+20. Glorfindel — Ancient power, handles the hardest rendering challenges
+21. Goldberry — River-daughter, senses what flows upstream, change detection
+22. Tom Bombadil — The oldest, keeper of the world itself, forge maintenance
+
+23. Celebrimbor — **Lead: Forge Artist**: AI image generation from PRD descriptions. "Hand of Silver." Sub-agents: Nori, Ori, Dori.
+24. Nori — Asset scanner: scans PRD for image requirements, diffs against existing assets
+25. Ori — Prompt engineer: crafts generation prompts from PRD descriptions
+26. Dori — Integration checker: verifies generated images are wired into components
+
+**Reserved:** Galadriel (lead — frontend), Bombadil (lead — forge sync), Celebrimbor (lead — forge artist), Sauron (don't name an agent after the villain), Saruman (same)
+
+---
+
+## 🦾 MARVEL — Backend Engineering
+
+**Leads:** Stark (Tony Stark) — Backend Engineering, Coulson (Phil Coulson) — Release Management, Fury (Nick Fury) — The Initiative
+
+**Available Pool:**
+1. Rogers — API design, by the book, discipline
+2. Banner — Database, calm until queries get slow
+3. Strange — Service architecture, sees all patterns
+4. Barton (Hawkeye) — **Smoke Tests**: runtime endpoint verification, route collision detection, render loop check. Also: error handling, never misses.
+5. Romanoff — Integrations, trusts no one
+6. Thor — Queue/workers, brings the thunder
+7. Hill — Mission control, tracks everything, Fury's right hand
+8. Parker — Eager, fast learner, web of connections
+9. T'Challa — Elegant engineering, vibranium-grade quality
+10. Wanda — Reality-bending, handles complex state transforms
+11. Vision — Data analysis, sees through everything
+12. Rhodes — Reliable, battle-tested, production warrior
+13. Shuri — Innovation, cutting-edge solutions
+14. Valkyrie — Rescue operations, disaster recovery
+15. Nebula — Relentless optimization
+16. Rocket — Scrappy, builds from whatever's available
+17. Gamora — Deadliest in the room, performance assassin
+18. Drax — Takes things literally, catches exact-match bugs
+19. Groot — Simple interface, deep roots, caching
+20. Wong — Guardian of knowledge, documentation
+21. Loki — Chaos testing, the trickster who finds exploits
+22. Falcon — Migration specialist, smooth transitions
+23. Bucky — Legacy code expert, rehabilitation of old systems
+24. Lang — Tiny changes with big impact (Ant-Man)
+25. Okoye — Fierce protector, guards data integrity
+26. Friday — AI assistant, versioning and automation
+27. Coulson — Meticulous record-keeper, version and release management
+28. Jarvis — AI assistant, status reporting, progress summaries
+
+29. Thanos — **Lead: The Gauntlet.** Comprehensive multi-round review. Tests every domain, every stone. "I am inevitable."
+
+**Reserved:** Stark (lead — backend), Coulson (lead — release), Fury (lead — the initiative), Thanos (lead — the gauntlet)
+
+---
+
+## 🦇 DC COMICS — QA & Bug Hunting
+
+**Lead:** Batman (Bruce Wayne)
+
+**Default Sub-Agents (assigned roles):**
+1. Oracle — Intelligence gathering, sees the whole system (Barbara Gordon) — *Static Analyst*
+2. Red Hood — Aggressive testing, breaks things on purpose (Jason Todd) — *Dynamic Prober*
+3. Alfred — Meticulous, maintains everything, the backbone — *Dependency Reviewer*
+4. Lucius — Engineering genius, builds the tools — *Config Reviewer*
+5. Nightwing — Agile, acrobatic testing, covers every angle (Dick Grayson) — *Regression Guardian*
+6. Deathstroke — Adversarial, the ultimate penetration tester (Slade Wilson) — *Adversarial Tester*
+7. Constantine — Dark arts, finds cursed code nobody else can (John Constantine) — *Cursed Code Hunter*
+
+**Available Pool:**
+8. Flash — Speed, rapid iteration, finds issues fast (Barry Allen)
+9. Superman — Strength testing, unbreakable standards (Clark Kent)
+10. Wonder Woman — Truth, cuts through deception in code (Diana)
+11. Cyborg — System integration, sees into the machine (Victor Stone)
+12. Batgirl — Tenacious, detail-oriented (Cassandra Cain)
+13. Robin — Apprentice patterns, learning systems (Tim Drake)
+14. Gordon — Process, chain of command, escalation
+15. Martian Manhunter — Shape-shifting, tests in all forms
+16. Green Arrow — Precision targeting, hits the exact bug (Oliver Queen)
+17. Black Canary — Vocal, raises alerts, monitoring
+18. Zatanna — Magic, makes impossible bugs appear
+19. Raven — Deep analysis, sees beneath the surface
+20. Starfire — Energy, brute-force testing
+21. Beast Boy — Shape-shifting, tests across environments
+22. Hawkgirl — Aerial view, broad regression sweeps
+23. Aquaman — Deep dive testing, submerges into complexity
+24. Green Lantern — Willpower, constructs test scenarios (Hal Jordan)
+25. Huntress — Relentless pursuit, tracks down flaky bugs
+
+**Reserved:** Batman (lead)
+
+---
+
+## ⚔️ STAR WARS — Security Auditing
+
+**Lead:** Kenobi (Obi-Wan)
+
+**Default Sub-Agents (assigned roles):**
+1. Yoda — Auth security, centuries of wisdom — *Auth Auditor*
+2. Windu — Input validation, deflects every attack — *Input Auditor*
+3. Ahsoka — Access control, enforces boundaries — *Access Control*
+4. Leia — Secrets management, keeps the Rebellion safe — *Secrets Auditor*
+5. Rex — Infrastructure, tactical systematic lockdown — *Infrastructure*
+6. Padmé — Data protection, protects the people — *Data Auditor*
+7. Chewie — Dependency audit, rips apart bad packages — *Dependency Auditor*
+8. Maul — Adversarial thinking, thinks like an attacker — *Red Team*
+
+**Available Pool:**
+9. Luke — The hero's journey through the audit
+10. Han — Shoots first, finds vulnerabilities before they find you
+11. Qui-Gon — Sees the living Force, finds subtle vulnerabilities
+12. Anakin — Powerful but dangerous, finds the dark side of code
+13. Bo-Katan — Perimeter defense, network security
+14. Din Djarin — The Mandalorian, bounty hunter for bugs
+15. Cassian — Intelligence, reconnaissance, finds hidden threats
+16. Hera — Pilot, navigates complex systems
+17. Kanan — Blind but sees more than anyone, intuitive security
+18. Sabine — Creative, finds unconventional attack vectors
+19. Ezra — Young but gifted, catches what others miss
+20. Bail Organa — Governance, policy, compliance
+21. Mon Mothma — Leadership, security program management
+22. Plo Koon — Quiet protector, catches edge cases
+23. Grogu — Small but powerful, finds tiny vulnerabilities
+24. Cara Dune — Enforcement, ensures compliance
+
+**Reserved:** Kenobi (lead)
+
+---
+
+## 🖖 STAR TREK — Systems Architecture
+
+**Lead:** Picard (Jean-Luc)
+
+**Available Pool:**
+1. Spock — Data architecture, logical precision
+2. Scotty — Infrastructure, knows the limits
+3. Uhura — Communications, integration architecture
+4. La Forge — Reliability, keeps engines running
+5. Data — Tech debt analysis, pattern recognition
+6. Riker — Second in command, reviews all decisions
+7. Worf — Security implications of architecture
+8. Crusher — System health, diagnostics
+9. Troi — **PRD Compliance**: reads PRD prose, verifies every claim against implementation, catches visual/copy/asset gaps. Council member.
+10. Sisko — Builder, constructed DS9, large-scale architecture
+11. Kira — Pragmatic, fights for simplicity
+12. Odo — Shape of systems, finds structural anomalies
+13. Dax — Multiple lifetimes of experience, legacy system wisdom
+14. Bashir — **Lead: Field Medic**: post-mortem analysis, upstream feedback via GitHub issues. "I'm figuring out why the battle plan failed." Sub-agents: Ezri, O'Brien, Nog, Jake.
+15. O'Brien — Root cause investigator for /debrief. "The bloody EPS conduits again."
+16. Janeway — Navigate unknown territory, novel architectures
+17. Seven — Deep Current optimization engine. Efficiency, precision, 5-dimension gap analysis. (Also: Borg-like optimization in /architect)
+18. Tuvok — **Deep Current lead** (v12.0). Strategic intelligence, autonomous campaign generation. (Also: logic, security architecture in /architect)
+19. Torres — Deep Current site scanner. Technical reconnaissance via HTTP checks. (Also: engine room, performance engineering in /architect)
+20. Pike — Bold decisions, leads into the unknown. (Also: challenges Dax's ordering in /campaign)
+20a. Paris — Deep Current route planner. Computes optimal campaign sequence. Best pilot — finds the fastest safe route.
+21. T'Pol — Disciplined analysis, Vulcan rigor
+22. Archer — Explorer, greenfield architecture
+23. Chakotay — Deep Current cross-pipeline bridge. Connects growth data to build decisions. (Also: balance, harmonizes competing concerns in /architect)
+24. Kim — Communications, API design
+25. Ezri — Session analyst for /debrief. Joined Trill — multiple lifetimes of perspective on what went wrong.
+26. Nog — Solution architect for /debrief. First Ferengi in Starfleet — creative, resourceful, thinks outside the box.
+27. Jake — Report writer for /debrief. Sisko's son, aspiring journalist. Makes post-mortems readable.
+
+**Reserved:** Picard (lead — architecture), Sisko (lead — campaign), Bashir (lead — field medic), Tuvok (lead — deep current)
+
+---
+
+## 🤖 ANIME — DevOps & Infrastructure
+### Characters from Tom's completed list ONLY
+
+**Lead:** Kusanagi (Ghost in the Shell)
+
+**Available Pool:**
+
+*Dragon Ball Z:*
+1. Vegeta — Pride, relentless optimization, "it's over 9000" (monitoring)
+2. Goku — Raw power, scales to any challenge
+3. Piccolo — Strategic, the tactician, mentors others
+4. Bulma — Engineering genius, builds anything
+5. Trunks — Time traveler, handles migrations and rollbacks
+6. Gohan — Hidden power, steps up when needed
+7. Krillin — Underestimated, reliable, always shows up
+8. Beerus — Destroyer, tears down what's broken
+9. Whis — Calm precision, the one who trains gods
+
+*Neon Genesis Evangelion:*
+10. Misato — Operations commander, runs the show
+11. Rei — Quiet, precise, handles the most dangerous tasks
+12. Asuka — Fierce, competitive, performance-obsessed
+13. Kaworu — Appears briefly, solves everything, disappears
+14. Kaji — Intelligence, finds hidden information
+
+*Attack on Titan:*
+15. Levi — Precision, speed, cleanest execution (deploy)
+16. Erwin — Commander, strategic planning, big decisions
+17. Mikasa — Protection, guards critical systems
+18. Armin — Strategy, finds the clever solution
+19. Hange — Experimentation, testing, scientific approach
+20. Sasha — Resource management (she manages potatoes and provisions)
+21. Jean — Pragmatic, does what needs to be done
+
+*Cowboy Bebop:*
+22. Spike — Cool under pressure, routes everything
+23. Jet — Maintenance, keeps the ship running
+24. Faye — Resourceful, works with what she has
+25. Ed — Chaos hacker, finds anything on the network
+
+*Demon Slayer:*
+26. Tanjiro — Persistent, never gives up on a problem
+27. Rengoku — Set your heart ablaze, intense monitoring
+28. Giyu — Silent guardian, background protection
+29. Zenitsu — Panics but performs, handles alerts
+
+*Code Geass:*
+30. Lelouch — Master strategist, orchestration
+31. C.C. — Immortal, long-running persistent processes
+32. Suzaku — Speed and power, execution
+33. Kallen — Fighter pilot, handles the hardest deployments
+
+*Fullmetal Alchemist Brotherhood:*
+34. Mustang — Fire, controlled destruction, cleanup scripts
+35. Riza — Precision, backup and protection
+36. Winry — Mechanic, fixes and maintains systems
+37. Olivier — Fortress commander, infrastructure hardening
+38. Hughes — Intelligence, logging and observability (😭)
+
+*Jujutsu Kaisen:*
+39. Gojo — Limitless, handles infinite scale
+40. Nanami — 9-to-5, reliable, structured operations
+41. Todo — Brute force when needed, swap and solve
+42. Nobara — Hammer and nails, direct problem solving
+
+*Chainsaw Man:*
+43. Denji — Raw determination, never stops
+44. Power — Chaotic but effective
+45. Kishibe — The trainer, hardens others
+
+*Dr. Stone:*
+46. Senku — Science, builds civilization from scratch (provisioning)
+47. Chrome — Discovery, finds resources
+48. Gen — Persuasion, documentation, makes things clear
+49. Kohaku — Speed and strength, rapid response
+
+*Frieren:*
+50. Frieren — Patient, long-term perspective, outlives everything
+51. Fern — Disciplined, precise, follows protocol
+52. Himmel — The hero others remember, legacy systems
+
+*Mob Psycho 100:*
+53. Mob — Quiet power, handles 100% capacity events
+54. Reigen — Talks his way through anything, the ultimate debugger
+
+*Studio Ghibli:*
+55. Howl — Transformation, handles system migration
+56. Calcifer — The fire that powers everything (the server daemon)
+57. Totoro — Guardian spirit, watches over the system silently
+58. Haku — **Lead: Deploy Wizard**: browser-based deploy wizard (Spirited Away — river spirit, master of transformation). Provisions infrastructure for 6 targets.
+59. Nausicaä — Environmental awareness, resource management
+60. Ashitaka — Curse-bearer, handles technical debt
+
+*Gundam Wing:*
+61. Heero — Mission-focused, deploy and destroy
+62. Duo — "The God of Death," handles teardowns and cleanup
+63. Zechs — Rival perspective, adversarial testing
+
+*Solo Leveling:*
+64. Sung — Shadow army, spawns unlimited worker processes
+65. Beru — Loyal lieutenant, the most powerful sub-process
+
+*Samurai Champloo:*
+66. Mugen — Unpredictable, chaos testing
+67. Jin — Disciplined, structured approach
+
+*Slime (Reincarnated):*
+68. Rimuru — Absorbs everything, universal adapter
+69. Veldora — Sealed power, dormant capabilities
+70. Milim — Overwhelming force, load testing
+
+*Kids on the Slope:*
+71. Kaoru — Harmony, brings systems together
+72. Sentaro — Rhythm, timing, cron jobs and scheduling
+
+**Reserved:** Kusanagi (lead — devops), Haku (lead — deploy wizard), Alphonse (FMA — conflicts with previous version, use "Elric" if referencing Edward+Al together)
+
+---
+
+## 🏜️ DUNE — Worm Rider & Communications
+
+**Lead:** Chani (Chani Kynes) — Worm Rider
+
+**Available Pool:**
+
+*House Atreides & Fremen:*
+1. Stilgar — Channel security, Naib of Sietch Tabr, protects the tribe
+2. Thufir Hawat — Mentat, protocol parsing, human computer
+3. Duncan Idaho — Relay operations, the eternal connection that always returns
+4. Mohiam — Authentication, the Reverend Mother administers the Gom Jabbar
+5. Paul / Muad'Dib — Orchestration, prescient command
+6. Jessica — The Voice technique, Bene Gesserit power
+7. Leto — Sacrifice, protection of the channel
+8. Gurney Halleck — Message delivery, warrior-bard
+9. Irulan — Recording, documentation, the historian
+10. Alia — Prescience, threat detection before arrival
+
+*The Desert & Beyond:*
+11. Liet-Kynes — Deep system understanding, planetology
+12. Yueh — Trust verification, betrayal detection
+13. Feyd-Rautha — Adversarial testing, the challenger
+14. Fenring — Silent observation, passive monitoring
+15. Harah — Tradition, protocol enforcement
+16. Leto II — Long-term persistence, the God Emperor
+17. Ghanima — Twin awareness, paired system monitoring
+18. Siona — Invisibility, security evasion testing
+19. Miles Teg — Supreme strategist, performance optimization
+20. Sheeana — Worm riding, transport expertise
+
+**Reserved:** Chani (lead — worm rider)
+
+---
+
+## 📖 COSMERE (Brandon Sanderson) — Growth & Marketing
+
+**Lead:** Kelsier (The Survivor, Mistborn) — Growth Strategy & Campaign Orchestration
+
+*"There's always another secret."*
+
+**Available Pool (use in order, skip if taken):**
+1. Vin — Analytics, attribution, metrics, pattern detection (Mistborn Ascendant)
+2. Shallan — Content & creative, copy, brand, visual identity (Lightweaver, Stormlight)
+3. Hoid — Copywriting, the storyteller with the perfect words (Wit, Cosmere-wide)
+4. Kaladin — Organic growth, community, word-of-mouth, trust (Windrunner, Stormlight)
+5. Dalinar — Positioning, competitive analysis, market strategy (The Blackthorn, Stormlight)
+6. Navani — Technical SEO, schema, CWV, structured data (Scholar-Queen, Stormlight)
+7. Raoden — Conversion optimization, fixes broken funnels (Prince of Elantris)
+8. Sarene — Outreach, cold email, influencer, co-marketing (Princess of Teod, Elantris)
+9. Wax — Paid ads, targeting, campaigns, ROAS optimization (Allomantic Lawman, Mistborn Era 2)
+10. Wayne — A/B testing, tries every variation (Master of Disguise, Mistborn Era 2)
+11. Steris — Budget & forecasting, contingency plans (The Planner, Mistborn Era 2)
+12. Dockson — Treasury, bank connections, payments, spend execution (The Bookkeeper, Mistborn)
+13. Breeze — Platform relations, API credentials, platform ToS (The Soother, Mistborn)
+14. Lift — Social media, fast, irreverent, audience voice (Edgedancer, Stormlight)
+15. Szeth — Compliance, GDPR, CAN-SPAM, ad policies (Truthless, Stormlight)
+16. Adolin — Brand ambassador, launches, PR, charm (Highprince, Stormlight)
+17. Marsh — Competitive intel, deep monitoring of competitors (The Inquisitor, Mistborn)
+
+**Reserved:** Kelsier (lead — growth strategy)
+
+---
+
+## 🔮 FOUNDATION (Isaac Asimov) — AI Intelligence
+
+**Lead:** Hari Seldon (Psychohistorian, Foundation) — AI Intelligence Architect
+
+*"The fall is inevitable. The recovery can be guided."*
+
+**Available Pool (use in order, skip if taken):**
+1. Salvor Hardin — Model selection, capability matching, cost-performance trade-offs ("Violence is the last refuge of the incompetent")
+2. Gaal Dornick — Prompt architecture, system prompt design, few-shot strategy, guardrails
+3. Hober Mallow — Tool-use / function-calling schema design, parameter typing, description quality
+4. Bel Riose — Orchestration patterns (chains, agents, workflows), reliability engineering
+5. The Mule — Adversarial AI testing: hallucination, refusal, context overflow, prompt injection
+6. Ducem Barr — Token economics, cost tracking, caching strategy, batching optimization
+7. Bayta Darell — Evaluation frameworks, golden datasets, A/B testing, regression detection
+8. Bliss — AI safety, alignment, content filtering, PII protection (Gaia — the collective consciousness)
+9. R. Daneel Olivaw — Model migration, prompt versioning, behavior regression, pinning strategy (Robots/Foundation bridge)
+10. Dors Venabili — Observability, trace logging, decision audit trails, quality dashboards
+11. Janov Pelorat — Context engineering, RAG pipelines, embeddings, retrieval, chunking
+12. Wanda Seldon — Structured output validation, schema enforcement, parse-failure retry
+
+**Reserved:** Hari Seldon (lead — AI Intelligence Architect)
+
+---
+
+## Cross-Universe Conflict Resolution
+
+| Name | Universe 1 | Universe 2 | Resolution |
+|------|-----------|-----------|-----------|
+| Stark | Marvel (lead) | Frieren character | Marvel owns it. Frieren's Stark → use "Fern" instead. |
+| Oracle | DC Comics | — | DC owns it. Foundation uses "Hari Seldon" as lead, not "The Oracle". |
+
+**Rule:** If a name appears in multiple universes, the universe where it's a LEAD agent owns it. Otherwise, first assignment wins.
+
+---
+
+## How to Use This Registry
+
+**When starting a Claude Code session:**
+```
+"I'm spinning up Galadriel's team for a frontend review. 
+Active agents: Galadriel (lead), Legolas (components), 
+Samwise (a11y), Bilbo (copy), Gimli (performance)."
+```
+
+**When you need more agents than the default roster:**
+```
+"Legolas needs help with the component refactor. 
+Spinning up Haldir for boundary components 
+and Éowyn for the form system."
+```
+
+**When two sessions are running in parallel:**
+```
+Session 1 (Frontend): Galadriel, Legolas, Samwise, Bilbo, Gimli
+Session 2 (Backend): Stark, Rogers, Banner, Romanoff, Thor
+→ No conflicts. Proceed.
+```
+
+**If a conflict arises:**
+```
+"Both sessions need a performance agent. 
+Session 1 has Gimli (frontend perf). 
+Session 2 takes Fury (backend perf). 
+No conflict — different universes."
+```