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
@@ -1,16 +1,52 @@
1
1
  # Godpowers Dashboard Contract
2
2
 
3
- This reference owns the shared dashboard shape for `/god-status`, `/god-next`, `/god-mode` closeouts, and completed command closeouts.
3
+ This reference owns the shared closeout shape for `/god-status`, `/god-next`,
4
+ `/god-mode` closeouts, and completed command closeouts.
4
5
 
5
- ## Runtime source
6
+ ## Runtime Source
6
7
 
7
- Prefer `lib/dashboard.js` for dashboard computation. Call `dashboard.compute(projectRoot)`, then render with `dashboard.render(result)` unless the caller needs a narrower brief view.
8
+ Prefer `lib/dashboard.js` for status computation. Call
9
+ `dashboard.compute(projectRoot)`, then render a compact action brief unless the
10
+ user asks for `/god-status --full` or passes a verbose flag.
8
11
 
9
- If the runtime module is unavailable, use a manual disk scan and say `Dashboard engine: unavailable, manual scan used`.
12
+ If the runtime module is unavailable, use a manual disk scan quietly. Mention
13
+ the fallback only when it changes the recommendation, then suggest
14
+ `/god-doctor`.
10
15
 
11
- Never mix workflow progress with audit, hygiene, remediation, or launch-readiness scores. Label those scores separately when they appear.
16
+ Never mix workflow progress with audit, hygiene, remediation, or
17
+ launch-readiness scores. Label those scores separately when they appear.
12
18
 
13
- ## Required shape
19
+ ## Default Closeout
20
+
21
+ Completed work, proposals, diagnostics, lifecycle views, and status summaries
22
+ use this shape by default:
23
+
24
+ ```text
25
+ <one sentence describing the result or current position>
26
+
27
+ Changed:
28
+ - <highest-signal user-visible change>
29
+ - <highest-signal user-visible change>
30
+
31
+ Validation:
32
+ - <command>: <result>
33
+
34
+ Attention:
35
+ - <only blockers or signals that change the recommendation>
36
+
37
+ Next commands:
38
+ - <recommended command>: <one sentence reason>
39
+ - /god-status --full: See the complete dashboard and proactive checks.
40
+ ```
41
+
42
+ Omit empty sections. Do not render rows that only say `fresh`, `clear`,
43
+ `none`, or `not-applicable`.
44
+
45
+ ## Full Dashboard
46
+
47
+ The full dashboard is available on request through `/god-status --full` and in
48
+ release-gate evidence. It may also appear when a user explicitly asks for all
49
+ status details.
14
50
 
15
51
  ```text
16
52
  Godpowers Dashboard
@@ -43,13 +79,6 @@ Deliverable progress:
43
79
  Increments: <done> done, <building> building, <pending> pending
44
80
  Ledger: .godpowers/REQUIREMENTS.md
45
81
 
46
- What changed:
47
- 1. <highest-signal user-visible change>
48
- 2. <highest-signal user-visible change>
49
-
50
- Validation:
51
- + <command>: <result>
52
-
53
82
  Proactive checks:
54
83
  Checkpoint: <fresh | refreshed | missing | stale | conflicts with state.json>
55
84
  Reviews: <none | N pending, suggest /god-review-changes>
@@ -57,7 +86,7 @@ Proactive checks:
57
86
  Docs: <fresh | N stale, suggest /god-docs | repo-doc-sync ran>
58
87
  Repo surface: <fresh | N stale, suggest /god-doctor | repo-surface-sync ran>
59
88
  Host: <full | degraded | unknown with host and first gap>
60
- Runtime: <not-applicable | known URL, suggest /god-test-runtime | no known URL, defer deployed verification>
89
+ Runtime: <not-applicable | known URL, suggest /god-test-runtime | no known URL>
61
90
  Automation: <not configured | N active | available via provider, suggest /god-automation-setup>
62
91
  Security: <clear | sensitive files changed, suggest /god-harden>
63
92
  Dependencies: <clear | dependency files changed, suggest /god-update-deps>
@@ -66,28 +95,36 @@ Proactive checks:
66
95
  Open items:
67
96
  1. <deferred staging, unstaged files, pending review, blocker, or none>
68
97
 
69
- Next:
70
- Recommended: <one concrete command or user decision>
71
- Why: <one sentence tied to current state>
98
+ Next commands:
99
+ - <recommended command>: <one sentence reason>
100
+ - /god-next: Recompute the state-derived next step.
72
101
  ```
73
102
 
74
- ## Proposition closeout
103
+ ## Next Commands
75
104
 
76
- When a command only recommends work, end with this proposition block unless it already launched the selected command.
105
+ When a command only recommends work, end with this block unless it already
106
+ launched the selected command.
77
107
 
78
108
  ```text
79
- Proposition:
80
- 1. Implement partial: <single suggested command>
81
- 2. Implement complete: <recipe sequence or /god-mode when safe>
82
- 3. Discuss more: /god-discuss <routing ambiguity or missing prerequisite>
83
- 4. Inspect status: /god-status, /god-locate, or /god-next
84
- Recommended: <one option and why>
109
+ Next commands:
110
+ - <best runnable command>: <plain sentence reason>
111
+ - <second runnable command>: <plain sentence reason>
112
+ - <third runnable command>: <plain sentence reason>
85
113
  ```
86
114
 
87
- ## Proactive rules
115
+ Use 1 to 4 commands. Put the recommendation first. Do not show abstract
116
+ implementation choices when a slash command can name the next move.
117
+
118
+ ## Proactive Rules
88
119
 
89
- `/god-status` is read-only by default, so Level 3 agent work becomes a suggestion unless the user asked it to continue work.
120
+ `/god-status` is read-only by default, so Level 3 agent work becomes a
121
+ suggestion unless the user asked it to continue work.
90
122
 
91
- `/god-next` may run Level 2 local helpers only when there is a direct trigger. Standalone `/god-next` turns Level 3 work into the recommended command or a proposition option.
123
+ `/god-next` may run Level 1 read-only checks by default. It may run Level 2
124
+ local helpers only when there is a direct trigger and no destructive effect.
125
+ Standalone `/god-next` turns Level 3 work into the recommended command.
92
126
 
93
- Report checkpoint, review, sync, docs, repo surface, host, runtime, automation, security, dependency, and hygiene signals using the labels in the required shape.
127
+ Report checkpoint, review, sync, docs, repo surface, host, runtime, automation,
128
+ security, dependency, and hygiene signals using the labels in the full
129
+ dashboard only when they affect the recommendation or the user asks for full
130
+ status.
@@ -8,7 +8,7 @@ Cross-tier reference content used by multiple agents.
8
8
  - [ORCHESTRATORS.md](ORCHESTRATORS.md): composition patterns with other AI
9
9
  coding workflow systems, including migration and managed sync-back.
10
10
  - [GLOSSARY.md](GLOSSARY.md): standardized vocabulary across tiers.
11
- - [DASHBOARD-CONTRACT.md](DASHBOARD-CONTRACT.md): shared dashboard and proposition output contract.
11
+ - [DASHBOARD-CONTRACT.md](DASHBOARD-CONTRACT.md): shared dashboard and `Next commands:` output contract.
12
12
  - [LOCKING.md](LOCKING.md): shared state-lock contract for mutating commands.
13
13
 
14
14
  ## Planned content
@@ -0,0 +1,35 @@
1
+ apiVersion: godpowers/v1
2
+ kind: CommandRouting
3
+ metadata:
4
+ command: /god-demo
5
+ description: Safe sandbox proof
6
+ tier: 0
7
+ family: start
8
+
9
+ prerequisites:
10
+ required:
11
+ []
12
+
13
+ execution:
14
+ spawns: [built-in]
15
+ context: fresh
16
+ reads:
17
+ - fixtures/quick-proof/project/.godpowers/state.json
18
+ - fixtures/quick-proof/manifest.json
19
+ writes:
20
+ []
21
+
22
+ success-path:
23
+ next-recommended: /god-first-run
24
+ outcome:
25
+ type: deterministic
26
+ label: Sandbox proof rendered
27
+ reason: The shipped quick-proof fixture can be inspected without modifying the project.
28
+ allowed-next: [/god-first-run, /god-init, /god-status]
29
+
30
+ failure-path:
31
+ on-error: /god-doctor
32
+
33
+ endoff:
34
+ state-update: tier-0 updated for /god-demo
35
+ events: [agent.start, agent.end]
@@ -0,0 +1,34 @@
1
+ apiVersion: godpowers/v1
2
+ kind: CommandRouting
3
+ metadata:
4
+ command: /god-first-run
5
+ description: Guided first 10 minute onboarding
6
+ tier: 0
7
+ family: start
8
+
9
+ prerequisites:
10
+ required:
11
+ []
12
+
13
+ execution:
14
+ spawns: [built-in]
15
+ context: fresh
16
+ reads:
17
+ - .godpowers/state.json
18
+ writes:
19
+ []
20
+
21
+ success-path:
22
+ next-recommended: varies
23
+ outcome:
24
+ type: contextual
25
+ label: Context-specific next route
26
+ reason: The next route depends on whether Godpowers state exists.
27
+ allowed-next: [/god-demo, /god-init, /god-next, /god-help]
28
+
29
+ failure-path:
30
+ on-error: /god-doctor
31
+
32
+ endoff:
33
+ state-update: tier-0 updated for /god-first-run
34
+ events: [agent.start, agent.end]
@@ -2,7 +2,7 @@ apiVersion: godpowers/v1
2
2
  kind: CommandRouting
3
3
  metadata:
4
4
  command: /god-roadmap-check
5
- description: Reconcile intent against ROADMAP.md before feature work
5
+ description: Legacy roadmap-only alias for /god-reconcile
6
6
  tier: 1
7
7
  family: compatibility
8
8
 
@@ -13,7 +13,7 @@ prerequisites:
13
13
  human-required: true
14
14
 
15
15
  execution:
16
- spawns: [god-roadmap-reconciler]
16
+ spawns: [god-reconciler]
17
17
  context: fresh
18
18
  reads:
19
19
  - .godpowers/roadmap/ROADMAP.md
@@ -0,0 +1,39 @@
1
+ apiVersion: godpowers/v1
2
+ kind: CommandRouting
3
+ metadata:
4
+ command: /god-surface
5
+ description: Runtime command surface profile switcher
6
+ tier: 0
7
+ family: configure
8
+
9
+ prerequisites:
10
+ required:
11
+ []
12
+
13
+ execution:
14
+ spawns: [built-in]
15
+ context: fresh
16
+ reads:
17
+ - lib/install-profiles.js
18
+ - lib/surface-profile.js
19
+ writes:
20
+ - <runtime>/GODPOWERS_PROFILE when --apply is used
21
+ - <runtime>/skills/ when --apply is used
22
+
23
+ standards:
24
+ gate-on-failure: pause-for-user
25
+
26
+ success-path:
27
+ next-recommended: /god-help
28
+ outcome:
29
+ type: deterministic
30
+ label: Surface profile previewed or applied
31
+ reason: The selected install profile controls which slash commands are visible in the target runtime.
32
+ allowed-next: [/god-help, /god-help all, /god-status]
33
+
34
+ failure-path:
35
+ on-error: /god-doctor
36
+
37
+ endoff:
38
+ state-update: tier-0 updated for /god-surface
39
+ events: [agent.start, agent.end]
@@ -0,0 +1,26 @@
1
+ apiVersion: godpowers/v1
2
+ kind: Recipe
3
+ metadata:
4
+ name: try-safely
5
+ category: starting
6
+ description: "Try Godpowers in a safe sandbox before touching the repo"
7
+
8
+ triggers:
9
+ intent-keywords:
10
+ - "try safely"
11
+ - "safe demo"
12
+ - "show me a demo"
13
+ - "sandbox"
14
+ - "proof before setup"
15
+ - "first run demo"
16
+
17
+ sequences:
18
+ default:
19
+ description: "Try Godpowers in a safe sandbox before touching the repo"
20
+ steps:
21
+ - command: "/god-demo"
22
+ why: "Runs the shipped sandbox proof without modifying the current project"
23
+ - command: "/god-first-run"
24
+ why: "Continues with guided onboarding after the proof"
25
+
26
+ default-sequence: default
@@ -2,10 +2,10 @@
2
2
  name: god-agent-audit
3
3
  description: |
4
4
  Validates every `agents/god-*.md` against the agent contract:
5
- required frontmatter, recommended sections (Have-Nots, Inputs,
6
- Outputs, Handoff), hand-off targets exist, no dual-ownership of
7
- output paths. Lenient by design: most issues are warnings; only
8
- structural breakage errors.
5
+ required frontmatter, structured contract frontmatter, recommended
6
+ sections (Have-Nots, Inputs, Outputs, Handoff), hand-off targets exist,
7
+ no dual-ownership of output paths. Lenient by design: most issues are
8
+ warnings; only structural breakage errors.
9
9
 
10
10
  Triggers on: "god agent audit", "/god-agent-audit", "audit agents",
11
11
  "validate agent contracts"
@@ -32,6 +32,7 @@ Mechanical validation of agent contracts. Backed by `lib/agent-validator.js`.
32
32
 
33
33
  **Recommended (warnings)**:
34
34
  - Frontmatter `tools` field
35
+ - Frontmatter `inputs`, `outputs`, `gates`, and `handoff` fields after at least 20 shipped agents have structured contracts
35
36
  - Hand-off targets that are referenced exist as agent files
36
37
  - Output paths claimed by 4+ agents (boundary review needed)
37
38
 
@@ -51,24 +52,23 @@ opportunities, not failures.
51
52
  Agent audit
52
53
 
53
54
  40 agents audited
54
- 0 errors, 2 warnings, 90 infos
55
+ 40 structured contracts
56
+ 0 errors, 1 warning, 97 infos
55
57
 
56
58
  Errors:
57
59
  (none)
58
60
 
59
61
  Warnings:
60
- [multi-ownership] STATE.md claimed by 4 agents (verify boundaries)
61
- [multi-ownership] .godpowers/roadmap/ROADMAP.md claimed by 4 agents
62
+ [multi-ownership] .godpowers/state.json claimed by 5 agents (verify boundaries)
62
63
 
63
- Infos: 90 missing-recommended-section suggestions across agents
64
+ Infos: 97 missing-recommended-section suggestions across agents
64
65
  (run with --json for full list)
65
66
 
66
- Proposition:
67
- 1. Implement partial: fix the highest-priority error or warning
68
- 2. Implement complete: /god-agent-audit --fix for info-level placeholder sections only
69
- 3. Discuss more: /god-discuss agent contract findings
70
- 4. Inspect details: /god-agent-audit --json
71
- Recommended: [one option and why]
67
+ Next commands:
68
+ - /god-agent-audit --fix: Fix the highest-priority approved agent contract issue.
69
+ - /god-agent-audit --fix for info-level placeholder sections only: Run the full recommended path.
70
+ - /god-discuss agent contract findings: Resolve the open question before continuing.
71
+ - /god-agent-audit --json: Inspect details before changing files.
72
72
  ```
73
73
 
74
74
  ## Backward-compatibility promise
@@ -76,7 +76,9 @@ Recommended: [one option and why]
76
76
  This skill never breaks existing agents that don't yet have the
77
77
  recommended sections. Errors fire only on real structural issues
78
78
  (missing required frontmatter, broken hand-off targets, conflicting
79
- output ownership).
79
+ output ownership). Missing structured contract frontmatter becomes a
80
+ warning once a project has at least 20 agents with complete `inputs`,
81
+ `outputs`, `gates`, and `handoff` fields.
80
82
 
81
83
  The `--fix` flag inserts placeholder sections so contributors can
82
84
  fill them in incrementally. It never modifies content that's already
@@ -69,6 +69,4 @@ The reflog records every god-arch invocation as `op:god-arch` for `/god-undo`.
69
69
  for `/god-repair` review. Re-running picks up cleanly.
70
70
 
71
71
 
72
- ## Locking
73
-
74
- See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
72
+ Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
@@ -46,10 +46,9 @@ Suggested next:
46
46
  /god-tech-debt - assess and prioritize debt revealed
47
47
  /god-feature - now safe to add new work with archaeology in hand
48
48
 
49
- Proposition:
50
- 1. Implement partial: /god-tech-debt for only the highest-risk areas
51
- 2. Implement complete: /god-reconstruct then /god-audit for full brownfield alignment
52
- 3. Discuss more: /god-discuss the open tribal-knowledge questions
53
- 4. Run God Mode: /god-mode only after reconstruction or audit makes the state clear
54
- Recommended: /god-reconstruct when planning artifacts are missing or stale.
49
+ Next commands:
50
+ - /god-tech-debt for only the highest-risk areas: Run the smallest safe next step.
51
+ - /god-reconstruct then /god-audit for full brownfield alignment: Run the full recommended path.
52
+ - /god-discuss the open tribal-knowledge questions: Resolve the open question before continuing.
53
+ - /god-mode only after reconstruction or audit makes the state clear: Run the full autonomous project workflow when it fits.
55
54
  ```
@@ -52,15 +52,14 @@ After god-auditor returns:
52
52
  1. Verify AUDIT-REPORT.md exists on disk
53
53
  2. Display the summary table to the user
54
54
  3. If any artifact scored below 80%: suggest re-running the failing tier
55
- 4. End with a proposition block:
55
+ 4. End with a Next commands block:
56
56
 
57
57
  ```
58
- Proposition:
59
- 1. Implement partial: [rerun the single lowest-scoring tier or fix the top finding]
60
- 2. Implement complete: [rerun all failing tiers in priority order]
61
- 3. Discuss more: /god-discuss audit remediation plan
62
- 4. Run God Mode: /god-mode only when the audit has no blocking findings
63
- Recommended: [one option and why]
58
+ Next commands:
59
+ - /god-redo [tier]: Rerun the single lowest-scoring tier or fix the top finding.
60
+ - /god-audit: Re-run audit after failing tiers are repaired in priority order.
61
+ - /god-discuss audit remediation plan: Resolve the open question before continuing.
62
+ - /god-mode only when the audit has no blocking findings: Run the full autonomous project workflow when it fits.
64
63
  ```
65
64
 
66
65
  ## Output Format
@@ -129,15 +129,14 @@ Approval required:
129
129
  - Confirm any host-native schedule, routine, background agent, API trigger, or connector scope
130
130
  ```
131
131
 
132
- ## Proposition Closeout
132
+ ## Next Commands Closeout
133
133
 
134
134
  End with:
135
135
 
136
136
  ```text
137
- Proposition:
138
- 1. Implement partial: create one read-only automation after approval
139
- 2. Implement complete: create all safe read-only automations after approval
140
- 3. Discuss more: tune provider, cadence, or safety rules
141
- 4. Inspect status: /god-automation-status
142
- Recommended: <one option tied to provider capability and user risk>
137
+ Next commands:
138
+ - /god-automation-setup: Create one approved read-only automation.
139
+ - /god-automation-setup --all-safe: Create all approved safe read-only automations.
140
+ - /god-discuss automation policy: Tune provider, cadence, or safety rules.
141
+ - /god-automation-status: Inspect status before continuing.
143
142
  ```
@@ -59,17 +59,16 @@ Safety rules:
59
59
  - Default templates are read-only.
60
60
  ```
61
61
 
62
- ## Proposition Closeout
62
+ ## Next Commands Closeout
63
63
 
64
64
  End with:
65
65
 
66
66
  ```text
67
- Proposition:
68
- 1. Implement partial: /god-automation-setup for one safe read-only template
69
- 2. Implement complete: /god-automation-setup for all safe templates supported by the current host
70
- 3. Discuss more: /god-discuss automation policy and provider choice
71
- 4. Inspect status: /god-status to see project progress and automation status together
72
- Recommended: <one option tied to the detected provider>
67
+ Next commands:
68
+ - /god-automation-setup for one safe read-only template: Run the smallest safe next step.
69
+ - /god-automation-setup for all safe templates supported by the current host: Run the full recommended path.
70
+ - /god-discuss automation policy and provider choice: Resolve the open question before continuing.
71
+ - /god-status to see project progress and automation status together: Inspect status before continuing.
73
72
  ```
74
73
 
75
74
  If no provider is available, recommend manual `/god-next` or
@@ -108,6 +108,4 @@ increment before moving to Tier 3 unless the user explicitly asked to stop
108
108
  after the current increment.
109
109
 
110
110
 
111
- ## Locking
112
-
113
- See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
111
+ Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
@@ -88,17 +88,16 @@ Suggested next:
88
88
  2. Accept the 2 new todos: /god-check-todos
89
89
  ```
90
90
 
91
- ## Proposition Closeout
91
+ ## Next Commands Closeout
92
92
 
93
- End every context scan report with a proposition block:
93
+ End every context scan report with a Next commands block:
94
94
 
95
95
  ```
96
- Proposition:
97
- 1. Implement partial: [first suggested action, usually /god-locate or /god-repair]
98
- 2. Implement complete: resolve all error and warn drifts, then rerun /god-context-scan
99
- 3. Discuss more: /god-discuss context drift
100
- 4. Inspect status: /god-status after re-orientation
101
- Recommended: [one option and why]
96
+ Next commands:
97
+ - /god-locate: Re-orient from checkpoint and disk state.
98
+ - /god-repair: Resolve state drift before continuing.
99
+ - /god-discuss context drift: Resolve the open question before continuing.
100
+ - /god-status after re-orientation: Inspect status before continuing.
102
101
  ```
103
102
 
104
103
  ## What this does NOT do
@@ -0,0 +1,53 @@
1
+ ---
2
+ name: god-demo
3
+ description: |
4
+ Run a safe Godpowers sandbox proof using the shipped quick-proof fixture.
5
+ Shows disk-derived state, missing artifacts, host guarantees, and the next
6
+ command without modifying the user's project.
7
+
8
+ Triggers on: "god demo", "/god-demo", "show me a demo", "sandbox",
9
+ "try godpowers safely"
10
+ ---
11
+
12
+ # /god-demo
13
+
14
+ Show a safe sandbox proof before the user touches their project. This command
15
+ uses the shipped quick-proof fixture and does not write to the user's project.
16
+
17
+ ## Process
18
+
19
+ 1. Resolve `<runtimeRoot>/lib/quick-proof.js`.
20
+ 2. Call `quickProof.compute(projectRoot)`.
21
+ 3. Render `quickProof.render(result, { brief: true })` by default.
22
+ 4. If the user asks for full detail, render without `brief`.
23
+ 5. End with `Next commands:`.
24
+
25
+ ## Output Shape
26
+
27
+ ```text
28
+ The sandbox proof read a shipped fixture from disk and computed the next command without changing this repo.
29
+
30
+ Changed:
31
+ - No project files were modified.
32
+
33
+ Validation:
34
+ - quick-proof fixture: rendered disk state, missing PRD, host guarantees, and next command.
35
+
36
+ Next commands:
37
+ - /god-first-run: Continue the guided first-run path.
38
+ - /god-init: Initialize Godpowers in this project.
39
+ - /god-status --full: Inspect full status once a project exists.
40
+ ```
41
+
42
+ ## Terminal Equivalent
43
+
44
+ ```bash
45
+ npx godpowers demo --project=.
46
+ ```
47
+
48
+ ## Rules
49
+
50
+ - Never write to the current project.
51
+ - Prefer compact proof output.
52
+ - Keep fixture state separate from the user's project state.
53
+ - Mention host guarantees separately from fixture progress.
@@ -95,6 +95,4 @@ The reflog records every god-deploy invocation as `op:god-deploy` for `/god-undo
95
95
  for `/god-repair` review. Re-running picks up cleanly.
96
96
 
97
97
 
98
- ## Locking
99
-
100
- See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
98
+ Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
@@ -66,12 +66,11 @@ Transitive (depth 2):
66
66
  Recommendation: Run /god-design with this change to apply.
67
67
  god-design-reviewer will gate via two-stage review.
68
68
 
69
- Proposition:
70
- 1. Implement partial: /god-design for only the lowest-risk token or component change
71
- 2. Implement complete: /god-design with the full proposed change
72
- 3. Discuss more: /god-discuss the design tradeoff before changing files
73
- 4. Run God Mode: /god-mode only if this design change is part of a wider project run
74
- Recommended: apply the smallest design change first when severity is warning
69
+ Next commands:
70
+ - /god-design for only the lowest-risk token or component change: Run the smallest safe next step.
71
+ - /god-design with the full proposed change: Run the full recommended path.
72
+ - /god-discuss the design tradeoff before changing files: Resolve the open question before continuing.
73
+ - /god-mode only if this design change is part of a wider project run: Run the full autonomous project workflow when it fits.
75
74
  or higher.
76
75
  ```
77
76
 
@@ -69,6 +69,14 @@ producing DESIGN.md in the
69
69
  6. After god-designer returns: surface any lint findings, suggest
70
70
  `/god-design polish` if warnings exist.
71
71
 
72
+ ## Verification
73
+
74
+ After god-designer returns:
75
+ 1. Verify `DESIGN.md` exists on disk when design was required.
76
+ 2. Run `npx godpowers gate --tier=design --project=.`
77
+ 3. If the gate returns a non-zero exit, do not mark Design complete. Report the gate output and repair the artifact first.
78
+ 4. Run `npx godpowers state advance --step=design --status=done --project=.`.
79
+
72
80
  ## Detection-driven behavior
73
81
 
74
82
  - **UI + impeccable installed**: bridges to impeccable's commands
@@ -267,6 +275,4 @@ The reflog records every god-design invocation as `op:god-design` for `/god-undo
267
275
  for `/god-repair` review. Re-running picks up cleanly.
268
276
 
269
277
 
270
- ## Locking
271
-
272
- See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
278
+ Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
@@ -73,10 +73,9 @@ Key findings:
73
73
 
74
74
  Suggested next: [the planning command this discussion was for]
75
75
 
76
- Proposition:
77
- 1. Implement partial: [smallest safe slice or planning command]
78
- 2. Implement complete: [full command that consumes this brief]
79
- 3. Discuss more: /god-discuss [specific unresolved question]
80
- 4. Run God Mode: /god-mode [scope] if the user wants autonomous execution
81
- Recommended: [one option and why]
76
+ Next commands:
77
+ - /god-next: Continue with the safest command that uses this discussion.
78
+ - /god-mode [scope]: Run the full command that consumes this brief when safe.
79
+ - /god-discuss [specific unresolved question]: Resolve the open question before continuing.
80
+ - /god-mode [scope] if the user wants autonomous execution: Run the full autonomous project workflow when it fits.
82
81
  ```
@@ -69,20 +69,15 @@ Godpowers may invoke docs work proactively in two ways:
69
69
  | Repo structural surface drift | Run `lib/repo-surface-sync.run` and include findings in docs scope | Do not invent routing or agent ownership prose without evidence |
70
70
  | `REVIEW-REQUIRED.md` contains docs drift items | Suggest `/god-review-changes` first | Do not auto-clear review items |
71
71
 
72
- When auto-invoked, show:
72
+ When auto-invoked, show a concise default note:
73
73
 
74
74
  ```text
75
- Auto-invoked:
76
- Trigger: docs and code changed in the same workflow
77
- Agent: god-docs-writer
78
- Local syncs:
79
- + repo-doc-sync: <safe mechanical fixes, prose review needed, or no-op>
80
- + repo-surface-sync: <structural surface fresh, scoped findings, or no-op>
81
- + docs-drift-check: <N claims checked, N drift items>
82
- Artifacts: .godpowers/docs/UPDATE-LOG.md or no-op
83
- Log: .godpowers/docs/UPDATE-LOG.md
75
+ Checked docs against changed code. Details were written to .godpowers/docs/UPDATE-LOG.md.
84
76
  ```
85
77
 
78
+ Use a detailed `Auto-invoked:` card only with `--verbose` or release-gate
79
+ debugging.
80
+
86
81
  ## Have-Nots
87
82
 
88
83
  Docs FAIL if: