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.
- package/CHANGELOG.md +46 -3
- package/README.md +28 -24
- package/RELEASE.md +31 -50
- package/SKILL.md +75 -113
- package/agents/god-archaeologist.md +11 -0
- package/agents/god-architect.md +12 -0
- package/agents/god-auditor.md +13 -0
- package/agents/god-automation-engineer.md +13 -0
- package/agents/god-browser-tester.md +15 -0
- package/agents/god-context-writer.md +14 -0
- package/agents/god-coordinator.md +14 -0
- package/agents/god-debt-assessor.md +11 -0
- package/agents/god-debugger.md +13 -0
- package/agents/god-deploy-engineer.md +13 -0
- package/agents/god-deps-auditor.md +13 -0
- package/agents/god-design-reviewer.md +14 -0
- package/agents/god-designer.md +15 -0
- package/agents/god-docs-writer.md +13 -0
- package/agents/god-executor.md +14 -0
- package/agents/god-explorer.md +14 -0
- package/agents/god-greenfieldifier.md +13 -0
- package/agents/god-harden-auditor.md +12 -0
- package/agents/god-incident-investigator.md +13 -0
- package/agents/god-launch-strategist.md +14 -0
- package/agents/god-migration-strategist.md +13 -0
- package/agents/god-observability-engineer.md +14 -0
- package/agents/god-orchestrator.md +16 -2
- package/agents/god-org-context-loader.md +11 -0
- package/agents/god-planner.md +11 -0
- package/agents/god-pm.md +14 -0
- package/agents/god-quality-reviewer.md +12 -0
- package/agents/god-reconciler.md +14 -1
- package/agents/god-reconstructor.md +16 -0
- package/agents/god-repo-scaffolder.md +11 -0
- package/agents/god-retrospective.md +11 -0
- package/agents/god-roadmap-reconciler.md +42 -87
- package/agents/god-roadmap-updater.md +11 -0
- package/agents/god-roadmapper.md +12 -0
- package/agents/god-spec-reviewer.md +14 -0
- package/agents/god-spike-runner.md +13 -0
- package/agents/god-stack-selector.md +12 -0
- package/agents/god-standards-check.md +13 -0
- package/agents/god-storyteller.md +14 -0
- package/agents/god-updater.md +14 -0
- package/bin/install.js +10 -0
- package/lib/README.md +4 -0
- package/lib/agent-validator.js +67 -2
- package/lib/cli-dispatch.js +40 -1
- package/lib/command-families.js +10 -2
- package/lib/install-profiles.js +4 -1
- package/lib/installer-args.js +22 -0
- package/lib/recipe-coverage-sync.js +1 -1
- package/lib/release-surface-sync.js +3 -0
- package/lib/repo-doc-sync.js +1 -1
- package/lib/repo-surface-sync.js +3 -3
- package/lib/route-quality-sync.js +2 -2
- package/lib/router.js +6 -0
- package/lib/surface-profile.js +168 -0
- package/package.json +2 -2
- package/references/orchestration/GOD-MODE-RUNBOOK.md +9 -14
- package/references/orchestration/GOD-ORCHESTRATOR-RUNBOOK.md +43 -81
- package/references/shared/DASHBOARD-CONTRACT.md +66 -29
- package/references/shared/README.md +1 -1
- package/routing/god-demo.yaml +35 -0
- package/routing/god-first-run.yaml +34 -0
- package/routing/god-roadmap-check.yaml +2 -2
- package/routing/god-surface.yaml +39 -0
- package/routing/recipes/try-safely.yaml +26 -0
- package/skills/god-agent-audit.md +17 -15
- package/skills/god-arch.md +1 -3
- package/skills/god-archaeology.md +5 -6
- package/skills/god-audit.md +6 -7
- package/skills/god-automation-setup.md +6 -7
- package/skills/god-automation-status.md +6 -7
- package/skills/god-build.md +1 -3
- package/skills/god-context-scan.md +7 -8
- package/skills/god-demo.md +53 -0
- package/skills/god-deploy.md +1 -3
- package/skills/god-design-impact.md +5 -6
- package/skills/god-design.md +9 -3
- package/skills/god-discuss.md +5 -6
- package/skills/god-docs.md +5 -10
- package/skills/god-doctor.md +8 -9
- package/skills/god-dogfood.md +7 -10
- package/skills/god-explore.md +5 -7
- package/skills/god-feature.md +1 -3
- package/skills/god-first-run.md +64 -0
- package/skills/god-harden.md +1 -3
- package/skills/god-help.md +77 -51
- package/skills/god-hotfix.md +1 -3
- package/skills/god-hygiene.md +5 -6
- package/skills/god-launch.md +1 -3
- package/skills/god-lifecycle.md +11 -13
- package/skills/god-link.md +1 -3
- package/skills/god-list-assumptions.md +7 -8
- package/skills/god-locate.md +7 -8
- package/skills/god-map-codebase.md +5 -6
- package/skills/god-migrate.md +7 -18
- package/skills/god-mode.md +5 -0
- package/skills/god-next.md +16 -17
- package/skills/god-observe.md +1 -3
- package/skills/god-prd.md +1 -3
- package/skills/god-preflight.md +7 -8
- package/skills/god-progress.md +7 -8
- package/skills/god-reconcile.md +9 -10
- package/skills/god-reconstruct.md +5 -7
- package/skills/god-redo.md +1 -3
- package/skills/god-refactor.md +7 -10
- package/skills/god-repair.md +1 -3
- package/skills/god-repo.md +1 -3
- package/skills/god-restore.md +1 -3
- package/skills/god-roadmap-check.md +10 -10
- package/skills/god-roadmap.md +1 -3
- package/skills/god-rollback.md +1 -3
- package/skills/god-scan.md +6 -12
- package/skills/god-skip.md +1 -3
- package/skills/god-spike.md +5 -6
- package/skills/god-stack.md +1 -3
- package/skills/god-standards.md +5 -6
- package/skills/god-status.md +12 -10
- package/skills/god-story-build.md +1 -3
- package/skills/god-story-close.md +1 -3
- package/skills/god-story.md +1 -3
- package/skills/god-surface.md +61 -0
- package/skills/god-sync.md +7 -13
- package/skills/god-tech-debt.md +5 -6
- package/skills/god-test-runtime.md +4 -8
- package/skills/god-undo.md +1 -3
- package/skills/god-update-deps.md +1 -3
- package/skills/god-upgrade.md +1 -3
- package/skills/god-version.md +1 -1
- package/skills/god.md +53 -52
package/skills/god-prd.md
CHANGED
|
@@ -82,6 +82,4 @@ The reflog records every god-prd invocation as `op:god-prd` for `/god-undo`.
|
|
|
82
82
|
for `/god-repair` review. Re-running picks up cleanly.
|
|
83
83
|
|
|
84
84
|
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
85
|
+
Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
package/skills/god-preflight.md
CHANGED
|
@@ -137,18 +137,17 @@ Use the report to choose the next pass:
|
|
|
137
137
|
| Tests are absent before refactor | `/god-add-tests` |
|
|
138
138
|
| Refactor path is obvious and bounded | `/god-refactor` |
|
|
139
139
|
|
|
140
|
-
##
|
|
140
|
+
## Next Commands Closeout
|
|
141
141
|
|
|
142
|
-
End the user-facing response with a
|
|
142
|
+
End the user-facing response with a Next commands block based on the recommended
|
|
143
143
|
sequence:
|
|
144
144
|
|
|
145
145
|
```
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
Recommended: [first command and why it should happen before the rest]
|
|
146
|
+
Next commands:
|
|
147
|
+
- /god-next: Run the first recommended command from the preflight result.
|
|
148
|
+
- /god-mode: Continue the full recommended sequence when preflight is clear.
|
|
149
|
+
- /god-discuss [highest uncertainty or blocker]: Resolve the open question before continuing.
|
|
150
|
+
- /god-mode only when the preflight says the repo is ready or the remaining gaps are acceptable: Run the full autonomous project workflow when it fits.
|
|
152
151
|
```
|
|
153
152
|
|
|
154
153
|
## Guardrails
|
package/skills/god-progress.md
CHANGED
|
@@ -78,17 +78,16 @@ Open the full checklist any time: .godpowers/REQUIREMENTS.md
|
|
|
78
78
|
Use plain text. No emoji, no box-drawing. Ledger marks are `[x]` done, `[~]`
|
|
79
79
|
in progress, `[ ]` not started, matching the ledger file.
|
|
80
80
|
|
|
81
|
-
##
|
|
81
|
+
## Next Commands Closeout
|
|
82
82
|
|
|
83
|
-
End every progress report with a
|
|
83
|
+
End every progress report with a Next commands block:
|
|
84
84
|
|
|
85
85
|
```text
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
Recommended: [one option and one sentence on why it fits the disk state]
|
|
86
|
+
Next commands:
|
|
87
|
+
- /god-build: Continue the next build step when the roadmap is unblocked.
|
|
88
|
+
- /god-mode: Continue the project run when the current phase is safe to resume.
|
|
89
|
+
- /god-status --full: Inspect the complete dashboard and proactive checks.
|
|
90
|
+
- /god-discuss <blocked requirement>: Resolve a gap before continuing.
|
|
92
91
|
```
|
|
93
92
|
|
|
94
93
|
If `derived.gaps` is non-empty, make `/god-review-changes` (or fixing the gap)
|
package/skills/god-reconcile.md
CHANGED
|
@@ -83,12 +83,11 @@ Recommended sequence:
|
|
|
83
83
|
Main work: [/god-feature scoped to Milestone 2]
|
|
84
84
|
Post-work: [/god-sync]
|
|
85
85
|
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
Recommended: [one option and why]
|
|
86
|
+
Next commands:
|
|
87
|
+
- /god-next: Run only the first preflight command.
|
|
88
|
+
- /god-sync: Run the full recommended sync sequence after reconciliation.
|
|
89
|
+
- /god-discuss [ambiguous overlap or artifact conflict]: Resolve the open question before continuing.
|
|
90
|
+
- stop: Leave artifacts unchanged.
|
|
92
91
|
```
|
|
93
92
|
|
|
94
93
|
## Difference from /god-roadmap-check
|
|
@@ -97,8 +96,8 @@ Recommended: [one option and why]
|
|
|
97
96
|
|---|---|---|
|
|
98
97
|
| Scope | ROADMAP only | Core artifacts plus runtime and repository surfaces |
|
|
99
98
|
| Use | Quick check | Comprehensive |
|
|
100
|
-
| Auto-invoked |
|
|
101
|
-
| Replaces |
|
|
99
|
+
| Auto-invoked | legacy compatibility only | by feature-addition recipes |
|
|
100
|
+
| Replaces | delegated to /god-reconcile | primary command |
|
|
102
101
|
|
|
103
|
-
For new projects,
|
|
104
|
-
|
|
102
|
+
For new projects, use /god-reconcile. /god-roadmap-check remains a
|
|
103
|
+
compatibility alias that asks `god-reconciler` for ROADMAP-focused output.
|
|
@@ -59,13 +59,11 @@ Suggested next:
|
|
|
59
59
|
/god-feature - now you can add features with reconciliation
|
|
60
60
|
/god-tech-debt - assess what needs paying down
|
|
61
61
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
Recommended: /god-audit before new feature work because reconstruction is
|
|
68
|
-
evidence-derived, not stakeholder-approved.
|
|
62
|
+
Next commands:
|
|
63
|
+
- /god-audit the reconstructed artifacts first: Run the smallest safe next step.
|
|
64
|
+
- /god-audit then /god-feature with reconciliation: Run the full recommended path.
|
|
65
|
+
- /god-discuss stakeholder review questions: Resolve the open question before continuing.
|
|
66
|
+
- /god-mode after stakeholder review or audit accepts the reconstruction: Run the full autonomous project workflow when it fits.
|
|
69
67
|
```
|
|
70
68
|
|
|
71
69
|
## Caveats
|
package/skills/god-redo.md
CHANGED
|
@@ -57,6 +57,4 @@ that originally produced the artifact. Updates the linkage map via
|
|
|
57
57
|
`/god-scan` after the artifact is rewritten.
|
|
58
58
|
|
|
59
59
|
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
60
|
+
Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
package/skills/god-refactor.md
CHANGED
|
@@ -92,18 +92,17 @@ Suggested next: /god-status or continue with /god-feature
|
|
|
92
92
|
|
|
93
93
|
When the user asks for a proposal, recommendation, or performance-improvement
|
|
94
94
|
approach and no files are edited, do not stop after the advice. End with a
|
|
95
|
-
|
|
95
|
+
Next commands block that turns the recommendation into user-selectable next
|
|
96
96
|
moves.
|
|
97
97
|
|
|
98
98
|
Use this shape:
|
|
99
99
|
|
|
100
100
|
```
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
Recommended: <one option and why>
|
|
101
|
+
Next commands:
|
|
102
|
+
- /god-spike <measurement or smallest safe slice>: Run the smallest safe next step.
|
|
103
|
+
- /god-refactor <full scoped refactor>: Run the full recommended path.
|
|
104
|
+
- /god-discuss <unresolved scope question>: Resolve the open question before continuing.
|
|
105
|
+
- /god-mode <scope> if the user wants the full autonomous project run: Run the full autonomous project workflow when it fits.
|
|
107
106
|
```
|
|
108
107
|
|
|
109
108
|
For performance refactors, prefer partial implementation when measurement is
|
|
@@ -144,6 +143,4 @@ in the linkage system:
|
|
|
144
143
|
via `/god-review-changes`.
|
|
145
144
|
|
|
146
145
|
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
146
|
+
Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
package/skills/god-repair.md
CHANGED
|
@@ -66,6 +66,4 @@ Built-in. Reads + writes:
|
|
|
66
66
|
Calls into `lib/drift-detector.js`, `lib/code-scanner.js`, `lib/reverse-sync.js`.
|
|
67
67
|
|
|
68
68
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
69
|
+
Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
package/skills/god-repo.md
CHANGED
|
@@ -34,6 +34,4 @@ Suggested next: /god-build (start building the first milestone)
|
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
37
|
+
Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
package/skills/god-restore.md
CHANGED
|
@@ -75,6 +75,4 @@ files back via standard fs operations. Calls `/god-scan` after restore
|
|
|
75
75
|
to refresh linkage map.
|
|
76
76
|
|
|
77
77
|
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
78
|
+
Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
@@ -18,12 +18,13 @@ description: |
|
|
|
18
18
|
Deprecated: prefer `/god-reconcile` for new workflows. This command remains in
|
|
19
19
|
the full profile for backward compatibility with existing route references.
|
|
20
20
|
|
|
21
|
-
Reconcile intent against ROADMAP.md before adding work.
|
|
21
|
+
Reconcile intent against ROADMAP.md before adding work. This legacy command
|
|
22
|
+
delegates to `god-reconciler` with ROADMAP-focused output.
|
|
22
23
|
|
|
23
24
|
## Setup
|
|
24
25
|
|
|
25
26
|
1. Verify `.godpowers/roadmap/ROADMAP.md` exists. If not: nothing to reconcile against; suggest /god-roadmap or /god-feature directly.
|
|
26
|
-
2. Spawn god-
|
|
27
|
+
2. Spawn `god-reconciler` with the user's intent description and ask for ROADMAP-focused output.
|
|
27
28
|
|
|
28
29
|
## Output
|
|
29
30
|
|
|
@@ -59,19 +60,18 @@ For each status, the recommendation differs:
|
|
|
59
60
|
|
|
60
61
|
## Verification
|
|
61
62
|
|
|
62
|
-
After god-
|
|
63
|
+
After `god-reconciler` returns:
|
|
63
64
|
1. Verify the verdict has a status from the canonical 6
|
|
64
65
|
2. Verify recommendation has a concrete action
|
|
65
66
|
3. Display to user; await decision before proceeding
|
|
66
|
-
4. End with a
|
|
67
|
+
4. End with a Next commands block:
|
|
67
68
|
|
|
68
69
|
```
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
Recommended: [one option and why]
|
|
70
|
+
Next commands:
|
|
71
|
+
- /god-roadmap-update: Apply the smallest roadmap correction from the recommendation.
|
|
72
|
+
- /god-feature <feature-name>: Start feature work after roadmap overlap is clear.
|
|
73
|
+
- /god-discuss roadmap overlap: Resolve the open question before continuing.
|
|
74
|
+
- /god-add-backlog [intent]: Defer the work for later review.
|
|
75
75
|
```
|
|
76
76
|
|
|
77
77
|
## When called manually
|
package/skills/god-roadmap.md
CHANGED
|
@@ -62,6 +62,4 @@ The reflog records every god-roadmap invocation as `op:god-roadmap` for `/god-un
|
|
|
62
62
|
for `/god-repair` review. Re-running picks up cleanly.
|
|
63
63
|
|
|
64
64
|
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
65
|
+
Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
package/skills/god-rollback.md
CHANGED
|
@@ -72,6 +72,4 @@ Writes via `lib/reverse-sync.js` (for linkage truncation) and standard
|
|
|
72
72
|
fs operations (for artifact move).
|
|
73
73
|
|
|
74
74
|
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
75
|
+
Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
package/skills/god-scan.md
CHANGED
|
@@ -17,19 +17,15 @@ god-build, god-feature, god-hotfix etc. trigger automatically (per
|
|
|
17
17
|
Phase 7 workflow integration). Useful when you want to refresh state
|
|
18
18
|
between automatic triggers, or after manual code edits.
|
|
19
19
|
|
|
20
|
-
Because `/god-scan` calls the local reverse-sync runtime directly,
|
|
21
|
-
|
|
20
|
+
Because `/god-scan` calls the local reverse-sync runtime directly, keep the
|
|
21
|
+
default message concise:
|
|
22
22
|
|
|
23
23
|
```
|
|
24
|
-
|
|
25
|
-
Trigger: /god-scan
|
|
26
|
-
Agent: none, local runtime only
|
|
27
|
-
Local syncs:
|
|
28
|
-
+ reverse-sync: pending
|
|
29
|
-
Artifacts: pending
|
|
30
|
-
Log: REVIEW-REQUIRED.md if drift is found
|
|
24
|
+
Scanning code links and drift. Review items will be written to REVIEW-REQUIRED.md if found.
|
|
31
25
|
```
|
|
32
26
|
|
|
27
|
+
Use a detailed `Auto-invoked:` card only with `--verbose` or debugging.
|
|
28
|
+
|
|
33
29
|
## Forms
|
|
34
30
|
|
|
35
31
|
| Form | Action |
|
|
@@ -114,6 +110,4 @@ User content outside fences is never modified.
|
|
|
114
110
|
```
|
|
115
111
|
|
|
116
112
|
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
113
|
+
Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
package/skills/god-skip.md
CHANGED
|
@@ -62,6 +62,4 @@ Reverse a previous skip. Marks the sub-step `pending` again.
|
|
|
62
62
|
Built-in. Reads and writes `state.json`, regenerates the managed progress view, and appends to reflog.
|
|
63
63
|
|
|
64
64
|
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
65
|
+
Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
package/skills/god-spike.md
CHANGED
|
@@ -84,12 +84,11 @@ Suggested next:
|
|
|
84
84
|
- If rejecting: archive .godpowers/spikes/<question-slug>/
|
|
85
85
|
- If unclear: /god-spike with narrower question
|
|
86
86
|
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
Recommended: proceed only when SPIKE.md has a clear DECISION and evidence.
|
|
87
|
+
Next commands:
|
|
88
|
+
- /god-feature for the smallest proven slice: Run the smallest safe next step.
|
|
89
|
+
- /god-feature with the full recommendation: Run the full recommended path.
|
|
90
|
+
- /god-discuss the remaining uncertainty: Resolve the open question before continuing.
|
|
91
|
+
- /god-mode only if this spike unblocks the full project run: Run the full autonomous project workflow when it fits.
|
|
93
92
|
|
|
94
93
|
REMINDER: spike code is throwaway. Do NOT merge to main.
|
|
95
94
|
```
|
package/skills/god-stack.md
CHANGED
|
@@ -59,6 +59,4 @@ The reflog records every god-stack invocation as `op:god-stack` for `/god-undo`.
|
|
|
59
59
|
for `/god-repair` review. Re-running picks up cleanly.
|
|
60
60
|
|
|
61
61
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
62
|
+
Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
package/skills/god-standards.md
CHANGED
|
@@ -55,12 +55,11 @@ Suggested next:
|
|
|
55
55
|
/god-redo prd to address failures with feedback
|
|
56
56
|
/god-skip prd --reason "..." to accept-as-is
|
|
57
57
|
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
Recommended: [one option and why]
|
|
58
|
+
Next commands:
|
|
59
|
+
- /god-redo [tier] with the listed failures: Run the smallest safe next step.
|
|
60
|
+
- /god-standards [tier]: Re-run the standards gate after fixing all failures.
|
|
61
|
+
- /god-discuss standards failure: Resolve the open question before continuing.
|
|
62
|
+
- /god-skip [tier] --reason "..." only with an explicit reason: Skip only with an explicit reason.
|
|
64
63
|
```
|
|
65
64
|
|
|
66
65
|
## Auto-invocation
|
package/skills/god-status.md
CHANGED
|
@@ -20,6 +20,7 @@ proactive checks, blockers, planning visibility, and the next action first.
|
|
|
20
20
|
| View | Shortcut | Purpose |
|
|
21
21
|
|------|----------|---------|
|
|
22
22
|
| Overview | `/god-status` | Operational state, proactive checks, and blockers. |
|
|
23
|
+
| Full dashboard | `/god-status --full` | Complete dashboard and every proactive check. |
|
|
23
24
|
| Progress ledger | `/god-progress` | Requirement and roadmap increment completion. |
|
|
24
25
|
| Lifecycle phase | `/god-status --lifecycle` | Project phase and fitting workflows. |
|
|
25
26
|
| Resume location | `/god-status --locate` | Orientation from checkpoint, handoff, and disk state. |
|
|
@@ -33,20 +34,21 @@ aliases for one minor release. New workflows should use `/god-status
|
|
|
33
34
|
|
|
34
35
|
1. Check whether `.godpowers/state.json` exists. If it does not, treat `.godpowers/PROGRESS.md` only as a generated legacy fallback; if neither exists, report that no Godpowers project was found and suggest `/god-init`.
|
|
35
36
|
2. Resolve the runtime root and load `<runtimeRoot>/lib/dashboard.js`.
|
|
36
|
-
3. Call `dashboard.compute(projectRoot)` and render
|
|
37
|
+
3. Call `dashboard.compute(projectRoot)` and render the compact action brief by default.
|
|
37
38
|
4. Prefer the MCP `status` tool when it is available, and fall back to the CLI or runtime module when it is not.
|
|
38
|
-
5. If `--
|
|
39
|
-
6. If `--
|
|
40
|
-
7.
|
|
41
|
-
8.
|
|
42
|
-
9.
|
|
43
|
-
10.
|
|
39
|
+
5. If `--full` is present, render the complete dashboard with all proactive checks.
|
|
40
|
+
6. If `--lifecycle` is present, emphasize lifecycle phase, fitting workflows, PRD visibility, roadmap visibility, and the next route.
|
|
41
|
+
7. If `--locate` is present, emphasize CHECKPOINT.md, HANDOFF.md, recent events, current step, and the next route.
|
|
42
|
+
8. Use `.godpowers/PROGRESS.md` only as generated fallback or legacy explanation when state.json is missing.
|
|
43
|
+
9. Scan canonical artifact paths for PRD, design, architecture, roadmap, stack, repo, build, deploy, observe, launch, harden, sync, checkpoint, and requirements evidence.
|
|
44
|
+
10. Compare disk state to recorded state and flag phantom resume or untracked work.
|
|
45
|
+
11. Offer `/god-repair` when recorded state and disk evidence conflict.
|
|
44
46
|
|
|
45
47
|
## Required reference
|
|
46
48
|
|
|
47
|
-
Read `<runtimeRoot>/references/shared/DASHBOARD-CONTRACT.md` before rendering output. The shared contract owns the dashboard shape, proactive labels, and
|
|
49
|
+
Read `<runtimeRoot>/references/shared/DASHBOARD-CONTRACT.md` before rendering output. The shared contract owns the compact status shape, full dashboard shape, proactive labels, and `Next commands:` block.
|
|
48
50
|
|
|
49
|
-
If the runtime module is unavailable,
|
|
51
|
+
If the runtime module is unavailable, use a manual scan quietly and suggest `/god-doctor` only when the fallback changes the recommendation.
|
|
50
52
|
|
|
51
53
|
Never mix workflow progress with audit, hygiene, remediation, or launch-readiness scores. Label those scores separately when they appear.
|
|
52
54
|
|
|
@@ -54,7 +56,7 @@ Never mix workflow progress with audit, hygiene, remediation, or launch-readines
|
|
|
54
56
|
|
|
55
57
|
`/god-status` is read-only by default. It suggests Level 3 agents instead of spawning them unless the user asked status to continue work.
|
|
56
58
|
|
|
57
|
-
Report checkpoint, review, sync, docs, repo surface, host, runtime, automation, security, dependency, and hygiene signals
|
|
59
|
+
Report checkpoint, review, sync, docs, repo surface, host, runtime, automation, security, dependency, and hygiene signals only when they affect the recommendation. `/god-status --full` shows every label from the shared dashboard contract.
|
|
58
60
|
|
|
59
61
|
## Mode D awareness
|
|
60
62
|
|
|
@@ -60,6 +60,4 @@ Reverse-sync writes Implementation Linkage footer to ROADMAP.md
|
|
|
60
60
|
still fires)
|
|
61
61
|
|
|
62
62
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
63
|
+
Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
@@ -66,6 +66,4 @@ linkage updates.
|
|
|
66
66
|
- Trigger any other workflow automatically
|
|
67
67
|
|
|
68
68
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
69
|
+
Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
package/skills/god-story.md
CHANGED
|
@@ -39,6 +39,4 @@ Add a new story under `.godpowers/stories/<feature-slug>/`.
|
|
|
39
39
|
- `/god-stories` to see all stories
|
|
40
40
|
|
|
41
41
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
42
|
+
Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: god-surface
|
|
3
|
+
description: |
|
|
4
|
+
Preview or apply a runtime command surface profile after install. Lets users
|
|
5
|
+
switch between core, builder, maintainer, suite, and full without reinstalling
|
|
6
|
+
from scratch.
|
|
7
|
+
|
|
8
|
+
Triggers on: "god surface", "/god-surface", "switch command surface",
|
|
9
|
+
"change profile", "show fewer commands"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# /god-surface
|
|
13
|
+
|
|
14
|
+
Preview or apply a runtime command surface profile after install. Use the
|
|
15
|
+
existing installer profiles: `core`, `builder`, `maintainer`, `suite`, and
|
|
16
|
+
`full`.
|
|
17
|
+
|
|
18
|
+
## Process
|
|
19
|
+
|
|
20
|
+
1. Resolve `<runtimeRoot>/lib/surface-profile.js`.
|
|
21
|
+
2. Default to dry-run preview.
|
|
22
|
+
3. Require an explicit runtime target such as `--codex`, `--claude`,
|
|
23
|
+
`--runtime=codex`, or `--all` before applying.
|
|
24
|
+
4. Apply only when the user passes `--apply`.
|
|
25
|
+
5. End with `Next commands:`.
|
|
26
|
+
|
|
27
|
+
## Examples
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
/god-surface --profile=core --dry-run
|
|
31
|
+
/god-surface --profile=builder --runtime=codex --dry-run
|
|
32
|
+
/god-surface --profile=maintainer --runtime=claude --apply
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Terminal equivalent:
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
npx godpowers surface --profile=builder --codex --global --dry-run
|
|
39
|
+
npx godpowers surface --profile=builder --codex --global --apply
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## Output Shape
|
|
43
|
+
|
|
44
|
+
```text
|
|
45
|
+
The builder profile would install the product-building command surface for Codex.
|
|
46
|
+
|
|
47
|
+
Attention:
|
|
48
|
+
- Dry-run only. No installed skills changed.
|
|
49
|
+
|
|
50
|
+
Next commands:
|
|
51
|
+
- /god-surface --profile=builder --runtime=codex --apply: Apply the previewed Codex surface.
|
|
52
|
+
- /god-help: Open the compact help view after switching.
|
|
53
|
+
- /god-help all: Show the complete catalog.
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
## Rules
|
|
57
|
+
|
|
58
|
+
- Do not apply a profile unless the user explicitly asks with `--apply`.
|
|
59
|
+
- Do not change project `.godpowers/` state.
|
|
60
|
+
- Do not invent new profile names.
|
|
61
|
+
- Keep the profile source of truth in `<runtimeRoot>/lib/install-profiles.js`.
|
package/skills/god-sync.md
CHANGED
|
@@ -43,7 +43,7 @@ User runs `/god-sync` after manual changes. Useful for:
|
|
|
43
43
|
payload, agent handoffs, workflow metadata, recipe routes, extension packs,
|
|
44
44
|
route quality, recipe coverage, release surfaces, and release policy are
|
|
45
45
|
checked before sync closes. Structural drift should recommend scoped agents
|
|
46
|
-
such as `god-auditor`, `god-
|
|
46
|
+
such as `god-auditor`, `god-reconciler`, `god-coordinator`, or
|
|
47
47
|
`god-docs-writer`.
|
|
48
48
|
6. If repo documentation changed durable project truth, plan or apply Pillars
|
|
49
49
|
updates through `lib/pillars.planArtifactSync` or
|
|
@@ -57,18 +57,14 @@ User runs `/god-sync` after manual changes. Useful for:
|
|
|
57
57
|
- Or: re-run reconciliation against current state to detect what changed
|
|
58
58
|
- Recent commits for context
|
|
59
59
|
|
|
60
|
-
Before spawning, show a
|
|
60
|
+
Before spawning, show a concise sync note:
|
|
61
61
|
|
|
62
62
|
```
|
|
63
|
-
|
|
64
|
-
Trigger: <manual /god-sync, recipe closeout, /god-mode final sync, or other source>
|
|
65
|
-
Agent: god-updater
|
|
66
|
-
Local syncs:
|
|
67
|
-
- pending: feature-awareness, reverse-sync, source-sync, repo-doc-sync, repo-surface-sync, route-quality-sync, recipe-coverage-sync, release-surface-sync, pillars-sync, checkpoint-sync, context-refresh
|
|
68
|
-
Artifacts: pending
|
|
69
|
-
Log: .godpowers/SYNC-LOG.md
|
|
63
|
+
Syncing project artifacts after this workflow. Details will be written to .godpowers/SYNC-LOG.md.
|
|
70
64
|
```
|
|
71
65
|
|
|
66
|
+
Use the detailed helper list only with `--verbose` or release-gate debugging.
|
|
67
|
+
|
|
72
68
|
## Verification
|
|
73
69
|
|
|
74
70
|
After god-updater returns:
|
|
@@ -94,7 +90,7 @@ Sync status:
|
|
|
94
90
|
+ repo-doc-sync: <refreshed README badges/counts, recommended god-docs-writer, or no-op>
|
|
95
91
|
+ repo-surface-sync: <checked routes/package/agents/workflows/extensions, recommended scoped agents, or no-op>
|
|
96
92
|
+ route-quality-sync: <checked atomic spawns and typed route outcomes, no-op, or recommended god-auditor>
|
|
97
|
-
+ recipe-coverage-sync: <checked high-frequency intent recipes, no-op, or recommended god-
|
|
93
|
+
+ recipe-coverage-sync: <checked high-frequency intent recipes, no-op, or recommended god-reconciler>
|
|
98
94
|
+ release-surface-sync: <checked badges/changelog/release/package guards, no-op, or recommended god-docs-writer>
|
|
99
95
|
+ pillars-sync: <updated N pillar files, no-op, or proposed>
|
|
100
96
|
+ checkpoint-sync: <CHECKPOINT.md updated or skipped>
|
|
@@ -154,6 +150,4 @@ Both bookends run automatically in feature-addition recipes. Both can be
|
|
|
154
150
|
invoked manually for spot-checks.
|
|
155
151
|
|
|
156
152
|
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
153
|
+
Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
package/skills/god-tech-debt.md
CHANGED
|
@@ -54,11 +54,10 @@ Suggested next:
|
|
|
54
54
|
- /god-upgrade for major-version migrations
|
|
55
55
|
- Re-run /god-tech-debt quarterly
|
|
56
56
|
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
Recommended: start with the top P0 item, then re-run /god-tech-debt after it
|
|
57
|
+
Next commands:
|
|
58
|
+
- /god-refactor <top-p0-item>: Address the highest-priority debt item first.
|
|
59
|
+
- /god-feature or /god-refactor for the full P0 bundle: Run the full recommended path.
|
|
60
|
+
- /god-discuss the highest-cost or highest-risk debt item: Resolve the open question before continuing.
|
|
61
|
+
- /god-mode only if debt work should join the full project run: Run the full autonomous project workflow when it fits.
|
|
63
62
|
lands.
|
|
64
63
|
```
|
|
@@ -110,18 +110,14 @@ missing. If only a local URL is evidenced, run local verification and defer
|
|
|
110
110
|
deployed staging verification until the user provides
|
|
111
111
|
`STAGING_APP_URL=<deployed staging origin>` or reaches final sign-off.
|
|
112
112
|
|
|
113
|
-
When auto-invoked, show:
|
|
113
|
+
When auto-invoked, show a concise default note:
|
|
114
114
|
|
|
115
115
|
```text
|
|
116
|
-
|
|
117
|
-
Trigger: frontend-visible files changed and URL was evidenced
|
|
118
|
-
Agent: god-browser-tester
|
|
119
|
-
Local syncs:
|
|
120
|
-
+ runtime-verification: <audit | test | full pipeline>
|
|
121
|
-
Artifacts: .godpowers/runtime/<run-id>/
|
|
122
|
-
Log: .godpowers/runtime/<run-id>/summary.md
|
|
116
|
+
Verified the evidenced runtime target. Details were written to .godpowers/runtime/<run-id>/summary.md.
|
|
123
117
|
```
|
|
124
118
|
|
|
119
|
+
Use a detailed `Auto-invoked:` card only with `--verbose` or debugging.
|
|
120
|
+
|
|
125
121
|
## Output to events.jsonl
|
|
126
122
|
|
|
127
123
|
```json
|
package/skills/god-undo.md
CHANGED
|
@@ -120,6 +120,4 @@ in the linkage system:
|
|
|
120
120
|
via `/god-review-changes`.
|
|
121
121
|
|
|
122
122
|
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
|
123
|
+
Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
|
package/skills/god-upgrade.md
CHANGED
|
@@ -123,6 +123,4 @@ in the linkage system:
|
|
|
123
123
|
via `/god-review-changes`.
|
|
124
124
|
|
|
125
125
|
|
|
126
|
-
|
|
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.
|
package/skills/god-version.md
CHANGED
|
@@ -16,7 +16,7 @@ Print version and a short capability summary.
|
|
|
16
16
|
```
|
|
17
17
|
Godpowers v2.3.1
|
|
18
18
|
Install: /Users/.../.claude/ (matches package.json)
|
|
19
|
-
Surface:
|
|
19
|
+
Surface: 120 skills, 40 agents, 13 workflows, 43 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
|