godpowers 3.0.0 → 3.0.2

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 (132) hide show
  1. package/CHANGELOG.md +46 -3
  2. package/README.md +28 -24
  3. package/RELEASE.md +31 -50
  4. package/SKILL.md +75 -113
  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/bin/install.js +10 -0
  46. package/lib/README.md +4 -0
  47. package/lib/agent-validator.js +67 -2
  48. package/lib/cli-dispatch.js +40 -1
  49. package/lib/command-families.js +10 -2
  50. package/lib/install-profiles.js +4 -1
  51. package/lib/installer-args.js +22 -0
  52. package/lib/recipe-coverage-sync.js +1 -1
  53. package/lib/release-surface-sync.js +3 -0
  54. package/lib/repo-doc-sync.js +1 -1
  55. package/lib/repo-surface-sync.js +3 -3
  56. package/lib/route-quality-sync.js +2 -2
  57. package/lib/router.js +6 -0
  58. package/lib/surface-profile.js +168 -0
  59. package/package.json +2 -2
  60. package/references/orchestration/GOD-MODE-RUNBOOK.md +9 -14
  61. package/references/orchestration/GOD-ORCHESTRATOR-RUNBOOK.md +43 -81
  62. package/references/shared/DASHBOARD-CONTRACT.md +66 -29
  63. package/references/shared/README.md +1 -1
  64. package/routing/god-demo.yaml +35 -0
  65. package/routing/god-first-run.yaml +34 -0
  66. package/routing/god-roadmap-check.yaml +2 -2
  67. package/routing/god-surface.yaml +39 -0
  68. package/routing/recipes/try-safely.yaml +26 -0
  69. package/skills/god-agent-audit.md +17 -15
  70. package/skills/god-arch.md +1 -3
  71. package/skills/god-archaeology.md +5 -6
  72. package/skills/god-audit.md +6 -7
  73. package/skills/god-automation-setup.md +6 -7
  74. package/skills/god-automation-status.md +6 -7
  75. package/skills/god-build.md +1 -3
  76. package/skills/god-context-scan.md +7 -8
  77. package/skills/god-demo.md +53 -0
  78. package/skills/god-deploy.md +1 -3
  79. package/skills/god-design-impact.md +5 -6
  80. package/skills/god-design.md +9 -3
  81. package/skills/god-discuss.md +5 -6
  82. package/skills/god-docs.md +5 -10
  83. package/skills/god-doctor.md +8 -9
  84. package/skills/god-dogfood.md +7 -10
  85. package/skills/god-explore.md +5 -7
  86. package/skills/god-feature.md +1 -3
  87. package/skills/god-first-run.md +64 -0
  88. package/skills/god-harden.md +1 -3
  89. package/skills/god-help.md +77 -51
  90. package/skills/god-hotfix.md +1 -3
  91. package/skills/god-hygiene.md +5 -6
  92. package/skills/god-launch.md +1 -3
  93. package/skills/god-lifecycle.md +11 -13
  94. package/skills/god-link.md +1 -3
  95. package/skills/god-list-assumptions.md +7 -8
  96. package/skills/god-locate.md +7 -8
  97. package/skills/god-map-codebase.md +5 -6
  98. package/skills/god-migrate.md +7 -18
  99. package/skills/god-mode.md +5 -0
  100. package/skills/god-next.md +16 -17
  101. package/skills/god-observe.md +1 -3
  102. package/skills/god-prd.md +1 -3
  103. package/skills/god-preflight.md +7 -8
  104. package/skills/god-progress.md +7 -8
  105. package/skills/god-reconcile.md +9 -10
  106. package/skills/god-reconstruct.md +5 -7
  107. package/skills/god-redo.md +1 -3
  108. package/skills/god-refactor.md +7 -10
  109. package/skills/god-repair.md +1 -3
  110. package/skills/god-repo.md +1 -3
  111. package/skills/god-restore.md +1 -3
  112. package/skills/god-roadmap-check.md +10 -10
  113. package/skills/god-roadmap.md +1 -3
  114. package/skills/god-rollback.md +1 -3
  115. package/skills/god-scan.md +6 -12
  116. package/skills/god-skip.md +1 -3
  117. package/skills/god-spike.md +5 -6
  118. package/skills/god-stack.md +1 -3
  119. package/skills/god-standards.md +5 -6
  120. package/skills/god-status.md +12 -10
  121. package/skills/god-story-build.md +1 -3
  122. package/skills/god-story-close.md +1 -3
  123. package/skills/god-story.md +1 -3
  124. package/skills/god-surface.md +61 -0
  125. package/skills/god-sync.md +7 -13
  126. package/skills/god-tech-debt.md +5 -6
  127. package/skills/god-test-runtime.md +4 -8
  128. package/skills/god-undo.md +1 -3
  129. package/skills/god-update-deps.md +1 -3
  130. package/skills/god-upgrade.md +1 -3
  131. package/skills/god-version.md +1 -1
  132. package/skills/god.md +53 -52
@@ -48,7 +48,7 @@ Plain-text report grouped by severity:
48
48
  GODPOWERS DOCTOR
49
49
 
50
50
  Install: claude (~/.claude/)
51
- [OK] 117 skills installed
51
+ [OK] 120 skills installed
52
52
  [OK] 40 agents installed
53
53
  [OK] VERSION matches (2.3.1)
54
54
  [WARN] routing/god-doctor.yaml exists but skill file did not until now
@@ -68,17 +68,16 @@ Suggested next steps:
68
68
  2. /god-restore (review trash)
69
69
  ```
70
70
 
71
- ## Proposition Closeout
71
+ ## Next Commands Closeout
72
72
 
73
- End every human-readable doctor report with a proposition block:
73
+ End every human-readable doctor report with a Next commands block:
74
74
 
75
75
  ```
76
- Proposition:
77
- 1. Implement partial: [safest single fix or diagnostic follow-up]
78
- 2. Implement complete: /god-doctor --fix when all proposed fixes are safe categories
79
- 3. Discuss more: /god-discuss [highest-risk warning or unclear repair]
80
- 4. Inspect status: /god-status after repair
81
- Recommended: [one option and why it is safe]
76
+ Next commands:
77
+ - /god-doctor --fix: Run the safest approved repair category.
78
+ - /god-doctor --fix when all proposed fixes are safe categories: Run the full recommended path.
79
+ - /god-discuss [highest-risk warning or unclear repair]: Resolve the open question before continuing.
80
+ - /god-status after repair: Inspect status before continuing.
82
81
  ```
83
82
 
84
83
  If the report contains errors that need manual repair, do not recommend
@@ -27,12 +27,12 @@ Run deterministic messy-repo scenarios before release or after automation change
27
27
  1. Resolve the runtime root and load `lib/dogfood-runner.js`.
28
28
  2. Run `dogfood.runAll()` against `fixtures/dogfood/`.
29
29
  3. Report each scenario with pass or fail status.
30
- 4. If any scenario fails, auto-invoke the matching specialist by visible card:
30
+ 4. If any scenario fails, recommend the matching specialist with a concise note:
31
31
  - `god-greenfieldifier` for planning-system import failures.
32
32
  - `god-context-writer` for host capability or install surface failures.
33
33
  - `god-coordinator` for extension authoring or suite release failures.
34
34
  5. Do not edit user projects while running fixture scenarios.
35
- 6. End with the Godpowers Dashboard and make `/god-repair` the recommended
35
+ 6. End with a compact action brief and make `/god-repair` the recommended
36
36
  route when dogfood is red.
37
37
 
38
38
  ## CLI Equivalent
@@ -50,14 +50,11 @@ npx godpowers dogfood --json
50
50
  - [DECISION] The dogfood suite includes extension scaffold validation.
51
51
  - [DECISION] The dogfood suite includes a Mode D suite release dry-run.
52
52
 
53
- ## Auto-Invoke Card
53
+ ## Automatic Work Note
54
54
 
55
55
  ```text
56
- Auto-invoked:
57
- Trigger: /god-dogfood scenario failure
58
- Agent: <god-greenfieldifier | god-context-writer | god-coordinator | none, local runtime only>
59
- Local syncs:
60
- + dogfood-runner: <pass, fail, or skipped reason>
61
- Artifacts: fixture-only unless repair is explicitly requested
62
- Log: none
56
+ Dogfood scenarios finished. Fixture details stayed in the run output unless repair was explicitly requested.
63
57
  ```
58
+
59
+ Use a detailed `Auto-invoked:` card only with `--verbose` or release-gate
60
+ debugging.
@@ -48,11 +48,9 @@ Idea explored. Suggested framing:
48
48
  Suggested next: /god-init (commit to this framing) or /god-explore again
49
49
  (if you want to try another angle)
50
50
 
51
- Proposition:
52
- 1. Implement partial: /god-init with this framing and stop after PRD
53
- 2. Implement complete: /god-mode with this framing for the full project run
54
- 3. Discuss more: /god-explore again with the weakest assumption
55
- 4. Run God Mode: /god-mode if the user is ready to build now
56
- Recommended: /god-init when the framing feels stable enough to turn into
57
- requirements.
51
+ Next commands:
52
+ - /god-init with this framing and stop after PRD: Run the smallest safe next step.
53
+ - /god-mode with this framing for the full project run: Run the full recommended path.
54
+ - /god-explore again with the weakest assumption: Resolve the open question before continuing.
55
+ - /god-mode if the user is ready to build now: Run the full autonomous project workflow when it fits.
58
56
  ```
@@ -107,6 +107,4 @@ in the linkage system:
107
107
  via `/god-review-changes`.
108
108
 
109
109
 
110
- ## Locking
111
-
112
- See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
110
+ Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
@@ -0,0 +1,64 @@
1
+ ---
2
+ name: god-first-run
3
+ description: |
4
+ Guide a first-time user through the first 10 minutes of Godpowers with one
5
+ recommended command and a few concrete alternatives. Never list the full
6
+ command catalog by default.
7
+
8
+ Triggers on: "god first run", "/god-first-run", "first time",
9
+ "getting started", "start using godpowers"
10
+ ---
11
+
12
+ # /god-first-run
13
+
14
+ Guide the user through the first 10 minutes. Keep the response short,
15
+ decisive, and state-aware. Do not list the full catalog unless the user asks
16
+ for `/god-help all`.
17
+
18
+ ## Process
19
+
20
+ 1. Check whether `.godpowers/state.json` exists.
21
+ 2. If no project state exists, recommend `/god-demo` first when the user wants
22
+ proof, otherwise recommend `/god-init`.
23
+ 3. If project state exists, recommend `/god-next`.
24
+ 4. Mention at most three alternatives.
25
+ 5. End with `Next commands:`.
26
+
27
+ ## Output Shape
28
+
29
+ For a fresh directory:
30
+
31
+ ```text
32
+ You have not initialized Godpowers here yet, so the first useful move is a safe proof or project init.
33
+
34
+ Next commands:
35
+ - /god-demo: Try the shipped sandbox without touching this repo.
36
+ - /god-init: Initialize Godpowers in this project now.
37
+ - /god-surface --profile=core --dry-run: Preview the smallest installed command surface.
38
+ - /god-help all: Show the complete catalog only if you want it.
39
+ ```
40
+
41
+ For an initialized project:
42
+
43
+ ```text
44
+ Godpowers state already exists here, so continue from disk instead of starting over.
45
+
46
+ Next commands:
47
+ - /god-next: Continue with the safest state-derived next step.
48
+ - /god-status --full: Inspect the complete dashboard and proactive checks.
49
+ - /god-help continue: See continue commands only.
50
+ ```
51
+
52
+ ## Rules
53
+
54
+ - Do not explain routing internals.
55
+ - Do not show more than four commands.
56
+ - Do not show every installed command.
57
+ - Prefer `/god-demo` when the user asks for proof or is unsure.
58
+ - Prefer `/god-init` when the user says they are ready to use the current repo.
59
+ - Prefer `/god-next` when `.godpowers/state.json` exists.
60
+
61
+ ## Implementation
62
+
63
+ Built-in, no spawned agent. Reads `.godpowers/state.json` and may call
64
+ `<runtimeRoot>/lib/dashboard.js` for the next route when state exists.
@@ -91,6 +91,4 @@ The reflog records every god-harden invocation as `op:god-harden` for `/god-undo
91
91
  for `/god-repair` review. Re-running picks up cleanly.
92
92
 
93
93
 
94
- ## Locking
95
-
96
- See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
94
+ Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
@@ -1,10 +1,8 @@
1
1
  ---
2
2
  name: god-help
3
3
  description: |
4
- Discoverable contextual help for Godpowers. Lists all skills grouped
5
- by category, with the current project state and what's suggested next.
6
- Different from /god (front door): /god proposes a command sequence;
7
- /god-help lists the catalog.
4
+ Discoverable contextual help for Godpowers. Shows a short guided view by
5
+ default, with the full catalog available only through /god-help all.
8
6
 
9
7
  Triggers on: "god help", "/god-help", "what can godpowers do",
10
8
  "list commands", "show help"
@@ -12,21 +10,55 @@ description: |
12
10
 
13
11
  # /god-help
14
12
 
15
- List Godpowers commands organized by family first, then by full catalog
16
- category. Show the map without hiding any installed command.
13
+ Show the smallest useful help view for the current project state. Do not dump
14
+ the installed command catalog unless the user asks for `all`, a family, a
15
+ category, a keyword search, or one command.
17
16
 
18
- ## Output sections
17
+ ## Default Output
19
18
 
20
- ### 1. Where you are
21
- One line summary of project state from `state.json`:
22
- - Mode (A/B/C/E + suite flag), scale, current tier, last command
19
+ ### 1. Where You Are
23
20
 
24
- ### 2. Suggested next
25
- The same suggestion `/god-next` would make. One command.
21
+ Render one plain sentence from disk state:
26
22
 
27
- ### 3. Command families
28
- Load `<runtimeRoot>/lib/command-families.js` and render family cards before the
29
- full catalog:
23
+ ```text
24
+ You are <not initialized | in planning | building | shipping | complete>; the likely next move is <command>.
25
+ ```
26
+
27
+ If no `.godpowers/` directory exists, treat the user as first-run and recommend
28
+ `/god-first-run`.
29
+
30
+ ### 2. Likely Next Area
31
+
32
+ Show 3 to 6 commands. Put the best command first. Use the family map from
33
+ `<runtimeRoot>/lib/command-families.js` and the state-derived recommendation
34
+ from `<runtimeRoot>/lib/router.js` or `<runtimeRoot>/lib/dashboard.js`.
35
+
36
+ Example for an initialized project:
37
+
38
+ ```text
39
+ Likely next area: continue
40
+
41
+ Next commands:
42
+ - /god-next: Continue with the safest state-derived next step.
43
+ - /god-status --full: See the complete dashboard and proactive checks.
44
+ - /god-help build: See build commands only.
45
+ ```
46
+
47
+ Example for first-run:
48
+
49
+ ```text
50
+ You have not initialized Godpowers here yet.
51
+
52
+ Next commands:
53
+ - /god-first-run: Walk through the first 10 minutes with one recommendation at a time.
54
+ - /god-demo: Try the shipped sandbox before touching this repo.
55
+ - /god-init: Start this project now.
56
+ - /god-help all: Show the complete catalog.
57
+ ```
58
+
59
+ ### 3. Families
60
+
61
+ Show family hubs without leaf commands:
30
62
 
31
63
  - Start: start or import a project.
32
64
  - Continue: understand state and choose the next move.
@@ -40,65 +72,59 @@ full catalog:
40
72
  - Collaborate: coordinate people, workstreams, suites, sprints, and pull requests.
41
73
  - Configure: tune settings, budgets, cache, profiles, help, and version info.
42
74
 
43
- ### 4. Decision ladders
44
- Show the compact ladders when the user asks about capture, work size, or
45
- verification:
46
-
47
- - Capture ladder: `/god-note`, `/god-add-todo`, `/god-add-backlog`, `/god-plant-seed`.
48
- - Work size ladder: `/god-fast`, `/god-quick`, `/god-story`, `/god-feature`, `/god-build`, `/god-debug`, `/god-hotfix`.
49
- - Verification ladder: `/god-lint`, `/god-standards`, `/god-review`, `/god-test-runtime`, `/god-audit`, `/god-hygiene`, `/god-preflight`, `/god-dogfood`.
75
+ End with `Next commands:` and never more than four commands.
50
76
 
51
- ### 5. Status views
52
- Present `/god-status` as the hub view and list the direct shortcuts:
53
- `/god-progress`, `/god-lifecycle`, `/god-locate`, and `/god-next`.
77
+ ## Subcommands
54
78
 
55
- ### 6. Full catalog
56
- All installed skills grouped by category. Categories match
57
- `docs/reference.md` order.
79
+ ### `/god-help`
58
80
 
59
- ### 7. Where to go for more
60
- - Full reference: https://github.com/aihxp/godpowers/blob/main/docs/reference.md
61
- - Concepts: https://github.com/aihxp/godpowers/blob/main/docs/concepts.md
62
- - Roadmap: https://github.com/aihxp/godpowers/blob/main/docs/ROADMAP.md
63
- - Installed have-nots catalog: `<runtime>/godpowers-references/HAVE-NOTS.md`
81
+ Contextual help with 3 to 6 likely next commands.
64
82
 
65
- ## Subcommands
83
+ ### `/god-help all`
66
84
 
67
- ### `/god-help`
68
- Full catalog with categories.
85
+ Full installed catalog grouped by category. This is the only default path that
86
+ lists every command.
69
87
 
70
88
  ### `/god-help <command>`
71
- Description of one specific command (reads the skill's frontmatter description).
89
+
90
+ Description of one command from the skill frontmatter.
72
91
 
73
92
  ### `/god-help search <keyword>`
74
- Filter the catalog by keyword match against descriptions.
93
+
94
+ Filter the catalog by keyword match against names and descriptions.
75
95
 
76
96
  ### `/god-help <family>`
97
+
77
98
  Show one family card plus its leaf commands. Valid families are start,
78
99
  continue, build, verify, operate, maintain, capture, recover, extend,
79
100
  collaborate, and configure.
80
101
 
81
102
  ### `/god-help --category=<name>`
82
- Show only one category (lifecycle, planning, building, shipping, etc.).
103
+
104
+ Show only one category, such as lifecycle, planning, building, shipping, or
105
+ configuration.
83
106
 
84
107
  ## Implementation
85
108
 
86
109
  Built-in, no spawned agent. Reads:
87
110
  - `<runtime>/skills/*.md` frontmatter
88
- - `.godpowers/state.json` (for current state line)
89
- - `<runtimeRoot>/lib/recipes.js` (for suggested next)
90
- - `<runtimeRoot>/lib/command-families.js` (for family cards and ladders)
111
+ - `.godpowers/state.json` for current state
112
+ - `<runtimeRoot>/lib/dashboard.js` for the next route when available
113
+ - `<runtimeRoot>/lib/command-families.js` for family cards and ladders
91
114
 
92
- Resolve `<runtimeRoot>` as `<projectRoot>` when `<projectRoot>/lib/recipes.js` exists. Otherwise use the installed bundle at `<tool-config-dir>/godpowers-runtime`, where `<tool-config-dir>` is the directory that contains this installed skill.
115
+ Resolve `<runtimeRoot>` as `<projectRoot>` when
116
+ `<projectRoot>/lib/dashboard.js` exists. Otherwise use the installed bundle at
117
+ `<tool-config-dir>/godpowers-runtime`, where `<tool-config-dir>` is the
118
+ directory that contains this installed skill.
93
119
 
94
- ## When to use
120
+ ## When To Use
95
121
 
96
- - First time using Godpowers and need an overview
97
- - Forgot the exact name of a command
98
- - Want to discover commands relevant to the current state
122
+ - First time using Godpowers and needing one next move.
123
+ - Forgot the exact name of a command.
124
+ - Want commands relevant to the current state without seeing the whole catalog.
99
125
 
100
- ## When NOT to use
126
+ ## When Not To Use
101
127
 
102
- - You know exactly what you want -> just run that command
103
- - You want intent-to-command matching -> use `/god` (front door)
104
- - You want a single next-step suggestion -> use `/god-next`
128
+ - You know exactly what you want: run that command.
129
+ - You want intent-to-command matching: use `/god`.
130
+ - You want the next state-derived action only: use `/god-next`.
@@ -123,6 +123,4 @@ in the linkage system:
123
123
  via `/god-review-changes`.
124
124
 
125
125
 
126
- ## Locking
127
-
128
- See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
126
+ Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
@@ -94,12 +94,11 @@ Suggested next actions (in priority order):
94
94
 
95
95
  Schedule next hygiene check in [N days] (default: 30).
96
96
 
97
- Proposition:
98
- 1. Implement partial: [highest-priority action]
99
- 2. Implement complete: [all P0/P1 hygiene actions in order]
100
- 3. Discuss more: /god-discuss hygiene remediation
101
- 4. Inspect status: /god-status after fixes
102
- Recommended: [one option and why]
97
+ Next commands:
98
+ - /god-next: Run the highest-priority hygiene follow-up from disk state.
99
+ - /god-hygiene: Re-run the health check after P0 and P1 fixes.
100
+ - /god-discuss hygiene remediation: Resolve the open question before continuing.
101
+ - /god-status after fixes: Inspect status before continuing.
103
102
  ```
104
103
 
105
104
  ## Have-Nots
@@ -97,6 +97,4 @@ The reflog records every god-launch invocation as `op:god-launch` for `/god-undo
97
97
  for `/god-repair` review. Re-running picks up cleanly.
98
98
 
99
99
 
100
- ## Locking
101
-
102
- See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
100
+ Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
@@ -121,29 +121,27 @@ Suggested next: /god-spike with narrower question
121
121
  Or: archive the spike if no longer relevant
122
122
  ```
123
123
 
124
- ## Proposition Closeout
124
+ ## Next Commands Closeout
125
125
 
126
- Every lifecycle report must end with a proposition block. Use the detected
126
+ Every lifecycle report must end with a Next commands block. Use the detected
127
127
  phase to fill in concrete commands:
128
128
 
129
129
  ```
130
- Proposition:
131
- 1. Implement partial: [smallest safe next command from the lifecycle report]
132
- 2. Implement complete: /god-mode [resume or scope] when the phase is safe for an autonomous project run
133
- 3. Discuss more: /god-discuss [unclear phase, blocker, or choice]
134
- 4. Inspect status: /god-status or /god-next
135
- Recommended: [one option and why it matches the detected phase]
130
+ Next commands:
131
+ - /god-next: Run the smallest safe next command from the lifecycle report.
132
+ - /god-mode [resume or scope] when the phase is safe for an autonomous project run: Run the full recommended path.
133
+ - /god-discuss [unclear phase, blocker, or choice]: Resolve the open question before continuing.
134
+ - /god-status or /god-next: Inspect status before continuing.
136
135
  ```
137
136
 
138
137
  For hard blockers, such as post-incident pending, replace the broad options
139
138
  with the required next command plus inspect and discuss alternatives:
140
139
 
141
140
  ```
142
- Proposition:
143
- 1. Resolve required next: /god-postmortem
144
- 2. Inspect first: /god-status
145
- 3. Discuss blocker: /god-discuss incident follow-up
146
- Recommended: /god-postmortem because the incident learning loop is still open.
141
+ Next commands:
142
+ - /god-postmortem: Resolve the required incident follow-up before continuing.
143
+ - /god-status --full: Inspect full status before acting.
144
+ - /god-discuss incident follow-up: Resolve the blocker with a focused discussion.
147
145
  ```
148
146
 
149
147
  ## Have-Nots
@@ -74,6 +74,4 @@ Updates:
74
74
  No source files are modified by this skill.
75
75
 
76
76
 
77
- ## Locking
78
-
79
- See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
77
+ Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
@@ -48,17 +48,16 @@ Assumptions Claude is operating under:
48
48
  Any of these wrong? Flag them now before they cement into decisions.
49
49
  ```
50
50
 
51
- ## Proposition Closeout
51
+ ## Next Commands Closeout
52
52
 
53
- After listing assumptions, end with a proposition block:
53
+ After listing assumptions, end with a Next commands block:
54
54
 
55
55
  ```
56
- Proposition:
57
- 1. Implement partial: correct or confirm the low-confidence assumptions only
58
- 2. Implement complete: confirm assumptions and continue to [queued command]
59
- 3. Discuss more: /god-discuss assumptions before planning
60
- 4. Inspect status: /god-status to re-ground before deciding
61
- Recommended: [one option and why]
56
+ Next commands:
57
+ - /god-discuss assumptions: Correct or confirm low-confidence assumptions.
58
+ - /god-next: Continue to the queued command after assumptions are confirmed.
59
+ - /god-discuss assumptions before planning: Resolve the open question before continuing.
60
+ - /god-status to re-ground before deciding: Inspect status before continuing.
62
61
  ```
63
62
 
64
63
  ## Have-Nots
@@ -80,17 +80,16 @@ Drift check:
80
80
  - If gap > 1 hour, run /god-context-scan
81
81
  ```
82
82
 
83
- ## Proposition Closeout
83
+ ## Next Commands Closeout
84
84
 
85
- The orientation summary must end with a compact proposition block:
85
+ The orientation summary must end with a compact Next commands block:
86
86
 
87
87
  ```
88
- Proposition:
89
- 1. Implement partial: [next suggested command]
90
- 2. Implement complete: /god-mode to continue the project run when no drift is flagged
91
- 3. Discuss more: /god-discuss [unclear state or stale checkpoint]
92
- 4. Inspect status: /god-status for the full report
93
- Recommended: [one option and why]
88
+ Next commands:
89
+ - /god-next: Run the next suggested command from disk state.
90
+ - /god-mode to continue the project run when no drift is flagged: Run the full recommended path.
91
+ - /god-discuss [unclear state or stale checkpoint]: Resolve the open question before continuing.
92
+ - /god-status for the full report: Inspect status before continuing.
94
93
  ```
95
94
 
96
95
  If drift is flagged, recommend `/god-context-scan` or `/god-repair` before
@@ -43,11 +43,10 @@ Codebase mapped.
43
43
 
44
44
  Suggested next: /god-init Mode B (gap-fill) or /god-feature
45
45
 
46
- Proposition:
47
- 1. Implement partial: /god-intel or /god-tech-debt on the riskiest mapped area
48
- 2. Implement complete: /god-init Mode B to gap-fill project artifacts
49
- 3. Discuss more: /god-discuss the unclear architecture or quality findings
50
- 4. Run God Mode: /god-mode after Mode B context exists
51
- Recommended: /god-init Mode B when the codebase is real but Godpowers artifacts
46
+ Next commands:
47
+ - /god-intel or /god-tech-debt on the riskiest mapped area: Run the smallest safe next step.
48
+ - /god-init Mode B to gap-fill project artifacts: Run the full recommended path.
49
+ - /god-discuss the unclear architecture or quality findings: Resolve the open question before continuing.
50
+ - /god-mode after Mode B context exists: Run the full autonomous project workflow when it fits.
52
51
  are missing.
53
52
  ```
@@ -26,28 +26,19 @@ Detect and migrate adjacent planning systems into Godpowers.
26
26
 
27
27
  ## Auto-Invoke Contract
28
28
 
29
- `/god-init` auto-invokes the import path when it detects legacy planning, BMAD, or
30
- Superpowers context. It must show this visible status card:
29
+ `/god-init` auto-invokes the import path when it detects legacy planning, BMAD,
30
+ or Superpowers context. It shows this concise note when import writes happen:
31
31
 
32
32
  ```
33
- Auto-invoked:
34
- Trigger: /god-init planning-system detection
35
- Agent: none, local runtime only
36
- Local syncs:
37
- + planning-system-import: <detected systems, written seeds, or no-op>
38
- Artifacts: .godpowers/prep/IMPORTED-CONTEXT.md and optional seed artifacts
33
+ Imported adjacent planning context into .godpowers/prep/IMPORTED-CONTEXT.md.
39
34
  ```
40
35
 
41
36
  `/god-sync` auto-invokes sync-back when `state.json` contains enabled
42
- `source-systems` entries. It must show this visible status card:
37
+ `source-systems` entries. It shows this concise note when companion files are
38
+ written:
43
39
 
44
40
  ```
45
- Auto-invoked:
46
- Trigger: /god-sync source-system sync-back
47
- Agent: none, local runtime only
48
- Local syncs:
49
- + source-sync: <written companion files, pointer fences, or no-op>
50
- Artifacts: <.planning/GODPOWERS-SYNC.md, _bmad-output/GODPOWERS-SYNC.md, docs/superpowers/GODPOWERS-SYNC.md>
41
+ Synced Godpowers progress back to the source planning system.
51
42
  ```
52
43
 
53
44
  If the import has low confidence, multiple conflicting systems, or missing
@@ -139,6 +130,4 @@ Suggested next:
139
130
  /god-audit to score imported seeds before treating them as authoritative.
140
131
  ```
141
132
 
142
- ## Locking
143
-
144
- See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
133
+ Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
@@ -129,6 +129,11 @@ workflow.
129
129
  - Instruction that `--yolo` cannot bypass safe sync blockers or
130
130
  unresolved Critical harden findings. These are release-truth gates, not
131
131
  preference pauses.
132
+ - Instruction to run `npx godpowers gate --tier=<tier> --project=.` after
133
+ each completed `god-prd`, `god-design`, `god-arch`, `god-roadmap`,
134
+ `god-stack`, `god-repo`, `god-build`, and `god-harden` tier skill and
135
+ before starting the downstream tier. A non-zero exit blocks progress
136
+ until the artifact is repaired.
132
137
 
133
138
  6. Spawn the **god-orchestrator** agent via the host platform's native agent spawning mechanism with only a
134
139
  display-safe payload:
@@ -1,10 +1,9 @@
1
1
  ---
2
2
  name: god-next
3
3
  description: |
4
- Decision engine. For any command intent, checks prerequisites, proposes
5
- auto-completion of missing prerequisites, runs standards checks at gates,
6
- and suggests next commands after success. Backed by runtime routing YAML
7
- configurations.
4
+ Decision engine. For any command intent, checks prerequisites, runs safe
5
+ read-only continuation when possible, and suggests the next concrete command
6
+ after success. Backed by runtime routing YAML configurations.
8
7
 
9
8
  Triggers on: "god next", "/god-next", "what's next", "what should I do next",
10
9
  "next step", "continue"
@@ -13,7 +12,9 @@ description: |
13
12
  # /god-next
14
13
 
15
14
  The unified decision engine. Route between commands based on disk state,
16
- routing definitions, recipes, command families, and user intent.
15
+ routing definitions, recipes, command families, and user intent. Explain what
16
+ you are about to do in one plain sentence, then run the safe next step when the
17
+ step is read-only or an explicit local check.
17
18
 
18
19
  ## Runtime module resolution
19
20
 
@@ -21,22 +22,22 @@ routing definitions, recipes, command families, and user intent.
21
22
  2. Otherwise use the installed bundle at `<tool-config-dir>/godpowers-runtime`.
22
23
  3. Read routing definitions from `<runtimeRoot>/routing/*.yaml` and recipes from `<runtimeRoot>/routing/recipes/*.yaml`.
23
24
  4. Load `<runtimeRoot>/lib/command-families.js` before resolving broad intent.
24
- 5. Load `<runtimeRoot>/lib/dashboard.js` and render the shared dashboard before route-specific detail.
25
+ 5. Load `<runtimeRoot>/lib/dashboard.js` and render only the compact action brief unless the user asks for `--full`.
25
26
  6. Prefer the MCP `next` tool when it is available, and fall back to the CLI or runtime module when it is not.
26
- 7. If no dashboard module is available, say `Dashboard engine: unavailable, manual scan used`.
27
+ 7. If no dashboard module is available, use a manual disk scan quietly and suggest `/god-doctor` only when the fallback changes the recommendation.
27
28
 
28
29
  ## Required references
29
30
 
30
31
  Read these references before producing a route recommendation:
31
32
 
32
33
  - `<runtimeRoot>/references/orchestration/GOD-NEXT-RUNBOOK.md` for invocation modes, route detail, and edge cases.
33
- - `<runtimeRoot>/references/shared/DASHBOARD-CONTRACT.md` for the shared status and proposition shape.
34
+ - `<runtimeRoot>/references/shared/DASHBOARD-CONTRACT.md` for the shared status and `Next commands:` shape.
34
35
 
35
36
  ## Invocation modes
36
37
 
37
38
  - Post-completion: after a command finishes, read its routing file and announce the next gate.
38
39
  - Pre-flight: before a target command runs, evaluate prerequisites and offer auto-completion when available.
39
- - Standalone: when the user asks what is next, derive the recommendation from disk state.
40
+ - Standalone: when the user asks what is next, derive the recommendation from disk state and run the safe read-only next step when it has no destructive effect.
40
41
  - Intent-based: when the user uses fuzzy text, match recipes and command families before raw route order.
41
42
 
42
43
  ## Decision rules
@@ -54,12 +55,10 @@ Read these references before producing a route recommendation:
54
55
 
55
56
  Render this sequence:
56
57
 
57
- 1. `Godpowers Next` heading.
58
- 2. Shared Godpowers Dashboard from `DASHBOARD-CONTRACT.md`.
59
- 3. Suggested next command and one-line reason.
60
- 4. Optional three-line path ahead when state allows it.
61
- 5. Optional pre-flight, standards, or blocker detail.
62
- 6. Proactive checks using the shared labels.
63
- 7. Proposition block unless the selected command already launched.
58
+ 1. One plain sentence describing the selected next step.
59
+ 2. Suggested next command and one-line reason.
60
+ 3. Optional blocker detail only when it changes the recommendation.
61
+ 4. `Next commands:` with the selected command first.
64
62
 
65
- Keep the route preview to three lines unless the user asks for the full plan.
63
+ Keep the route preview to three lines unless the user asks for the full plan or
64
+ `--full`. Do not print the full dashboard by default.
@@ -79,6 +79,4 @@ The reflog records every god-observe invocation as `op:god-observe` for `/god-un
79
79
  for `/god-repair` review. Re-running picks up cleanly.
80
80
 
81
81
 
82
- ## Locking
83
-
84
- See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
82
+ Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.