godpowers 2.7.0 → 3.0.1

package/CHANGELOG.md

@@ -7,6 +7,48 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.0.1] - 2026-06-11
+
+### Changed
+- Updated README, roadmap, reference, MCP, architecture, release checklist, and
+  release notes for the 3.0.1 patch release.
+- Bumped `godpowers` and `@godpowers/mcp` package metadata to 3.0.1.
+- Clarified that `npm run lint` is a separate release-sensitive check rather
+  than part of `npm run release:check`.
+
+### Fixed
+- Fixed architecture extension compatibility examples to match shipped
+  first-party pack compatibility ranges.
+- Added quick proof regression coverage for adoption canary and published
+  install verification documentation links.
+
+### Removed
+- Removed the completed migration planning file from the public documentation
+  tree.
+
+## [3.0.0] - 2026-06-10
+
+### Added
+- Added `/god-plan`, `/god-fix`, `/god-ship`, `/god-capture`, and
+  `/god-extend` as thin verb dispatchers over existing leaf commands.
+- Added routing metadata for the new verb dispatchers so repository surface
+  checks keep skills and routes aligned.
+
+### Changed
+- Changed the omitted installer profile default from `full` to `core`.
+- Updated the `core` profile to install the front door, status, verb
+  dispatchers, and `/god-mode` compatibility while preserving every command in
+  `--profile=full`.
+- Routed `/god-observe` through the `ship` verb boundary based on Phase 2 host
+  proof evidence.
+- Updated public docs, profile tests, command-family tests, and Phase 5
+  surface evidence for the 117-command surface.
+
+### Deprecated
+- Deprecated `/god-locate` in favor of `/god-status --locate`.
+- Deprecated `/god-lifecycle` in favor of `/god-status --lifecycle`.
+- Added `successor` metadata to deprecated compatibility commands.
+
 ## [2.7.0] - 2026-06-10
 
 ### Added
@@ -74,7 +116,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 - Updated USERS, README, roadmap, reference, architecture, release notes, and
-  bridge-plan status for the Phase 2 host proof campaign.
+  migration status for the Phase 2 host proof campaign.
 
 ## [2.5.0] - 2026-06-10
 

package/README.md

@@ -2,7 +2,7 @@
 
 [![CI](https://github.com/aihxp/godpowers/actions/workflows/ci.yml/badge.svg)](https://github.com/aihxp/godpowers/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-2.7.0-blue)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-3.0.1-blue)](CHANGELOG.md)
 [![npm](https://img.shields.io/npm/v/godpowers.svg)](https://www.npmjs.com/package/godpowers)
 
 **Ship fast. Ship right. Ship everything. Ship accountably.**
@@ -30,23 +30,17 @@ Godpowers makes AI coding accountable: every serious run should leave disk
 state, artifacts, validation gates, host guarantees, and a next action. Code is
 only one output. The project memory and proof trail matter too.
 
-Version 2.7.0 makes `.godpowers/state.json` the one-directional state authority,
-adds the locked `godpowers state advance` helper, and generates checksummed
-markdown state views for humans. It keeps the optional `@godpowers/mcp`
-companion package, the 2.5.2 installed-runtime gate and build-gate fixes, the
-2.5.1 Codex host proof studies, executable tier gates, 2.4 command-family UX,
-external CLI canary evidence, prompt-size guardrails, legacy command quarantine,
-lib coverage gating, and package verification before publish.
-
-Maintainer hardening continues on the 2.x line with small, audited public
-surface updates when they close real workflow gaps. The 2.1.0 patch closes a command-injection vector in the
-agent-browser driver, guards runtime file parsing against corrupt state,
-makes data-directory installs a clean replace, and reconciles documentation
-drift. The 2.0.3 patch range-checks workflow agent references,
-derives command metadata from the individual files in `skills/`, delegates
-installer runtime logic to `lib/`, moves the detailed God Mode runbook into
-`references/`, and exposes async file APIs for incremental migration away from
-synchronous-only internals.
+Version 3.0.1 is a release-surface cleanup patch on top of the 3.0.0 surface
+contraction release. The current 3.x line keeps the omitted installer profile
+on `core`, preserves `--profile=full` for compatibility, keeps locate and
+lifecycle views under `/god-status`, ships the optional `@godpowers/mcp`
+companion package, and verifies docs, package contents, npm metadata, GitHub
+release state, and published install behavior before public release.
+
+Maintainer hardening continues on the 3.x line with small, audited public
+surface updates when they close real workflow gaps. Historical release details
+live in [CHANGELOG.md](CHANGELOG.md), while the current release status lives in
+[RELEASE.md](RELEASE.md).
 
 Strict release readiness remains fail-closed. Godpowers requires delegated
 release checks to cover root docs, docs, agents, skills, routing, workflows,
@@ -120,8 +114,9 @@ The installer copies:
 - Codex agent metadata to `<runtime>/agents/*.toml`
 - SessionStart hook (Claude Code only) to `<runtime>/hooks/`
 
-Installer profiles keep the visible command surface calm. Start with `core` or
-`builder` unless you already know you need the full maintainer surface:
+Installer profiles keep the visible command surface calm. The default omitted
+profile is `core`; choose `builder` or `maintainer` only when you already know
+you need those leaves:
 
 ```bash
 npx godpowers --claude --global --profile=core
@@ -129,10 +124,11 @@ npx godpowers --codex --local --profile=builder
 npx godpowers --all --profile=maintainer
 ```
 
-Profiles are `core`, `builder`, `maintainer`, `suite`, and `full`. `full`
-preserves the complete command surface, while the smaller profiles install the
-commands most relevant to the role. `--minimal` is an alias for
-`--profile=core`.
+Profiles are `core`, `builder`, `maintainer`, `suite`, and `full`. `core`
+installs the front door, status, verb dispatchers, and `/god-mode`
+compatibility. `full` preserves the complete command surface, while the smaller
+profiles install the commands most relevant to the role. `--minimal` is an
+alias for `--profile=core`.
 
 Use profiles as journeys:
 
@@ -227,13 +223,13 @@ commands remain direct shortcuts.
 
 | Goal | Starter path |
 |---|---|
-| Start a product | `/god-init`, `/god-prd`, `/god-design`, `/god-arch`, `/god-roadmap`, `/god-stack`, `/god-repo`, `/god-build` |
+| Start a product | `/god-init`, `/god-plan`, `/god-build` |
 | Add a feature | `/god-reconcile`, `/god-feature`, `/god-sync`, `/god-review` |
-| Fix production | `/god-hotfix`, `/god-postmortem`, `/god-status` |
+| Fix production | `/god-fix`, `/god-postmortem`, `/god-status` |
 | Audit an existing repo | `/god-preflight`, `/god-archaeology`, `/god-reconstruct`, `/god-audit`, `/god-tech-debt` |
-| Ship a release | `/god-sync`, `/god-docs`, `/god-version`, `/god-automation-setup`, `npm run release:check` |
+| Ship a release | `/god-ship`, `/god-sync`, `/god-docs`, `/god-version`, `npm run release:check` |
 | Maintain project health | `/god-hygiene`, `/god-update-deps`, `/god-docs`, `/god-check-todos` |
-| Extend Godpowers | `/god-extension-scaffold --name=@godpowers/my-pack --output=.`, `/god-test-extension`, `/god-extension-add`, `/god-extension-list` |
+| Extend Godpowers | `/god-extend scaffold --name=@godpowers/my-pack --output=.`, `/god-extend test`, `/god-extend add`, `/god-extend list` |
 
 ### Outcome Metrics
 
@@ -308,14 +304,14 @@ dependency to the main `godpowers` package:
 
 ```bash
 npx godpowers mcp-info --project=.
-npx -y -p godpowers@2.7.0 -p @godpowers/mcp@2.7.0 godpowers-mcp serve --project=.
+npx -y -p godpowers@3.0.1 -p @godpowers/mcp@3.0.1 godpowers-mcp serve --project=.
 ```
 
 The companion exposes `status`, `next`, `gate_check`, `lint_artifact`, and
 `trace_requirement`. Host registration is opt-in:
 
 ```bash
-npx -y -p godpowers@2.7.0 -p @godpowers/mcp@2.7.0 godpowers-mcp setup --host=codex --project=. --write
+npx -y -p godpowers@3.0.1 -p @godpowers/mcp@3.0.1 godpowers-mcp setup --host=codex --project=. --write
 ```
 
 See [MCP Companion](docs/mcp.md) for package boundaries and setup details.
@@ -325,6 +321,11 @@ See [MCP Companion](docs/mcp.md) for package boundaries and setup details.
 | Command | What it does | Spawns agent |
 |---------|--------------|--------------|
 | `/god` | Front door: match free-text intent to a command sequence | (built-in) |
+| `/god-plan` | Route planning intent to planning leaves | (built-in) |
+| `/god-fix` | Route bug and outage intent to debug or hotfix | (built-in) |
+| `/god-ship` | Route deploy, observe, and launch intent | (built-in) |
+| `/god-capture` | Route notes, todos, backlog items, and seeds | (built-in) |
+| `/god-extend` | Route extension install, inspection, testing, and authoring | (built-in) |
 | `/god-mode` | Full autonomous project run | god-orchestrator |
 | `/god-next` | Auto-detect and suggest the next command | (built-in) |
 | `/god-init` | Start a project, detect mode and scale | (built-in) |
@@ -591,7 +592,7 @@ Pi. T3 Code inherits from the underlying agent (Codex / Claude / OpenCode).
 - [Quick Proof](docs/quick-proof.md)
 - [First 10 Minute Proof Case Study](docs/case-studies/first-10-minute-proof.md)
 - [Concepts](docs/concepts.md)
-- [Command reference (all 112 skills + 40 agents)](docs/reference.md)
+- [Command reference (all 117 skills + 40 agents)](docs/reference.md)
 - [Feature awareness](docs/feature-awareness.md)
 - [Adoption Canary](docs/adoption-canary.md)
 - [Repository documentation sync](docs/repo-doc-sync.md)

package/RELEASE.md

@@ -1,63 +1,53 @@
-# Godpowers 2.7.0 Release
+# Godpowers 3.0.1 Release
 
-> Status: Release candidate
-> Date: 2026-06-10
+> Status: Published
+> Date: 2026-06-11
 
-[DECISION] Godpowers 2.7.0 is the Phase 4 one-directional state release.
-[DECISION] This release makes `.godpowers/state.json` the authority for Godpowers state decisions while treating `.godpowers/PROGRESS.md` and Godpowers-owned per-tier `STATE.md` files as generated human views.
-[DECISION] This release preserves the optional `@godpowers/mcp` companion boundary and keeps the main `godpowers` package dependency-free.
+[DECISION] Godpowers 3.0.1 is a documentation and release-surface cleanup patch on top of the 3.0.0 surface contraction release.
+[DECISION] This release preserves the 3.0.0 runtime behavior: `core` remains the omitted installer profile, `--profile=full` remains the complete compatibility surface, verb dispatchers continue routing to existing leaves, and `@godpowers/mcp` remains the optional read-only companion package.
+[DECISION] This release removes the completed migration planning document from the public documentation tree.
+[DECISION] This release updates stale README, roadmap, architecture, reference, MCP, release checklist, package metadata, and package version surfaces.
 
 ## What's in this release
 
-- [DECISION] 112 slash commands.
+- [DECISION] 117 slash commands.
 - [DECISION] 40 specialist agents.
 - [DECISION] 13 executable workflows.
 - [DECISION] 42 intent recipes.
-- [DECISION] A locked `godpowers state advance --step=<step> --status=<status> --project=.` state mutation helper.
-- [DECISION] Generated checksummed state views for `.godpowers/PROGRESS.md` and Godpowers-owned design, build, deploy, observe, and launch `STATE.md` files.
-- [DECISION] Five read-only MCP tools in `@godpowers/mcp`.
+- [DECISION] Five thin verb dispatch commands remain shipped: `/god-plan`, `/god-fix`, `/god-ship`, `/god-capture`, and `/god-extend`.
+- [DECISION] Five read-only MCP tools remain available in `@godpowers/mcp`: `status`, `next`, `gate_check`, `lint_artifact`, and `trace_requirement`.
 
-## Highlights
+## Changes
 
-- [DECISION] `godpowers state advance` updates `.godpowers/state.json` through the state lock and refreshes generated markdown views after the mutation.
-- [DECISION] Route prerequisites, executable gates, workflow handoffs, command prompts, and specialist agent contracts now use `.godpowers/state.json` for Godpowers state decisions.
-- [DECISION] Generated markdown views preserve user prose outside managed fences and replace tampered managed fences on the next state mutation.
-- [DECISION] Design and build gates now use structured state evidence instead of markdown `STATE.md` authority.
-- [DECISION] Deploy, observe, and launch handoffs now use structured state evidence for readiness, target, rollback, SLO, alert, runbook, and launch data.
-- [DECISION] `god-repair` remains available as diagnostics and recovery while generated state views prove themselves.
+- [DECISION] `package.json`, `package-lock.json`, and `packages/mcp/package.json` now publish the 3.0.1 patch version.
+- [DECISION] README current-release prose now points at the 3.x release line instead of foregrounding older 2.x patch details.
+- [DECISION] `docs/ROADMAP.md` now reports the 3.x public adoption window and the v3.0.1 current surface.
+- [DECISION] `docs/RELEASE-CHECKLIST.md` now describes `npm run lint` as a separate static release-sensitive gate instead of claiming it runs inside `npm run release:check`.
+- [DECISION] Architecture extension compatibility examples now match the shipped first-party pack range `>=2.0.0 <4.0.0`.
+- [DECISION] MCP setup examples now pin `godpowers@3.0.1` and `@godpowers/mcp@3.0.1`.
+- [DECISION] The quick proof regression test now guards adoption canary and release verification documentation links.
 
 ## Validation
 
-- [DECISION] `npm ci` passed and reported 0 vulnerabilities.
-- [DECISION] `node scripts/test-state-advance.js` passed.
-- [DECISION] `node scripts/test-state-views.js` passed.
-- [DECISION] `npm --workspace @godpowers/mcp test` passed.
-- [DECISION] `node scripts/static-check.js` passed.
-- [DECISION] `npm run lint` passed.
-- [DECISION] `npm run test:quick-proof` passed.
-- [DECISION] `npm run test:audit` passed with `npm audit --omit=dev`, `git diff --check`, and public surface checks green.
-- [DECISION] `npm run test:e2e` passed.
-- [DECISION] `node scripts/test-runtime-verification.js` passed.
-- [DECISION] `node scripts/test-agent-browser.js` passed.
-- [DECISION] `npm run pack:check` passed with 538 root package files.
-- [DECISION] `npm run pack:mcp:check` passed with 8 companion package files.
-- [DECISION] `node bin/install.js dogfood --json` passed 5 of 5 scenarios.
-- [DECISION] Repo documentation sync, repo surface sync, and release surface sync were fresh.
-- [DECISION] Changed-file banned character scans passed.
-- [DECISION] `npm run release:check` passed with `coverage:lib` at 92.78 percent line coverage, `npm audit --omit=dev` reporting 0 vulnerabilities, public surface docs matching version 2.7.0, root package contents verified at 538 files, and `@godpowers/mcp` package contents verified at 8 files.
-- [DECISION] The final publish result must be recorded in `docs/BRIDGE-PLAN.md` after the tag-triggered GitHub workflow completes.
+- [DECISION] `npm run test:quick-proof` passed with 22 tests.
+- [DECISION] `npm run lint` passed with 29 static checks.
+- [DECISION] `npm run release:check` passed with `coverage:lib` at 92.82 percent line coverage.
+- [DECISION] `npm run release:check` passed `npm audit --omit=dev` with 0 vulnerabilities.
+- [DECISION] `npm run release:check` passed public surface docs for version 3.0.1 with 117 skills, 40 agents, 13 workflows, and 42 recipes.
+- [DECISION] `npm run release:check` passed root package contents with 548 files.
+- [DECISION] `npm run release:check` passed `@godpowers/mcp` package contents with 8 files.
+- [DECISION] `npm pack --pack-destination /tmp/godpowers-release-3.0.1` produced `godpowers-3.0.1.tgz` with 548 files.
+- [DECISION] `npm pack --workspace @godpowers/mcp --pack-destination /tmp/godpowers-release-3.0.1` produced `godpowers-mcp-3.0.1.tgz` with 8 files.
 
 ## Upgrade
 
-- [DECISION] Use `npm install -g godpowers@2.7.0` or `npx godpowers@2.7.0`.
+- [DECISION] Use `npm install -g godpowers@3.0.1` or `npx godpowers@3.0.1`.
+- [DECISION] Use `npx godpowers --profile=full` when the complete pre-3.0 command surface should be installed.
+- [DECISION] Use `npx godpowers --profile=core` or omit `--profile` for the contracted default surface.
 - [DECISION] Use optional MCP package install `npm install -g godpowers @godpowers/mcp` when the host can register MCP servers.
 - [DECISION] Re-run `/god-context` in each project to refresh installed runtime metadata.
-- [DECISION] Existing `.godpowers/state.json` files remain compatible.
-- [DECISION] Existing `.godpowers/PROGRESS.md` and Godpowers-owned per-tier `STATE.md` files become generated human views after the next state mutation.
 
 ## Notes
 
-- [DECISION] The npm `godpowers@2.7.0` package must be published through the tag-triggered GitHub workflow with provenance.
-- [DECISION] The npm `@godpowers/mcp@2.7.0` package must be published through the same workflow with provenance.
-- [DECISION] The `v2.7.0` tag must match the npm package version.
-- [DECISION] The next bridge-plan phase after 2.7.0 publish verification is Phase 5: Surface Contraction.
+- [DECISION] The publish targets are npm `godpowers@3.0.1`, npm `@godpowers/mcp@3.0.1`, and GitHub release `https://github.com/aihxp/godpowers/releases/tag/v3.0.1`.
+- [DECISION] The tag-triggered GitHub publish workflow remains the preferred npm path because it publishes with provenance.

package/SKILL.md

@@ -52,6 +52,9 @@ re-derive state from disk. Never rely on conversation memory for progress.
 Each tier gates on a verified artifact from the prior tier. You cannot build
 without architecture. You cannot deploy without a build. You cannot launch with
 unresolved Critical security findings.
+When a tier command has an executable gate, run
+`npx godpowers gate --tier=<tier> --project=.` and block on any non-zero exit
+before marking that tier done.
 
 For PRD, design, architecture, roadmap, stack, repo, build, and harden, run
 `npx godpowers gate --tier=<tier> --project=.` after the tier artifact is
@@ -365,7 +368,7 @@ Spawn these agents only when the trigger is direct and scope is bounded:
 - `god-docs-writer` when repo-doc-sync reports narrative drift in
   `CHANGELOG.md`, `RELEASE.md`, `CONTRIBUTING.md`, `SECURITY.md`, or
   `SUPPORT.md` after local mechanical sync has finished.
-- `god-auditor`, `god-roadmap-reconciler`, or `god-coordinator` when
+- `god-auditor`, `god-reconciler`, or `god-coordinator` when
   repo-surface-sync reports structural drift that needs agent contract,
   lifecycle graph, or extension-pack judgment.
 - `god-browser-tester` when frontend-visible files changed and a known local,

package/agents/god-archaeologist.md

@@ -8,6 +8,17 @@ description: |
 
   Spawned by: /god-archaeology, brownfield-arc workflow
 tools: Read, Bash, Grep, Glob, WebSearch
+inputs:
+  - "brownfield codebase"
+  - "git history"
+  - "repository documentation"
+outputs:
+  - ".godpowers/archaeology/REPORT.md"
+gates:
+  - "archaeology have-nots"
+  - "evidence-backed history and risk claims"
+handoff:
+  - "return report path and priority risks to caller"
 ---
 
 # God Archaeologist

package/agents/god-architect.md

@@ -6,6 +6,18 @@ description: |
 
   Spawned by: /god-arch, god-orchestrator
 tools: Read, Write, Bash, Grep, Glob
+inputs:
+  - ".godpowers/prd/PRD.md"
+  - "optional .godpowers/domain/GLOSSARY.md"
+  - "optional preparation context"
+outputs:
+  - ".godpowers/arch/ARCH.md"
+  - ".godpowers/arch/adr/"
+gates:
+  - "A-01 through A-13 have-nots"
+  - "npx godpowers gate --tier=arch --project=."
+handoff:
+  - "return architecture artifact and pause only for tied load-bearing decisions"
 ---
 
 # God Architect

package/agents/god-auditor.md

@@ -7,6 +7,19 @@ description: |
 
   Spawned by: /god-preflight, /god-audit, god-orchestrator (gate checks)
 tools: Read, Bash, Grep, Glob
+inputs:
+  - ".godpowers artifacts"
+  - "repository structure"
+  - "Pillars and workflow evidence"
+outputs:
+  - ".godpowers/preflight/PREFLIGHT.md"
+  - ".godpowers/AUDIT-REPORT.md"
+  - "gate pass or fail verdict"
+gates:
+  - "all applicable have-nots"
+  - "preflight and audit scoring evidence"
+handoff:
+  - "return prioritized remediation and gate verdict to caller"
 ---
 
 # God Auditor

package/agents/god-automation-engineer.md

@@ -7,6 +7,19 @@ description: |
 
   Spawned by: /god-automation-setup
 tools: Read, Write, Edit, Bash, Glob
+inputs:
+  - "approved automation setup plan"
+  - "host provider choice"
+  - ".godpowers/state.json"
+outputs:
+  - ".godpowers/automations.json"
+  - "host-native automation configuration"
+gates:
+  - "explicit user approval"
+  - "provider verification"
+  - "no unverified background claims"
+handoff:
+  - "return successful automation ids or hard-stop blocker"
 ---
 
 # God Automation Engineer

package/agents/god-browser-tester.md

@@ -10,6 +10,21 @@ description: |
   Spawned by: /god-test-runtime, /god-build (optional after wave),
   /god-launch (mandatory gate), /god-harden (a11y check)
 tools: Read, Write, Bash, Grep
+inputs:
+  - "runtime URL"
+  - "DESIGN.md"
+  - ".godpowers/prd/PRD.md"
+  - "project root"
+outputs:
+  - ".godpowers/runtime/<run-id>/audit-report.json"
+  - ".godpowers/runtime/<run-id>/test-report.json"
+  - ".godpowers/runtime/<run-id>/summary.md"
+gates:
+  - "WCAG AA contrast"
+  - "component drift threshold"
+  - "P-MUST acceptance flows"
+handoff:
+  - "return run id, backend, report paths, and critical findings to spawner"
 ---
 
 # God Browser Tester

package/agents/god-context-writer.md

@@ -9,6 +9,20 @@ description: |
   Spawned by: /god-init (automatic quiet setup after consent), /god-context,
   /god-sync (refresh).
 tools: Read, Write, Edit, Bash, Grep, Glob
+inputs:
+  - ".godpowers/state.json"
+  - "detected AI tool configuration"
+  - "DESIGN.md and PRODUCT.md presence"
+outputs:
+  - "AGENTS.md godpowers fence"
+  - "tool-specific pointer files"
+  - "context refresh summary"
+gates:
+  - "detect-then-write policy"
+  - "fenced edits only"
+  - "idempotent context output"
+handoff:
+  - "return canonical and pointer write summary to invoking skill"
 ---
 
 # God Context Writer

package/agents/god-coordinator.md

@@ -10,6 +10,20 @@ description: |
   Spawned by: /god-suite-init, /god-suite-status, /god-suite-sync,
   /god-suite-release, /god-suite-patch
 tools: Read, Write, Edit, Bash, Grep, Glob, Task
+inputs:
+  - "suite manifest"
+  - "per-repo state files"
+  - "suite operation request"
+outputs:
+  - "suite coordination state"
+  - "per-repo orchestrator handoff files"
+  - "suite release or sync report"
+gates:
+  - "per-repo orchestrator ownership"
+  - "byte-identical file sync verification"
+  - "suite meta-linter results"
+handoff:
+  - "return suite-level status and per-repo next actions"
 ---
 
 # God Coordinator

package/agents/god-debt-assessor.md

@@ -7,6 +7,17 @@ description: |
 
   Spawned by: /god-tech-debt, brownfield-arc workflow
 tools: Read, Bash, Grep, Glob, WebSearch
+inputs:
+  - "brownfield codebase"
+  - "optional archaeology report"
+  - "dependency and test evidence"
+outputs:
+  - ".godpowers/tech-debt/REPORT.md"
+gates:
+  - "technical debt prioritization evidence"
+  - "debt assessment have-nots"
+handoff:
+  - "return prioritized P0 through P3 remediation plan"
 ---
 
 # God Debt Assessor

package/agents/god-debugger.md

@@ -7,6 +7,19 @@ description: |
 
   Spawned by: /god-debug, when build encounters failures
 tools: Read, Edit, Bash, Grep, Glob, WebSearch
+inputs:
+  - "bug report"
+  - "failing command evidence"
+  - "codebase and recent commits"
+outputs:
+  - "regression test"
+  - "minimal fix"
+  - "debug conclusion summary"
+gates:
+  - "observe-minimize-instrument-hypothesize-test-conclude sequence"
+  - "regression test passes"
+handoff:
+  - "return root cause, fix files, and verification commands"
 ---
 
 # God Debugger

package/agents/god-deploy-engineer.md

@@ -6,6 +6,19 @@ description: |
 
   Spawned by: /god-deploy, god-orchestrator
 tools: Read, Write, Edit, Bash, Glob
+inputs:
+  - ".godpowers/arch/ARCH.md"
+  - ".godpowers/stack/DECISION.md"
+  - ".godpowers/state.json build evidence"
+outputs:
+  - ".godpowers/state.json deploy evidence"
+  - "CI and deploy configuration"
+  - "rollback procedure"
+gates:
+  - "D-01 through D-08 have-nots"
+  - "deploy state evidence is complete"
+handoff:
+  - "return deploy evidence and smoke verification status"
 ---
 
 # God Deploy Engineer

package/agents/god-deps-auditor.md

@@ -7,6 +7,19 @@ description: |
 
   Spawned by: /god-update-deps
 tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch
+inputs:
+  - "package manifests"
+  - "lockfiles"
+  - "stack decision"
+  - "security advisories"
+outputs:
+  - ".godpowers/deps/AUDIT.md"
+  - "classified dependency update plan"
+gates:
+  - "DP-01 through DP-06 have-nots"
+  - "patch-minor-major risk classification"
+handoff:
+  - "return safe updates, deferred migrations, and verification notes"
 ---
 
 # God Deps Auditor

package/agents/god-design-reviewer.md

@@ -9,6 +9,20 @@ description: |
 
   Spawned by: /god-design, god-orchestrator (mid-arc DESIGN/PRODUCT changes)
 tools: Read, Bash, Grep, Glob
+inputs:
+  - "DESIGN.md diff"
+  - "PRODUCT.md"
+  - "PRD and design context"
+outputs:
+  - "design review verdict"
+  - ".godpowers/design/REJECTED.md on block"
+  - "design.review-verdict event"
+gates:
+  - "impeccable critique when available"
+  - "design-spec lint"
+  - "WCAG contrast checks"
+handoff:
+  - "return PASS, WARN, or BLOCK verdict to design updater or orchestrator"
 ---
 
 # God Design Reviewer

package/agents/god-designer.md

@@ -8,6 +8,21 @@ description: |
 
   Spawned by: /god-design, god-orchestrator (Tier 1, conditional on UI)
 tools: Read, Write, Edit, Bash, Grep, Glob
+inputs:
+  - ".godpowers/prd/PRD.md"
+  - ".godpowers/arch/ARCH.md"
+  - ".godpowers/stack/DECISION.md"
+  - ".godpowers/state.json"
+outputs:
+  - "DESIGN.md"
+  - "PRODUCT.md when supported"
+  - ".godpowers/state.json design evidence"
+gates:
+  - "design-spec lint"
+  - "impeccable detect when available"
+  - "design have-nots"
+handoff:
+  - "return design artifact paths and validation summary to orchestrator"
 ---
 
 # God Designer

package/agents/god-docs-writer.md

@@ -7,6 +7,19 @@ description: |
 
   Spawned by: /god-docs
 tools: Read, Write, Edit, Bash, Grep, Glob
+inputs:
+  - "codebase"
+  - "existing documentation"
+  - "changed behavior evidence"
+outputs:
+  - "updated docs"
+  - ".godpowers/docs/UPDATE-LOG.md"
+gates:
+  - "DC-01 through DC-05 have-nots"
+  - "docs match code evidence"
+  - "substitution and three-label checks"
+handoff:
+  - "return updated files and drift findings"
 ---
 
 # God Docs Writer

package/agents/god-executor.md

@@ -7,6 +7,20 @@ description: |
 
   Spawned by: god-orchestrator (one per slice, parallel waves)
 tools: Read, Write, Edit, Bash, Grep, Glob
+inputs:
+  - "one slice from .godpowers/build/PLAN.md"
+  - "relevant architecture excerpts"
+  - ".godpowers/stack/DECISION.md"
+outputs:
+  - "source code changes"
+  - "tests and regression coverage"
+  - "request-trace closeout"
+gates:
+  - "RED-GREEN-REFACTOR sequence"
+  - "full test suite and lint for the slice"
+  - "requirement id annotations"
+handoff:
+  - "return changed files and verification results to orchestrator without committing"
 ---
 
 # God Executor

package/agents/god-explorer.md

@@ -7,6 +7,20 @@ description: |
 
   Spawned by: /god-explore
 tools: Read, Write, Bash, WebSearch
+inputs:
+  - "free-form user intent"
+  - "optional existing artifacts"
+  - "optional domain glossary"
+outputs:
+  - ".godpowers/explore/<slug>.md"
+  - ".godpowers/discussions/<topic>.md"
+  - "optional domain glossary update"
+gates:
+  - "clarified problem framing"
+  - "hidden assumptions surfaced"
+  - "no PRD or architecture overreach"
+handoff:
+  - "return clarified framing and suggested PRD seed"
 ---
 
 # God Explorer