godpowers 1.6.8 → 1.6.10

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 (72) hide show
  1. package/CHANGELOG.md +67 -0
  2. package/README.md +9 -8
  3. package/RELEASE.md +33 -32
  4. package/SKILL.md +91 -2
  5. package/agents/god-auditor.md +4 -4
  6. package/agents/god-coordinator.md +4 -4
  7. package/agents/god-deploy-engineer.md +1 -1
  8. package/agents/god-greenfieldifier.md +1 -1
  9. package/agents/god-launch-strategist.md +1 -1
  10. package/agents/god-observability-engineer.md +1 -1
  11. package/agents/god-orchestrator.md +82 -24
  12. package/agents/god-reconciler.md +1 -1
  13. package/bin/install.js +1 -1
  14. package/hooks/session-start.sh +2 -2
  15. package/lib/checkpoint.js +4 -1
  16. package/lib/context-writer.js +1 -1
  17. package/package.json +1 -1
  18. package/references/HAVE-NOTS.md +1 -1
  19. package/references/orchestration/SCALE-DETECTION.md +1 -1
  20. package/references/shared/GLOSSARY.md +1 -1
  21. package/references/shared/ORCHESTRATORS.md +1 -1
  22. package/routing/god-mode.yaml +1 -1
  23. package/routing/god-preflight.yaml +1 -1
  24. package/routing/recipes/add-feature-mid-arc-pause.yaml +4 -4
  25. package/routing/recipes/bluefield-org-aware.yaml +1 -1
  26. package/routing/recipes/brownfield-onboarding.yaml +1 -1
  27. package/routing/recipes/greenfield-fast.yaml +1 -1
  28. package/routing/recipes/greenfield-with-ideation.yaml +1 -1
  29. package/skills/god-agent-audit.md +7 -0
  30. package/skills/god-archaeology.md +7 -0
  31. package/skills/god-audit.md +11 -1
  32. package/skills/god-context-scan.md +13 -0
  33. package/skills/god-context.md +1 -1
  34. package/skills/god-deploy.md +1 -1
  35. package/skills/god-design-impact.md +8 -0
  36. package/skills/god-discuss.md +7 -0
  37. package/skills/god-doctor.md +17 -0
  38. package/skills/god-explore.md +8 -0
  39. package/skills/god-extract-learnings.md +1 -1
  40. package/skills/god-feature.md +1 -1
  41. package/skills/god-hotfix.md +1 -1
  42. package/skills/god-hygiene.md +8 -1
  43. package/skills/god-init.md +1 -1
  44. package/skills/god-launch.md +1 -1
  45. package/skills/god-lifecycle.md +33 -5
  46. package/skills/god-list-assumptions.md +13 -0
  47. package/skills/god-locate.md +16 -0
  48. package/skills/god-logs.md +1 -1
  49. package/skills/god-map-codebase.md +8 -0
  50. package/skills/god-mode.md +55 -17
  51. package/skills/god-next.md +32 -4
  52. package/skills/god-org-context.md +1 -1
  53. package/skills/god-preflight.md +18 -4
  54. package/skills/god-quick.md +1 -1
  55. package/skills/god-reconcile.md +6 -1
  56. package/skills/god-reconstruct.md +8 -0
  57. package/skills/god-refactor.md +23 -0
  58. package/skills/god-roadmap-check.md +10 -0
  59. package/skills/god-roadmap-update.md +1 -1
  60. package/skills/god-skip.md +1 -1
  61. package/skills/god-spike.md +7 -0
  62. package/skills/god-standards.md +7 -0
  63. package/skills/god-status.md +25 -0
  64. package/skills/god-suite-init.md +1 -1
  65. package/skills/god-suite-release.md +1 -1
  66. package/skills/god-suite-status.md +1 -1
  67. package/skills/god-suite-sync.md +1 -1
  68. package/skills/god-tech-debt.md +8 -0
  69. package/skills/god.md +23 -7
  70. package/workflows/bluefield-arc.yaml +1 -1
  71. package/workflows/brownfield-arc.yaml +1 -1
  72. package/workflows/feature-arc.yaml +1 -1
@@ -17,7 +17,7 @@ Urgent production bug fix. Speed matters; discipline still applies.
17
17
 
18
18
  - Production is broken or degraded
19
19
  - Users are affected right now
20
- - Waiting for a normal /god-mode arc is unacceptable
20
+ - Waiting for a normal /god-mode project run is unacceptable
21
21
 
22
22
  ## When NOT to use
23
23
 
@@ -23,7 +23,7 @@ Periodic health check. Three audits in one slash command.
23
23
  ## When NOT to use
24
24
 
25
25
  - Mid-incident: focus on /god-hotfix or /god-debug
26
- - Right after /god-mode: hygiene was already optional during arc
26
+ - Right after /god-mode: hygiene was already optional during the project run
27
27
 
28
28
  ## Orchestration
29
29
 
@@ -93,6 +93,13 @@ Suggested next actions (in priority order):
93
93
  3. [next]
94
94
 
95
95
  Schedule next hygiene check in [N days] (default: 30).
96
+
97
+ Proposition:
98
+ 1. Implement partial: [highest-priority action]
99
+ 2. Implement complete: [all P0/P1 hygiene actions in order]
100
+ 3. Discuss more: /god-discuss hygiene remediation
101
+ 4. Inspect status: /god-status after fixes
102
+ Recommended: [one option and why]
96
103
  ```
97
104
 
98
105
  ## Have-Nots
@@ -260,5 +260,5 @@ without explicit user invocation of /god-suite-init.
260
260
  After init completes, print:
261
261
 
262
262
  ```
263
- Suggested next: /god-prd for requirements, or /god-mode for the full autonomous arc.
263
+ Suggested next: /god-prd for requirements, or /god-mode for the full autonomous project run.
264
264
  ```
@@ -58,7 +58,7 @@ the user requests staging or final sign-off begins.
58
58
  The launch pause must not expand into every possible channel, analytics, or
59
59
  provider credential. Ask only for the next missing access item needed to run a
60
60
  named live smoke, launch-readiness, attribution, or monitoring check. Do not
61
- ask mid-arc for `STAGING_APP_URL` unless the user requested deployed staging.
61
+ ask mid-run for `STAGING_APP_URL` unless the user requested deployed staging.
62
62
  At final sign-off, if no live target URL is known, ask only for
63
63
  `STAGING_APP_URL=<staging-origin>`.
64
64
 
@@ -17,7 +17,7 @@ Show project phase and contextually appropriate workflows.
17
17
 
18
18
  1. Detect lifecycle phase from disk:
19
19
  - **No `.godpowers/`** -> Pre-init
20
- - **`.godpowers/PROGRESS.md` exists, not all tiers done** -> In-arc
20
+ - **`.godpowers/PROGRESS.md` exists, not all tiers done** -> In progress
21
21
  - **All tiers done, no special markers** -> Steady state
22
22
  - **`.godpowers/postmortems/<id>/` exists with no POSTMORTEM.md** -> Post-incident pending
23
23
  - **`.godpowers/migrations/<slug>/MIGRATION.md` exists, status != complete** -> In-migration
@@ -36,15 +36,18 @@ Lifecycle: Pre-init (no Godpowers project here)
36
36
  Available actions:
37
37
  /god-init Initialize a Godpowers project
38
38
  /god-explore Brainstorm before committing
39
- /god-mode Run full autonomous arc (will init first)
39
+ /god-mode Run full autonomous project run (will init first)
40
40
  ```
41
41
 
42
- ### In-arc
42
+ ### In Progress
43
43
  ```
44
- Lifecycle: In-arc (planning/building/shipping)
44
+ Lifecycle: In progress (planning/building/shipping)
45
45
 
46
46
  Current state:
47
47
  PRD: [done/pending]
48
+ Roadmap: [done/pending]
49
+ Current step: [phase, tier, or roadmap milestone]
50
+ Completion: [pct]% ([done] of [total] tracked steps)
48
51
  Architecture: [done/pending]
49
52
  ...
50
53
 
@@ -55,7 +58,7 @@ Or run /god-mode to autonomously continue from here.
55
58
 
56
59
  ### Steady state
57
60
  ```
58
- Lifecycle: Steady state (full-arc complete, in maintenance)
61
+ Lifecycle: Steady state (project run complete, in maintenance)
59
62
 
60
63
  Last full audit: [N days ago]
61
64
  Last dep audit: [N days ago]
@@ -111,6 +114,31 @@ Suggested next: /god-spike with narrower question
111
114
  Or: archive the spike if no longer relevant
112
115
  ```
113
116
 
117
+ ## Proposition Closeout
118
+
119
+ Every lifecycle report must end with a proposition block. Use the detected
120
+ phase to fill in concrete commands:
121
+
122
+ ```
123
+ Proposition:
124
+ 1. Implement partial: [smallest safe next command from the lifecycle report]
125
+ 2. Implement complete: /god-mode [resume or scope] when the phase is safe for an autonomous project run
126
+ 3. Discuss more: /god-discuss [unclear phase, blocker, or choice]
127
+ 4. Inspect status: /god-status or /god-next
128
+ Recommended: [one option and why it matches the detected phase]
129
+ ```
130
+
131
+ For hard blockers, such as post-incident pending, replace the broad options
132
+ with the required next command plus inspect and discuss alternatives:
133
+
134
+ ```
135
+ Proposition:
136
+ 1. Resolve required next: /god-postmortem
137
+ 2. Inspect first: /god-status
138
+ 3. Discuss blocker: /god-discuss incident follow-up
139
+ Recommended: /god-postmortem because the incident learning loop is still open.
140
+ ```
141
+
114
142
  ## Have-Nots
115
143
 
116
144
  Lifecycle check FAILS if:
@@ -48,6 +48,19 @@ Assumptions Claude is operating under:
48
48
  Any of these wrong? Flag them now before they cement into decisions.
49
49
  ```
50
50
 
51
+ ## Proposition Closeout
52
+
53
+ After listing assumptions, end with a proposition block:
54
+
55
+ ```
56
+ Proposition:
57
+ 1. Implement partial: correct or confirm the low-confidence assumptions only
58
+ 2. Implement complete: confirm assumptions and continue to [queued command]
59
+ 3. Discuss more: /god-discuss assumptions before planning
60
+ 4. Inspect status: /god-status to re-ground before deciding
61
+ Recommended: [one option and why]
62
+ ```
63
+
51
64
  ## Have-Nots
52
65
 
53
66
  - Assumptions are too vague to verify ("we're building a good product")
@@ -73,6 +73,22 @@ Drift check:
73
73
  - If gap > 1 hour, run /god-context-scan
74
74
  ```
75
75
 
76
+ ## Proposition Closeout
77
+
78
+ The orientation summary must end with a compact proposition block:
79
+
80
+ ```
81
+ Proposition:
82
+ 1. Implement partial: [next suggested command]
83
+ 2. Implement complete: /god-mode to continue the project run when no drift is flagged
84
+ 3. Discuss more: /god-discuss [unclear state or stale checkpoint]
85
+ 4. Inspect status: /god-status for the full report
86
+ Recommended: [one option and why]
87
+ ```
88
+
89
+ If drift is flagged, recommend `/god-context-scan` or `/god-repair` before
90
+ continuing work.
91
+
76
92
  ## Process
77
93
 
78
94
  1. If `.godpowers/` does not exist: report "no Godpowers project here"
@@ -3,7 +3,7 @@ name: god-logs
3
3
  description: |
4
4
  View events.jsonl as a readable timeline. Each line: timestamp,
5
5
  event name, tier, agent, duration if available. Use to inspect
6
- what happened during a run, debug a stuck arc, or audit
6
+ what happened during a run, debug a stuck project run, or audit
7
7
  retroactively.
8
8
 
9
9
  Triggers on: "god logs", "/god-logs", "show logs", "what happened",
@@ -42,4 +42,12 @@ Codebase mapped.
42
42
  + .godpowers/codebase/concerns.md
43
43
 
44
44
  Suggested next: /god-init Mode B (gap-fill) or /god-feature
45
+
46
+ Proposition:
47
+ 1. Implement partial: /god-intel or /god-tech-debt on the riskiest mapped area
48
+ 2. Implement complete: /god-init Mode B to gap-fill project artifacts
49
+ 3. Discuss more: /god-discuss the unclear architecture or quality findings
50
+ 4. Run God Mode: /god-mode after Mode B context exists
51
+ Recommended: /god-init Mode B when the codebase is real but Godpowers artifacts
52
+ are missing.
45
53
  ```
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: god-mode
3
3
  description: |
4
- Full autonomous arc orchestrator. Spawns the god-orchestrator agent in a
4
+ Full autonomous project-run orchestrator. Spawns the god-orchestrator agent in a
5
5
  fresh context which runs the entire workflow: idea to hardened production.
6
6
  Pauses only for legitimate human-only decisions.
7
7
 
@@ -12,11 +12,12 @@ description: |
12
12
  # /god-mode
13
13
 
14
14
  You are receiving a /god-mode invocation. Your job is to spawn the
15
- **god-orchestrator** agent in a fresh context to run the autonomous arc.
15
+ **god-orchestrator** agent in a fresh context to run the autonomous project
16
+ workflow.
16
17
 
17
18
  ## Process
18
19
 
19
- 1. Resolve whether this is a new arc or a resume:
20
+ 1. Resolve whether this is a new project run or a resume:
20
21
  - If `.godpowers/state.json`, `.godpowers/PROGRESS.md`, or
21
22
  `.godpowers/CHECKPOINT.md` exists, this is a resume. Do not ask the user
22
23
  to describe the project again. Call
@@ -64,7 +65,7 @@ You are receiving a /god-mode invocation. Your job is to spawn the
64
65
  `workflows/<name>.yaml`, run via `lib/workflow-runner`)
65
66
  - `--plan` (v0.14; emit plan to `.godpowers/runs/<id>/plan.yaml`
66
67
  and stop. Same effect as `--dry-run`. Use with `--workflow` for
67
- a specific arc's plan.)
68
+ a specific project run's plan.)
68
69
  - `--brownfield` (force brownfield path even if detection says greenfield)
69
70
  - `--bluefield` (force bluefield path)
70
71
  - `--greenfield` (force greenfield, skip archaeology even if code exists)
@@ -89,16 +90,16 @@ You are receiving a /god-mode invocation. Your job is to spawn the
89
90
  `/god-arch` when initial findings, imported planning context, the PRD,
90
91
  or the codebase show UI or product-experience signals
91
92
  - Instruction that a red test, typecheck, lint, build, or check command
92
- is not a completed arc. It must enter the autonomous repair loop and
93
+ is not a completed project run. It must enter the autonomous repair loop and
93
94
  continue the same `/god-mode` run until green, except for Critical
94
95
  security or a genuine human-only decision.
95
96
  - Instruction that deploy, observe, harden, and launch must follow the
96
97
  Shipping Closure Protocol: verify a real environment when available,
97
98
  otherwise create local/CI-verifiable deploy automation, defer deployed
98
99
  staging by default, and continue until the user requests staging or the
99
- arc reaches final sign-off.
100
+ project run reaches final sign-off.
100
101
  - Instruction that keys, API tokens, dashboards, admin consoles, and
101
- provider-specific access are last-mile inputs. Do not pause mid-arc for
102
+ provider-specific access are last-mile inputs. Do not pause mid-run for
102
103
  `STAGING_APP_URL` unless the user requested deployed staging. At final
103
104
  sign-off, ask only for the smallest next item needed by a concrete
104
105
  command, usually `STAGING_APP_URL=<staging-origin>`. Ask for additional
@@ -114,7 +115,7 @@ You are receiving a /god-mode invocation. Your job is to spawn the
114
115
  artifact rewrites, and updates every affected artifact after approval.
115
116
  - Instruction that brownfield and bluefield arcs run `/god-preflight`
116
117
  automatically when `.godpowers/preflight/PREFLIGHT.md` is absent.
117
- Greenfield arcs skip preflight unless the user explicitly requests it.
118
+ Greenfield project runs skip preflight unless the user explicitly requests it.
118
119
  - Instruction to run routing prerequisites through `lib/router.js`
119
120
  `checkPrerequisites` before every direct command dispatch. If
120
121
  `safe-sync-clear` fails, run
@@ -129,7 +130,7 @@ You are receiving a /god-mode invocation. Your job is to spawn the
129
130
  - Name the project root.
130
131
  - Name the invocation flags.
131
132
  - Name the handoff file path.
132
- - Say: "Read the handoff file first, then run the autonomous arc from disk
133
+ - Say: "Read the handoff file first, then run the autonomous workflow from disk
133
134
  state. Return only user-facing progress and final status."
134
135
 
135
136
  Do not put recovered checkpoint facts, safe-sync plans, local file lists,
@@ -141,12 +142,12 @@ You are receiving a /god-mode invocation. Your job is to spawn the
141
142
  loadout lists, or internal routing payloads into the user-visible transcript.
142
143
  The visible transcript may say only what phase is running, what durable state
143
144
  was detected, what commands are running, what changed, and the final
144
- `Arc complete` or `PAUSE: external access required` block.
145
+ `Project run complete` or `PAUSE: external access required` block.
145
146
 
146
147
  8. Orchestrator runs the appropriate workflow:
147
- - Greenfield -> full-arc
148
- - Brownfield -> brownfield-arc (preflight -> archaeology -> reconstruct -> debt-assess -> greenfield simulation audit -> greenfieldify plan and approved artifact updates -> proceed)
149
- - Bluefield -> bluefield-arc (org-context -> preflight -> greenfield simulation audit -> greenfieldify plan and approved artifact updates -> arc with constraints)
148
+ - Greenfield -> full project run
149
+ - Brownfield -> brownfield project run (preflight -> archaeology -> reconstruct -> debt-assess -> greenfield simulation audit -> greenfieldify plan and approved artifact updates -> proceed)
150
+ - Bluefield -> bluefield project run (org-context -> preflight -> greenfield simulation audit -> greenfieldify plan and approved artifact updates -> workflow with constraints)
150
151
 
151
152
  9. Relay only the orchestrator's user-facing output to the user. If the
152
153
  platform displays raw spawn details automatically, the displayed payload
@@ -168,9 +169,15 @@ Show:
168
169
  - detected resume or project mode in plain language
169
170
  - a compact "Next step" card before each visible phase or tier sub-step
170
171
  - a compact "Step result" card after each visible phase or tier sub-step
172
+ - plain-language workflow names. Say "project run" or "workflow" instead of
173
+ unexplained "arc" in visible output
174
+ - PRD and roadmap visibility in status and closeout blocks when artifacts
175
+ exist or are expected
171
176
  - short progress updates for phases, commands, validations, and file edits
172
177
  - concise validation summaries instead of full command noise when possible
173
178
  - final changed paths, validation results, and completion or pause status
179
+ - final current status, open items, worktree/index state, and recommended next
180
+ action
174
181
 
175
182
  Hide:
176
183
  - raw Task input
@@ -280,7 +287,7 @@ complete. This ensures all 14 artifact categories are in a consistent state:
280
287
 
281
288
  - 10 Tier 0-3 artifacts validated (have-nots passing)
282
289
  - 4 capture artifacts noted as `not-yet-created` (graceful handling)
283
- - SYNC-LOG.md updated with arc completion entry
290
+ - SYNC-LOG.md updated with project-run completion entry
284
291
  - state.json reflects final tier statuses
285
292
 
286
293
  Under `--yolo`, the sync step auto-applies (no pause). Under
@@ -297,7 +304,7 @@ If `/god-mode` resumes an existing `.godpowers` project that lacks Pillars,
297
304
  it Pillar-izes the project before continuing. Existing `.godpowers` artifacts
298
305
  become managed source references in the relevant `agents/*.md` files.
299
306
 
300
- The sync step is what closes the loop between greenfield arc creation and
307
+ The sync step is what closes the loop between greenfield project-run creation and
301
308
  the comprehensive 14-artifact reconciliation system. See
302
309
  `docs/greenfield-coverage.md` for what's created when.
303
310
 
@@ -306,7 +313,19 @@ the comprehensive 14-artifact reconciliation system. See
306
313
  When orchestrator returns "complete", display:
307
314
 
308
315
  ```
309
- Godpowers full-arc complete.
316
+ Godpowers project run complete.
317
+
318
+ Current status:
319
+ State: complete
320
+ Progress: <pct>% (<done> of <total> steps complete; current step <n> of <total>)
321
+ Worktree: <clean | modified files unstaged | staged changes | mixed>
322
+ Index: <untouched | staged files listed>
323
+
324
+ Planning visibility:
325
+ PRD: <done | pending | missing | deferred> <artifact path when present>
326
+ Roadmap: <done | pending | missing | deferred> <artifact path when present>
327
+ Current milestone: <roadmap milestone, tier, or next planning gate when known>
328
+ Completion: <pct>% <brief basis, for example done steps over total tracked steps>
310
329
 
311
330
  Artifacts on disk:
312
331
  + PRD .godpowers/prd/PRD.md
@@ -337,5 +356,24 @@ Periodic hygiene:
337
356
  Quality audit: /god-audit
338
357
  Health check: /god-hygiene
339
358
 
340
- Or describe what you want and /god-next will route.
359
+ Open items:
360
+ 1. <none, or deployed staging deferred, pending review, unstaged files, etc.>
361
+
362
+ Next:
363
+ Recommended: <single safest command or decision>
364
+ Why: <one sentence tied to disk state>
365
+
366
+ Proposition:
367
+ 1. Review status: /god-status
368
+ 2. Continue work: /god-next or describe the next intent
369
+ 3. Commit release-ready changes: stage only the intended files, then commit
370
+ 4. Run deployed staging: provide STAGING_APP_URL=<deployed staging origin> when needed
341
371
  ```
372
+
373
+ If the run edited code but did not stage or commit, the completion block must
374
+ say so. If unrelated or pre-existing worktree changes are present, do not imply
375
+ the worktree is clean. Recommend a scoped review or explicit staging path.
376
+
377
+ If the run is a focused brownfield/refactor workflow rather than a full greenfield
378
+ project run, adapt the same closeout shape and replace "Project is now in STEADY
379
+ STATE" with the actual disk-derived lifecycle and next route.
@@ -158,6 +158,16 @@ Path ahead:
158
158
 
159
159
  Keep the route to 3 lines unless the user asks for the full plan.
160
160
 
161
+ Also show planning visibility when the artifacts exist or are expected:
162
+
163
+ ```
164
+ Planning visibility:
165
+ PRD: <done | pending | missing> <path when present>
166
+ Roadmap: <done | pending | missing> <path when present>
167
+ Current milestone: <roadmap milestone, tier, or next planning gate>
168
+ Completion: <pct>% <basis from state.json or PROGRESS.md>
169
+ ```
170
+
161
171
  ## Process for Mode 4 (intent-based)
162
172
 
163
173
  ```
@@ -175,9 +185,9 @@ Returns ranked recipes matching:
175
185
  Display top match with the recipe's sequence:
176
186
  "Best match: add-feature-mid-arc-pause
177
187
  Sequence:
178
- 1. /god-pause-work (Save current /god-mode arc state)
188
+ 1. /god-pause-work (Save current /god-mode project-run state)
179
189
  2. /god-feature (Run feature workflow)
180
- 3. /god-resume-work (Restore arc)
190
+ 3. /god-resume-work (Restore project run)
181
191
 
182
192
  Run this sequence? Or see other matches?"
183
193
  ```
@@ -277,13 +287,13 @@ When in steady state, match keywords to workflows:
277
287
  | upgrade, migrate, bump major | /god-upgrade |
278
288
  | docs, documentation, README | /god-docs |
279
289
  | deps, dependencies, audit | /god-update-deps |
280
- | preflight, intake, audit before arc-ready, audit before pillars | /god-preflight |
290
+ | preflight, intake, audit before project run readiness, audit before pillars | /god-preflight |
281
291
  | audit, score, quality check | /god-audit |
282
292
  | health check, hygiene | /god-hygiene |
283
293
 
284
294
  If mode detection indicates brownfield or bluefield and
285
295
  `.godpowers/preflight/PREFLIGHT.md` is missing, prefer `/god-preflight` before
286
- recommending archaeology, reconstruction, arc-ready, pillars, or refactor work.
296
+ recommending archaeology, reconstruction, project-run readiness, pillars, or refactor work.
287
297
 
288
298
  ## Output Format
289
299
 
@@ -312,3 +322,21 @@ Previous tier had standards failures. Address before proceeding:
312
322
  - [failure 2]
313
323
  Suggested: /god-redo [tier] OR /god-skip [tier] --reason="..."
314
324
  ```
325
+
326
+ ## Proposition Closeout
327
+
328
+ Every `/god-next` response must end with a proposition block unless it already
329
+ launched the selected command:
330
+
331
+ ```
332
+ Proposition:
333
+ 1. Implement partial: [single suggested command]
334
+ 2. Implement complete: [recipe sequence or /god-mode when safe]
335
+ 3. Discuss more: /god-discuss [routing ambiguity or missing prerequisite]
336
+ 4. Inspect status: /god-status or /god-locate
337
+ Recommended: [one option and why]
338
+ ```
339
+
340
+ For missing prerequisites, the partial option is the auto-completable
341
+ prerequisite. For standards failures, the partial option is `/god-redo` with
342
+ feedback and the complete option is blocked until the gate passes.
@@ -67,7 +67,7 @@ Constraints that will apply to this project:
67
67
  - Observability: Datadog
68
68
  ...
69
69
 
70
- Downstream agents will respect these throughout the arc.
70
+ Downstream agents will respect these throughout the project run.
71
71
 
72
72
  Suggested next: /god-init (or /god-mode if you're ready to build)
73
73
  ```
@@ -1,12 +1,12 @@
1
1
  ---
2
2
  name: god-preflight
3
3
  description: |
4
- Run a read-only intake audit before arc-ready, pillars, archaeology, or
4
+ Run a read-only intake audit before project-run readiness, pillars, archaeology, or
5
5
  reconstruction work. Inventory the codebase, surface blockers, and recommend
6
6
  the safest next pass without changing project code.
7
7
 
8
8
  Triggers on: "god preflight", "/god-preflight", "preflight audit",
9
- "audit before arc-ready", "audit before pillars", "intake audit"
9
+ "audit before project-run readiness", "audit before pillars", "intake audit"
10
10
  ---
11
11
 
12
12
  # /god-preflight
@@ -15,7 +15,7 @@ Read-only intake audit for an existing codebase.
15
15
 
16
16
  ## When to use
17
17
 
18
- - Before applying arc-ready direction to an existing repo
18
+ - Before applying project-run direction to an existing repo
19
19
  - Before scoring the repo against pillars
20
20
  - Before brownfield archaeology or reconstruction
21
21
  - When deciding whether to restructure, refactor, initialize Godpowers, or pause
@@ -28,7 +28,7 @@ It answers:
28
28
 
29
29
  - What kind of project is this?
30
30
  - What structure, tooling, tests, docs, CI, deploy paths, and agent instructions exist?
31
- - What is missing before arc-ready can make good decisions?
31
+ - What is missing before the project run can make good decisions?
32
32
  - Which pillar weaknesses are already visible?
33
33
  - What areas are risky to refactor before more evidence exists?
34
34
  - What is the safest next pass?
@@ -137,6 +137,20 @@ 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
141
+
142
+ End the user-facing response with a proposition block based on the recommended
143
+ sequence:
144
+
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]
152
+ ```
153
+
140
154
  ## Guardrails
141
155
 
142
156
  - Build nothing.
@@ -11,7 +11,7 @@ description: |
11
11
  # /god-quick
12
12
 
13
13
  Run a focused task with TDD and atomic commits, but skip the full planning
14
- arc.
14
+ workflow.
15
15
 
16
16
  ## When to use
17
17
 
@@ -74,7 +74,12 @@ Recommended sequence:
74
74
  Main work: [/god-feature scoped to Milestone 2]
75
75
  Post-work: [/god-sync]
76
76
 
77
- Run? (yes / show alternatives / cancel)
77
+ Proposition:
78
+ 1. Implement partial: [run only the first preflight command]
79
+ 2. Implement complete: [run the full recommended sequence]
80
+ 3. Discuss more: /god-discuss [ambiguous overlap or artifact conflict]
81
+ 4. Cancel: leave artifacts unchanged
82
+ Recommended: [one option and why]
78
83
  ```
79
84
 
80
85
  ## Difference from /god-roadmap-check
@@ -58,6 +58,14 @@ Suggested next:
58
58
  /god-audit - score the reconstructed artifacts
59
59
  /god-feature - now you can add features with reconciliation
60
60
  /god-tech-debt - assess what needs paying down
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.
61
69
  ```
62
70
 
63
71
  ## Caveats
@@ -88,6 +88,29 @@ Behavior: unchanged
88
88
  Suggested next: /god-status or continue with /god-feature
89
89
  ```
90
90
 
91
+ ## Proposal Mode
92
+
93
+ When the user asks for a proposal, recommendation, or performance-improvement
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
96
+ moves.
97
+
98
+ Use this shape:
99
+
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>
107
+ ```
108
+
109
+ For performance refactors, prefer partial implementation when measurement is
110
+ missing. Example:
111
+ `Implement partial: /god-spike startup timeline to measure load phases before
112
+ refactoring.`
113
+
91
114
  ## Have-Nots
92
115
 
93
116
  Refactor FAILS if:
@@ -57,6 +57,16 @@ After god-roadmap-reconciler returns:
57
57
  1. Verify the verdict has a status from the canonical 6
58
58
  2. Verify recommendation has a concrete action
59
59
  3. Display to user; await decision before proceeding
60
+ 4. End with a proposition block:
61
+
62
+ ```
63
+ Proposition:
64
+ 1. Implement partial: [smallest command from the recommendation]
65
+ 2. Implement complete: [roadmap update plus feature work when needed]
66
+ 3. Discuss more: /god-discuss roadmap overlap
67
+ 4. Defer: /god-add-backlog [intent]
68
+ Recommended: [one option and why]
69
+ ```
60
70
 
61
71
  ## When called manually
62
72
 
@@ -16,7 +16,7 @@ Keep ROADMAP.md as a living artifact.
16
16
  ## When to use
17
17
 
18
18
  - After completing a milestone (mark done, gate passed)
19
- - After adding a feature mid-arc that wasn't on the original roadmap
19
+ - After adding a feature mid-run that wasn't on the original roadmap
20
20
  - When priorities shift (move between Now / Next / Later)
21
21
  - When a planned milestone is superseded
22
22
 
@@ -45,7 +45,7 @@ The reason is required. Skips without reason are rejected.
45
45
  ## Mandatory non-skippable steps
46
46
 
47
47
  These cannot be skipped:
48
- - The final `/god-sync` at end of arc
48
+ - The final `/god-sync` at the end of the project run
49
49
  - `/god-harden` for projects with `public-facing: true` in intent.yaml
50
50
  - Standards gates between tiers (use `/god-standards --override` to bypass with reason)
51
51
 
@@ -84,6 +84,13 @@ 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.
93
+
87
94
  REMINDER: spike code is throwaway. Do NOT merge to main.
88
95
  ```
89
96
 
@@ -54,6 +54,13 @@ Verdict: PARTIAL (87%)
54
54
  Suggested next:
55
55
  /god-redo prd to address failures with feedback
56
56
  /god-skip prd --reason "..." to accept-as-is
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]
57
64
  ```
58
65
 
59
66
  ## Auto-invocation