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.
- package/CHANGELOG.md +61 -0
- package/README.md +28 -16
- package/RELEASE.md +35 -27
- package/SKILL.md +26 -3
- package/agents/god-debugger.md +44 -8
- package/agents/god-executor.md +28 -0
- package/agents/god-quality-reviewer.md +23 -1
- package/agents/god-spec-reviewer.md +6 -0
- package/bin/install.js +6 -0
- package/lib/README.md +5 -2
- package/lib/agent-cache.js +25 -3
- package/lib/code-intelligence.js +161 -0
- package/lib/command-families.js +375 -0
- package/lib/dashboard.js +54 -20
- package/lib/extensions.js +6 -13
- package/lib/feature-awareness.js +2 -2
- package/lib/host-capabilities.js +4 -0
- package/lib/install-profiles.js +1 -0
- package/lib/planning-systems.js +7 -4
- package/lib/quick-proof.js +5 -2
- package/lib/release-surface-sync.js +4 -1
- package/lib/route-quality-sync.js +42 -12
- package/lib/router.js +32 -0
- package/lib/workflow-helper-groups.js +50 -0
- package/lib/workflow-runner.js +6 -1
- package/package.json +2 -2
- package/routing/god-add-backlog.yaml +1 -0
- package/routing/god-add-tests.yaml +1 -0
- package/routing/god-add-todo.yaml +1 -0
- package/routing/god-agent-audit.yaml +6 -0
- package/routing/god-arch.yaml +1 -0
- package/routing/god-archaeology.yaml +1 -0
- package/routing/god-audit.yaml +1 -0
- package/routing/god-automation-setup.yaml +1 -0
- package/routing/god-automation-status.yaml +1 -0
- package/routing/god-budget.yaml +6 -0
- package/routing/god-build-agent.yaml +1 -0
- package/routing/god-build.yaml +1 -0
- package/routing/god-cache-clear.yaml +6 -0
- package/routing/god-check-todos.yaml +6 -0
- package/routing/god-context-scan.yaml +6 -0
- package/routing/god-context.yaml +1 -0
- package/routing/god-cost.yaml +6 -0
- package/routing/god-debug.yaml +1 -0
- package/routing/god-deploy.yaml +1 -0
- package/routing/god-design-impact.yaml +6 -0
- package/routing/god-design.yaml +1 -0
- package/routing/god-discuss.yaml +12 -0
- package/routing/god-docs.yaml +1 -0
- package/routing/god-doctor.yaml +6 -0
- package/routing/god-dogfood.yaml +1 -0
- package/routing/god-explore.yaml +1 -0
- package/routing/god-export-otel.yaml +1 -0
- package/routing/god-extension-add.yaml +6 -0
- package/routing/god-extension-info.yaml +6 -0
- package/routing/god-extension-list.yaml +6 -0
- package/routing/god-extension-remove.yaml +6 -0
- package/routing/god-extension-scaffold.yaml +26 -0
- package/routing/god-extract-learnings.yaml +1 -0
- package/routing/god-fast.yaml +1 -0
- package/routing/god-feature.yaml +1 -0
- package/routing/god-graph.yaml +6 -0
- package/routing/god-harden.yaml +1 -0
- package/routing/god-help.yaml +6 -0
- package/routing/god-hotfix.yaml +1 -0
- package/routing/god-hygiene.yaml +1 -0
- package/routing/god-init.yaml +1 -0
- package/routing/god-intel.yaml +1 -0
- package/routing/god-launch.yaml +6 -0
- package/routing/god-lifecycle.yaml +12 -0
- package/routing/god-link.yaml +1 -0
- package/routing/god-lint.yaml +1 -0
- package/routing/god-list-assumptions.yaml +6 -0
- package/routing/god-locate.yaml +6 -0
- package/routing/god-logs.yaml +12 -0
- package/routing/god-map-codebase.yaml +1 -0
- package/routing/god-metrics.yaml +6 -0
- package/routing/god-migrate.yaml +1 -0
- package/routing/god-mode.yaml +6 -0
- package/routing/god-next.yaml +12 -0
- package/routing/god-note.yaml +1 -0
- package/routing/god-observe.yaml +1 -0
- package/routing/god-org-context.yaml +1 -0
- package/routing/god-party.yaml +1 -0
- package/routing/god-pause-work.yaml +6 -0
- package/routing/god-plant-seed.yaml +1 -0
- package/routing/god-postmortem.yaml +1 -0
- package/routing/god-pr-branch.yaml +1 -0
- package/routing/god-prd.yaml +1 -0
- package/routing/god-preflight.yaml +1 -0
- package/routing/god-progress.yaml +7 -0
- package/routing/god-quick.yaml +1 -0
- package/routing/god-reconcile.yaml +6 -0
- package/routing/god-reconstruct.yaml +1 -0
- package/routing/god-redo.yaml +6 -0
- package/routing/god-refactor.yaml +1 -0
- package/routing/god-repair.yaml +1 -0
- package/routing/god-repo.yaml +1 -0
- package/routing/god-restore.yaml +1 -0
- package/routing/god-resume-work.yaml +6 -0
- package/routing/god-review-changes.yaml +1 -0
- package/routing/god-review.yaml +1 -0
- package/routing/god-roadmap-check.yaml +6 -0
- package/routing/god-roadmap-update.yaml +1 -0
- package/routing/god-roadmap.yaml +1 -0
- package/routing/god-rollback.yaml +1 -0
- package/routing/god-scan.yaml +1 -0
- package/routing/god-set-profile.yaml +1 -0
- package/routing/god-settings.yaml +1 -0
- package/routing/god-skip.yaml +1 -0
- package/routing/god-smite.yaml +1 -0
- package/routing/god-spike.yaml +1 -0
- package/routing/god-sprint.yaml +6 -0
- package/routing/god-stack.yaml +2 -1
- package/routing/god-standards.yaml +1 -0
- package/routing/god-status.yaml +1 -0
- package/routing/god-stories.yaml +1 -0
- package/routing/god-story-build.yaml +1 -0
- package/routing/god-story-close.yaml +1 -0
- package/routing/god-story-verify.yaml +1 -0
- package/routing/god-story.yaml +1 -0
- package/routing/god-suite-init.yaml +1 -0
- package/routing/god-suite-patch.yaml +1 -0
- package/routing/god-suite-release.yaml +1 -0
- package/routing/god-suite-status.yaml +6 -0
- package/routing/god-suite-sync.yaml +1 -0
- package/routing/god-sync.yaml +1 -0
- package/routing/god-tech-debt.yaml +1 -0
- package/routing/god-test-extension.yaml +6 -0
- package/routing/god-test-runtime.yaml +1 -0
- package/routing/god-thread.yaml +6 -0
- package/routing/god-trace.yaml +6 -0
- package/routing/god-undo.yaml +1 -0
- package/routing/god-update-deps.yaml +1 -0
- package/routing/god-upgrade.yaml +1 -0
- package/routing/god-version.yaml +1 -0
- package/routing/god-workstream.yaml +6 -0
- package/routing/god.yaml +6 -0
- package/routing/recipes/add-feature-mid-arc-pause.yaml +6 -0
- package/routing/recipes/brownfield-onboarding.yaml +5 -2
- package/routing/recipes/extension-authoring.yaml +32 -0
- package/routing/recipes/greenfield-fast.yaml +3 -0
- package/routing/recipes/production-broken.yaml +4 -0
- package/routing/recipes/release-maintenance.yaml +3 -0
- package/routing/recipes/returning-after-break.yaml +3 -0
- package/routing/recipes/weekly-health-check.yaml +2 -0
- package/schema/routing.v1.json +62 -4
- package/schema/workflow.v1.json +14 -0
- package/skills/god-discuss.md +10 -5
- package/skills/god-doctor.md +9 -3
- package/skills/god-extension-scaffold.md +66 -0
- package/skills/god-help.md +38 -3
- package/skills/god-next.md +19 -2
- package/skills/god-status.md +13 -0
- package/skills/god-sync.md +1 -1
- package/skills/god-version.md +2 -2
- package/skills/god.md +61 -12
- package/workflows/audit-only.yaml +2 -2
- package/workflows/bluefield-arc.yaml +3 -7
- package/workflows/brownfield-arc.yaml +4 -8
- package/workflows/deps-audit.yaml +2 -5
- package/workflows/docs-arc.yaml +2 -2
- package/workflows/feature-arc.yaml +3 -6
- package/workflows/full-arc.yaml +5 -11
- package/workflows/hotfix-arc.yaml +3 -6
- package/workflows/hygiene.yaml +2 -2
- package/workflows/migration-arc.yaml +3 -5
- package/workflows/postmortem.yaml +2 -5
- package/workflows/refactor-arc.yaml +3 -6
package/schema/routing.v1.json
CHANGED
|
@@ -20,9 +20,29 @@
|
|
|
20
20
|
"properties": {
|
|
21
21
|
"command": {
|
|
22
22
|
"type": "string",
|
|
23
|
-
"pattern": "^/god
|
|
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": "
|
|
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
|
|
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
|
|
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
|
}
|
package/schema/workflow.v1.json
CHANGED
|
@@ -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" },
|
package/skills/god-discuss.md
CHANGED
|
@@ -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.
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
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
|
package/skills/god-doctor.md
CHANGED
|
@@ -48,9 +48,9 @@ Plain-text report grouped by severity:
|
|
|
48
48
|
GODPOWERS DOCTOR
|
|
49
49
|
|
|
50
50
|
Install: claude (~/.claude/)
|
|
51
|
-
[OK]
|
|
51
|
+
[OK] 112 skills installed
|
|
52
52
|
[OK] 40 agents installed
|
|
53
|
-
[OK] VERSION matches (2.3.
|
|
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
|
|
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
|
package/skills/god-help.md
CHANGED
|
@@ -12,7 +12,8 @@ description: |
|
|
|
12
12
|
|
|
13
13
|
# /god-help
|
|
14
14
|
|
|
15
|
-
List Godpowers commands organized by
|
|
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.
|
|
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
|
-
###
|
|
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
|
|
package/skills/god-next.md
CHANGED
|
@@ -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.
|
|
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
|
-
|
|
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
|
|
|
package/skills/god-status.md
CHANGED
|
@@ -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
|
package/skills/god-sync.md
CHANGED
|
@@ -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
|
|
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>
|
package/skills/god-version.md
CHANGED
|
@@ -14,9 +14,9 @@ Print version and a short capability summary.
|
|
|
14
14
|
## Output
|
|
15
15
|
|
|
16
16
|
```
|
|
17
|
-
Godpowers v2.3.
|
|
17
|
+
Godpowers v2.3.1
|
|
18
18
|
Install: /Users/.../.claude/ (matches package.json)
|
|
19
|
-
Surface:
|
|
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:
|
|
164
|
-
What this does:
|
|
215
|
+
Match: production-broken (score: 20)
|
|
216
|
+
What this does: Production is broken now
|
|
165
217
|
|
|
166
218
|
Sequence:
|
|
167
|
-
1. /god-hotfix
|
|
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
|
|
227
|
+
User: /god parallel feature during build
|
|
178
228
|
|
|
179
|
-
Top matches for "
|
|
229
|
+
Top matches for "parallel feature during build":
|
|
180
230
|
|
|
181
|
-
1. add-feature-mid-arc-pause (
|
|
182
|
-
2. add-feature-
|
|
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
|
|
234
|
+
Pick one (1/2) or describe more specifically.
|
|
186
235
|
```
|
|
187
236
|
|
|
188
237
|
### Example 3: state-driven (no text)
|
|
@@ -133,13 +133,9 @@ jobs:
|
|
|
133
133
|
tier: 0
|
|
134
134
|
needs: launch
|
|
135
135
|
uses: god-orchestrator@^1.0.0
|
|
136
|
-
local-
|
|
137
|
-
-
|
|
138
|
-
-
|
|
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-
|
|
93
|
-
-
|
|
94
|
-
- source-sync-
|
|
95
|
-
-
|
|
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-
|
|
63
|
-
-
|
|
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
|
package/workflows/docs-arc.yaml
CHANGED