godpowers 3.0.0 → 3.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (132) hide show
  1. package/CHANGELOG.md +46 -3
  2. package/README.md +28 -24
  3. package/RELEASE.md +31 -50
  4. package/SKILL.md +75 -113
  5. package/agents/god-archaeologist.md +11 -0
  6. package/agents/god-architect.md +12 -0
  7. package/agents/god-auditor.md +13 -0
  8. package/agents/god-automation-engineer.md +13 -0
  9. package/agents/god-browser-tester.md +15 -0
  10. package/agents/god-context-writer.md +14 -0
  11. package/agents/god-coordinator.md +14 -0
  12. package/agents/god-debt-assessor.md +11 -0
  13. package/agents/god-debugger.md +13 -0
  14. package/agents/god-deploy-engineer.md +13 -0
  15. package/agents/god-deps-auditor.md +13 -0
  16. package/agents/god-design-reviewer.md +14 -0
  17. package/agents/god-designer.md +15 -0
  18. package/agents/god-docs-writer.md +13 -0
  19. package/agents/god-executor.md +14 -0
  20. package/agents/god-explorer.md +14 -0
  21. package/agents/god-greenfieldifier.md +13 -0
  22. package/agents/god-harden-auditor.md +12 -0
  23. package/agents/god-incident-investigator.md +13 -0
  24. package/agents/god-launch-strategist.md +14 -0
  25. package/agents/god-migration-strategist.md +13 -0
  26. package/agents/god-observability-engineer.md +14 -0
  27. package/agents/god-orchestrator.md +16 -2
  28. package/agents/god-org-context-loader.md +11 -0
  29. package/agents/god-planner.md +11 -0
  30. package/agents/god-pm.md +14 -0
  31. package/agents/god-quality-reviewer.md +12 -0
  32. package/agents/god-reconciler.md +14 -1
  33. package/agents/god-reconstructor.md +16 -0
  34. package/agents/god-repo-scaffolder.md +11 -0
  35. package/agents/god-retrospective.md +11 -0
  36. package/agents/god-roadmap-reconciler.md +42 -87
  37. package/agents/god-roadmap-updater.md +11 -0
  38. package/agents/god-roadmapper.md +12 -0
  39. package/agents/god-spec-reviewer.md +14 -0
  40. package/agents/god-spike-runner.md +13 -0
  41. package/agents/god-stack-selector.md +12 -0
  42. package/agents/god-standards-check.md +13 -0
  43. package/agents/god-storyteller.md +14 -0
  44. package/agents/god-updater.md +14 -0
  45. package/bin/install.js +10 -0
  46. package/lib/README.md +4 -0
  47. package/lib/agent-validator.js +67 -2
  48. package/lib/cli-dispatch.js +40 -1
  49. package/lib/command-families.js +10 -2
  50. package/lib/install-profiles.js +4 -1
  51. package/lib/installer-args.js +22 -0
  52. package/lib/recipe-coverage-sync.js +1 -1
  53. package/lib/release-surface-sync.js +3 -0
  54. package/lib/repo-doc-sync.js +1 -1
  55. package/lib/repo-surface-sync.js +3 -3
  56. package/lib/route-quality-sync.js +2 -2
  57. package/lib/router.js +6 -0
  58. package/lib/surface-profile.js +168 -0
  59. package/package.json +2 -2
  60. package/references/orchestration/GOD-MODE-RUNBOOK.md +9 -14
  61. package/references/orchestration/GOD-ORCHESTRATOR-RUNBOOK.md +43 -81
  62. package/references/shared/DASHBOARD-CONTRACT.md +66 -29
  63. package/references/shared/README.md +1 -1
  64. package/routing/god-demo.yaml +35 -0
  65. package/routing/god-first-run.yaml +34 -0
  66. package/routing/god-roadmap-check.yaml +2 -2
  67. package/routing/god-surface.yaml +39 -0
  68. package/routing/recipes/try-safely.yaml +26 -0
  69. package/skills/god-agent-audit.md +17 -15
  70. package/skills/god-arch.md +1 -3
  71. package/skills/god-archaeology.md +5 -6
  72. package/skills/god-audit.md +6 -7
  73. package/skills/god-automation-setup.md +6 -7
  74. package/skills/god-automation-status.md +6 -7
  75. package/skills/god-build.md +1 -3
  76. package/skills/god-context-scan.md +7 -8
  77. package/skills/god-demo.md +53 -0
  78. package/skills/god-deploy.md +1 -3
  79. package/skills/god-design-impact.md +5 -6
  80. package/skills/god-design.md +9 -3
  81. package/skills/god-discuss.md +5 -6
  82. package/skills/god-docs.md +5 -10
  83. package/skills/god-doctor.md +8 -9
  84. package/skills/god-dogfood.md +7 -10
  85. package/skills/god-explore.md +5 -7
  86. package/skills/god-feature.md +1 -3
  87. package/skills/god-first-run.md +64 -0
  88. package/skills/god-harden.md +1 -3
  89. package/skills/god-help.md +77 -51
  90. package/skills/god-hotfix.md +1 -3
  91. package/skills/god-hygiene.md +5 -6
  92. package/skills/god-launch.md +1 -3
  93. package/skills/god-lifecycle.md +11 -13
  94. package/skills/god-link.md +1 -3
  95. package/skills/god-list-assumptions.md +7 -8
  96. package/skills/god-locate.md +7 -8
  97. package/skills/god-map-codebase.md +5 -6
  98. package/skills/god-migrate.md +7 -18
  99. package/skills/god-mode.md +5 -0
  100. package/skills/god-next.md +16 -17
  101. package/skills/god-observe.md +1 -3
  102. package/skills/god-prd.md +1 -3
  103. package/skills/god-preflight.md +7 -8
  104. package/skills/god-progress.md +7 -8
  105. package/skills/god-reconcile.md +9 -10
  106. package/skills/god-reconstruct.md +5 -7
  107. package/skills/god-redo.md +1 -3
  108. package/skills/god-refactor.md +7 -10
  109. package/skills/god-repair.md +1 -3
  110. package/skills/god-repo.md +1 -3
  111. package/skills/god-restore.md +1 -3
  112. package/skills/god-roadmap-check.md +10 -10
  113. package/skills/god-roadmap.md +1 -3
  114. package/skills/god-rollback.md +1 -3
  115. package/skills/god-scan.md +6 -12
  116. package/skills/god-skip.md +1 -3
  117. package/skills/god-spike.md +5 -6
  118. package/skills/god-stack.md +1 -3
  119. package/skills/god-standards.md +5 -6
  120. package/skills/god-status.md +12 -10
  121. package/skills/god-story-build.md +1 -3
  122. package/skills/god-story-close.md +1 -3
  123. package/skills/god-story.md +1 -3
  124. package/skills/god-surface.md +61 -0
  125. package/skills/god-sync.md +7 -13
  126. package/skills/god-tech-debt.md +5 -6
  127. package/skills/god-test-runtime.md +4 -8
  128. package/skills/god-undo.md +1 -3
  129. package/skills/god-update-deps.md +1 -3
  130. package/skills/god-upgrade.md +1 -3
  131. package/skills/god-version.md +1 -1
  132. package/skills/god.md +53 -52
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
- ## Locking
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.
@@ -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
- ## Proposition Closeout
140
+ ## Next Commands Closeout
141
141
 
142
- End the user-facing response with a proposition block based on the recommended
142
+ End the user-facing response with a Next commands block based on the recommended
143
143
  sequence:
144
144
 
145
145
  ```
146
- Proposition:
147
- 1. Implement partial: [first recommended command or task]
148
- 2. Implement complete: [full recommended sequence]
149
- 3. Discuss more: /god-discuss [highest uncertainty or blocker]
150
- 4. Run God Mode: /god-mode only when the preflight says the repo is ready or the remaining gaps are acceptable
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
@@ -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
- ## Proposition Closeout
81
+ ## Next Commands Closeout
82
82
 
83
- End every progress report with a proposition block:
83
+ End every progress report with a Next commands block:
84
84
 
85
85
  ```text
86
- Proposition:
87
- 1. Implement partial: [single next command, e.g. /god-build]
88
- 2. Implement complete: /god-mode to continue the project run when unblocked
89
- 3. Inspect deeper: open .godpowers/REQUIREMENTS.md or run /god-status
90
- 4. Discuss more: /god-discuss [a gap, a blocked requirement, or scope]
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)
@@ -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
- Proposition:
87
- 1. Implement partial: [run only the first preflight command]
88
- 2. Implement complete: [run the full recommended sequence]
89
- 3. Discuss more: /god-discuss [ambiguous overlap or artifact conflict]
90
- 4. Cancel: leave artifacts unchanged
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 | by feature-addition recipes (legacy) | by feature-addition recipes (preferred) |
101
- | Replaces | -- | /god-roadmap-check (kept for back-compat) |
99
+ | Auto-invoked | legacy compatibility only | by feature-addition recipes |
100
+ | Replaces | delegated to /god-reconcile | primary command |
102
101
 
103
- For new projects, prefer /god-reconcile. /god-roadmap-check remains a
104
- narrower tool for when you only care about milestone overlap.
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
- Proposition:
63
- 1. Implement partial: /god-audit the reconstructed artifacts first
64
- 2. Implement complete: /god-audit then /god-feature with reconciliation
65
- 3. Discuss more: /god-discuss stakeholder review questions
66
- 4. Run God Mode: /god-mode after stakeholder review or audit accepts the reconstruction
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
@@ -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
- ## Locking
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.
@@ -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
- proposition block that turns the recommendation into user-selectable next
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
- Proposition:
102
- 1. Implement partial: /god-spike <measurement or smallest safe slice>
103
- 2. Implement complete: /god-refactor <full scoped refactor>
104
- 3. Discuss more: /god-discuss <unresolved scope question>
105
- 4. Run God Mode: /god-mode <scope> if the user wants the full autonomous project run
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
- ## Locking
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.
@@ -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
- ## Locking
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.
@@ -34,6 +34,4 @@ Suggested next: /god-build (start building the first milestone)
34
34
  ```
35
35
 
36
36
 
37
- ## Locking
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.
@@ -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
- ## Locking
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-roadmap-reconciler with the user's intent description and the roadmap path.
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-roadmap-reconciler returns:
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 proposition block:
67
+ 4. End with a Next commands block:
67
68
 
68
69
  ```
69
- Proposition:
70
- 1. Implement partial: [smallest command from the recommendation]
71
- 2. Implement complete: [roadmap update plus feature work when needed]
72
- 3. Discuss more: /god-discuss roadmap overlap
73
- 4. Defer: /god-add-backlog [intent]
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
@@ -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
- ## Locking
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.
@@ -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
- ## Locking
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.
@@ -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, it must be
21
- explicit when no agent is spawned:
20
+ Because `/god-scan` calls the local reverse-sync runtime directly, keep the
21
+ default message concise:
22
22
 
23
23
  ```
24
- Auto-invoked:
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
- ## Locking
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.
@@ -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
- ## Locking
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.
@@ -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
- Proposition:
88
- 1. Implement partial: /god-feature for the smallest proven slice
89
- 2. Implement complete: /god-feature with the full recommendation
90
- 3. Discuss more: /god-discuss the remaining uncertainty
91
- 4. Run God Mode: /god-mode only if this spike unblocks the full project run
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
  ```
@@ -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
- ## Locking
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.
@@ -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
- Proposition:
59
- 1. Implement partial: /god-redo [tier] with the listed failures
60
- 2. Implement complete: fix all failures, rerun /god-standards, then continue the gate
61
- 3. Discuss more: /god-discuss standards failure
62
- 4. Skip: /god-skip [tier] --reason "..." only with an explicit reason
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
@@ -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 with `dashboard.render(result)`.
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 `--lifecycle` is present, emphasize lifecycle phase, fitting workflows, PRD visibility, roadmap visibility, and the next route.
39
- 6. If `--locate` is present, emphasize CHECKPOINT.md, HANDOFF.md, recent events, current step, and the next route.
40
- 7. Use `.godpowers/PROGRESS.md` only as generated fallback or legacy explanation when state.json is missing.
41
- 8. Scan canonical artifact paths for PRD, design, architecture, roadmap, stack, repo, build, deploy, observe, launch, harden, sync, checkpoint, and requirements evidence.
42
- 9. Compare disk state to recorded state and flag phantom resume or untracked work.
43
- 10. Offer `/god-repair` when recorded state and disk evidence conflict.
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 proposition block.
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, fall back to a manual scan and say `Dashboard engine: unavailable, manual scan used`.
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 using the labels in the shared dashboard contract.
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
- ## Locking
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
- ## Locking
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.
@@ -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
- ## Locking
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`.
@@ -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-roadmap-reconciler`, `god-coordinator`, or
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 visible auto-invoke card:
60
+ Before spawning, show a concise sync note:
61
61
 
62
62
  ```
63
- Auto-invoked:
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-roadmap-reconciler>
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
- ## Locking
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.
@@ -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
- Proposition:
58
- 1. Implement partial: run the command for the top P0 item only
59
- 2. Implement complete: /god-feature or /god-refactor for the full P0 bundle
60
- 3. Discuss more: /god-discuss the highest-cost or highest-risk debt item
61
- 4. Run God Mode: /god-mode only if debt work should join the full project run
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
- Auto-invoked:
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
@@ -52,6 +52,4 @@ Suggested next:
52
52
  ```
53
53
 
54
54
 
55
- ## Locking
56
-
57
- See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
55
+ Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
@@ -120,6 +120,4 @@ in the linkage system:
120
120
  via `/god-review-changes`.
121
121
 
122
122
 
123
- ## Locking
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.
@@ -123,6 +123,4 @@ in the linkage system:
123
123
  via `/god-review-changes`.
124
124
 
125
125
 
126
- ## Locking
127
-
128
- See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
126
+ Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
@@ -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: 117 skills, 40 agents, 13 workflows, 42 recipes
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