godpowers 3.0.0 → 3.0.1

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.
Files changed (88) hide show
  1. package/CHANGELOG.md +20 -1
  2. package/README.md +12 -19
  3. package/RELEASE.md +29 -48
  4. package/SKILL.md +4 -1
  5. package/agents/god-archaeologist.md +11 -0
  6. package/agents/god-architect.md +12 -0
  7. package/agents/god-auditor.md +13 -0
  8. package/agents/god-automation-engineer.md +13 -0
  9. package/agents/god-browser-tester.md +15 -0
  10. package/agents/god-context-writer.md +14 -0
  11. package/agents/god-coordinator.md +14 -0
  12. package/agents/god-debt-assessor.md +11 -0
  13. package/agents/god-debugger.md +13 -0
  14. package/agents/god-deploy-engineer.md +13 -0
  15. package/agents/god-deps-auditor.md +13 -0
  16. package/agents/god-design-reviewer.md +14 -0
  17. package/agents/god-designer.md +15 -0
  18. package/agents/god-docs-writer.md +13 -0
  19. package/agents/god-executor.md +14 -0
  20. package/agents/god-explorer.md +14 -0
  21. package/agents/god-greenfieldifier.md +13 -0
  22. package/agents/god-harden-auditor.md +12 -0
  23. package/agents/god-incident-investigator.md +13 -0
  24. package/agents/god-launch-strategist.md +14 -0
  25. package/agents/god-migration-strategist.md +13 -0
  26. package/agents/god-observability-engineer.md +14 -0
  27. package/agents/god-orchestrator.md +16 -2
  28. package/agents/god-org-context-loader.md +11 -0
  29. package/agents/god-planner.md +11 -0
  30. package/agents/god-pm.md +14 -0
  31. package/agents/god-quality-reviewer.md +12 -0
  32. package/agents/god-reconciler.md +14 -1
  33. package/agents/god-reconstructor.md +16 -0
  34. package/agents/god-repo-scaffolder.md +11 -0
  35. package/agents/god-retrospective.md +11 -0
  36. package/agents/god-roadmap-reconciler.md +42 -87
  37. package/agents/god-roadmap-updater.md +11 -0
  38. package/agents/god-roadmapper.md +12 -0
  39. package/agents/god-spec-reviewer.md +14 -0
  40. package/agents/god-spike-runner.md +13 -0
  41. package/agents/god-stack-selector.md +12 -0
  42. package/agents/god-standards-check.md +13 -0
  43. package/agents/god-storyteller.md +14 -0
  44. package/agents/god-updater.md +14 -0
  45. package/lib/README.md +3 -0
  46. package/lib/agent-validator.js +67 -2
  47. package/lib/recipe-coverage-sync.js +1 -1
  48. package/lib/release-surface-sync.js +3 -0
  49. package/lib/repo-doc-sync.js +1 -1
  50. package/lib/repo-surface-sync.js +3 -3
  51. package/lib/route-quality-sync.js +2 -2
  52. package/lib/router.js +6 -0
  53. package/package.json +1 -1
  54. package/references/orchestration/GOD-ORCHESTRATOR-RUNBOOK.md +12 -3
  55. package/routing/god-roadmap-check.yaml +2 -2
  56. package/skills/god-agent-audit.md +12 -9
  57. package/skills/god-arch.md +1 -3
  58. package/skills/god-build.md +1 -3
  59. package/skills/god-deploy.md +1 -3
  60. package/skills/god-design.md +9 -3
  61. package/skills/god-feature.md +1 -3
  62. package/skills/god-harden.md +1 -3
  63. package/skills/god-hotfix.md +1 -3
  64. package/skills/god-launch.md +1 -3
  65. package/skills/god-link.md +1 -3
  66. package/skills/god-migrate.md +1 -3
  67. package/skills/god-mode.md +5 -0
  68. package/skills/god-observe.md +1 -3
  69. package/skills/god-prd.md +1 -3
  70. package/skills/god-reconcile.md +4 -4
  71. package/skills/god-redo.md +1 -3
  72. package/skills/god-refactor.md +1 -3
  73. package/skills/god-repair.md +1 -3
  74. package/skills/god-repo.md +1 -3
  75. package/skills/god-restore.md +1 -3
  76. package/skills/god-roadmap-check.md +4 -3
  77. package/skills/god-roadmap.md +1 -3
  78. package/skills/god-rollback.md +1 -3
  79. package/skills/god-scan.md +1 -3
  80. package/skills/god-skip.md +1 -3
  81. package/skills/god-stack.md +1 -3
  82. package/skills/god-story-build.md +1 -3
  83. package/skills/god-story-close.md +1 -3
  84. package/skills/god-story.md +1 -3
  85. package/skills/god-sync.md +3 -5
  86. package/skills/god-undo.md +1 -3
  87. package/skills/god-update-deps.md +1 -3
  88. package/skills/god-upgrade.md +1 -3
package/CHANGELOG.md CHANGED
@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [3.0.1] - 2026-06-11
11
+
12
+ ### Changed
13
+ - Updated README, roadmap, reference, MCP, architecture, release checklist, and
14
+ release notes for the 3.0.1 patch release.
15
+ - Bumped `godpowers` and `@godpowers/mcp` package metadata to 3.0.1.
16
+ - Clarified that `npm run lint` is a separate release-sensitive check rather
17
+ than part of `npm run release:check`.
18
+
19
+ ### Fixed
20
+ - Fixed architecture extension compatibility examples to match shipped
21
+ first-party pack compatibility ranges.
22
+ - Added quick proof regression coverage for adoption canary and published
23
+ install verification documentation links.
24
+
25
+ ### Removed
26
+ - Removed the completed migration planning file from the public documentation
27
+ tree.
28
+
10
29
  ## [3.0.0] - 2026-06-10
11
30
 
12
31
  ### Added
@@ -97,7 +116,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
97
116
 
98
117
  ### Changed
99
118
  - Updated USERS, README, roadmap, reference, architecture, release notes, and
100
- bridge-plan status for the Phase 2 host proof campaign.
119
+ migration status for the Phase 2 host proof campaign.
101
120
 
102
121
  ## [2.5.0] - 2026-06-10
103
122
 
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [![CI](https://github.com/aihxp/godpowers/actions/workflows/ci.yml/badge.svg)](https://github.com/aihxp/godpowers/actions/workflows/ci.yml)
4
4
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
5
- [![Version](https://img.shields.io/badge/version-3.0.0-blue)](CHANGELOG.md)
5
+ [![Version](https://img.shields.io/badge/version-3.0.1-blue)](CHANGELOG.md)
6
6
  [![npm](https://img.shields.io/npm/v/godpowers.svg)](https://www.npmjs.com/package/godpowers)
7
7
 
8
8
  **Ship fast. Ship right. Ship everything. Ship accountably.**
@@ -30,24 +30,17 @@ Godpowers makes AI coding accountable: every serious run should leave disk
30
30
  state, artifacts, validation gates, host guarantees, and a next action. Code is
31
31
  only one output. The project memory and proof trail matter too.
32
32
 
33
- Version 3.0.0 makes the omitted installer profile `core`, adds five verb
34
- dispatch commands, and folds locate and lifecycle views into `/god-status`
35
- flags while preserving full-profile compatibility aliases. It keeps the
36
- one-directional state authority from 2.7.0, the optional `@godpowers/mcp`
37
- companion package, the installed-runtime gate and build-gate fixes, Codex host
38
- proof studies, executable tier gates, command-family UX, external CLI canary
39
- evidence, prompt-size guardrails, lib coverage gating, and package verification
40
- before publish.
33
+ Version 3.0.1 is a release-surface cleanup patch on top of the 3.0.0 surface
34
+ contraction release. The current 3.x line keeps the omitted installer profile
35
+ on `core`, preserves `--profile=full` for compatibility, keeps locate and
36
+ lifecycle views under `/god-status`, ships the optional `@godpowers/mcp`
37
+ companion package, and verifies docs, package contents, npm metadata, GitHub
38
+ release state, and published install behavior before public release.
41
39
 
42
40
  Maintainer hardening continues on the 3.x line with small, audited public
43
- surface updates when they close real workflow gaps. The 2.1.0 patch closes a command-injection vector in the
44
- agent-browser driver, guards runtime file parsing against corrupt state,
45
- makes data-directory installs a clean replace, and reconciles documentation
46
- drift. The 2.0.3 patch range-checks workflow agent references,
47
- derives command metadata from the individual files in `skills/`, delegates
48
- installer runtime logic to `lib/`, moves the detailed God Mode runbook into
49
- `references/`, and exposes async file APIs for incremental migration away from
50
- synchronous-only internals.
41
+ surface updates when they close real workflow gaps. Historical release details
42
+ live in [CHANGELOG.md](CHANGELOG.md), while the current release status lives in
43
+ [RELEASE.md](RELEASE.md).
51
44
 
52
45
  Strict release readiness remains fail-closed. Godpowers requires delegated
53
46
  release checks to cover root docs, docs, agents, skills, routing, workflows,
@@ -311,14 +304,14 @@ dependency to the main `godpowers` package:
311
304
 
312
305
  ```bash
313
306
  npx godpowers mcp-info --project=.
314
- npx -y -p godpowers@3.0.0 -p @godpowers/mcp@3.0.0 godpowers-mcp serve --project=.
307
+ npx -y -p godpowers@3.0.1 -p @godpowers/mcp@3.0.1 godpowers-mcp serve --project=.
315
308
  ```
316
309
 
317
310
  The companion exposes `status`, `next`, `gate_check`, `lint_artifact`, and
318
311
  `trace_requirement`. Host registration is opt-in:
319
312
 
320
313
  ```bash
321
- npx -y -p godpowers@3.0.0 -p @godpowers/mcp@3.0.0 godpowers-mcp setup --host=codex --project=. --write
314
+ npx -y -p godpowers@3.0.1 -p @godpowers/mcp@3.0.1 godpowers-mcp setup --host=codex --project=. --write
322
315
  ```
323
316
 
324
317
  See [MCP Companion](docs/mcp.md) for package boundaries and setup details.
package/RELEASE.md CHANGED
@@ -1,12 +1,12 @@
1
- # Godpowers 3.0.0 Release
1
+ # Godpowers 3.0.1 Release
2
2
 
3
- > Status: Prepared
4
- > Date: 2026-06-10
3
+ > Status: Published
4
+ > Date: 2026-06-11
5
5
 
6
- [DECISION] Godpowers 3.0.0 is the Phase 5 surface contraction release.
7
- [DECISION] This release makes the omitted installer profile resolve to `core` instead of `full`.
8
- [DECISION] This release keeps `--profile=full` as the complete compatibility surface for every shipped command.
9
- [DECISION] This release preserves the optional `@godpowers/mcp` companion boundary and keeps the main `godpowers` package dependency-free.
6
+ [DECISION] Godpowers 3.0.1 is a documentation and release-surface cleanup patch on top of the 3.0.0 surface contraction release.
7
+ [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.
8
+ [DECISION] This release removes the completed migration planning document from the public documentation tree.
9
+ [DECISION] This release updates stale README, roadmap, architecture, reference, MCP, release checklist, package metadata, and package version surfaces.
10
10
 
11
11
  ## What's in this release
12
12
 
@@ -14,52 +14,34 @@
14
14
  - [DECISION] 40 specialist agents.
15
15
  - [DECISION] 13 executable workflows.
16
16
  - [DECISION] 42 intent recipes.
17
- - [DECISION] Five thin verb dispatch commands: `/god-plan`, `/god-fix`, `/god-ship`, `/god-capture`, and `/god-extend`.
18
- - [DECISION] `core` installs the front door, status, verb dispatchers, and `/god-mode` compatibility.
19
- - [DECISION] `full` preserves all direct leaf commands and compatibility aliases.
20
- - [DECISION] Five read-only MCP tools remain available in `@godpowers/mcp`.
17
+ - [DECISION] Five thin verb dispatch commands remain shipped: `/god-plan`, `/god-fix`, `/god-ship`, `/god-capture`, and `/god-extend`.
18
+ - [DECISION] Five read-only MCP tools remain available in `@godpowers/mcp`: `status`, `next`, `gate_check`, `lint_artifact`, and `trace_requirement`.
21
19
 
22
- ## Highlights
20
+ ## Changes
23
21
 
24
- - [DECISION] Omitted installer profile selection now writes `GODPOWERS_PROFILE` as `core`.
25
- - [DECISION] `/god-plan` routes planning intent to PRD, design, architecture, roadmap, stack, or reconstruction leaves.
26
- - [DECISION] `/god-fix` routes fix intent to debug or hotfix leaves.
27
- - [DECISION] `/god-ship` routes shipping intent to deploy, observe, or launch leaves.
28
- - [DECISION] `/god-capture` routes capture intent to note, todo, backlog, or seed leaves.
29
- - [DECISION] `/god-extend` routes extension intent to scaffold, add, list, info, remove, test, or agent-authoring leaves.
30
- - [DECISION] `/god-locate` is deprecated in favor of `/god-status --locate`.
31
- - [DECISION] `/god-lifecycle` is deprecated in favor of `/god-status --lifecycle`.
32
- - [DECISION] `/god-roadmap-check` now has `successor` metadata pointing to `/god-reconcile`.
22
+ - [DECISION] `package.json`, `package-lock.json`, and `packages/mcp/package.json` now publish the 3.0.1 patch version.
23
+ - [DECISION] README current-release prose now points at the 3.x release line instead of foregrounding older 2.x patch details.
24
+ - [DECISION] `docs/ROADMAP.md` now reports the 3.x public adoption window and the v3.0.1 current surface.
25
+ - [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`.
26
+ - [DECISION] Architecture extension compatibility examples now match the shipped first-party pack range `>=2.0.0 <4.0.0`.
27
+ - [DECISION] MCP setup examples now pin `godpowers@3.0.1` and `@godpowers/mcp@3.0.1`.
28
+ - [DECISION] The quick proof regression test now guards adoption canary and release verification documentation links.
33
29
 
34
30
  ## Validation
35
31
 
36
- - [DECISION] `npm ci` passed and reported 0 vulnerabilities.
37
- - [DECISION] `node scripts/test-installer-profiles.js` passed.
38
- - [DECISION] `node scripts/test-surface-contraction.js` passed.
39
- - [DECISION] `node scripts/test-command-families.js` passed.
40
- - [DECISION] `node scripts/validate-skills.js` passed.
41
- - [DECISION] `node scripts/test-quick-proof.js` passed.
42
- - [DECISION] `node scripts/test-doc-surface-counts.js` passed with public surface docs matching version 3.0.0.
43
- - [DECISION] `node scripts/test-repo-doc-sync.js` passed.
44
- - [DECISION] `node scripts/test-repo-surface-sync.js` passed.
45
- - [DECISION] `node scripts/test-automation-surface-sync.js` passed.
46
- - [DECISION] `node scripts/test-router.js` passed.
47
- - [DECISION] `npm run test:e2e` passed.
48
- - [DECISION] `node scripts/test-runtime-verification.js` passed.
49
- - [DECISION] `node scripts/test-agent-browser.js` passed.
50
- - [DECISION] `node scripts/test-install-smoke.js` passed.
51
- - [DECISION] `node bin/install.js dogfood --json` passed 5 of 5 scenarios.
52
- - [DECISION] `npm --workspace @godpowers/mcp test` passed.
53
- - [DECISION] `npm run pack:check` passed with 548 root package files.
54
- - [DECISION] `npm run pack:mcp:check` passed with 8 companion package files.
55
- - [DECISION] `npm run lint` passed.
56
- - [DECISION] `npm run test:audit` passed with `npm audit --omit=dev`, `git diff --check`, and public surface checks green.
57
- - [DECISION] `npm run release:check` passed with `coverage:lib` at 92.79 percent line coverage, `npm audit --omit=dev` reporting 0 vulnerabilities, public surface docs matching version 3.0.0, root package contents verified at 548 files, and `@godpowers/mcp` package contents verified at 8 files.
58
- - [DECISION] Publish status remains pending until branch review, protected merge, registry credentials, and release hooks are all green.
32
+ - [DECISION] `npm run test:quick-proof` passed with 22 tests.
33
+ - [DECISION] `npm run lint` passed with 29 static checks.
34
+ - [DECISION] `npm run release:check` passed with `coverage:lib` at 92.82 percent line coverage.
35
+ - [DECISION] `npm run release:check` passed `npm audit --omit=dev` with 0 vulnerabilities.
36
+ - [DECISION] `npm run release:check` passed public surface docs for version 3.0.1 with 117 skills, 40 agents, 13 workflows, and 42 recipes.
37
+ - [DECISION] `npm run release:check` passed root package contents with 548 files.
38
+ - [DECISION] `npm run release:check` passed `@godpowers/mcp` package contents with 8 files.
39
+ - [DECISION] `npm pack --pack-destination /tmp/godpowers-release-3.0.1` produced `godpowers-3.0.1.tgz` with 548 files.
40
+ - [DECISION] `npm pack --workspace @godpowers/mcp --pack-destination /tmp/godpowers-release-3.0.1` produced `godpowers-mcp-3.0.1.tgz` with 8 files.
59
41
 
60
42
  ## Upgrade
61
43
 
62
- - [DECISION] Use `npm install -g godpowers@3.0.0` or `npx godpowers@3.0.0`.
44
+ - [DECISION] Use `npm install -g godpowers@3.0.1` or `npx godpowers@3.0.1`.
63
45
  - [DECISION] Use `npx godpowers --profile=full` when the complete pre-3.0 command surface should be installed.
64
46
  - [DECISION] Use `npx godpowers --profile=core` or omit `--profile` for the contracted default surface.
65
47
  - [DECISION] Use optional MCP package install `npm install -g godpowers @godpowers/mcp` when the host can register MCP servers.
@@ -67,6 +49,5 @@
67
49
 
68
50
  ## Notes
69
51
 
70
- - [DECISION] No npm publish has been attempted from this prepared release note.
71
- - [DECISION] No GitHub release has been created from this prepared release note.
72
- - [DECISION] The next bridge-plan action is protected review and merge for the Phase 5 behavior slice.
52
+ - [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`.
53
+ - [DECISION] The tag-triggered GitHub publish workflow remains the preferred npm path because it publishes with provenance.
package/SKILL.md CHANGED
@@ -52,6 +52,9 @@ re-derive state from disk. Never rely on conversation memory for progress.
52
52
  Each tier gates on a verified artifact from the prior tier. You cannot build
53
53
  without architecture. You cannot deploy without a build. You cannot launch with
54
54
  unresolved Critical security findings.
55
+ When a tier command has an executable gate, run
56
+ `npx godpowers gate --tier=<tier> --project=.` and block on any non-zero exit
57
+ before marking that tier done.
55
58
 
56
59
  For PRD, design, architecture, roadmap, stack, repo, build, and harden, run
57
60
  `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:
365
368
  - `god-docs-writer` when repo-doc-sync reports narrative drift in
366
369
  `CHANGELOG.md`, `RELEASE.md`, `CONTRIBUTING.md`, `SECURITY.md`, or
367
370
  `SUPPORT.md` after local mechanical sync has finished.
368
- - `god-auditor`, `god-roadmap-reconciler`, or `god-coordinator` when
371
+ - `god-auditor`, `god-reconciler`, or `god-coordinator` when
369
372
  repo-surface-sync reports structural drift that needs agent contract,
370
373
  lifecycle graph, or extension-pack judgment.
371
374
  - `god-browser-tester` when frontend-visible files changed and a known local,
@@ -8,6 +8,17 @@ description: |
8
8
 
9
9
  Spawned by: /god-archaeology, brownfield-arc workflow
10
10
  tools: Read, Bash, Grep, Glob, WebSearch
11
+ inputs:
12
+ - "brownfield codebase"
13
+ - "git history"
14
+ - "repository documentation"
15
+ outputs:
16
+ - ".godpowers/archaeology/REPORT.md"
17
+ gates:
18
+ - "archaeology have-nots"
19
+ - "evidence-backed history and risk claims"
20
+ handoff:
21
+ - "return report path and priority risks to caller"
11
22
  ---
12
23
 
13
24
  # God Archaeologist
@@ -6,6 +6,18 @@ description: |
6
6
 
7
7
  Spawned by: /god-arch, god-orchestrator
8
8
  tools: Read, Write, Bash, Grep, Glob
9
+ inputs:
10
+ - ".godpowers/prd/PRD.md"
11
+ - "optional .godpowers/domain/GLOSSARY.md"
12
+ - "optional preparation context"
13
+ outputs:
14
+ - ".godpowers/arch/ARCH.md"
15
+ - ".godpowers/arch/adr/"
16
+ gates:
17
+ - "A-01 through A-13 have-nots"
18
+ - "npx godpowers gate --tier=arch --project=."
19
+ handoff:
20
+ - "return architecture artifact and pause only for tied load-bearing decisions"
9
21
  ---
10
22
 
11
23
  # God Architect
@@ -7,6 +7,19 @@ description: |
7
7
 
8
8
  Spawned by: /god-preflight, /god-audit, god-orchestrator (gate checks)
9
9
  tools: Read, Bash, Grep, Glob
10
+ inputs:
11
+ - ".godpowers artifacts"
12
+ - "repository structure"
13
+ - "Pillars and workflow evidence"
14
+ outputs:
15
+ - ".godpowers/preflight/PREFLIGHT.md"
16
+ - ".godpowers/AUDIT-REPORT.md"
17
+ - "gate pass or fail verdict"
18
+ gates:
19
+ - "all applicable have-nots"
20
+ - "preflight and audit scoring evidence"
21
+ handoff:
22
+ - "return prioritized remediation and gate verdict to caller"
10
23
  ---
11
24
 
12
25
  # God Auditor
@@ -7,6 +7,19 @@ description: |
7
7
 
8
8
  Spawned by: /god-automation-setup
9
9
  tools: Read, Write, Edit, Bash, Glob
10
+ inputs:
11
+ - "approved automation setup plan"
12
+ - "host provider choice"
13
+ - ".godpowers/state.json"
14
+ outputs:
15
+ - ".godpowers/automations.json"
16
+ - "host-native automation configuration"
17
+ gates:
18
+ - "explicit user approval"
19
+ - "provider verification"
20
+ - "no unverified background claims"
21
+ handoff:
22
+ - "return successful automation ids or hard-stop blocker"
10
23
  ---
11
24
 
12
25
  # God Automation Engineer
@@ -10,6 +10,21 @@ description: |
10
10
  Spawned by: /god-test-runtime, /god-build (optional after wave),
11
11
  /god-launch (mandatory gate), /god-harden (a11y check)
12
12
  tools: Read, Write, Bash, Grep
13
+ inputs:
14
+ - "runtime URL"
15
+ - "DESIGN.md"
16
+ - ".godpowers/prd/PRD.md"
17
+ - "project root"
18
+ outputs:
19
+ - ".godpowers/runtime/<run-id>/audit-report.json"
20
+ - ".godpowers/runtime/<run-id>/test-report.json"
21
+ - ".godpowers/runtime/<run-id>/summary.md"
22
+ gates:
23
+ - "WCAG AA contrast"
24
+ - "component drift threshold"
25
+ - "P-MUST acceptance flows"
26
+ handoff:
27
+ - "return run id, backend, report paths, and critical findings to spawner"
13
28
  ---
14
29
 
15
30
  # God Browser Tester
@@ -9,6 +9,20 @@ description: |
9
9
  Spawned by: /god-init (automatic quiet setup after consent), /god-context,
10
10
  /god-sync (refresh).
11
11
  tools: Read, Write, Edit, Bash, Grep, Glob
12
+ inputs:
13
+ - ".godpowers/state.json"
14
+ - "detected AI tool configuration"
15
+ - "DESIGN.md and PRODUCT.md presence"
16
+ outputs:
17
+ - "AGENTS.md godpowers fence"
18
+ - "tool-specific pointer files"
19
+ - "context refresh summary"
20
+ gates:
21
+ - "detect-then-write policy"
22
+ - "fenced edits only"
23
+ - "idempotent context output"
24
+ handoff:
25
+ - "return canonical and pointer write summary to invoking skill"
12
26
  ---
13
27
 
14
28
  # God Context Writer
@@ -10,6 +10,20 @@ description: |
10
10
  Spawned by: /god-suite-init, /god-suite-status, /god-suite-sync,
11
11
  /god-suite-release, /god-suite-patch
12
12
  tools: Read, Write, Edit, Bash, Grep, Glob, Task
13
+ inputs:
14
+ - "suite manifest"
15
+ - "per-repo state files"
16
+ - "suite operation request"
17
+ outputs:
18
+ - "suite coordination state"
19
+ - "per-repo orchestrator handoff files"
20
+ - "suite release or sync report"
21
+ gates:
22
+ - "per-repo orchestrator ownership"
23
+ - "byte-identical file sync verification"
24
+ - "suite meta-linter results"
25
+ handoff:
26
+ - "return suite-level status and per-repo next actions"
13
27
  ---
14
28
 
15
29
  # God Coordinator
@@ -7,6 +7,17 @@ description: |
7
7
 
8
8
  Spawned by: /god-tech-debt, brownfield-arc workflow
9
9
  tools: Read, Bash, Grep, Glob, WebSearch
10
+ inputs:
11
+ - "brownfield codebase"
12
+ - "optional archaeology report"
13
+ - "dependency and test evidence"
14
+ outputs:
15
+ - ".godpowers/tech-debt/REPORT.md"
16
+ gates:
17
+ - "technical debt prioritization evidence"
18
+ - "debt assessment have-nots"
19
+ handoff:
20
+ - "return prioritized P0 through P3 remediation plan"
10
21
  ---
11
22
 
12
23
  # God Debt Assessor
@@ -7,6 +7,19 @@ description: |
7
7
 
8
8
  Spawned by: /god-debug, when build encounters failures
9
9
  tools: Read, Edit, Bash, Grep, Glob, WebSearch
10
+ inputs:
11
+ - "bug report"
12
+ - "failing command evidence"
13
+ - "codebase and recent commits"
14
+ outputs:
15
+ - "regression test"
16
+ - "minimal fix"
17
+ - "debug conclusion summary"
18
+ gates:
19
+ - "observe-minimize-instrument-hypothesize-test-conclude sequence"
20
+ - "regression test passes"
21
+ handoff:
22
+ - "return root cause, fix files, and verification commands"
10
23
  ---
11
24
 
12
25
  # God Debugger
@@ -6,6 +6,19 @@ description: |
6
6
 
7
7
  Spawned by: /god-deploy, god-orchestrator
8
8
  tools: Read, Write, Edit, Bash, Glob
9
+ inputs:
10
+ - ".godpowers/arch/ARCH.md"
11
+ - ".godpowers/stack/DECISION.md"
12
+ - ".godpowers/state.json build evidence"
13
+ outputs:
14
+ - ".godpowers/state.json deploy evidence"
15
+ - "CI and deploy configuration"
16
+ - "rollback procedure"
17
+ gates:
18
+ - "D-01 through D-08 have-nots"
19
+ - "deploy state evidence is complete"
20
+ handoff:
21
+ - "return deploy evidence and smoke verification status"
9
22
  ---
10
23
 
11
24
  # God Deploy Engineer
@@ -7,6 +7,19 @@ description: |
7
7
 
8
8
  Spawned by: /god-update-deps
9
9
  tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch
10
+ inputs:
11
+ - "package manifests"
12
+ - "lockfiles"
13
+ - "stack decision"
14
+ - "security advisories"
15
+ outputs:
16
+ - ".godpowers/deps/AUDIT.md"
17
+ - "classified dependency update plan"
18
+ gates:
19
+ - "DP-01 through DP-06 have-nots"
20
+ - "patch-minor-major risk classification"
21
+ handoff:
22
+ - "return safe updates, deferred migrations, and verification notes"
10
23
  ---
11
24
 
12
25
  # God Deps Auditor
@@ -9,6 +9,20 @@ description: |
9
9
 
10
10
  Spawned by: /god-design, god-orchestrator (mid-arc DESIGN/PRODUCT changes)
11
11
  tools: Read, Bash, Grep, Glob
12
+ inputs:
13
+ - "DESIGN.md diff"
14
+ - "PRODUCT.md"
15
+ - "PRD and design context"
16
+ outputs:
17
+ - "design review verdict"
18
+ - ".godpowers/design/REJECTED.md on block"
19
+ - "design.review-verdict event"
20
+ gates:
21
+ - "impeccable critique when available"
22
+ - "design-spec lint"
23
+ - "WCAG contrast checks"
24
+ handoff:
25
+ - "return PASS, WARN, or BLOCK verdict to design updater or orchestrator"
12
26
  ---
13
27
 
14
28
  # God Design Reviewer
@@ -8,6 +8,21 @@ description: |
8
8
 
9
9
  Spawned by: /god-design, god-orchestrator (Tier 1, conditional on UI)
10
10
  tools: Read, Write, Edit, Bash, Grep, Glob
11
+ inputs:
12
+ - ".godpowers/prd/PRD.md"
13
+ - ".godpowers/arch/ARCH.md"
14
+ - ".godpowers/stack/DECISION.md"
15
+ - ".godpowers/state.json"
16
+ outputs:
17
+ - "DESIGN.md"
18
+ - "PRODUCT.md when supported"
19
+ - ".godpowers/state.json design evidence"
20
+ gates:
21
+ - "design-spec lint"
22
+ - "impeccable detect when available"
23
+ - "design have-nots"
24
+ handoff:
25
+ - "return design artifact paths and validation summary to orchestrator"
11
26
  ---
12
27
 
13
28
  # God Designer
@@ -7,6 +7,19 @@ description: |
7
7
 
8
8
  Spawned by: /god-docs
9
9
  tools: Read, Write, Edit, Bash, Grep, Glob
10
+ inputs:
11
+ - "codebase"
12
+ - "existing documentation"
13
+ - "changed behavior evidence"
14
+ outputs:
15
+ - "updated docs"
16
+ - ".godpowers/docs/UPDATE-LOG.md"
17
+ gates:
18
+ - "DC-01 through DC-05 have-nots"
19
+ - "docs match code evidence"
20
+ - "substitution and three-label checks"
21
+ handoff:
22
+ - "return updated files and drift findings"
10
23
  ---
11
24
 
12
25
  # God Docs Writer
@@ -7,6 +7,20 @@ description: |
7
7
 
8
8
  Spawned by: god-orchestrator (one per slice, parallel waves)
9
9
  tools: Read, Write, Edit, Bash, Grep, Glob
10
+ inputs:
11
+ - "one slice from .godpowers/build/PLAN.md"
12
+ - "relevant architecture excerpts"
13
+ - ".godpowers/stack/DECISION.md"
14
+ outputs:
15
+ - "source code changes"
16
+ - "tests and regression coverage"
17
+ - "request-trace closeout"
18
+ gates:
19
+ - "RED-GREEN-REFACTOR sequence"
20
+ - "full test suite and lint for the slice"
21
+ - "requirement id annotations"
22
+ handoff:
23
+ - "return changed files and verification results to orchestrator without committing"
10
24
  ---
11
25
 
12
26
  # God Executor
@@ -7,6 +7,20 @@ description: |
7
7
 
8
8
  Spawned by: /god-explore
9
9
  tools: Read, Write, Bash, WebSearch
10
+ inputs:
11
+ - "free-form user intent"
12
+ - "optional existing artifacts"
13
+ - "optional domain glossary"
14
+ outputs:
15
+ - ".godpowers/explore/<slug>.md"
16
+ - ".godpowers/discussions/<topic>.md"
17
+ - "optional domain glossary update"
18
+ gates:
19
+ - "clarified problem framing"
20
+ - "hidden assumptions surfaced"
21
+ - "no PRD or architecture overreach"
22
+ handoff:
23
+ - "return clarified framing and suggested PRD seed"
10
24
  ---
11
25
 
12
26
  # God Explorer
@@ -7,6 +7,19 @@ description: |
7
7
 
8
8
  Spawned by: brownfield-arc, bluefield-arc, god-orchestrator
9
9
  tools: Read, Write, Edit, Bash, Grep, Glob
10
+ inputs:
11
+ - "greenfield simulation audit"
12
+ - ".godpowers/state.json"
13
+ - "canonical Godpowers artifacts"
14
+ outputs:
15
+ - "controlled artifact migration plan"
16
+ - "approved canonical artifact updates"
17
+ gates:
18
+ - "user approval before rewriting artifacts"
19
+ - "state.json handoff authority"
20
+ - "greenfieldification rules"
21
+ handoff:
22
+ - "return migrated artifacts and remaining brownfield or bluefield gaps"
10
23
  ---
11
24
 
12
25
  # God Greenfieldifier
@@ -7,6 +7,18 @@ description: |
7
7
 
8
8
  Spawned by: /god-harden, god-orchestrator
9
9
  tools: Read, Bash, Grep, Glob, WebSearch
10
+ inputs:
11
+ - "codebase"
12
+ - ".godpowers/state.json deploy evidence"
13
+ - "optional org security standards"
14
+ outputs:
15
+ - ".godpowers/harden/FINDINGS.md"
16
+ gates:
17
+ - "H-01 through H-11 have-nots"
18
+ - "Critical findings block launch"
19
+ - "manual adversarial review"
20
+ handoff:
21
+ - "return security findings and block launch on unresolved Critical issues"
10
22
  ---
11
23
 
12
24
  # God Harden Auditor
@@ -8,6 +8,19 @@ description: |
8
8
 
9
9
  Spawned by: /god-postmortem
10
10
  tools: Read, Write, Edit, Bash, Grep, Glob
11
+ inputs:
12
+ - "logs and events"
13
+ - "git history"
14
+ - "hotfix commit"
15
+ - "optional handoff"
16
+ outputs:
17
+ - ".godpowers/postmortems/<id>/POSTMORTEM.md"
18
+ - "runbook update recommendations"
19
+ gates:
20
+ - "PM-01 through PM-08 have-nots"
21
+ - "timeline and class-of-bug evidence"
22
+ handoff:
23
+ - "return postmortem path, action items, and prevention class"
11
24
  ---
12
25
 
13
26
  # God Incident Investigator
@@ -7,6 +7,20 @@ description: |
7
7
 
8
8
  Spawned by: /god-launch, god-orchestrator
9
9
  tools: Read, Write, Edit, Bash, Grep, WebSearch
10
+ inputs:
11
+ - ".godpowers/prd/PRD.md"
12
+ - ".godpowers/harden/FINDINGS.md"
13
+ - ".godpowers/state.json launch prerequisites"
14
+ outputs:
15
+ - ".godpowers/state.json launch evidence"
16
+ - "landing copy and channel messaging"
17
+ - "D-7 to D+7 launch runbook"
18
+ gates:
19
+ - "L-01 through L-08 have-nots"
20
+ - "no unresolved Critical harden findings"
21
+ - "launch state evidence is complete"
22
+ handoff:
23
+ - "return launch evidence and pause only for human-only brand choices"
10
24
  ---
11
25
 
12
26
  # God Launch Strategist