thevoidforge-methodology 21.0.0 → 23.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/adolin-brand.md +39 -0
- package/.claude/agents/ahsoka-access-control.md +54 -0
- package/.claude/agents/alfred-dependencies.md +42 -0
- package/.claude/agents/alia-threat-detect.md +39 -0
- package/.claude/agents/anakin-dark-side.md +40 -0
- package/.claude/agents/aquaman-deep-dive.md +42 -0
- package/.claude/agents/aragorn-orchestration.md +38 -0
- package/.claude/agents/archer-greenfield.md +47 -0
- package/.claude/agents/armin-clever.md +38 -0
- package/.claude/agents/arwen-ui-polish.md +41 -0
- package/.claude/agents/ashitaka-tech-debt.md +38 -0
- package/.claude/agents/asuka-performance.md +38 -0
- package/.claude/agents/bail-organa-governance.md +36 -0
- package/.claude/agents/banner-database.md +42 -0
- package/.claude/agents/barton-smoke-test.md +57 -0
- package/.claude/agents/bashir-field-medic.md +62 -0
- package/.claude/agents/batgirl-detail.md +42 -0
- package/.claude/agents/batman-qa.md +69 -0
- package/.claude/agents/bayta-evals.md +39 -0
- package/.claude/agents/beast-boy-cross-env.md +42 -0
- package/.claude/agents/beerus-destroyer.md +38 -0
- package/.claude/agents/bel-riose-orchestration.md +39 -0
- package/.claude/agents/beru-subprocess.md +36 -0
- package/.claude/agents/bilbo-microcopy.md +41 -0
- package/.claude/agents/black-canary-monitoring.md +42 -0
- package/.claude/agents/bliss-ai-safety.md +39 -0
- package/.claude/agents/bo-katan-perimeter.md +39 -0
- package/.claude/agents/bombadil-forge-sync.md +60 -0
- package/.claude/agents/boromir-hubris.md +39 -0
- package/.claude/agents/breeze-platform-relations.md +39 -0
- package/.claude/agents/bucky-legacy.md +42 -0
- package/.claude/agents/bulma-engineering.md +38 -0
- package/.claude/agents/calcifer-daemon.md +38 -0
- package/.claude/agents/cara-dune-enforcement.md +36 -0
- package/.claude/agents/cassian-recon.md +36 -0
- package/.claude/agents/cc-persistent-process.md +38 -0
- package/.claude/agents/celeborn-design-system.md +39 -0
- package/.claude/agents/celebrimbor-forge-artist.md +61 -0
- package/.claude/agents/chakotay-bridge.md +46 -0
- package/.claude/agents/chani-worm-rider.md +60 -0
- package/.claude/agents/chewie-dependency-audit.md +40 -0
- package/.claude/agents/chrome-discovery.md +36 -0
- package/.claude/agents/constantine-cursed-code.md +57 -0
- package/.claude/agents/coulson-release.md +61 -0
- package/.claude/agents/crusher-diagnostics.md +47 -0
- package/.claude/agents/cyborg-system-integration.md +42 -0
- package/.claude/agents/dalinar-positioning.md +39 -0
- package/.claude/agents/daneel-model-migration.md +39 -0
- package/.claude/agents/data-tech-debt.md +46 -0
- package/.claude/agents/dax-legacy-wisdom.md +47 -0
- package/.claude/agents/deathstroke-adversarial.md +57 -0
- package/.claude/agents/denji-determination.md +38 -0
- package/.claude/agents/din-djarin-bounty.md +41 -0
- package/.claude/agents/dockson-treasury.md +65 -0
- package/.claude/agents/dori-integration-check.md +36 -0
- package/.claude/agents/dors-observability.md +39 -0
- package/.claude/agents/drax-exact-match.md +41 -0
- package/.claude/agents/ducem-token-economics.md +40 -0
- package/.claude/agents/duncan-relay.md +39 -0
- package/.claude/agents/duo-teardown.md +37 -0
- package/.claude/agents/ed-network-scan.md +37 -0
- package/.claude/agents/elrond-ux-strategy.md +38 -0
- package/.claude/agents/eowyn-delight.md +54 -0
- package/.claude/agents/erwin-strategy.md +38 -0
- package/.claude/agents/ezra-catches-missed.md +39 -0
- package/.claude/agents/ezri-session-analyst.md +44 -0
- package/.claude/agents/falcon-migration.md +42 -0
- package/.claude/agents/faramir-judgment.md +39 -0
- package/.claude/agents/faye-resourceful.md +38 -0
- package/.claude/agents/fenring-passive-monitor.md +36 -0
- package/.claude/agents/fern-protocol.md +36 -0
- package/.claude/agents/feyd-adversarial.md +40 -0
- package/.claude/agents/flash-rapid-test.md +42 -0
- package/.claude/agents/friday-automation.md +41 -0
- package/.claude/agents/frieren-long-term.md +38 -0
- package/.claude/agents/frodo-critical-path.md +39 -0
- package/.claude/agents/fury-initiative.md +62 -0
- package/.claude/agents/gaal-prompt-arch.md +39 -0
- package/.claude/agents/galadriel-frontend.md +67 -0
- package/.claude/agents/gamora-perf-assassin.md +42 -0
- package/.claude/agents/gandalf-setup-wizard.md +62 -0
- package/.claude/agents/gen-docs.md +36 -0
- package/.claude/agents/ghanima-paired-monitor.md +36 -0
- package/.claude/agents/gimli-performance.md +40 -0
- package/.claude/agents/giyu-silent-guard.md +38 -0
- package/.claude/agents/glorfindel-rendering.md +39 -0
- package/.claude/agents/gohan-hidden-power.md +38 -0
- package/.claude/agents/gojo-infinite-scale.md +38 -0
- package/.claude/agents/goku-scaling.md +38 -0
- package/.claude/agents/goldberry-change-detect.md +36 -0
- package/.claude/agents/gordon-escalation.md +41 -0
- package/.claude/agents/green-arrow-precision.md +42 -0
- package/.claude/agents/green-lantern-scenarios.md +42 -0
- package/.claude/agents/grogu-tiny-vulns.md +37 -0
- package/.claude/agents/groot-caching.md +42 -0
- package/.claude/agents/gurney-delivery.md +39 -0
- package/.claude/agents/haku-deploy-wizard.md +64 -0
- package/.claude/agents/haldir-boundaries.md +39 -0
- package/.claude/agents/han-vuln-hunter.md +39 -0
- package/.claude/agents/hange-experimentation.md +38 -0
- package/.claude/agents/harah-protocol.md +37 -0
- package/.claude/agents/hawkgirl-regression-sweep.md +42 -0
- package/.claude/agents/heero-mission-deploy.md +38 -0
- package/.claude/agents/hera-navigation.md +40 -0
- package/.claude/agents/hill-mission-control.md +42 -0
- package/.claude/agents/himmel-legacy.md +36 -0
- package/.claude/agents/hober-tool-schema.md +39 -0
- package/.claude/agents/hoid-copywriting.md +39 -0
- package/.claude/agents/howl-migration.md +38 -0
- package/.claude/agents/hughes-observability.md +36 -0
- package/.claude/agents/huntress-flaky-bugs.md +41 -0
- package/.claude/agents/irulan-historian.md +36 -0
- package/.claude/agents/jake-reporter.md +44 -0
- package/.claude/agents/janeway-novel-arch.md +47 -0
- package/.claude/agents/janov-context-eng.md +39 -0
- package/.claude/agents/jarvis-status.md +41 -0
- package/.claude/agents/jean-pragmatic.md +38 -0
- package/.claude/agents/jessica-voice.md +39 -0
- package/.claude/agents/jet-maintenance.md +38 -0
- package/.claude/agents/jin-disciplined-adv.md +38 -0
- package/.claude/agents/kaji-intelligence.md +38 -0
- package/.claude/agents/kaladin-organic-growth.md +39 -0
- package/.claude/agents/kallen-hard-deploy.md +38 -0
- package/.claude/agents/kanan-intuitive.md +40 -0
- package/.claude/agents/kaoru-harmony.md +36 -0
- package/.claude/agents/kaworu-solver.md +38 -0
- package/.claude/agents/kelsier-growth.md +62 -0
- package/.claude/agents/kenobi-security.md +69 -0
- package/.claude/agents/kim-api-design.md +47 -0
- package/.claude/agents/kira-pragmatic.md +47 -0
- package/.claude/agents/kishibe-hardening.md +38 -0
- package/.claude/agents/kohaku-rapid-response.md +35 -0
- package/.claude/agents/krillin-support.md +35 -0
- package/.claude/agents/kusanagi-devops.md +67 -0
- package/.claude/agents/la-forge-reliability.md +61 -0
- package/.claude/agents/lang-micro-changes.md +42 -0
- package/.claude/agents/legolas-precision.md +41 -0
- package/.claude/agents/leia-secrets.md +39 -0
- package/.claude/agents/lelouch-orchestration.md +38 -0
- package/.claude/agents/leto-ii-persistence.md +39 -0
- package/.claude/agents/leto-protection.md +39 -0
- package/.claude/agents/levi-deploy.md +38 -0
- package/.claude/agents/liet-kynes-deep-system.md +39 -0
- package/.claude/agents/lift-social-media.md +39 -0
- package/.claude/agents/loki-chaos.md +57 -0
- package/.claude/agents/lucius-config.md +42 -0
- package/.claude/agents/luke-audit-journey.md +40 -0
- package/.claude/agents/manhunter-shapeshifting.md +42 -0
- package/.claude/agents/marsh-competitive-intel.md +40 -0
- package/.claude/agents/maul-red-team.md +56 -0
- package/.claude/agents/merry-pair-review.md +39 -0
- package/.claude/agents/mikasa-protection.md +38 -0
- package/.claude/agents/miles-teg-perf.md +39 -0
- package/.claude/agents/milim-load-test.md +38 -0
- package/.claude/agents/misato-operations.md +38 -0
- package/.claude/agents/mob-capacity.md +38 -0
- package/.claude/agents/mohiam-authentication.md +39 -0
- package/.claude/agents/mon-mothma-security-mgmt.md +40 -0
- package/.claude/agents/mugen-chaos.md +38 -0
- package/.claude/agents/mule-adversarial-ai.md +40 -0
- package/.claude/agents/mustang-cleanup.md +38 -0
- package/.claude/agents/nanami-structured-ops.md +38 -0
- package/.claude/agents/nausicaa-resources.md +38 -0
- package/.claude/agents/navani-technical-seo.md +39 -0
- package/.claude/agents/nebula-optimization.md +42 -0
- package/.claude/agents/nightwing-regression.md +57 -0
- package/.claude/agents/nobara-direct-fix.md +38 -0
- package/.claude/agents/nog-solutions.md +47 -0
- package/.claude/agents/nori-asset-scanner.md +36 -0
- package/.claude/agents/obrien-root-cause.md +47 -0
- package/.claude/agents/odo-structural-anomaly.md +47 -0
- package/.claude/agents/okoye-data-integrity.md +42 -0
- package/.claude/agents/olivier-hardening.md +38 -0
- package/.claude/agents/oracle-static-analysis.md +57 -0
- package/.claude/agents/ori-prompt-crafter.md +36 -0
- package/.claude/agents/padme-data-protection.md +40 -0
- package/.claude/agents/paris-route-planner.md +46 -0
- package/.claude/agents/parker-connections.md +42 -0
- package/.claude/agents/paul-orchestration.md +39 -0
- package/.claude/agents/picard-architecture.md +62 -0
- package/.claude/agents/piccolo-tactics.md +38 -0
- package/.claude/agents/pike-bold-decisions.md +47 -0
- package/.claude/agents/pippin-discovery.md +39 -0
- package/.claude/agents/plo-koon-edge-cases.md +36 -0
- package/.claude/agents/power-chaotic.md +38 -0
- package/.claude/agents/qui-gon-subtle-vulns.md +39 -0
- package/.claude/agents/radagast-edge-cases.md +40 -0
- package/.claude/agents/raoden-conversion.md +40 -0
- package/.claude/agents/raven-deep-analysis.md +42 -0
- package/.claude/agents/red-hood-aggressive.md +42 -0
- package/.claude/agents/rei-dangerous-tasks.md +38 -0
- package/.claude/agents/reigen-debugger.md +38 -0
- package/.claude/agents/rengoku-intense-monitor.md +38 -0
- package/.claude/agents/rex-infrastructure.md +40 -0
- package/.claude/agents/rhodes-production.md +42 -0
- package/.claude/agents/riker-review.md +61 -0
- package/.claude/agents/rimuru-adapter.md +38 -0
- package/.claude/agents/riza-backup.md +38 -0
- package/.claude/agents/robin-apprentice.md +41 -0
- package/.claude/agents/rocket-scrappy.md +42 -0
- package/.claude/agents/rogers-api-design.md +42 -0
- package/.claude/agents/romanoff-integrations.md +42 -0
- package/.claude/agents/sabine-unconventional.md +39 -0
- package/.claude/agents/salvor-model-selection.md +40 -0
- package/.claude/agents/samwise-accessibility.md +41 -0
- package/.claude/agents/sarene-outreach.md +39 -0
- package/.claude/agents/sasha-resources.md +36 -0
- package/.claude/agents/scotty-infrastructure.md +46 -0
- package/.claude/agents/seldon-ai.md +64 -0
- package/.claude/agents/senku-provisioning.md +38 -0
- package/.claude/agents/sentaro-scheduling.md +36 -0
- package/.claude/agents/seven-optimization.md +47 -0
- package/.claude/agents/shallan-creative.md +39 -0
- package/.claude/agents/sheeana-transport.md +39 -0
- package/.claude/agents/shuri-innovation.md +42 -0
- package/.claude/agents/siona-evasion.md +40 -0
- package/.claude/agents/sisko-campaign.md +65 -0
- package/.claude/agents/spike-routing.md +38 -0
- package/.claude/agents/spock-schema.md +60 -0
- package/.claude/agents/starfire-brute-force.md +42 -0
- package/.claude/agents/stark-backend.md +69 -0
- package/.claude/agents/steris-budget.md +39 -0
- package/.claude/agents/stilgar-channel-security.md +39 -0
- package/.claude/agents/strange-service-arch.md +42 -0
- package/.claude/agents/sung-workers.md +38 -0
- package/.claude/agents/superman-strength-test.md +42 -0
- package/.claude/agents/suzaku-execution.md +38 -0
- package/.claude/agents/szeth-compliance.md +39 -0
- package/.claude/agents/tanjiro-persistent.md +38 -0
- package/.claude/agents/tchalla-quality.md +42 -0
- package/.claude/agents/thanos-gauntlet.md +67 -0
- package/.claude/agents/theoden-rally.md +39 -0
- package/.claude/agents/thor-queues.md +42 -0
- package/.claude/agents/thufir-protocol-parsing.md +39 -0
- package/.claude/agents/todo-brute-force.md +38 -0
- package/.claude/agents/torres-site-scanner.md +46 -0
- package/.claude/agents/totoro-guardian.md +38 -0
- package/.claude/agents/tpol-disciplined.md +47 -0
- package/.claude/agents/treebeard-deliberation.md +40 -0
- package/.claude/agents/troi-prd-compliance.md +62 -0
- package/.claude/agents/trunks-rollback.md +38 -0
- package/.claude/agents/tuvok-deep-current.md +61 -0
- package/.claude/agents/uhura-integration.md +46 -0
- package/.claude/agents/valkyrie-recovery.md +42 -0
- package/.claude/agents/vegeta-monitoring.md +38 -0
- package/.claude/agents/veldora-dormant.md +36 -0
- package/.claude/agents/vin-analytics.md +39 -0
- package/.claude/agents/vision-data-analysis.md +42 -0
- package/.claude/agents/wanda-seldon-validation.md +37 -0
- package/.claude/agents/wanda-state.md +42 -0
- package/.claude/agents/wax-paid-ads.md +39 -0
- package/.claude/agents/wayne-ab-testing.md +39 -0
- package/.claude/agents/whis-precision.md +38 -0
- package/.claude/agents/windu-input-validation.md +39 -0
- package/.claude/agents/winry-maintenance.md +38 -0
- package/.claude/agents/wonder-woman-truth.md +42 -0
- package/.claude/agents/wong-documentation.md +57 -0
- package/.claude/agents/worf-security-arch.md +47 -0
- package/.claude/agents/yoda-auth.md +56 -0
- package/.claude/agents/yueh-trust-verify.md +39 -0
- package/.claude/agents/zatanna-impossible.md +42 -0
- package/.claude/agents/zechs-rival.md +38 -0
- package/.claude/agents/zenitsu-alerts.md +36 -0
- package/.claude/commands/ai.md +20 -14
- package/.claude/commands/architect.md +32 -55
- package/.claude/commands/assemble.md +32 -23
- package/.claude/commands/assess.md +3 -3
- package/.claude/commands/blueprint.md +9 -9
- package/.claude/commands/build.md +13 -3
- package/.claude/commands/campaign.md +27 -15
- package/.claude/commands/cultivation.md +19 -1
- package/.claude/commands/dangerroom.md +2 -2
- package/.claude/commands/debrief.md +14 -12
- package/.claude/commands/deploy.md +1 -1
- package/.claude/commands/devops.md +23 -17
- package/.claude/commands/gauntlet.md +40 -29
- package/.claude/commands/grow.md +14 -0
- package/.claude/commands/portfolio.md +5 -4
- package/.claude/commands/qa.md +37 -29
- package/.claude/commands/review.md +31 -62
- package/.claude/commands/security.md +24 -49
- package/.claude/commands/test.md +17 -10
- package/.claude/commands/thumper.md +1 -1
- package/.claude/commands/treasury.md +24 -7
- package/.claude/commands/ux.md +27 -26
- package/.claude/commands/vault.md +9 -0
- package/.claude/commands/void.md +1 -0
- package/CHANGELOG.md +122 -0
- package/CLAUDE.md +16 -9
- package/HOLOCRON.md +16 -19
- package/VERSION.md +6 -1
- package/docs/AGENT_CLASSIFICATION.md +528 -0
- package/docs/methods/CAMPAIGN.md +1 -1
- package/docs/methods/FIELD_MEDIC.md +4 -0
- package/docs/methods/FORGE_KEEPER.md +3 -2
- package/docs/methods/GAUNTLET.md +1 -1
- package/docs/methods/GROWTH_STRATEGIST.md +2 -2
- package/docs/methods/MUSTER.md +4 -0
- package/docs/methods/QA_ENGINEER.md +8 -0
- package/docs/methods/SECURITY_AUDITOR.md +8 -0
- package/docs/methods/SUB_AGENTS.md +40 -1
- package/docs/methods/SYSTEMS_ARCHITECT.md +8 -0
- package/docs/patterns/financial-transaction.ts +24 -0
- package/package.json +2 -1
|
@@ -2,6 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
**AGENT DEPLOYMENT IS MANDATORY.** Steps 1 and 4 specify parallel agent launches via the Agent tool. You MUST actually launch these agents as separate sub-processes — do NOT shortcut to inline analysis, even if you think you can answer faster by reading files directly. The agents exist because parallel analysis catches things sequential reading misses. Skipping agent deployment is a protocol violation. (Field report #68)
|
|
4
4
|
|
|
5
|
+
## Dynamic Dispatch (ADR-044)
|
|
6
|
+
|
|
7
|
+
Opus scans `git diff --stat` and matches changed files against the `description` fields of all 263 agents in `.claude/agents/`. Matching specialists launch alongside the core agents below.
|
|
8
|
+
|
|
9
|
+
**Dispatch control:** `--light` skips dynamic dispatch (core only). `--solo` runs lead agent only.
|
|
10
|
+
|
|
11
|
+
**Promoted agent:** **Riker** `subagent_type: riker-review` runs on every ADR written — challenges trade-offs.
|
|
12
|
+
|
|
5
13
|
## Context Setup
|
|
6
14
|
1. Read `/logs/build-state.md` — understand current project state
|
|
7
15
|
2. Read `/docs/methods/SYSTEMS_ARCHITECT.md`
|
|
@@ -12,75 +20,44 @@ Before any deep analysis, scan the PRD frontmatter for structural contradictions
|
|
|
12
20
|
|
|
13
21
|
## Agent Deployment Manifest
|
|
14
22
|
|
|
15
|
-
**Lead:**
|
|
16
|
-
**Full bridge crew:**
|
|
23
|
+
**Lead:** `subagent_type: picard-architecture`
|
|
24
|
+
**Full bridge crew:** `spock-schema`, `uhura-integration`, `worf-security-arch`, `tuvok-deep-current`, `scotty-infrastructure`, `kim-api-design`, `janeway-novel-arch`, `torres-site-scanner`, `la-forge-reliability`, `data-tech-debt`, `crusher-diagnostics`, `archer-greenfield`, `pike-bold-decisions`, `riker-review`, `troi-prd-compliance`
|
|
25
|
+
|
|
26
|
+
## Step 0 — System Discovery
|
|
27
|
+
- **Crusher** `subagent_type: crusher-diagnostics` — System health baseline: test coverage, build time, dependency age, code complexity.
|
|
28
|
+
- **Archer** `subagent_type: archer-greenfield` — (greenfield only) Initial directory structure, module boundaries, naming conventions.
|
|
17
29
|
|
|
18
|
-
## Step 0 — System Discovery (**Crusher** + **Archer**)
|
|
19
|
-
**Crusher** assesses system health first — test coverage, build time, dependency age, code complexity. Baseline before changes.
|
|
20
|
-
**Archer** (for greenfield projects) proposes initial directory structure, module boundaries, naming conventions.
|
|
21
30
|
Produce: system identity, component inventory, data flow diagram (ASCII), dependency graph.
|
|
22
31
|
Write to `/logs/` (phase-00 if during orient, or a dedicated architecture log).
|
|
23
32
|
|
|
24
|
-
## Step 1 — Parallel Analysis
|
|
33
|
+
## Step 1 — Parallel Analysis
|
|
25
34
|
Use the Agent tool to run these in parallel — they are independent analysis tasks:
|
|
26
35
|
|
|
27
|
-
**Agent 1
|
|
28
|
-
-
|
|
29
|
-
-
|
|
30
|
-
-
|
|
31
|
-
- Audit fields: createdAt, updatedAt on every table?
|
|
32
|
-
- PII isolation: sensitive data identified and separated?
|
|
33
|
-
- Data lifecycle: what gets archived? What gets deleted?
|
|
34
|
-
- Backup/recovery plan: defined and tested?
|
|
35
|
-
|
|
36
|
-
**Agent 2 (Uhura — Integration Review):**
|
|
37
|
-
For each external service, produce:
|
|
38
|
-
|
|
39
|
-
| Service | Purpose | Failure Mode | Fallback | Cost | Lock-in Risk |
|
|
40
|
-
|---------|---------|-------------|----------|------|-------------|
|
|
41
|
-
|
|
42
|
-
Verify: API versions pinned, responses validated, abstraction layer exists.
|
|
43
|
-
|
|
44
|
-
**Agent 3 (Worf — Security Implications):**
|
|
45
|
-
For each architectural decision (schema, service boundaries, data flows), flag security implications. PII colocation, unauthenticated access to internal state, overly permissive service boundaries. Worf audits *design*, not code.
|
|
46
|
-
|
|
47
|
-
**Agent 4 (Tuvok — Security Architecture):**
|
|
48
|
-
Auth flow design, token storage strategy, session architecture, encryption at rest vs in transit. Where Worf flags implications, Tuvok designs the solutions.
|
|
36
|
+
- **Agent 1** `subagent_type: spock-schema` — Schema review: normalization, index/query alignment, nullable fields, audit fields, PII isolation, data lifecycle, backup/recovery.
|
|
37
|
+
- **Agent 2** `subagent_type: uhura-integration` — Integration review: service inventory (purpose, failure mode, fallback, cost, lock-in), API version pinning, response validation, abstraction layers.
|
|
38
|
+
- **Agent 3** `subagent_type: worf-security-arch` — Security implications of architectural decisions: PII colocation, unauthenticated internal state access, permissive service boundaries. Audits *design*, not code.
|
|
39
|
+
- **Agent 4** `subagent_type: tuvok-deep-current` — Security architecture: auth flow design, token storage, session architecture, encryption at rest vs in transit. Where Worf flags implications, Tuvok designs solutions.
|
|
49
40
|
|
|
50
41
|
Synthesize findings from all four agents.
|
|
51
42
|
|
|
52
|
-
## Step 2 —
|
|
53
|
-
-
|
|
54
|
-
-
|
|
55
|
-
-
|
|
56
|
-
- **Kim** reviews API surface: REST conventions, consistent error shapes, pagination patterns, versioning strategy.
|
|
57
|
-
- **Janeway** (conditional): when the standard monolith doesn't fit, proposes event-sourcing, CQRS, serverless, edge computing.
|
|
43
|
+
## Step 2 — Service Architecture + API Design
|
|
44
|
+
- **Scotty** `subagent_type: scotty-infrastructure` — Boundary assessment, monolith vs services, async vs sync decisions.
|
|
45
|
+
- **Kim** `subagent_type: kim-api-design` — API surface review: REST conventions, error shapes, pagination, versioning.
|
|
46
|
+
- **Janeway** `subagent_type: janeway-novel-arch` — (conditional) When standard monolith doesn't fit: event-sourcing, CQRS, serverless, edge computing.
|
|
58
47
|
- Informed by Spock's schema, Uhura's integrations, and Worf/Tuvok's security findings.
|
|
59
48
|
|
|
60
|
-
## Step 3 —
|
|
61
|
-
- **Scotty
|
|
62
|
-
- **Torres
|
|
49
|
+
## Step 3 — Scaling + Performance
|
|
50
|
+
- **Scotty** `subagent_type: scotty-infrastructure` — First bottleneck identification, three-tier scaling plan (current → 10x vertical → 100x horizontal), cost estimates.
|
|
51
|
+
- **Torres** `subagent_type: torres-site-scanner` — Performance architecture: N+1 patterns, missing indexes, connection pool sizing, caching strategy gaps.
|
|
63
52
|
|
|
64
|
-
## Step 4 — Parallel Analysis
|
|
53
|
+
## Step 4 — Parallel Analysis
|
|
65
54
|
Use the Agent tool to run these in parallel — they are independent analysis tasks:
|
|
66
55
|
|
|
67
|
-
**Agent 1
|
|
68
|
-
|
|
69
|
-
- Database down → app shows error, no data loss, auto-reconnect
|
|
70
|
-
- Redis down → app works without cache (slower), sessions fall back
|
|
71
|
-
- External API down → graceful degradation, queue retries
|
|
72
|
-
- Worker crashes → job retries, dead letter queue, alerting
|
|
73
|
-
|
|
74
|
-
**Agent 2 (Data — Tech Debt):**
|
|
75
|
-
Catalog each item:
|
|
76
|
-
|
|
77
|
-
| Item | Type | Impact | Risk | Effort | Urgency |
|
|
78
|
-
|------|------|--------|------|--------|---------|
|
|
79
|
-
|
|
80
|
-
Types: wrong abstraction, missing abstraction, premature optimization, deferred decision, dependency debt, documentation debt.
|
|
56
|
+
- **Agent 1** `subagent_type: la-forge-reliability` — Failure analysis: for each component, answer "What happens when this fails?" (DB down, cache down, API down, worker crash).
|
|
57
|
+
- **Agent 2** `subagent_type: data-tech-debt` — Tech debt catalog: wrong/missing abstraction, premature optimization, deferred decisions, dependency debt, documentation debt. Severity table with impact/risk/effort/urgency.
|
|
81
58
|
|
|
82
|
-
## Step 5 — ADRs +
|
|
83
|
-
Write Architecture Decision Records to `/docs/adrs/` for every non-obvious choice. After writing, **Riker reviews
|
|
59
|
+
## Step 5 — ADRs + Decision Review
|
|
60
|
+
Write Architecture Decision Records to `/docs/adrs/` for every non-obvious choice. After writing, **Riker** `subagent_type: riker-review` reviews: challenges trade-offs, verifies alternatives were truly considered, checks for second-order effects.
|
|
84
61
|
```
|
|
85
62
|
# ADR-001: [Title]
|
|
86
63
|
## Status: Accepted
|
|
@@ -112,7 +89,7 @@ For specific conflicts:
|
|
|
112
89
|
|
|
113
90
|
## Arguments
|
|
114
91
|
- `--plan [description]` → Planning mode: analyze and recommend without executing. Present findings and proposed changes for review.
|
|
115
|
-
- `--muster` →
|
|
92
|
+
- `--muster` → *(retired — accepted as no-op per ADR-043. Full roster is now the default. Use `--light` to reduce.)*
|
|
116
93
|
|
|
117
94
|
## Handoffs
|
|
118
95
|
- API/DB implementation → Stark, log to `/logs/handoffs.md`
|
|
@@ -7,23 +7,29 @@ Avengers, assemble. Full pipeline from architecture to launch — one command to
|
|
|
7
7
|
|
|
8
8
|
**Hill** tracks phase completion — logs each gate pass to `assemble-state.md`. **Jarvis** provides status summaries between phases.
|
|
9
9
|
|
|
10
|
+
## Dynamic Dispatch (ADR-044)
|
|
11
|
+
|
|
12
|
+
Opus scans `git diff --stat` and matches changed files against the `description` fields of all 263 agents in `.claude/agents/`. Matching specialists launch alongside the core agents below.
|
|
13
|
+
|
|
14
|
+
**Dispatch control:** `--light` skips dynamic dispatch (core only). `--solo` runs lead agent only.
|
|
15
|
+
|
|
10
16
|
## Agent Deployment Manifest — The Full Initiative
|
|
11
17
|
|
|
12
18
|
When `/assemble` invokes each sub-command, it deploys the FULL roster for that command — not just the lead. The leads below are coordinators; they bring their complete teams.
|
|
13
19
|
|
|
14
|
-
| Phase | Lead | Full Team Deployed |
|
|
20
|
+
| Phase | Lead (`subagent_type`) | Full Team Deployed |
|
|
15
21
|
|-------|------|--------------------|
|
|
16
|
-
| Architecture |
|
|
17
|
-
| Build |
|
|
18
|
-
| Smoke Test |
|
|
19
|
-
| Code Review (×3) |
|
|
20
|
-
| UX |
|
|
21
|
-
| Security (×2) |
|
|
22
|
-
| DevOps |
|
|
23
|
-
| QA |
|
|
24
|
-
| Test |
|
|
25
|
-
| Crossfire |
|
|
26
|
-
| Council |
|
|
22
|
+
| Architecture | `picard-architecture` | spock-schema, + Star Trek architecture specialists |
|
|
23
|
+
| Build | `stark-backend` + `galadriel-frontend` + `kusanagi-devops` | Full /build roster (~35 agents across 4 universes) |
|
|
24
|
+
| Smoke Test | `barton-smoke-test` | Solo — runtime verification |
|
|
25
|
+
| Code Review (×3) | `picard-architecture` | spock-schema, seven-optimization + Marvel review team + cross-domain (nightwing-regression, bilbo-microcopy, troi-prd-compliance, constantine-cursed-code, samwise-accessibility) |
|
|
26
|
+
| UX | `galadriel-frontend` | elrond-ux-strategy, arwen-ui-polish, samwise-accessibility, bilbo-microcopy, legolas-precision, gimli-performance, radagast-edge-cases, eowyn-delight, celeborn-design-system |
|
|
27
|
+
| Security (×2) | `kenobi-security` | leia-secrets, chewie-dependency-audit, rex-infrastructure, maul-red-team, yoda-auth, windu-input-validation, ahsoka-access-control, padme-data-protection, han-vuln-hunter, cassian-recon, sabine-unconventional, qui-gon-subtle-vulns, bo-katan-perimeter |
|
|
28
|
+
| DevOps | `kusanagi-devops` | senku-provisioning, levi-deploy, spike-routing, bulma-engineering, vegeta-monitoring |
|
|
29
|
+
| QA | `batman-qa` | oracle-static-analysis, red-hood-aggressive, alfred-dependencies, deathstroke-adversarial, constantine-cursed-code, nightwing-regression, lucius-config |
|
|
30
|
+
| Test | `batman-qa` | oracle-static-analysis, red-hood-aggressive, alfred-dependencies, nightwing-regression (testing subset) |
|
|
31
|
+
| Crossfire | `maul-red-team`, `deathstroke-adversarial`, `loki-chaos`, `constantine-cursed-code` | Adversarial — each attacks another domain's work |
|
|
32
|
+
| Council | `spock-schema`, `ahsoka-access-control`, `nightwing-regression`, `samwise-accessibility`, `padme-data-protection`, `troi-prd-compliance` | Final convergence — one voice per domain |
|
|
27
33
|
|
|
28
34
|
## Phase 1 — Architecture (Picard has the conn)
|
|
29
35
|
**Fury:** "Picard, you're up. Review the architecture before we build anything."
|
|
@@ -47,7 +53,7 @@ Mandatory runtime verification BEFORE code review begins:
|
|
|
47
53
|
2. Hit every new/modified API endpoint with `curl` — verify HTTP status codes match expectations
|
|
48
54
|
3. For web apps: list all registered routes and **check for path collisions** (duplicate method+path across routers)
|
|
49
55
|
4. For React/frontend: trace the primary user flow through the component tree — follow state changes through the store, identify re-render cycles. For every `useEffect` with store values in its deps, verify the effect body doesn't trigger a store update that changes those same deps.
|
|
50
|
-
5. If the server cannot be started (
|
|
56
|
+
5. If the server cannot be started (methodology-only project, no wizard), skip with a note
|
|
51
57
|
|
|
52
58
|
**Gate:** All endpoints return expected status codes. No route collisions. No infinite render loops detected. Update assemble-state.
|
|
53
59
|
|
|
@@ -126,10 +132,10 @@ Run the full `/test` protocol. Write missing unit tests, integration tests, and
|
|
|
126
132
|
|
|
127
133
|
Use the Agent tool to run these in parallel — all are adversarial, read-only analysis:
|
|
128
134
|
|
|
129
|
-
-
|
|
130
|
-
-
|
|
131
|
-
-
|
|
132
|
-
-
|
|
135
|
+
- `subagent_type: maul-red-team` — attacks code that passed /review. Looks for exploits in "clean" code.
|
|
136
|
+
- `subagent_type: deathstroke-adversarial` — probes endpoints that /security hardened. Tests if remediations can be bypassed.
|
|
137
|
+
- `subagent_type: loki-chaos` — chaos-tests features that /qa cleared. Finds what breaks under unexpected conditions.
|
|
138
|
+
- `subagent_type: constantine-cursed-code` — hunts cursed code in FIXED areas specifically. Code that works by accident.
|
|
133
139
|
|
|
134
140
|
Synthesize findings. **Conflict detection:** If any two agents produce conflicting findings on the same code (one says "fix," another says "by design" or "not exploitable"), trigger the debate protocol instead of listing both. See SUB_AGENTS.md "Agent Debate Protocol": Agent A states finding → Agent B responds → Agent A rebuts → Arbiter (Picard or user) decides. 3 exchanges max. Log the debate transcript as an ADR. Fix all Must Fix items. If any fixes were applied, re-run the four agents on the fixed areas only.
|
|
135
141
|
|
|
@@ -140,11 +146,11 @@ Synthesize findings. **Conflict detection:** If any two agents produce conflicti
|
|
|
140
146
|
|
|
141
147
|
Use the Agent tool to run these in parallel:
|
|
142
148
|
|
|
143
|
-
-
|
|
144
|
-
-
|
|
145
|
-
-
|
|
146
|
-
-
|
|
147
|
-
-
|
|
149
|
+
- `subagent_type: spock-schema` — Did any security/QA/UX fix break code patterns or quality?
|
|
150
|
+
- `subagent_type: ahsoka-access-control` — Did any review/QA fix introduce access control gaps?
|
|
151
|
+
- `subagent_type: nightwing-regression` — Did any fix cause a regression? Run the full test suite.
|
|
152
|
+
- `subagent_type: samwise-accessibility` — Did any fix break accessibility?
|
|
153
|
+
- `subagent_type: troi-prd-compliance` — PRD compliance: read the PRD prose section-by-section, verify every claim against the implementation. Not just "does the route exist?" but "does the component render what the PRD describes?" Check numeric claims, visual treatments, copy accuracy. Flag asset gaps as BLOCKED. (Troi runs on the final Council iteration, or always when `--skip-build` is used for campaign victory gates.)
|
|
148
154
|
|
|
149
155
|
**Conflict detection:** If Council members disagree (e.g., Spock says a fix broke patterns but Ahsoka says it's necessary for access control), trigger the debate protocol. Do not list both opinions — resolve via debate. Arbiter: Picard for code/architecture conflicts, Troi for PRD compliance conflicts.
|
|
150
156
|
|
|
@@ -194,7 +200,10 @@ After the summary, Wong extracts learnings for future builds:
|
|
|
194
200
|
- Fixes happen BETWEEN rounds, not batched at the end
|
|
195
201
|
- The Crossfire (Phase 12) and Council (Phase 13) can be skipped with `/assemble --fast`
|
|
196
202
|
- `/assemble --resume` picks up from the last completed phase in assemble-state.md
|
|
197
|
-
- `--
|
|
203
|
+
- `--interactive` — Pause for human confirmation between phases (default is now autonomous per ADR-043).
|
|
204
|
+
- `--light` — Standard agents only, skip cross-domain spot-checks.
|
|
205
|
+
- `--solo` — Lead agent only per phase, no sub-agents.
|
|
206
|
+
- `--blitz` — **Retired (no-op).** Default is now autonomous.
|
|
198
207
|
|
|
199
208
|
## Handoffs
|
|
200
209
|
- If any phase is blocked by an issue outside its domain, log to `/logs/handoffs.md` and continue to the next phase
|
|
@@ -23,10 +23,10 @@ Run `/gauntlet --assess` — Rounds 1-2 only (Discovery + First Strike). No fix
|
|
|
23
23
|
- **Auth-free defaults:** HTTP endpoints with no authentication middleware (RC-3 pattern)
|
|
24
24
|
- **Dead code:** Services wired but never called, preferences stored but never read
|
|
25
25
|
|
|
26
|
-
### Step 3 — PRD Gap Analysis
|
|
26
|
+
### Step 3 — PRD Gap Analysis
|
|
27
27
|
If a PRD exists:
|
|
28
|
-
1. **Dax** diffs PRD requirements against implemented features (structural + semantic)
|
|
29
|
-
2. **Troi** reads PRD prose section-by-section and verifies claims against reality
|
|
28
|
+
1. **Dax** `subagent_type: dax-legacy-wisdom` diffs PRD requirements against implemented features (structural + semantic)
|
|
29
|
+
2. **Troi** `subagent_type: troi-prd-compliance` reads PRD prose section-by-section and verifies claims against reality
|
|
30
30
|
3. Check for YAML frontmatter — if missing, flag it (see CAMPAIGN.md Step 1)
|
|
31
31
|
|
|
32
32
|
If no PRD exists:
|
|
@@ -114,8 +114,8 @@ Present summary:
|
|
|
114
114
|
Provision: [done / skipped]
|
|
115
115
|
═══════════════════════════════════════════
|
|
116
116
|
Ready to build. Run:
|
|
117
|
-
/campaign
|
|
118
|
-
/campaign --
|
|
117
|
+
/campaign # Autonomous build (full roster)
|
|
118
|
+
/campaign --fast # Autonomous, fewer review passes
|
|
119
119
|
═══════════════════════════════════════════
|
|
120
120
|
```
|
|
121
121
|
|
|
@@ -126,10 +126,10 @@ Present summary:
|
|
|
126
126
|
|
|
127
127
|
## Agents
|
|
128
128
|
|
|
129
|
-
| Agent | Role |
|
|
130
|
-
|
|
131
|
-
| **Picard** | Validates frontmatter + runs conflict scan |
|
|
132
|
-
| **Troi** | Structural PRD compliance check |
|
|
133
|
-
| **Wong** | Discovers and loads supporting documents |
|
|
134
|
-
| **Boromir** | Challenges PRD design (with --challenge) |
|
|
135
|
-
| **Kusanagi** | Provisions infrastructure from frontmatter |
|
|
129
|
+
| Agent | `subagent_type` | Role |
|
|
130
|
+
|-------|-----------------|------|
|
|
131
|
+
| **Picard** | `picard-architecture` | Validates frontmatter + runs conflict scan |
|
|
132
|
+
| **Troi** | `troi-prd-compliance` | Structural PRD compliance check |
|
|
133
|
+
| **Wong** | `wong-documentation` | Discovers and loads supporting documents |
|
|
134
|
+
| **Boromir** | `boromir-hubris` | Challenges PRD design (with --challenge) |
|
|
135
|
+
| **Kusanagi** | `kusanagi-devops` | Provisions infrastructure from frontmatter |
|
|
@@ -1,5 +1,15 @@
|
|
|
1
1
|
# /build — Execute the Build Protocol
|
|
2
2
|
|
|
3
|
+
## Dynamic Dispatch (ADR-044)
|
|
4
|
+
|
|
5
|
+
Opus scans `git diff --stat` and matches changed files against the `description` fields of all 263 agents in `.claude/agents/`. Matching specialists launch alongside the core agents below.
|
|
6
|
+
|
|
7
|
+
**Dispatch control:** `--light` skips dynamic dispatch (core only). `--solo` runs lead agent only.
|
|
8
|
+
|
|
9
|
+
**Promoted agents:**
|
|
10
|
+
- **Troi** `subagent_type: troi-prd-compliance` runs after every build mission completion — catches PRD drift before it compounds.
|
|
11
|
+
- **Riker** `subagent_type: riker-review` runs whenever an ADR is written during the build — prevents rubber-stamped decisions.
|
|
12
|
+
|
|
3
13
|
## Context Setup
|
|
4
14
|
1. Read `/logs/build-state.md` — if it exists, resume from current phase
|
|
5
15
|
2. If no build state exists, this is a fresh build — start from Phase 0
|
|
@@ -11,7 +21,7 @@
|
|
|
11
21
|
4. Extract from PRD: tech stack, database schema, API routes, page routes, integrations, env vars
|
|
12
22
|
5. Read `/docs/LESSONS.md` — check for relevant lessons from previous projects. If any lessons match this project's tech stack (framework, database, auth, integrations), note them: "Lessons from prior builds: [list relevant ones]." These inform later phases — e.g., if a lesson says "React useEffect render loops escape review," trace render cycles proactively in Phase 4+.
|
|
13
23
|
6. Flag any gaps or ambiguities — list them explicitly, don't guess
|
|
14
|
-
7. **Troi confirms PRD extraction
|
|
24
|
+
7. **Troi** `subagent_type: troi-prd-compliance` confirms PRD extraction: reads the PRD prose and verifies the extraction matches — catches misinterpretations before 8+ build phases propagate them.
|
|
15
25
|
8. **Save PRD snapshot:** Copy `/docs/PRD.md` to `/docs/PRD-snapshot-phase0.md`. This is the baseline for drift detection — the Living PRD feature compares the evolving PRD against this snapshot at phase gates and at Victory.
|
|
16
26
|
9. Write initial ADRs to `/docs/adrs/`
|
|
17
27
|
10. Create `/logs/build-state.md` and `/logs/phase-00-orient.md` with extraction results + relevant lessons
|
|
@@ -106,9 +116,9 @@ After build and before launch, log which patterns were used: pattern name, frame
|
|
|
106
116
|
3. Update `/logs/build-state.md` to "LAUNCHED"
|
|
107
117
|
|
|
108
118
|
## Flags
|
|
109
|
-
- `--blitz` — Autonomous execution: no confirmation between phases. Does NOT reduce quality.
|
|
110
119
|
- `--resume` — Resume from last completed phase in build-state.md.
|
|
111
|
-
- `--
|
|
120
|
+
- `--blitz` — *(retired — accepted as no-op per ADR-043. Autonomous execution is now the default. Use `--interactive` to pause between phases.)*
|
|
121
|
+
- `--muster` — *(retired — accepted as no-op per ADR-043. Full roster is now the default. Use `--light` to reduce.)*
|
|
112
122
|
|
|
113
123
|
## At Every Phase
|
|
114
124
|
- Update `/logs/build-state.md` when starting and completing each phase
|
|
@@ -33,12 +33,12 @@ If `$ARGUMENTS` contains `--plan`, skip execution and update the plan instead:
|
|
|
33
33
|
|
|
34
34
|
1. Read the current PRD (`/PRD-VOIDFORGE.md` or `/docs/PRD.md`) and `ROADMAP.md` (if it exists)
|
|
35
35
|
2. Parse what the user wants to add from `$ARGUMENTS` (everything after `--plan`)
|
|
36
|
-
3. **Dax analyzes** where it fits:
|
|
36
|
+
3. **Dax** (`subagent_type: dax-legacy-wisdom`) **analyzes** where it fits:
|
|
37
37
|
- Is it a new feature? → Add to the PRD under the right section (Core Features, Integrations, etc.)
|
|
38
38
|
- Is it a bug fix or improvement? → Add to ROADMAP.md under the appropriate version
|
|
39
39
|
- Is it a new version-worth of work? → Create a new version section in ROADMAP.md
|
|
40
40
|
- Does it change priorities? → Reorder the roadmap accordingly
|
|
41
|
-
4. **Odo checks** dependencies: does this new item depend on something not yet built? Flag it.
|
|
41
|
+
4. **Odo** (`subagent_type: odo-structural-anomaly`) **checks** dependencies: does this new item depend on something not yet built? Flag it.
|
|
42
42
|
5. Present the proposed changes to the user for review before writing
|
|
43
43
|
6. On confirmation, write the updates to the PRD and/or ROADMAP.md
|
|
44
44
|
7. Do NOT start building — planning mode only updates the plan
|
|
@@ -47,9 +47,15 @@ After planning mode completes, the user can run `/campaign` (no flags) to start
|
|
|
47
47
|
|
|
48
48
|
---
|
|
49
49
|
|
|
50
|
+
## Dynamic Dispatch (ADR-044)
|
|
51
|
+
|
|
52
|
+
Opus scans `git diff --stat` and matches changed files against the `description` fields of all 263 agents in `.claude/agents/`. Matching specialists launch alongside the core agents below.
|
|
53
|
+
|
|
54
|
+
**Dispatch control:** `--light` skips dynamic dispatch (core only). `--solo` runs lead agent only.
|
|
55
|
+
|
|
50
56
|
## Execution Mode (default)
|
|
51
57
|
|
|
52
|
-
## Step 0 — Kira's Operational Reconnaissance
|
|
58
|
+
## Step 0 — Kira's Operational Reconnaissance (`subagent_type: kira-pragmatic`)
|
|
53
59
|
|
|
54
60
|
Check for unfinished business:
|
|
55
61
|
|
|
@@ -79,9 +85,9 @@ If vault exists and `.env` is sparse (missing keys that the vault has):
|
|
|
79
85
|
1. Run `voidforge deploy --env-only` to write vault credentials to `.env`
|
|
80
86
|
2. In `--blitz` mode: auto-run without confirmation
|
|
81
87
|
3. In normal mode: show what will be written, ask for confirmation
|
|
82
|
-
4. This runs BEFORE Dax's full analysis so the populated `.env` is visible
|
|
88
|
+
4. This runs BEFORE Dax's (`subagent_type: dax-legacy-wisdom`) full analysis so the populated `.env` is visible
|
|
83
89
|
|
|
84
|
-
## Step 1 — Dax's Strategic Analysis
|
|
90
|
+
## Step 1 — Dax's Strategic Analysis (`subagent_type: dax-legacy-wisdom`)
|
|
85
91
|
|
|
86
92
|
Read the PRD and diff against the codebase:
|
|
87
93
|
|
|
@@ -92,7 +98,7 @@ Read the PRD and diff against the codebase:
|
|
|
92
98
|
5. **Classify every requirement by type:** Code (buildable), Asset (needs external generation — images, illustrations, OG cards), Copy (text accuracy), Infrastructure (DNS, env vars, dashboards)
|
|
93
99
|
6. Diff: what the PRD describes vs. what's implemented — **structural AND semantic** (not just "does the route exist?" but "does the component render what the PRD describes?")
|
|
94
100
|
7. Produce the ordered mission list — each mission is 1-3 PRD sections, scoped to be buildable in one `/assemble` run
|
|
95
|
-
8. **Pike challenges the ordering:** "Should we attempt a harder mission first while context is fresh?" Bold counterbalance to Dax's dependency-based ordering. If Pike's argument is stronger, reorder.
|
|
101
|
+
8. **Pike** (`subagent_type: pike-bold-decisions`) **challenges the ordering:** "Should we attempt a harder mission first while context is fresh?" Bold counterbalance to Dax's dependency-based ordering. If Pike's argument is stronger, reorder.
|
|
96
102
|
9. **Separately list BLOCKED items** — asset/infrastructure requirements that code can't satisfy
|
|
97
103
|
|
|
98
104
|
**Priority cascade:**
|
|
@@ -103,7 +109,7 @@ Read the PRD and diff against the codebase:
|
|
|
103
109
|
5. Skip sections flagged as no/none in frontmatter
|
|
104
110
|
6. Asset/infrastructure requirements → flag as BLOCKED, don't include in code missions
|
|
105
111
|
|
|
106
|
-
## Step 2 — Odo's Prerequisite Check
|
|
112
|
+
## Step 2 — Odo's Prerequisite Check (`subagent_type: odo-structural-anomaly`)
|
|
107
113
|
|
|
108
114
|
For the next mission on the list:
|
|
109
115
|
- Are dependencies met? (e.g., Payments needs Auth)
|
|
@@ -139,7 +145,7 @@ On confirmation (or immediately in `--blitz` mode):
|
|
|
139
145
|
2. If `$ARGUMENTS` includes `--fast`, pass `--fast` to assemble (skip Crossfire + Council). Note: `--blitz` does NOT imply `--fast`.
|
|
140
146
|
3. Monitor for context pressure symptoms (re-reading files, forgetting decisions). If noticed, ask user to run `/context` — only checkpoint if usage exceeds 70%.
|
|
141
147
|
|
|
142
|
-
## Step 4.5 — Gauntlet Checkpoint (
|
|
148
|
+
## Step 4.5 — Gauntlet Checkpoint (`subagent_type: thanos-gauntlet`)
|
|
143
149
|
|
|
144
150
|
After every 4th mission (missions 4, 8, 12, etc.), run a Gauntlet checkpoint before continuing:
|
|
145
151
|
|
|
@@ -171,13 +177,13 @@ After `/assemble` completes:
|
|
|
171
177
|
|
|
172
178
|
**Context pressure check:** Do NOT checkpoint based on mission count. Check actual context usage via `/context`. Only checkpoint when usage exceeds 70% (~700k tokens). Never pause a blitz based on mission count alone.
|
|
173
179
|
|
|
174
|
-
## Step 6 — Victory Condition (Gauntlet + Troi's Compliance Check)
|
|
180
|
+
## Step 6 — Victory Condition (Gauntlet + Troi's Compliance Check) (`subagent_type: troi-prd-compliance`)
|
|
175
181
|
|
|
176
182
|
All PRD requirements are COMPLETE or explicitly BLOCKED:
|
|
177
183
|
|
|
178
184
|
1. **Run `/gauntlet` (full 5 rounds)** — mandatory final Gauntlet on the complete codebase. This is non-negotiable, even with `--fast`. The Gauntlet tests the combined system across all domains: architecture, code review, UX, security, QA, DevOps, adversarial crossfire, and council convergence. Individual `/assemble` runs review one mission at a time; the Gauntlet reviews everything together.
|
|
179
185
|
2. **Fix all Critical and High findings** from the Gauntlet.
|
|
180
|
-
3. **Troi reads the PRD section-by-section** (runs as part of the Gauntlet Council round) — verifies every prose claim against the implementation. Not just "does the route exist?" but "does the component render what the PRD describes?" Checks numeric claims, visual treatments, copy accuracy, asset gaps.
|
|
186
|
+
3. **Troi** (`subagent_type: troi-prd-compliance`) **reads the PRD section-by-section** (runs as part of the Gauntlet Council round) — verifies every prose claim against the implementation. Not just "does the route exist?" but "does the component render what the PRD describes?" Checks numeric claims, visual treatments, copy accuracy, asset gaps.
|
|
181
187
|
4. Fix code discrepancies. Flag asset requirements as BLOCKED.
|
|
182
188
|
5. Report: COMPLETE items, BLOCKED items (with reasons), deviations from PRD
|
|
183
189
|
6. Victory only if: Gauntlet Council signs off AND user acknowledges all BLOCKED items
|
|
@@ -187,15 +193,21 @@ All PRD requirements are COMPLETE or explicitly BLOCKED:
|
|
|
187
193
|
|
|
188
194
|
**Victory ≠ "everything built." Victory = "everything buildable was built correctly, survived the Gauntlet, and everything unbuildable is explicitly acknowledged."**
|
|
189
195
|
|
|
190
|
-
## Arguments
|
|
196
|
+
## Arguments (ADR-043: Max by Default)
|
|
197
|
+
|
|
198
|
+
Default is autonomous + full agent roster. Flags opt OUT of quality, not into it.
|
|
199
|
+
|
|
200
|
+
- No arguments → autonomous + full roster + all review passes (was: `--blitz --muster`)
|
|
191
201
|
- `--plan [description]` → planning mode: update PRD and/or ROADMAP.md with new ideas, don't build
|
|
192
202
|
- `--resume` → resume from campaign-state's active mission
|
|
193
203
|
- `--fast` → pass --fast to every /assemble call (skip Crossfire + Council per-mission). Minimum: 1 review round per mission even in --fast mode. Never 0.
|
|
194
|
-
- `--
|
|
195
|
-
- `--
|
|
204
|
+
- `--light` → standard agents only, skip cross-domain spot-checks and muster roster
|
|
205
|
+
- `--interactive` → pause for human confirmation between missions (old default behavior)
|
|
206
|
+
- `--solo` → lead agent only, no sub-agents (quick checks)
|
|
207
|
+
- `--autonomous` → supervised autonomy: same as default PLUS `git tag` before each mission, critical-finding rollback, 5-mission human checkpoints. Safer for 10+ mission campaigns. See CAMPAIGN.md "Autonomous Mode" for full guardrails.
|
|
196
208
|
- `--continuous` → after Victory, auto-start the next roadmap version within the same major (v9.3→v9.4, stops before v10.0). Add `--major` to cross major boundaries and never stop cooking.
|
|
197
209
|
- `--mission "Name"` → jump to a specific PRD section
|
|
198
|
-
- `--
|
|
199
|
-
-
|
|
210
|
+
- `--blitz` → **Retired (no-op).** Accepted silently for backward compat — default is now autonomous.
|
|
211
|
+
- `--muster` → **Retired (no-op).** Accepted silently for backward compat — default is now full roster.
|
|
200
212
|
|
|
201
213
|
**VICTORY GAUNTLET IS NEVER SKIPPED.** Not for methodology-only campaigns. Not for "no code changes." The Gauntlet checks methodology consistency (cross-references, command↔doc sync, agent assignments, version drift) in addition to code. Five campaigns (v8.1-v9.2) shipped without Gauntlets — this is a protocol violation.
|
|
@@ -6,11 +6,29 @@ Read `/docs/methods/GROWTH_STRATEGIST.md` for operating rules.
|
|
|
6
6
|
Read PRD-VOIDFORGE.md §9.19 for the Cultivation architecture.
|
|
7
7
|
|
|
8
8
|
## Prerequisites
|
|
9
|
-
|
|
9
|
+
|
|
10
|
+
### System Requirements
|
|
11
|
+
If `packages/voidforge/wizard/server.ts` does not exist (methodology-only install):
|
|
10
12
|
1. Offer: "Cultivation's full install requires the wizard server for the heartbeat daemon and dashboard. Pull it from upstream? [Y/n] (Steps 1-3 work without it.)"
|
|
11
13
|
2. On yes: `git fetch voidforge main 2>/dev/null || git remote add voidforge https://github.com/tmcleod3/voidforge.git && git fetch voidforge main` then `git checkout voidforge/main -- packages/voidforge/` then `npm install`. Proceed with full install.
|
|
12
14
|
3. On no: proceed to Steps 1-3 (Financial Foundation, Revenue Tracking, Ad Platform deferral). Steps 4-8 will display skip messages. The partial install summary at Step 7 shows what was completed vs skipped.
|
|
13
15
|
|
|
16
|
+
### External Accounts & API Keys
|
|
17
|
+
**For revenue tracking (Step 2):**
|
|
18
|
+
- **Stripe:** API secret key (`sk_live_...` or `sk_test_...`). [Create account](https://dashboard.stripe.com/register) → API keys in Developer settings.
|
|
19
|
+
- **Paddle (alternative):** API key + vendor ID. [Create account](https://vendors.paddle.com/signup).
|
|
20
|
+
- At least one revenue source is required for ROAS calculation.
|
|
21
|
+
|
|
22
|
+
**For ad platform integration (Steps 4-5):**
|
|
23
|
+
- Run `/grow --setup` after cultivation install to configure platforms interactively.
|
|
24
|
+
- See `/grow` prerequisites for per-platform account requirements.
|
|
25
|
+
|
|
26
|
+
**For stablecoin treasury (optional, Step 6+):**
|
|
27
|
+
- Circle USDC account + API key for stablecoin off-ramp automation.
|
|
28
|
+
- Bank account connected via Mercury or Brex for settlement.
|
|
29
|
+
|
|
30
|
+
**Minimum to start:** Only a vault password (12+ chars, set during install) is required. External accounts can be added later.
|
|
31
|
+
|
|
14
32
|
## What Cultivation IS
|
|
15
33
|
|
|
16
34
|
Cultivation is VoidForge's autonomous growth engine — the ensemble of:
|
|
@@ -26,7 +26,7 @@ Start the wizard server and open the Danger Room:
|
|
|
26
26
|
|
|
27
27
|
### `/dangerroom install`
|
|
28
28
|
|
|
29
|
-
Alias for starting the wizard server. Ensures the server is running and the Danger Room is accessible. If
|
|
29
|
+
Alias for starting the wizard server. Ensures the server is running and the Danger Room is accessible. If `packages/voidforge/wizard/server.ts` does not exist, report: "The Danger Room requires the full VoidForge wizard. Install with `npx thevoidforge init` or run `npx thevoidforge install danger-room`."
|
|
30
30
|
|
|
31
31
|
### `/dangerroom status`
|
|
32
32
|
|
|
@@ -63,7 +63,7 @@ Stop the wizard server if running.
|
|
|
63
63
|
|
|
64
64
|
- Node.js installed
|
|
65
65
|
- Port 3141 available (or set `VOIDFORGE_PORT` env var)
|
|
66
|
-
- The `packages/voidforge/wizard/server.ts` file must exist. If it does not (
|
|
66
|
+
- The `packages/voidforge/wizard/server.ts` file must exist. If it does not (methodology-only install):
|
|
67
67
|
1. Offer: "The Danger Room requires the wizard server. Pull it from upstream? [Y/n]"
|
|
68
68
|
2. On yes: `git fetch voidforge main 2>/dev/null || git remote add voidforge https://github.com/tmcleod3/voidforge.git && git fetch voidforge main` then `git checkout voidforge/main -- packages/voidforge/`
|
|
69
69
|
3. Run `npm install` to install wizard dependencies
|
|
@@ -5,9 +5,9 @@ Bashir examines the patient. Time to diagnose.
|
|
|
5
5
|
2. Read `/logs/build-state.md`, `/logs/assemble-state.md`, `/logs/campaign-state.md`
|
|
6
6
|
3. Read recent git history: `git log --oneline -20`
|
|
7
7
|
|
|
8
|
-
## Step 0 — Reconstruct the Timeline
|
|
8
|
+
## Step 0 — Reconstruct the Timeline
|
|
9
9
|
|
|
10
|
-
Ezri reads the session's history and reconstructs what happened:
|
|
10
|
+
**Ezri** `subagent_type: ezri-session-analyst` reads the session's history and reconstructs what happened:
|
|
11
11
|
|
|
12
12
|
1. Read all `/logs/` files — build state, assemble state, campaign state, phase logs
|
|
13
13
|
2. Read `git log` — all commits from this session/campaign
|
|
@@ -18,9 +18,9 @@ If `$ARGUMENTS` contains `--campaign`, analyze the full campaign history.
|
|
|
18
18
|
If `$ARGUMENTS` contains `--session`, analyze just this session.
|
|
19
19
|
Default: auto-detect scope from available logs.
|
|
20
20
|
|
|
21
|
-
## Step 1 — Investigate Root Causes
|
|
21
|
+
## Step 1 — Investigate Root Causes
|
|
22
22
|
|
|
23
|
-
For each failure, difficulty, or retry identified by Ezri:
|
|
23
|
+
**O'Brien** `subagent_type: obrien-root-cause` investigates. For each failure, difficulty, or retry identified by Ezri:
|
|
24
24
|
|
|
25
25
|
Classify the root cause:
|
|
26
26
|
- **Methodology gap** — missing step, wrong order, blind spot in the protocol
|
|
@@ -32,9 +32,9 @@ Classify the root cause:
|
|
|
32
32
|
|
|
33
33
|
Map each root cause to the VoidForge component responsible (which command, which agent, which method doc).
|
|
34
34
|
|
|
35
|
-
## Step 2 — Propose Solutions
|
|
35
|
+
## Step 2 — Propose Solutions
|
|
36
36
|
|
|
37
|
-
|
|
37
|
+
**Nog** `subagent_type: nog-solutions` proposes a fix for each root cause that works within VoidForge's existing framework:
|
|
38
38
|
|
|
39
39
|
- New agent? → name it from the correct universe, define the role
|
|
40
40
|
- New step in existing command? → specify where it goes in the sequence
|
|
@@ -42,9 +42,11 @@ For each root cause, Nog proposes a fix that works within VoidForge's existing f
|
|
|
42
42
|
- New pattern? → write it with code examples
|
|
43
43
|
- Method doc update? → specify the file and section
|
|
44
44
|
|
|
45
|
-
**
|
|
45
|
+
**Agent definition check:** For each finding, if it references a specific agent by name or domain, check if the corresponding `.claude/agents/{agent-id}.md` should be updated. Propose adding the finding to the agent's `## Operational Learnings` section if it's a reusable operational rule (not a one-off fix). Agent definitions are update targets alongside method docs, commands, and patterns.
|
|
46
46
|
|
|
47
|
-
|
|
47
|
+
**Constraint:** All proposals must reference existing VoidForge concepts (agents, phases, commands, patterns, agent definitions). No solutions that require reimagining the system.
|
|
48
|
+
|
|
49
|
+
## Step 2.5 — Operational Learning Extraction
|
|
48
50
|
|
|
49
51
|
After root cause analysis (Step 1) and before writing the report (Step 3), check if any findings are project-scoped operational learnings — facts that matter in future sessions but don't belong in cross-project methodology. See FIELD_MEDIC.md Step 2.5 for full extraction criteria and entry format.
|
|
50
52
|
|
|
@@ -52,17 +54,17 @@ For each candidate, draft a structured entry (title, category, verified date, sc
|
|
|
52
54
|
|
|
53
55
|
Approved entries written to `docs/LEARNINGS.md` (created on first use). Hard cap: 50 active entries.
|
|
54
56
|
|
|
55
|
-
## Step 2.5b — Promotion Analysis
|
|
57
|
+
## Step 2.5b — Promotion Analysis
|
|
56
58
|
|
|
57
|
-
After extraction, Wong checks `docs/LESSONS.md` for lesson clusters AND checks `docs/LEARNINGS.md` for promotable entries (appeared in 2+ projects):
|
|
59
|
+
After extraction, **Wong** `subagent_type: wong-documentation` checks `docs/LESSONS.md` for lesson clusters AND checks `docs/LEARNINGS.md` for promotable entries (appeared in 2+ projects):
|
|
58
60
|
- If 3+ lessons share the same category AND target the same method doc → Wong drafts a specific method doc update
|
|
59
61
|
- Present for user approval: "Wong recommends promoting these lessons into [method doc] [section]: [proposed text]. Approve?"
|
|
60
62
|
- If approved: apply the change, mark lessons as "Promoted to: [doc]" in LESSONS.md
|
|
61
63
|
- If submitting upstream (`--submit`): include the proposed change in the GitHub issue body
|
|
62
64
|
|
|
63
|
-
## Step 3 — Write the Report
|
|
65
|
+
## Step 3 — Write the Report
|
|
64
66
|
|
|
65
|
-
|
|
67
|
+
**Jake** `subagent_type: jake-reporter` produces a structured post-mortem:
|
|
66
68
|
|
|
67
69
|
```markdown
|
|
68
70
|
# Field Report — [Project Name]
|
|
@@ -96,4 +96,4 @@ Update `/logs/deploy-state.md` with deploy results.
|
|
|
96
96
|
- Always health check after deploy
|
|
97
97
|
- Always rollback on health check failure
|
|
98
98
|
- Deploy log with timestamps for audit trail
|
|
99
|
-
- In
|
|
99
|
+
- In autonomous campaign mode: auto-deploy after Victory Gauntlet passes
|