godpowers 2.3.0 → 2.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (169) hide show
  1. package/CHANGELOG.md +61 -0
  2. package/README.md +28 -16
  3. package/RELEASE.md +35 -27
  4. package/SKILL.md +26 -3
  5. package/agents/god-debugger.md +44 -8
  6. package/agents/god-executor.md +28 -0
  7. package/agents/god-quality-reviewer.md +23 -1
  8. package/agents/god-spec-reviewer.md +6 -0
  9. package/bin/install.js +6 -0
  10. package/lib/README.md +5 -2
  11. package/lib/agent-cache.js +25 -3
  12. package/lib/code-intelligence.js +161 -0
  13. package/lib/command-families.js +375 -0
  14. package/lib/dashboard.js +54 -20
  15. package/lib/extensions.js +6 -13
  16. package/lib/feature-awareness.js +2 -2
  17. package/lib/host-capabilities.js +4 -0
  18. package/lib/install-profiles.js +1 -0
  19. package/lib/planning-systems.js +7 -4
  20. package/lib/quick-proof.js +5 -2
  21. package/lib/release-surface-sync.js +4 -1
  22. package/lib/route-quality-sync.js +42 -12
  23. package/lib/router.js +32 -0
  24. package/lib/workflow-helper-groups.js +50 -0
  25. package/lib/workflow-runner.js +6 -1
  26. package/package.json +2 -2
  27. package/routing/god-add-backlog.yaml +1 -0
  28. package/routing/god-add-tests.yaml +1 -0
  29. package/routing/god-add-todo.yaml +1 -0
  30. package/routing/god-agent-audit.yaml +6 -0
  31. package/routing/god-arch.yaml +1 -0
  32. package/routing/god-archaeology.yaml +1 -0
  33. package/routing/god-audit.yaml +1 -0
  34. package/routing/god-automation-setup.yaml +1 -0
  35. package/routing/god-automation-status.yaml +1 -0
  36. package/routing/god-budget.yaml +6 -0
  37. package/routing/god-build-agent.yaml +1 -0
  38. package/routing/god-build.yaml +1 -0
  39. package/routing/god-cache-clear.yaml +6 -0
  40. package/routing/god-check-todos.yaml +6 -0
  41. package/routing/god-context-scan.yaml +6 -0
  42. package/routing/god-context.yaml +1 -0
  43. package/routing/god-cost.yaml +6 -0
  44. package/routing/god-debug.yaml +1 -0
  45. package/routing/god-deploy.yaml +1 -0
  46. package/routing/god-design-impact.yaml +6 -0
  47. package/routing/god-design.yaml +1 -0
  48. package/routing/god-discuss.yaml +12 -0
  49. package/routing/god-docs.yaml +1 -0
  50. package/routing/god-doctor.yaml +6 -0
  51. package/routing/god-dogfood.yaml +1 -0
  52. package/routing/god-explore.yaml +1 -0
  53. package/routing/god-export-otel.yaml +1 -0
  54. package/routing/god-extension-add.yaml +6 -0
  55. package/routing/god-extension-info.yaml +6 -0
  56. package/routing/god-extension-list.yaml +6 -0
  57. package/routing/god-extension-remove.yaml +6 -0
  58. package/routing/god-extension-scaffold.yaml +26 -0
  59. package/routing/god-extract-learnings.yaml +1 -0
  60. package/routing/god-fast.yaml +1 -0
  61. package/routing/god-feature.yaml +1 -0
  62. package/routing/god-graph.yaml +6 -0
  63. package/routing/god-harden.yaml +1 -0
  64. package/routing/god-help.yaml +6 -0
  65. package/routing/god-hotfix.yaml +1 -0
  66. package/routing/god-hygiene.yaml +1 -0
  67. package/routing/god-init.yaml +1 -0
  68. package/routing/god-intel.yaml +1 -0
  69. package/routing/god-launch.yaml +6 -0
  70. package/routing/god-lifecycle.yaml +12 -0
  71. package/routing/god-link.yaml +1 -0
  72. package/routing/god-lint.yaml +1 -0
  73. package/routing/god-list-assumptions.yaml +6 -0
  74. package/routing/god-locate.yaml +6 -0
  75. package/routing/god-logs.yaml +12 -0
  76. package/routing/god-map-codebase.yaml +1 -0
  77. package/routing/god-metrics.yaml +6 -0
  78. package/routing/god-migrate.yaml +1 -0
  79. package/routing/god-mode.yaml +6 -0
  80. package/routing/god-next.yaml +12 -0
  81. package/routing/god-note.yaml +1 -0
  82. package/routing/god-observe.yaml +1 -0
  83. package/routing/god-org-context.yaml +1 -0
  84. package/routing/god-party.yaml +1 -0
  85. package/routing/god-pause-work.yaml +6 -0
  86. package/routing/god-plant-seed.yaml +1 -0
  87. package/routing/god-postmortem.yaml +1 -0
  88. package/routing/god-pr-branch.yaml +1 -0
  89. package/routing/god-prd.yaml +1 -0
  90. package/routing/god-preflight.yaml +1 -0
  91. package/routing/god-progress.yaml +7 -0
  92. package/routing/god-quick.yaml +1 -0
  93. package/routing/god-reconcile.yaml +6 -0
  94. package/routing/god-reconstruct.yaml +1 -0
  95. package/routing/god-redo.yaml +6 -0
  96. package/routing/god-refactor.yaml +1 -0
  97. package/routing/god-repair.yaml +1 -0
  98. package/routing/god-repo.yaml +1 -0
  99. package/routing/god-restore.yaml +1 -0
  100. package/routing/god-resume-work.yaml +6 -0
  101. package/routing/god-review-changes.yaml +1 -0
  102. package/routing/god-review.yaml +1 -0
  103. package/routing/god-roadmap-check.yaml +6 -0
  104. package/routing/god-roadmap-update.yaml +1 -0
  105. package/routing/god-roadmap.yaml +1 -0
  106. package/routing/god-rollback.yaml +1 -0
  107. package/routing/god-scan.yaml +1 -0
  108. package/routing/god-set-profile.yaml +1 -0
  109. package/routing/god-settings.yaml +1 -0
  110. package/routing/god-skip.yaml +1 -0
  111. package/routing/god-smite.yaml +1 -0
  112. package/routing/god-spike.yaml +1 -0
  113. package/routing/god-sprint.yaml +6 -0
  114. package/routing/god-stack.yaml +2 -1
  115. package/routing/god-standards.yaml +1 -0
  116. package/routing/god-status.yaml +1 -0
  117. package/routing/god-stories.yaml +1 -0
  118. package/routing/god-story-build.yaml +1 -0
  119. package/routing/god-story-close.yaml +1 -0
  120. package/routing/god-story-verify.yaml +1 -0
  121. package/routing/god-story.yaml +1 -0
  122. package/routing/god-suite-init.yaml +1 -0
  123. package/routing/god-suite-patch.yaml +1 -0
  124. package/routing/god-suite-release.yaml +1 -0
  125. package/routing/god-suite-status.yaml +6 -0
  126. package/routing/god-suite-sync.yaml +1 -0
  127. package/routing/god-sync.yaml +1 -0
  128. package/routing/god-tech-debt.yaml +1 -0
  129. package/routing/god-test-extension.yaml +6 -0
  130. package/routing/god-test-runtime.yaml +1 -0
  131. package/routing/god-thread.yaml +6 -0
  132. package/routing/god-trace.yaml +6 -0
  133. package/routing/god-undo.yaml +1 -0
  134. package/routing/god-update-deps.yaml +1 -0
  135. package/routing/god-upgrade.yaml +1 -0
  136. package/routing/god-version.yaml +1 -0
  137. package/routing/god-workstream.yaml +6 -0
  138. package/routing/god.yaml +6 -0
  139. package/routing/recipes/add-feature-mid-arc-pause.yaml +6 -0
  140. package/routing/recipes/brownfield-onboarding.yaml +5 -2
  141. package/routing/recipes/extension-authoring.yaml +32 -0
  142. package/routing/recipes/greenfield-fast.yaml +3 -0
  143. package/routing/recipes/production-broken.yaml +4 -0
  144. package/routing/recipes/release-maintenance.yaml +3 -0
  145. package/routing/recipes/returning-after-break.yaml +3 -0
  146. package/routing/recipes/weekly-health-check.yaml +2 -0
  147. package/schema/routing.v1.json +62 -4
  148. package/schema/workflow.v1.json +14 -0
  149. package/skills/god-discuss.md +10 -5
  150. package/skills/god-doctor.md +9 -3
  151. package/skills/god-extension-scaffold.md +66 -0
  152. package/skills/god-help.md +38 -3
  153. package/skills/god-next.md +19 -2
  154. package/skills/god-status.md +13 -0
  155. package/skills/god-sync.md +1 -1
  156. package/skills/god-version.md +2 -2
  157. package/skills/god.md +61 -12
  158. package/workflows/audit-only.yaml +2 -2
  159. package/workflows/bluefield-arc.yaml +3 -7
  160. package/workflows/brownfield-arc.yaml +4 -8
  161. package/workflows/deps-audit.yaml +2 -5
  162. package/workflows/docs-arc.yaml +2 -2
  163. package/workflows/feature-arc.yaml +3 -6
  164. package/workflows/full-arc.yaml +5 -11
  165. package/workflows/hotfix-arc.yaml +3 -6
  166. package/workflows/hygiene.yaml +2 -2
  167. package/workflows/migration-arc.yaml +3 -5
  168. package/workflows/postmortem.yaml +2 -5
  169. package/workflows/refactor-arc.yaml +3 -6
@@ -12,6 +12,9 @@ triggers:
12
12
  - "greenfield"
13
13
  - "new project"
14
14
  - "idea to production"
15
+ - "start a product"
16
+ - "start product"
17
+ - "build a product"
15
18
  state-conditions:
16
19
  - "no-godpowers-dir"
17
20
 
@@ -8,6 +8,10 @@ metadata:
8
8
  triggers:
9
9
  intent-keywords:
10
10
  - "production down"
11
+ - "production is broken"
12
+ - "production broken"
13
+ - "fix production"
14
+ - "prod is broken"
11
15
  - "urgent"
12
16
  - "p0"
13
17
  - "p1"
@@ -12,6 +12,9 @@ triggers:
12
12
  - "update readme badge"
13
13
  - "release notes"
14
14
  - "package release"
15
+ - "ship a release"
16
+ - "release the project"
17
+ - "prepare release"
15
18
 
16
19
  sequences:
17
20
  default:
@@ -11,6 +11,9 @@ triggers:
11
11
  - "after break"
12
12
  - "pick up where left"
13
13
  - "resume project"
14
+ - "coming back after a week"
15
+ - "back after a week"
16
+ - "coming back"
14
17
  state-conditions:
15
18
  - "file:.godpowers/PROGRESS.md"
16
19
 
@@ -11,6 +11,8 @@ triggers:
11
11
  - "health check"
12
12
  - "hygiene"
13
13
  - "project health"
14
+ - "maintain project health"
15
+ - "maintain health"
14
16
  state-conditions:
15
17
  - "lifecycle-phase == steady-state-active"
16
18
 
@@ -20,9 +20,29 @@
20
20
  "properties": {
21
21
  "command": {
22
22
  "type": "string",
23
- "pattern": "^/god-[a-z-]+$"
23
+ "pattern": "^/god(?:-[a-z-]+)?$"
24
24
  },
25
25
  "description": { "type": "string" },
26
+ "family": {
27
+ "type": "string",
28
+ "enum": [
29
+ "start",
30
+ "continue",
31
+ "build",
32
+ "verify",
33
+ "operate",
34
+ "maintain",
35
+ "capture",
36
+ "recover",
37
+ "extend",
38
+ "collaborate",
39
+ "configure"
40
+ ]
41
+ },
42
+ "trigger-precedence": {
43
+ "type": "array",
44
+ "items": { "$ref": "#/$defs/TriggerPrecedence" }
45
+ },
26
46
  "tier": {
27
47
  "type": "integer",
28
48
  "minimum": 0,
@@ -110,7 +130,10 @@
110
130
  "properties": {
111
131
  "next-recommended": {
112
132
  "type": "string",
113
- "pattern": "^/god-[a-z-]+$"
133
+ "pattern": "^(?:/god(?:-[a-z-]+)?(?:\\s.*)?|varies|varies-by-verdict|steady-state|session-end)(?:\\sor\\s/god-[a-z-]+(?:\\s.*)?)*$"
134
+ },
135
+ "outcome": {
136
+ "$ref": "#/$defs/RouteOutcome"
114
137
  },
115
138
  "alternatives": {
116
139
  "type": "array",
@@ -162,7 +185,7 @@
162
185
  },
163
186
  "auto-complete": {
164
187
  "type": "string",
165
- "pattern": "^/god-[a-z-]+$",
188
+ "pattern": "^/god(?:-[a-z-]+)?(?:\\s.*)?$",
166
189
  "description": "Command to run if prerequisite missing"
167
190
  },
168
191
  "human-required": {
@@ -175,9 +198,44 @@
175
198
  "type": "object",
176
199
  "required": ["command"],
177
200
  "properties": {
178
- "command": { "type": "string", "pattern": "^/god-[a-z-]+$" },
201
+ "command": { "type": "string", "pattern": "^/god(?:-[a-z-]+)?(?:\\s.*)?$" },
179
202
  "when": { "type": "string", "description": "Condition for this recommendation" }
180
203
  }
204
+ },
205
+ "RouteOutcome": {
206
+ "type": "object",
207
+ "required": ["type", "label", "reason"],
208
+ "properties": {
209
+ "type": {
210
+ "type": "string",
211
+ "enum": [
212
+ "contextual",
213
+ "verdict-based",
214
+ "steady-state",
215
+ "session-end",
216
+ "requires-selection",
217
+ "no-next-command",
218
+ "explicit-command"
219
+ ]
220
+ },
221
+ "label": { "type": "string" },
222
+ "reason": { "type": "string" },
223
+ "allowed-next": {
224
+ "type": "array",
225
+ "items": { "type": "string" }
226
+ }
227
+ }
228
+ },
229
+ "TriggerPrecedence": {
230
+ "type": "object",
231
+ "required": ["trigger", "prefer"],
232
+ "properties": {
233
+ "trigger": { "type": "string" },
234
+ "prefer": { "type": "string" },
235
+ "when": { "type": "string" },
236
+ "fallback": { "type": "string" },
237
+ "reason": { "type": "string" }
238
+ }
181
239
  }
182
240
  }
183
241
  }
@@ -106,6 +106,20 @@
106
106
  ]
107
107
  }
108
108
  },
109
+ "local-helper-groups": {
110
+ "type": "array",
111
+ "description": "Named helper groups expanded by the workflow runner into explicit local-helpers in serialized plans.",
112
+ "items": {
113
+ "type": "string",
114
+ "enum": [
115
+ "standard-closeout",
116
+ "repo-maintenance-closeout",
117
+ "runtime-awareness-closeout",
118
+ "release-readiness-closeout",
119
+ "source-sync-closeout"
120
+ ]
121
+ }
122
+ },
109
123
  "per": { "type": "string", "enum": ["slice", "wave"] },
110
124
  "parallel-by": { "type": "string", "enum": ["slice", "wave"] },
111
125
  "on-pass": { "type": "string" },
@@ -11,7 +11,7 @@ description: |
11
11
 
12
12
  # /god-discuss
13
13
 
14
- Pre-planning Socratic discussion with domain grilling.
14
+ Pre-planning Socratic discussion with domain and plan grilling.
15
15
 
16
16
  ## When to use
17
17
 
@@ -31,10 +31,15 @@ The agent:
31
31
  4. Explores the codebase instead of asking when repo evidence can answer
32
32
  5. Challenges vague, overloaded, or conflicting terms against the glossary
33
33
  6. Stress-tests domain relationships with concrete scenarios and edge cases
34
- 7. Surfaces 2-3 hidden assumptions
35
- 8. Identifies what's [DECISION] vs [HYPOTHESIS] vs [OPEN QUESTION]
36
- 9. Drafts a brief in `.godpowers/discussions/<topic>.md`
37
- 10. Updates `.godpowers/domain/GLOSSARY.md` when a term or ambiguity is resolved
34
+ 7. Attempts to falsify the proposed plan before accepting it:
35
+ - What breaks if the smallest happy path is wrong?
36
+ - Which dependency, user behavior, or edge case could invalidate the plan?
37
+ - What would make this scope too broad for one safe slice?
38
+ - What evidence would change the recommended next command?
39
+ 8. Surfaces 2-3 hidden assumptions
40
+ 9. Identifies what's [DECISION] vs [HYPOTHESIS] vs [OPEN QUESTION]
41
+ 10. Drafts a brief in `.godpowers/discussions/<topic>.md`
42
+ 11. Updates `.godpowers/domain/GLOSSARY.md` when a term or ambiguity is resolved
38
43
 
39
44
  The brief and glossary get passed to the next planning command. The glossary is
40
45
  preparation context, not a replacement for PRD, ARCH, ROADMAP, STACK, or Pillars
@@ -48,9 +48,9 @@ Plain-text report grouped by severity:
48
48
  GODPOWERS DOCTOR
49
49
 
50
50
  Install: claude (~/.claude/)
51
- [OK] 111 skills installed
51
+ [OK] 112 skills installed
52
52
  [OK] 40 agents installed
53
- [OK] VERSION matches (2.3.0)
53
+ [OK] VERSION matches (2.3.1)
54
54
  [WARN] routing/god-doctor.yaml exists but skill file did not until now
55
55
 
56
56
  Project: /Users/.../my-project/.godpowers/
@@ -114,6 +114,12 @@ as a read-only diagnostic. It reports:
114
114
  `/god-doctor --fix` may call `lib/feature-awareness.run(projectRoot)` because
115
115
  that helper writes only safe state metadata and managed context fences.
116
116
 
117
+ ## Host Capability Reporting
118
+
119
+ `/god-doctor` reports optional code intelligence when `ast-grep`, `sg`, or LSP
120
+ tools are available. Missing code intelligence is diagnostic context only; it
121
+ does not make the host degraded.
122
+
117
123
  ## Repo Documentation Sync
118
124
 
119
125
  For initialized projects, `/god-doctor` calls `lib/repo-doc-sync.detect` as a
@@ -151,7 +157,7 @@ Built-in, no spawned agent. Reads:
151
157
  - `lib/repo-surface-sync.detect(projectRoot)` for structural repo surface
152
158
  freshness
153
159
  - `lib/route-quality-sync.detect(projectRoot)` through repo surface sync for
154
- atomic spawn and contextual route exit freshness
160
+ atomic spawn and typed route outcome freshness
155
161
  - `lib/recipe-coverage-sync.detect(projectRoot)` through repo surface sync for
156
162
  high-frequency intent recipe coverage freshness
157
163
  - `lib/release-surface-sync.detect(projectRoot)` through repo surface sync for
@@ -0,0 +1,66 @@
1
+ ---
2
+ name: god-extension-scaffold
3
+ description: |
4
+ Create a publishable Godpowers extension pack skeleton from inside the
5
+ slash-command UX. Wraps the same extension authoring helper exposed by
6
+ `npx godpowers extension-scaffold`, then routes to contract testing.
7
+
8
+ Triggers on: "god extension scaffold", "/god-extension-scaffold",
9
+ "create extension pack", "author extension pack", "new extension pack",
10
+ "extend godpowers"
11
+ ---
12
+
13
+ # /god-extension-scaffold
14
+
15
+ Create a Godpowers extension pack skeleton.
16
+
17
+ ## Usage
18
+
19
+ ### `/god-extension-scaffold --name=@godpowers/my-pack --output=.`
20
+
21
+ Optional arguments:
22
+
23
+ - `--skill=custom-pack-command` sets the generated skill name.
24
+ - `--agent=custom-pack-agent` creates a generated agent contract.
25
+ - `--workflow=my-pack-workflow` creates a generated workflow YAML.
26
+ - `--overwrite` allows replacing existing scaffold files.
27
+
28
+ ## Process
29
+
30
+ 1. Parse the requested package name, output root, optional skill, optional
31
+ agent, and optional workflow.
32
+ 2. Call `lib/extension-authoring.js scaffold(...)`.
33
+ 3. Validate the generated `manifest.yaml` against the extension manifest
34
+ contract.
35
+ 4. Report the created pack path and written files.
36
+ 5. Suggest `/god-test-extension <pack-dir>` before install or publish.
37
+
38
+ ## Output
39
+
40
+ ```
41
+ Extension scaffold created: ./godpowers-my-pack
42
+
43
+ Written:
44
+ manifest.yaml
45
+ package.json
46
+ README.md
47
+ skills/custom-pack-command.md
48
+
49
+ Suggested next: /god-test-extension ./godpowers-my-pack
50
+ ```
51
+
52
+ ## Implementation
53
+
54
+ Built-in. Calls `lib/extension-authoring.js scaffold(...)`.
55
+
56
+ The terminal equivalent remains:
57
+
58
+ ```bash
59
+ npx godpowers extension-scaffold --name=@godpowers/my-pack --output=.
60
+ ```
61
+
62
+ ## Related
63
+
64
+ - `/god-test-extension <path>` - contract test the pack before install or publish
65
+ - `/god-extension-add <path>` - install a passing pack
66
+ - `/god-extension-list` - verify the pack is visible in the runtime
@@ -12,7 +12,8 @@ description: |
12
12
 
13
13
  # /god-help
14
14
 
15
- List Godpowers commands organized by category. Show the catalog.
15
+ List Godpowers commands organized by family first, then by full catalog
16
+ category. Show the map without hiding any installed command.
16
17
 
17
18
  ## Output sections
18
19
 
@@ -23,11 +24,39 @@ One line summary of project state from `state.json`:
23
24
  ### 2. Suggested next
24
25
  The same suggestion `/god-next` would make. One command.
25
26
 
26
- ### 3. Catalog
27
+ ### 3. Command families
28
+ Load `<runtimeRoot>/lib/command-families.js` and render family cards before the
29
+ full catalog:
30
+
31
+ - Start: start or import a project.
32
+ - Continue: understand state and choose the next move.
33
+ - Build: plan, implement, test, and ship product work.
34
+ - Verify: check artifacts, code, runtime behavior, and release readiness.
35
+ - Operate: deploy, observe, harden, launch, and respond in production.
36
+ - Maintain: keep artifacts, docs, dependencies, context, and repo surfaces current.
37
+ - Capture: save thoughts, tasks, backlog items, seeds, and learnings.
38
+ - Recover: undo, repair, restore, skip, or diagnose broken state.
39
+ - Extend: install, inspect, test, remove, or author extension packs.
40
+ - Collaborate: coordinate people, workstreams, suites, sprints, and pull requests.
41
+ - Configure: tune settings, budgets, cache, profiles, help, and version info.
42
+
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`.
50
+
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`.
54
+
55
+ ### 6. Full catalog
27
56
  All installed skills grouped by category. Categories match
28
57
  `docs/reference.md` order.
29
58
 
30
- ### 4. Where to go for more
59
+ ### 7. Where to go for more
31
60
  - Full reference: https://github.com/aihxp/godpowers/blob/main/docs/reference.md
32
61
  - Concepts: https://github.com/aihxp/godpowers/blob/main/docs/concepts.md
33
62
  - Roadmap: https://github.com/aihxp/godpowers/blob/main/docs/ROADMAP.md
@@ -44,6 +73,11 @@ Description of one specific command (reads the skill's frontmatter description).
44
73
  ### `/god-help search <keyword>`
45
74
  Filter the catalog by keyword match against descriptions.
46
75
 
76
+ ### `/god-help <family>`
77
+ Show one family card plus its leaf commands. Valid families are start,
78
+ continue, build, verify, operate, maintain, capture, recover, extend,
79
+ collaborate, and configure.
80
+
47
81
  ### `/god-help --category=<name>`
48
82
  Show only one category (lifecycle, planning, building, shipping, etc.).
49
83
 
@@ -53,6 +87,7 @@ Built-in, no spawned agent. Reads:
53
87
  - `<runtime>/skills/*.md` frontmatter
54
88
  - `.godpowers/state.json` (for current state line)
55
89
  - `<runtimeRoot>/lib/recipes.js` (for suggested next)
90
+ - `<runtimeRoot>/lib/command-families.js` (for family cards and ladders)
56
91
 
57
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.
58
93
 
@@ -22,10 +22,12 @@ Before reading routing data or calling runtime modules, resolve the Godpowers ru
22
22
  1. If `<projectRoot>/lib/router.js` exists, use the repository checkout runtime at `<projectRoot>`.
23
23
  2. Otherwise use the installed bundle at `<tool-config-dir>/godpowers-runtime`, where `<tool-config-dir>` is the directory that contains this installed skill, such as `~/.claude`, `~/.codex`, `~/.cursor`, `~/.windsurf`, or `~/.gemini`.
24
24
  3. Read routing definitions from `<runtimeRoot>/routing/*.yaml` and recipes from `<runtimeRoot>/routing/recipes/*.yaml`.
25
- 4. For status output, load `<runtimeRoot>/lib/dashboard.js` and call
25
+ 4. Load `<runtimeRoot>/lib/command-families.js` for work size, verification,
26
+ capture, and trigger precedence hints.
27
+ 5. For status output, load `<runtimeRoot>/lib/dashboard.js` and call
26
28
  `dashboard.compute(projectRoot)`. Use `dashboard.render(result)` for the
27
29
  shared dashboard section before adding route-specific detail.
28
- 5. If the checkout runtime and installed runtime differ, say which runtime root
30
+ 6. If the checkout runtime and installed runtime differ, say which runtime root
29
31
  was used. Only call the output a manual disk scan when `lib/dashboard.js`
30
32
  cannot be loaded at all.
31
33
 
@@ -72,6 +74,11 @@ Get success-path.next-recommended (e.g., "/god-arch"), then apply any
72
74
  conditional-next rule such as UI-detected -> "/god-design"
73
75
  |
74
76
  v
77
+ Read success-path.outcome when present. Use it to label contextual,
78
+ verdict-based, steady-state, session-end, and selection outcomes before
79
+ showing allowed next commands.
80
+ |
81
+ v
75
82
  Display: "PRD complete: .godpowers/prd/PRD.md
76
83
  Suggested next: /god-arch (design the architecture)"
77
84
  ```
@@ -128,6 +135,16 @@ If prereqs missing and NOT auto-completable:
128
135
 
129
136
  ## Process for Mode 3 (standalone)
130
137
 
138
+ When the user asks a broad next-step question, use the family helpers before
139
+ falling back to raw route order:
140
+
141
+ - Capture intent routes through the capture ladder.
142
+ - Implementation intent routes through the work size ladder.
143
+ - Check or audit intent routes through the verification ladder.
144
+ - Duplicate trigger phrases use `resolveTrigger` so `continue`, `think through`,
145
+ `what happened`, `what's done`, and `where am i` pick the context-aware
146
+ command.
147
+
131
148
  ```
132
149
  User types: /god-next
133
150
  |
@@ -11,6 +11,19 @@ description: |
11
11
 
12
12
  Re-derive state from disk. Your memory is not authoritative. The file system is.
13
13
 
14
+ ## Status family views
15
+
16
+ `/god-status` is the hub for the continue family. It should render the overview
17
+ first, then offer direct shortcuts when the user wants a narrower view:
18
+
19
+ | View | Shortcut | Purpose |
20
+ |------|----------|---------|
21
+ | Overview | `/god-status` | Operational state, proactive checks, and blockers. |
22
+ | Progress ledger | `/god-progress` | Requirement and roadmap increment completion. |
23
+ | Lifecycle phase | `/god-lifecycle` | Project phase and fitting workflows. |
24
+ | Resume location | `/god-locate` | Orientation from checkpoint, handoff, and disk state. |
25
+ | Next action | `/god-next` | Single recommended command with reason. |
26
+
14
27
  ## Process
15
28
 
16
29
  1. Check if `.godpowers/PROGRESS.md` exists
@@ -93,7 +93,7 @@ Sync status:
93
93
  + source-sync: <written legacy planning/BMAD/Superpowers companion files, no-op, or skipped>
94
94
  + repo-doc-sync: <refreshed README badges/counts, recommended god-docs-writer, or no-op>
95
95
  + repo-surface-sync: <checked routes/package/agents/workflows/extensions, recommended scoped agents, or no-op>
96
- + route-quality-sync: <checked atomic spawns and contextual exits, no-op, or recommended god-auditor>
96
+ + route-quality-sync: <checked atomic spawns and typed route outcomes, no-op, or recommended god-auditor>
97
97
  + recipe-coverage-sync: <checked high-frequency intent recipes, no-op, or recommended god-roadmap-reconciler>
98
98
  + release-surface-sync: <checked badges/changelog/release/package guards, no-op, or recommended god-docs-writer>
99
99
  + pillars-sync: <updated N pillar files, no-op, or proposed>
@@ -14,9 +14,9 @@ Print version and a short capability summary.
14
14
  ## Output
15
15
 
16
16
  ```
17
- Godpowers v2.3.0
17
+ Godpowers v2.3.1
18
18
  Install: /Users/.../.claude/ (matches package.json)
19
- Surface: 111 skills, 40 agents, 13 workflows, 41 recipes
19
+ Surface: 112 skills, 40 agents, 13 workflows, 42 recipes
20
20
  Schema: intent.v1, state.v1, events.v1, workflow.v1, routing.v1, recipe.v1
21
21
  External integrations available: impeccable, agent-browser (others lazy)
22
22
  Feature awareness: planning-system migration, source-system sync-back, context refresh, dashboard status labels, repo documentation sync, repo surface sync, quick proof, request trace, release hardening, maintenance hardening
package/skills/god.md CHANGED
@@ -22,7 +22,7 @@ Before calling runtime modules, resolve the Godpowers runtime root:
22
22
 
23
23
  1. If `<projectRoot>/lib/recipes.js` exists, use the repository checkout runtime at `<projectRoot>`.
24
24
  2. Otherwise use the installed bundle at `<tool-config-dir>/godpowers-runtime`, where `<tool-config-dir>` is the directory that contains this installed skill, such as `~/.claude`, `~/.codex`, `~/.cursor`, `~/.windsurf`, or `~/.gemini`.
25
- 3. Load recipes from `<runtimeRoot>/lib/recipes.js`, routing from `<runtimeRoot>/lib/router.js`, and recipe YAML from `<runtimeRoot>/routing/recipes/`.
25
+ 3. Load recipes from `<runtimeRoot>/lib/recipes.js`, routing from `<runtimeRoot>/lib/router.js`, command families from `<runtimeRoot>/lib/command-families.js`, and recipe YAML from `<runtimeRoot>/routing/recipes/`.
26
26
 
27
27
  ## Why this exists
28
28
 
@@ -41,6 +41,57 @@ This skill complements `/god-next` rather than replacing it:
41
41
  | `/god-init` | "Start a project here" |
42
42
  | `/god-mode` | "Run the whole project run autonomously" |
43
43
 
44
+ ## Command family UX
45
+
46
+ Before showing individual leaf commands, use the family map from
47
+ `lib/command-families.js`:
48
+
49
+ | Family | User question |
50
+ |--------|---------------|
51
+ | start | "How do I begin or import this project?" |
52
+ | continue | "Where are we and what should happen next?" |
53
+ | build | "How big is this work and how should it run?" |
54
+ | verify | "What is the cheapest sufficient check?" |
55
+ | operate | "How do we run, observe, harden, or fix production?" |
56
+ | maintain | "How do we keep docs, deps, routes, and context current?" |
57
+ | capture | "Where should this thought, task, backlog item, or seed go?" |
58
+ | recover | "How do we repair or walk back state?" |
59
+ | extend | "How do we install or author skill packs?" |
60
+ | collaborate | "How do we coordinate people, workstreams, suites, or PRs?" |
61
+ | configure | "How do we tune settings, budgets, cache, profiles, or help?" |
62
+
63
+ Use the classifiers from `lib/command-families.js` when intent is about
64
+ capture, work size, verification, or duplicate trigger phrases. Keep every
65
+ leaf command available as a direct shortcut.
66
+
67
+ ### Capture ladder
68
+
69
+ - Save only: `/god-note`
70
+ - Actionable soon: `/god-add-todo`
71
+ - Optional later: `/god-add-backlog`
72
+ - Conditional future trigger: `/god-plant-seed`
73
+
74
+ ### Work size ladder
75
+
76
+ - Trivial direct edit: `/god-fast`
77
+ - Small TDD task: `/god-quick`
78
+ - Fine-grained planned slice: `/god-story`
79
+ - Existing-product feature: `/god-feature`
80
+ - Current milestone work: `/god-build`
81
+ - Non-urgent bug: `/god-debug`
82
+ - Production outage: `/god-hotfix`
83
+
84
+ ### Verification ladder
85
+
86
+ - Mechanical artifact check: `/god-lint`
87
+ - Artifact quality gate: `/god-standards`
88
+ - Code diff review: `/god-review`
89
+ - Live behavior check: `/god-test-runtime`
90
+ - Artifact set score: `/god-audit`
91
+ - Ongoing health check: `/god-hygiene`
92
+ - Existing repo intake: `/god-preflight`
93
+ - Release fixture readiness: `/god-dogfood`
94
+
44
95
  ## Process
45
96
 
46
97
  ### Step 1: parse the user's intent
@@ -64,6 +115,7 @@ text empty?
64
115
  also call <runtimeRoot>/lib/router.js suggestNext(projectRoot) for structural next
65
116
 
66
117
  no -> intent-driven: call <runtimeRoot>/lib/recipes.js matchIntent(text, projectRoot)
118
+ call <runtimeRoot>/lib/command-families.js classifiers for capture, work size, verification, and trigger precedence hints
67
119
  take top 1-3 matches by score
68
120
  if highest score >= 10 (exact phrase match): propose directly
69
121
  if highest score 5-9 (all-words match): propose with confirmation
@@ -160,13 +212,11 @@ any destructive sequence executes.
160
212
  ```
161
213
  User: /god production is broken
162
214
 
163
- Match: production-broken (score: 30)
164
- What this does: P0 incident response with rollback-first triage
215
+ Match: production-broken (score: 20)
216
+ What this does: Production is broken now
165
217
 
166
218
  Sequence:
167
- 1. /god-hotfix Spawn god-debugger for fast triage
168
- 2. /god-deploy Push the fix once green
169
- 3. /god-postmortem Schedule the incident review
219
+ 1. /god-hotfix Skip planning, debug, fix with TDD, expedited deploy, schedule postmortem
170
220
 
171
221
  Run this sequence? (yes / show others / cancel)
172
222
  ```
@@ -174,15 +224,14 @@ Run this sequence? (yes / show others / cancel)
174
224
  ### Example 2: ambiguous intent (multiple matches)
175
225
 
176
226
  ```
177
- User: /god add a new feature
227
+ User: /god parallel feature during build
178
228
 
179
- Top matches for "add a new feature":
229
+ Top matches for "parallel feature during build":
180
230
 
181
- 1. add-feature-mid-arc-pause (15) Pause /god-mode, run feature, resume
182
- 2. add-feature-small (10) Lightweight feature, no project-run context
183
- 3. add-feature-next-milestone (10) Defer to next milestone
231
+ 1. add-feature-mid-arc-pause (10) Bigger feature during the current project run; reconcile with roadmap, pause, do feature, update roadmap, resume
232
+ 2. add-feature-parallel (10) Parallel feature, do not disrupt main work
184
233
 
185
- Pick one (1/2/3) or describe more specifically.
234
+ Pick one (1/2) or describe more specifically.
186
235
  ```
187
236
 
188
237
  ### Example 3: state-driven (no text)
@@ -25,9 +25,9 @@ jobs:
25
25
  tier: 0
26
26
  needs: audit-score
27
27
  uses: god-orchestrator@^1.0.0
28
+ local-helper-groups:
29
+ - repo-maintenance-closeout
28
30
  local-helpers:
29
- - repo-doc-sync
30
- - repo-surface-sync
31
31
  - host-capabilities
32
32
  with:
33
33
  action: audit-closeout
@@ -133,13 +133,9 @@ jobs:
133
133
  tier: 0
134
134
  needs: launch
135
135
  uses: god-orchestrator@^1.0.0
136
- local-helpers:
137
- - feature-awareness
138
- - repo-doc-sync
139
- - repo-surface-sync
140
- - host-capabilities
141
- - checkpoint-sync
142
- - pillars-sync-plan
136
+ local-helper-groups:
137
+ - runtime-awareness-closeout
138
+ - standard-closeout
143
139
  with:
144
140
  action: final-sync
145
141
  dashboard: action-brief
@@ -89,14 +89,10 @@ jobs:
89
89
  tier: 0
90
90
  needs: steady-state-handoff
91
91
  uses: god-orchestrator@^1.0.0
92
- local-helpers:
93
- - feature-awareness
94
- - source-sync-back
95
- - repo-doc-sync
96
- - repo-surface-sync
97
- - host-capabilities
98
- - checkpoint-sync
99
- - pillars-sync-plan
92
+ local-helper-groups:
93
+ - runtime-awareness-closeout
94
+ - source-sync-closeout
95
+ - standard-closeout
100
96
  with:
101
97
  action: final-sync
102
98
  dashboard: action-brief
@@ -59,11 +59,8 @@ jobs:
59
59
  tier: 0
60
60
  needs: [deps-patch-batch, deps-minor-per-package, deps-major-handoff]
61
61
  uses: god-orchestrator@^1.0.0
62
- local-helpers:
63
- - repo-doc-sync
64
- - repo-surface-sync
65
- - checkpoint-sync
66
- - pillars-sync-plan
62
+ local-helper-groups:
63
+ - standard-closeout
67
64
  with:
68
65
  action: final-sync
69
66
  dashboard: action-brief
@@ -18,9 +18,9 @@ jobs:
18
18
  mechanical-doc-sync:
19
19
  tier: 0
20
20
  uses: god-orchestrator@^1.0.0
21
+ local-helper-groups:
22
+ - repo-maintenance-closeout
21
23
  local-helpers:
22
- - repo-doc-sync
23
- - repo-surface-sync
24
24
  - host-capabilities
25
25
  with:
26
26
  action: local-helper-sync