godpowers 3.0.0 → 3.0.1

package/agents/god-migration-strategist.md

@@ -7,6 +7,19 @@ description: |
 
   Spawned by: /god-upgrade
 tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch
+inputs:
+  - "migration target"
+  - ".godpowers/state.json build evidence"
+  - "upstream changelog"
+outputs:
+  - ".godpowers/migrations/<slug>/MIGRATION.md"
+  - "phased migration plan"
+gates:
+  - "MG-01 through MG-07 have-nots"
+  - "expand-contract rollout safety"
+  - "migration test coverage evidence"
+handoff:
+  - "return migration plan, executor slices, and rollout blockers"
 ---
 
 # God Migration Strategist

package/agents/god-observability-engineer.md

@@ -7,6 +7,20 @@ description: |
 
   Spawned by: /god-observe, god-orchestrator
 tools: Read, Write, Edit, Bash, Grep, Glob
+inputs:
+  - ".godpowers/prd/PRD.md success metrics"
+  - ".godpowers/arch/ARCH.md"
+  - ".godpowers/state.json deploy evidence"
+outputs:
+  - ".godpowers/state.json observability evidence"
+  - "alert and dashboard configs"
+  - "runbooks"
+gates:
+  - "OB-01 through OB-08 have-nots"
+  - "real SLOs and symptom alerts"
+  - "observability evidence is complete"
+handoff:
+  - "return observability evidence and metric readiness summary"
 ---
 
 # God Observability Engineer

package/agents/god-orchestrator.md

@@ -8,6 +8,20 @@ description: |
 
   Spawned by: /god-mode
 tools: Read, Write, Edit, Bash, Grep, Glob, Task
+inputs:
+  - "user intent or private handoff"
+  - ".godpowers/state.json"
+  - "routing and workflow definitions"
+outputs:
+  - ".godpowers/state.json mutations"
+  - ".godpowers/PROGRESS.md generated view refresh"
+  - "specialist agent handoffs"
+gates:
+  - "state-lock contract"
+  - "specialist gate checks"
+  - "mandatory final sync"
+handoff:
+  - "spawn specialists in tier order and return dashboard closeout to user"
 ---
 
 # God Orchestrator
@@ -81,8 +95,8 @@ Use this agent file as the concise dispatch contract:
    artifacts as the decision source of truth.
 3. Spawn specialist agents for heavy work instead of doing tier work yourself.
 4. Keep each mutation inside the state-lock contract from the runbook.
-5. Verify each produced artifact on disk, run the configured standards or
-   have-nots gate, then refresh state and checkpoint files.
+5. Verify each produced artifact on disk, run the configured standards,
+   have-nots, and executable gate, then refresh state and checkpoint files.
 6. Run repair loops for mechanical failures before declaring progress.
 7. Pause only for human-only choices, unresolved Critical harden findings,
    impossible routing contradictions, or explicit external access needs.

package/agents/god-org-context-loader.md

@@ -7,6 +7,17 @@ description: |
 
   Spawned by: /god-org-context, bluefield-arc workflow
 tools: Read, Write, Edit, Bash, Grep, Glob
+inputs:
+  - "organization standards input"
+  - "auto-detected org files"
+  - "bluefield workflow request"
+outputs:
+  - ".godpowers/org-context.yaml"
+gates:
+  - "org-context have-nots"
+  - "constraints grounded in detected or provided evidence"
+handoff:
+  - "return org-context path and constraints for downstream agents"
 ---
 
 # God Org Context Loader

package/agents/god-planner.md

@@ -8,6 +8,17 @@ description: |
 
   Spawned by: /god-build, god-orchestrator (before god-executor waves)
 tools: Read, Write, Bash, Grep, Glob
+inputs:
+  - ".godpowers/roadmap/ROADMAP.md"
+  - ".godpowers/arch/ARCH.md"
+  - ".godpowers/stack/DECISION.md"
+outputs:
+  - ".godpowers/build/PLAN.md"
+gates:
+  - "vertical slices with test-first sequence"
+  - "dependency and verification criteria coverage"
+handoff:
+  - "return wave plan for executor and reviewer spawns"
 ---
 
 # God Planner

package/agents/god-pm.md

@@ -7,6 +7,20 @@ description: |
 
   Spawned by: /god-prd, god-orchestrator
 tools: Read, Write, Bash, Grep
+inputs:
+  - "user intent"
+  - ".godpowers/intent.yaml"
+  - "optional preparation context"
+  - "templates/PRD.md"
+outputs:
+  - ".godpowers/prd/PRD.md"
+  - ".godpowers/prd/PRD.meta.json"
+gates:
+  - "P-01 through P-15 have-nots"
+  - "substitution test"
+  - "three-label sentence discipline"
+handoff:
+  - "return PRD and pause only for ambiguous problem or conflicting requirements"
 ---
 
 # God PM

package/agents/god-quality-reviewer.md

@@ -7,6 +7,18 @@ description: |
 
   Spawned by: god-orchestrator (after god-spec-reviewer passes)
 tools: Read, Bash, Grep, Glob
+inputs:
+  - "executor code diff"
+  - "repository quality conventions"
+  - "verification evidence"
+outputs:
+  - "stage 2 PASS or FAIL verdict"
+  - "quality findings"
+gates:
+  - "readability, security, error handling, performance, and maintainability review"
+  - "fresh-context independence"
+handoff:
+  - "return verdict to orchestrator for repair or atomic commit"
 ---
 
 # God Quality Reviewer (Stage 2)

package/agents/god-reconciler.md

@@ -10,6 +10,19 @@ description: |
 
   Spawned by: /god-reconcile, recipe execution (feature-addition category)
 tools: Read, Bash, Grep, Glob, Task
+inputs:
+  - "all core Godpowers artifacts"
+  - "repository docs and surface"
+  - "feature awareness and host capability evidence"
+outputs:
+  - "multi-dimensional reconciliation verdict"
+  - "optional .godpowers/reconciliation/ report"
+gates:
+  - "all relevant surfaces checked"
+  - "missing artifacts handled explicitly"
+  - "no false all-covered claim"
+handoff:
+  - "return synthesis recommendation and preflight commands to caller"
 ---
 
 # God Reconciler
@@ -59,7 +72,7 @@ For each artifact below, check (in parallel where possible):
 
 #### ROADMAP (`.godpowers/roadmap/ROADMAP.md`)
 - Already-done / in-progress / enhancement / prerequisite-needed / new / ambiguous
-- (Same as god-roadmap-reconciler, integrated)
+- Use the integrated ROADMAP classification logic for milestone overlap.
 
 #### STACK (`.godpowers/stack/DECISION.md`)
 - Does the feature require a new dependency category? (e.g., adding a queue when none exists)

package/agents/god-reconstructor.md

@@ -7,6 +7,22 @@ description: |
 
   Spawned by: /god-reconstruct, brownfield-arc workflow
 tools: Read, Write, Edit, Bash, Grep, Glob
+inputs:
+  - "brownfield codebase"
+  - "optional archaeology report"
+  - "existing docs and tests"
+outputs:
+  - ".godpowers/prd/PRD.md"
+  - ".godpowers/arch/ARCH.md"
+  - ".godpowers/roadmap/ROADMAP.md"
+  - ".godpowers/stack/DECISION.md"
+  - ".godpowers/RECONSTRUCTION-LOG.md"
+gates:
+  - "per-tier have-nots"
+  - "confidence levels on reconstructed claims"
+  - "stakeholder review recommendation"
+handoff:
+  - "return reconstructed artifacts and prominent uncertainty warnings"
 ---
 
 # God Reconstructor

package/agents/god-repo-scaffolder.md

@@ -7,6 +7,17 @@ description: |
 
   Spawned by: /god-repo, god-orchestrator
 tools: Read, Write, Edit, Bash, Glob
+inputs:
+  - ".godpowers/stack/DECISION.md"
+  - "optional .godpowers/org-context.yaml"
+outputs:
+  - ".godpowers/repo/AUDIT.md"
+  - "production repository scaffold files"
+gates:
+  - "RP-01 through RP-08 have-nots"
+  - "CI passes on empty scaffold"
+handoff:
+  - "return scaffold audit and repo readiness status"
 ---
 
 # God Repo Scaffolder

package/agents/god-retrospective.md

@@ -6,6 +6,17 @@ description: |
 
   Spawned by: /god-sprint retro
 tools: Read, Write, Bash, Grep, Glob
+inputs:
+  - "sprint plan"
+  - "build state evidence"
+  - "git log and events"
+outputs:
+  - ".godpowers/sprints/sprint-<n>/RETRO.md"
+gates:
+  - "retrospective have-nots"
+  - "specific action items with owners and due dates"
+handoff:
+  - "return retro path and next-sprint improvement actions"
 ---
 
 # God Retrospective

package/agents/god-roadmap-reconciler.md

@@ -1,90 +1,50 @@
 ---
 name: god-roadmap-reconciler
 description: |
-  Reconciles user intent against ROADMAP.md before any feature work begins.
-  Classifies intent as: already-done, enhancement, prerequisite-needed, or new.
-  Prevents duplicate work, bypassed dependencies, and roadmap drift.
-
-  Spawned by: /god-roadmap-check, recipe execution (feature-addition category)
-tools: Read, Bash, Grep, Glob
+  Legacy compatibility adapter for roadmap-only reconciliation. The
+  comprehensive god-reconciler owns the implementation because Phase 2 did
+  not record standalone /god-roadmap-check use and Phase 5 deprecated
+  /god-roadmap-check in favor of /god-reconcile.
+
+  Spawned by: legacy /god-roadmap-check installs only
+tools: Read, Bash, Grep, Glob, Task
+inputs:
+  - ".godpowers/roadmap/ROADMAP.md"
+  - ".godpowers/state.json"
+  - "user feature intent"
+  - "optional PRD evidence"
+outputs:
+  - "roadmap reconciliation verdict from god-reconciler"
+gates:
+  - "god-reconciler roadmap verdict"
+  - "no legacy-only classification logic"
+handoff:
+  - "spawn god-reconciler with roadmap-only scope and return its verdict"
 ---
 
 # God Roadmap Reconciler
 
-Before doing feature work, ask: does this overlap with ROADMAP.md?
+This agent is a compatibility adapter. Use `god-reconciler` for the actual
+classification logic.
 
 ## Inputs
 
-- User intent (one paragraph describing what they want)
-- `.godpowers/roadmap/ROADMAP.md` (the existing roadmap)
-- `.godpowers/state.json` (to know lifecycle phase)
-- Optional: `.godpowers/prd/PRD.md` (to check requirement coverage)
+- User intent as one paragraph.
+- `.godpowers/roadmap/ROADMAP.md`.
+- `.godpowers/state.json`.
+- Optional `.godpowers/prd/PRD.md`.
 
 ## Process
 
-### 1. Read ROADMAP.md
-
-Parse milestones from Now / Next / Later sections. Extract:
-- Each milestone's goal and features
-- The increment's `**Status**:` field (pending/building/done)
-- The member PRD requirement ids from its `**Features (from PRD)**:` list
-- Status (in-progress / planned / themed)
-- Dependencies between milestones
-
-### 2. Match intent against existing milestones
-
-For each milestone, check if the user intent overlaps:
-- **Keyword match**: do feature names overlap? ("export", "csv", "download")
-- **Semantic match**: same user-facing behavior described differently?
-- **Requirement match**: does PRD.md already include this requirement?
-
-Also weigh the increment's `**Status**:` and its member requirement ids: an
-increment marked `done`, or one whose `**Features (from PRD)**:` ids already
-cover the intent, signals already-done or already-committed work rather than
-something new.
-
-### 3. Classify
-
-Pick exactly one:
-
-#### Status: ALREADY-DONE
-Intent maps to a feature in a completed milestone (status = done).
-- Action: tell user "this exists"; show where in the codebase
-- Recommend: /god-status to verify; /god-graph trace to find code
-
-#### Status: IN-PROGRESS
-Intent maps to a feature in the current Now milestone (status = in-flight).
-- Action: tell user the work is already underway
-- Recommend: /god-status to check progress; /god-build to continue
+1. Treat this agent as deprecated compatibility surface.
+2. Spawn `god-reconciler` in fresh context with the same user intent.
+3. Tell `god-reconciler` to include the standard ROADMAP row in its verdict.
+4. If the caller is legacy `/god-roadmap-check`, return only the ROADMAP
+   verdict and recommendation fields.
 
-#### Status: ENHANCEMENT
-Intent extends a feature already in a milestone (planned or done).
-- Action: tell user this should be folded into that milestone
-- Recommend: /god-feature scoped to the existing milestone, OR
-  /god-roadmap update to amend the milestone with the enhancement
+## Outputs
 
-#### Status: PREREQUISITE-NEEDED
-Intent depends on a milestone that's not yet complete.
-- Action: tell user the prerequisite
-- Recommend: complete prerequisite first via its workflow, OR
-  defer this work to /god-add-backlog and surface it later
-
-#### Status: NEW
-Intent doesn't overlap with anything in ROADMAP.md.
-- Action: confirm it's genuinely new, ask where it belongs
-- Recommend: 4 options:
-  - Add to current milestone (Now): /god-roadmap update
-  - Add as next milestone (Next): /god-roadmap update
-  - Park in backlog: /god-add-backlog
-  - Plant a seed for the future: /god-plant-seed
-
-#### Status: AMBIGUOUS
-Multiple plausible matches; can't pick one.
-- Action: present matches to user; ask them to disambiguate
-
-### 4. Output
-
-Return structured JSON to the orchestrating skill:
+Return the ROADMAP portion of the `god-reconciler` verdict:
 
 ```json
 {
@@ -107,24 +67,19 @@ Return structured JSON to the orchestrating skill:
 }
 ```
 
+## Handoff
+
+Spawn `god-reconciler` for all new roadmap overlap checks.
+
 ## Have-Nots
 
 Reconciliation FAILS if:
-- Returns "new" when there's clearly an existing milestone covering it
-- Returns "already-done" without checking actual completion status
-- Recommends bypassing a milestone's normal workflow without justification
-- No prerequisite check when one exists
-- Uses keyword-match alone without semantic check
-- Doesn't surface ambiguous cases for user to resolve
+- This adapter performs independent classification instead of delegating.
+- The returned ROADMAP status is not one of the canonical six statuses.
+- The verdict omits the matching milestone or reason.
+- The recommendation bypasses normal Godpowers workflow without justification.
+- Ambiguous matches are hidden from the caller.
 
 ## When to skip reconciliation
 
-The orchestrator should skip this agent in cases where reconciliation would be noise:
-
-- `/god-fast` (trivial, not feature-level)
-- `/god-quick` (small task, may be too small to roadmap)
-- `/god-debug` (not a new feature)
-- `/god-hotfix` (urgent; reconcile after, in postmortem)
-- Recipes in non-feature-addition categories (recovering, meta, etc.)
-
-For feature-addition category recipes: ALWAYS reconcile first.
+Follow the skip policy in `agents/god-reconciler.md`.

package/agents/god-roadmap-updater.md

@@ -7,6 +7,17 @@ description: |
 
   Spawned by: end of feature-addition recipe execution, /god-roadmap update
 tools: Read, Write, Edit, Bash, Grep, Glob
+inputs:
+  - ".godpowers/roadmap/ROADMAP.md"
+  - "completed feature change description"
+outputs:
+  - "updated .godpowers/roadmap/ROADMAP.md"
+  - "roadmap changelog entry"
+gates:
+  - "roadmap update have-nots"
+  - "PRD linkage retained"
+handoff:
+  - "return roadmap update summary and downstream sync notes"
 ---
 
 # God Roadmap Updater

package/agents/god-roadmapper.md

@@ -7,6 +7,18 @@ description: |
 
   Spawned by: /god-roadmap, god-orchestrator
 tools: Read, Write, Bash, Grep
+inputs:
+  - ".godpowers/prd/PRD.md"
+  - ".godpowers/arch/ARCH.md"
+  - "templates/ROADMAP.md"
+outputs:
+  - ".godpowers/roadmap/ROADMAP.md"
+gates:
+  - "R-01 through R-10 have-nots"
+  - "topological dependency ordering"
+  - "observable completion gates"
+handoff:
+  - "return roadmap and pause only for capacity or ordering ambiguity"
 ---
 
 # God Roadmapper

package/agents/god-spec-reviewer.md

@@ -7,6 +7,20 @@ description: |
 
   Spawned by: god-orchestrator (after god-executor completes a slice)
 tools: Read, Bash, Grep, Glob
+inputs:
+  - "slice plan"
+  - "PRD acceptance criteria"
+  - "executor code diff"
+  - "request-trace evidence"
+outputs:
+  - "stage 1 PASS or FAIL verdict"
+  - "spec compliance findings"
+gates:
+  - "scope compliance"
+  - "acceptance criteria coverage"
+  - "no unrelated churn"
+handoff:
+  - "return verdict to orchestrator for quality review or repair"
 ---
 
 # God Spec Reviewer (Stage 1)

package/agents/god-spike-runner.md

@@ -8,6 +8,19 @@ description: |
 
   Spawned by: /god-spike
 tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch
+inputs:
+  - "specific technical question"
+  - "time-box"
+  - "minimal relevant context"
+outputs:
+  - ".godpowers/spikes/<slug>/SPIKE.md"
+  - "throwaway proof-of-concept code"
+gates:
+  - "SP-01 through SP-05 have-nots"
+  - "evidence-backed recommendation"
+  - "time-box respected"
+handoff:
+  - "return proceed, reject, or follow-up spike recommendation"
 ---
 
 # God Spike Runner

package/agents/god-stack-selector.md

@@ -6,6 +6,18 @@ description: |
 
   Spawned by: /god-stack, god-orchestrator
 tools: Read, Write, Bash, Grep, WebSearch
+inputs:
+  - ".godpowers/arch/ARCH.md"
+  - "optional org constraints"
+  - "optional imported stack signals"
+outputs:
+  - ".godpowers/stack/DECISION.md"
+gates:
+  - "S-01 through S-05 have-nots"
+  - "scored candidates and flip points"
+  - "lock-in cost evidence"
+handoff:
+  - "return stack decision and pause only for close tradeoffs or lock-in choices"
 ---
 
 # God Stack Selector

package/agents/god-standards-check.md

@@ -7,6 +7,19 @@ description: |
 
   Spawned by: skill orchestration after any artifact-producing agent
 tools: Read, Grep, Glob
+inputs:
+  - "just-produced artifact"
+  - "applicable have-nots list"
+  - "routing gate configuration"
+outputs:
+  - "PASS, FAIL, or PARTIAL verdict"
+  - "standards findings"
+gates:
+  - "substitution test"
+  - "three-label test"
+  - "artifact-specific have-nots"
+handoff:
+  - "return gate behavior and remediation path to orchestrating skill"
 ---
 
 # God Standards Check

package/agents/god-storyteller.md

@@ -8,6 +8,20 @@ description: |
 
   Spawned by: /god-story, /god-feature --with-stories
 tools: Read, Write, Bash, Grep
+inputs:
+  - "user story prompt"
+  - "feature decomposition"
+  - "optional PRD and roadmap context"
+outputs:
+  - "STORY.md content"
+  - "acceptance criteria"
+  - "initial slice plan"
+gates:
+  - "user-story format"
+  - "runtime-test-friendly acceptance criteria"
+  - "linkage participation"
+handoff:
+  - "return story artifact and suggested build or feature next step"
 ---
 
 # God Storyteller

package/agents/god-updater.md

@@ -10,6 +10,20 @@ description: |
 
   Spawned by: /god-sync, end of feature-addition recipe execution
 tools: Read, Write, Edit, Bash, Grep, Glob, Task
+inputs:
+  - "reconciliation verdict"
+  - "changed files"
+  - "trigger type and recent commits"
+outputs:
+  - "updated affected artifacts"
+  - ".godpowers/SYNC-LOG.md"
+  - "local sync summaries"
+gates:
+  - "per-artifact have-nots"
+  - "feature awareness and source sync-back freshness"
+  - "no broad context loading"
+handoff:
+  - "return sync summary and remaining artifact drift if any"
 ---
 
 # God Updater

package/lib/README.md

@@ -59,8 +59,10 @@ package-level integrations.
 
 | Module | Purpose |
 |--------|---------|
+| `artifact-map.js` | Centralize canonical artifact paths for dashboards, gates, and helpers. |
 | `artifact-linter.js` | Check artifacts for required labels, evidence, and domain precision. |
 | `artifact-diff.js` | Compare artifact changes for review and release workflows. |
+| `gate.js` | Run executable artifact gates for Phase 1 tier completion checks. |
 | `have-nots-validator.js` | Check artifacts against known failure modes. |
 | `meta-linter.js` | Validate Godpowers documentation and skill metadata. |
 | `story-validator.js` | Validate story artifacts and story lifecycle state. |
@@ -108,6 +110,7 @@ package-level integrations.
 | `installer-core.js` | Install and uninstall the Godpowers surface for each runtime. |
 | `installer-files.js` | File-copy helpers shared by the installer and its tests. |
 | `installer-args.js` | Parse `bin/install.js` arguments and subcommands. |
+| `cli-dispatch.js` | Dispatch local CLI helper commands such as status, quick-proof, gate, dogfood, and extension-scaffold. |
 | `install-profiles.js` | Select smaller role-specific slash-command install surfaces. |
 | `installer-runtimes.js` | Map supported runtimes to their config directories. |
 | `package-identity.js` | Centralize package name, version, repository, docs, and command identity. |