godpowers 1.6.7 → 1.6.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,69 @@ All notable changes to Godpowers will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [1.6.9] - 2026-05-16
9
+
10
+ Proposal closeout patch. Makes Godpowers end exploratory, diagnostic, audit,
11
+ status, lifecycle, and decision-support answers with concrete choices instead
12
+ of leaving the user to infer the next action.
13
+
14
+ ### Added
15
+ - Added a core Proposal Closeout rule requiring a `Proposition:` block when
16
+ Godpowers gives a recommendation, proposal, exploratory plan, diagnostic
17
+ report, status report, audit report, lifecycle report, reconciliation report,
18
+ or decision-support response without directly launching work.
19
+ - Added proposition closeouts to `/god`, `/god-next`, `/god-status`,
20
+ `/god-lifecycle`, `/god-locate`, `/god-context-scan`, `/god-preflight`,
21
+ `/god-doctor`, `/god-audit`, `/god-hygiene`, `/god-standards`, and
22
+ `/god-agent-audit`.
23
+ - Added proposition closeouts to proposal-heavy planning and analysis commands:
24
+ `/god-discuss`, `/god-explore`, `/god-list-assumptions`, `/god-refactor`,
25
+ `/god-spike`, `/god-tech-debt`, `/god-archaeology`, `/god-map-codebase`,
26
+ `/god-reconstruct`, `/god-design-impact`, `/god-reconcile`, and
27
+ `/god-roadmap-check`.
28
+
29
+ ### Changed
30
+ - Proposal-style outputs now mirror the clearer GSD pattern: implement a small
31
+ slice, implement the full route, discuss more, inspect status, or run
32
+ `/god-mode` only when that is safe.
33
+ - `/god-next` and `/god-status` now explicitly distinguish partial progress,
34
+ full autonomous continuation, discussion, and inspection choices.
35
+ - Diagnostic commands now avoid recommending broad automation when blockers or
36
+ disk-state inconsistencies make that unsafe.
37
+
38
+ ### Guardrails
39
+ - Pure completion commands can still use their normal `Suggested next` line
40
+ after a verified artifact is produced.
41
+ - `/god-mode` is not offered as a blanket answer when a blocker, failing gate,
42
+ manual repair, or unresolved ambiguity should be addressed first.
43
+ - The patch changes guidance only. It does not add slash commands, specialist
44
+ agents, workflows, recipes, schemas, or public artifact formats.
45
+
46
+ ## [1.6.8] - 2026-05-16
47
+
48
+ Staging deferral patch. Keeps Godpowers moving through local and CI-verifiable
49
+ shipping work instead of pausing early for a deployed staging URL.
50
+
51
+ ### Changed
52
+ - `god-orchestrator` now treats deployed staging verification as deferred by
53
+ default when no live target URL is evidenced and the user did not request
54
+ staging.
55
+ - `/god-mode`, `/god-deploy`, and `/god-launch` now ask for
56
+ `STAGING_APP_URL` only when the user explicitly requests staging, invokes
57
+ deployed verification, or reaches final project sign-off.
58
+ - Deploy, observe, and launch specialists now record missing deployed access in
59
+ `.godpowers/deploy/WAITING-FOR-EXTERNAL-ACCESS.md` while continuing through
60
+ local and CI-verifiable gates.
61
+
62
+ ### Guardrails
63
+ - Godpowers still never invents staging or production domains from names,
64
+ brands, titles, or common TLDs.
65
+ - Provider keys, dashboards, DNS tokens, production secrets, and admin consoles
66
+ are requested only after a named scripted check proves that exact access is
67
+ needed.
68
+ - Final sign-off can still run deployed smoke immediately when the user
69
+ provides `STAGING_APP_URL=<deployed staging origin>`.
70
+
8
71
  ## [1.6.7] - 2026-05-16
9
72
 
10
73
  Progress visibility patch. Makes Godpowers easier to follow while preserving
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [![CI](https://github.com/aihxp/godpowers/actions/workflows/ci.yml/badge.svg)](https://github.com/aihxp/godpowers/actions/workflows/ci.yml)
4
4
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
5
- [![Version](https://img.shields.io/badge/version-1.6.7-blue)](CHANGELOG.md)
5
+ [![Version](https://img.shields.io/badge/version-1.6.9-blue)](CHANGELOG.md)
6
6
  [![npm](https://img.shields.io/npm/v/godpowers.svg)](https://www.npmjs.com/package/godpowers)
7
7
 
8
8
  **Ship fast. Ship right. Ship everything. Ship accountably.**
@@ -12,10 +12,9 @@ idea to hardened production. It runs as **slash commands inside your AI coding
12
12
  tool** (Claude Code, Codex, Cursor, etc.) that orchestrate **specialist agents**
13
13
  in fresh contexts to do the work.
14
14
 
15
- Version 1.6.7 keeps the stable Godpowers surface while making the live arc
16
- easier to follow: progress reports now show percent complete, current step,
17
- recent work, and what happens next. The orchestrator also documents compact
18
- "Next step" and "Step result" cards around visible tier/sub-step work.
15
+ Version 1.6.9 keeps the stable Godpowers surface while making proposal and
16
+ status outputs easier to act on: exploratory, diagnostic, audit, lifecycle, and
17
+ decision-support commands now end with explicit proposition choices.
19
18
 
20
19
  It fuses four disciplines into one unified workflow:
21
20
 
package/RELEASE.md CHANGED
@@ -1,10 +1,11 @@
1
- # Godpowers 1.6.7 Release
1
+ # Godpowers 1.6.9 Release
2
2
 
3
3
  Date: 2026-05-16
4
4
 
5
- Godpowers 1.6.7 makes the live workflow easier to track. The goal of this
6
- patch is to answer "what is Godpowers doing, how far along is it, what just
7
- happened, and what happens next" from disk state.
5
+ Godpowers 1.6.9 makes proposal and report outputs easier to act on. The goal of
6
+ this patch is to keep Godpowers from ending a recommendation, audit, lifecycle
7
+ report, status report, or exploratory answer without offering concrete next
8
+ moves.
8
9
 
9
10
  ## What is stable
10
11
 
@@ -23,39 +24,36 @@ happened, and what happens next" from disk state.
23
24
  - Extension pack compatibility range for the 1.x line
24
25
  - Domain precision through `.godpowers/domain/GLOSSARY.md` and DG-01 through
25
26
  DG-05 checks
27
+ - GSD-style proposition closeouts for exploratory, diagnostic, audit,
28
+ lifecycle, status, reconciliation, and decision-support outputs
26
29
 
27
30
  ## What is new
28
31
 
29
- - `lib/state.progressSummary` computes percentage complete, completed step
30
- count, total step count, current step number, and current tier/sub-step from
31
- `state.json`.
32
- - `CHECKPOINT.md` can persist progress frontmatter and now includes
33
- "What happened recently" and "What happens next" sections.
34
- - `god-orchestrator` now has a Step Narration Protocol for compact
35
- "Next step" and "Step result" cards around visible tier/sub-step work.
36
- - `/god-mode`, `/god-next`, `/god-status`, and `/god-locate` now document
37
- progress, path-ahead, recent-work, and next-action summaries.
38
- - `templates/PROGRESS.md` now includes a current step plan and recent step
39
- result shape.
40
- - Package publication now allowlists `agents/god-*.md`, preventing local
41
- Pillars files under `agents/` from entering the npm payload.
42
- - Package contents checks now fail if non-specialist files under `agents/`
43
- would be published.
44
- - `AGENTS.md` now includes the Pillars Protocol for loading durable project
45
- context and workflow-state files.
46
- - Installer local mode now resolves runtime destinations under the current
47
- directory and installs only `god-*.md` specialist agent files.
48
-
49
- ## What 1.6.7 means
50
-
51
- Godpowers 1.6.7 does not expand the public command surface. It makes the
52
- existing arc more legible by showing a disk-derived progress report, a short
53
- plan before visible work starts, and a short result after work completes or
54
- pauses.
55
-
56
- The release also tightens npm packaging around specialist agents. Local
57
- project Pillars can live under `agents/` during development, but only
58
- `agents/god-*.md` files are packaged as Godpowers specialist agents.
32
+ - The core Godpowers skill now requires a `Proposition:` block after
33
+ recommendations, proposals, exploratory plans, diagnostics, status reports,
34
+ audits, lifecycle reports, reconciliations, and decision-support answers
35
+ when no command was launched.
36
+ - `/god`, `/god-next`, `/god-status`, `/god-lifecycle`, `/god-locate`,
37
+ `/god-context-scan`, `/god-preflight`, `/god-doctor`, `/god-audit`,
38
+ `/god-hygiene`, `/god-standards`, and `/god-agent-audit` now close with
39
+ concrete next choices.
40
+ - Planning and analysis commands such as `/god-discuss`, `/god-explore`,
41
+ `/god-list-assumptions`, `/god-refactor`, `/god-spike`, `/god-tech-debt`,
42
+ `/god-archaeology`, `/god-map-codebase`, `/god-reconstruct`,
43
+ `/god-design-impact`, `/god-reconcile`, and `/god-roadmap-check` now make
44
+ their next move explicit.
45
+ - Proposition blocks separate partial implementation, full implementation,
46
+ discussion, status inspection, and `/god-mode` continuation when safe.
47
+
48
+ ## What 1.6.9 means
49
+
50
+ Godpowers 1.6.9 does not expand the public command surface. It changes how
51
+ Godpowers exits proposal-like work: the user should see useful routes forward
52
+ instead of only a recommendation.
53
+
54
+ Pure completion commands can still end with a normal `Suggested next` line when
55
+ an artifact was actually produced. Proposal, diagnostic, audit, lifecycle,
56
+ status, and decision-support commands must offer a proposition block.
59
57
 
60
58
  Safe sync and unresolved Critical harden findings remain release-truth gates.
61
59
  Per-repo Quarterback ownership remains intact for Mode D suite work.
@@ -65,8 +63,8 @@ Per-repo Quarterback ownership remains intact for Mode D suite work.
65
63
  During the 1.x stability window, do not add broad new command families, change
66
64
  schema formats, or rename public artifacts without evidence from real use.
67
65
 
68
- The `v1.6.7` git tag points to the release commit that matches the npm
69
- `godpowers@1.6.7` package. Public publishes should prefer the tag-triggered
66
+ The `v1.6.9` git tag points to the release commit that matches the npm
67
+ `godpowers@1.6.9` package. Public publishes should prefer the tag-triggered
70
68
  GitHub workflow so npm provenance, git history, and release notes stay aligned.
71
69
 
72
70
  Allowed changes:
package/SKILL.md CHANGED
@@ -67,6 +67,31 @@ answer a question, inspect first. When a term is resolved, record it in
67
67
  `.godpowers/domain/GLOSSARY.md` with canonical spelling, avoided aliases,
68
68
  relationships, and any unresolved ambiguity.
69
69
 
70
+ ### 9. Proposal Closeout
71
+ When you answer with a recommendation, proposal, or exploratory plan and do not
72
+ make file edits, run commands, or hand off to another command, end with a
73
+ proposition block. The block must give the user concrete next moves instead of
74
+ leaving them at a dead stop.
75
+
76
+ This also applies to diagnostic, status, audit, lifecycle, reconciliation, and
77
+ decision-support reports when they end with suggestions, options, or a
78
+ recommended sequence.
79
+
80
+ Use this shape:
81
+
82
+ ```
83
+ Proposition:
84
+ 1. Implement partial: <smallest safe slice and command>
85
+ 2. Implement complete: <larger command or arc>
86
+ 3. Discuss more: <focused question or /god-discuss topic>
87
+ 4. Run God Mode: /god-mode <optional flags or scope>
88
+ Recommended: <one option and why>
89
+ ```
90
+
91
+ Only include options that actually fit the situation. If `/god-mode` is too
92
+ broad or unsafe for the request, say so and offer `/god-feature`,
93
+ `/god-refactor`, `/god-spike`, or `/god-discuss` instead.
94
+
70
95
  ---
71
96
 
72
97
  ## Operating Modes
@@ -65,11 +65,16 @@ Build is complete. All tests pass. `.godpowers/build/STATE.md` shows green.
65
65
  only when needed by the next command, exact provider links only when a failed
66
66
  check proves they are needed, and the command Godpowers will run after access
67
67
  exists.
68
- - Default first pause: ask only for `STAGING_APP_URL=<staging-origin>` so the
69
- real smoke command can run. Do not ask for provider keys, API tokens,
70
- dashboards, DNS tokens, production secrets, admin consoles, or test users
71
- until a named deploy, smoke, rollback, health, callback, webhook, export, or
72
- observability check cannot run without that exact item.
68
+ - Default behavior: do not pause mid-arc only to ask for
69
+ `STAGING_APP_URL=<staging-origin>`. Record deployed staging as deferred, keep
70
+ the exact smoke command in the waiting artifact, and continue through local
71
+ and CI-verifiable deploy readiness.
72
+ - Ask for `STAGING_APP_URL` only when the user explicitly requested deployed
73
+ staging, invokes `/god-deploy` for deployed verification, or reaches final
74
+ project sign-off. Do not ask for provider keys, API tokens, dashboards, DNS
75
+ tokens, production secrets, admin consoles, or test users until a named
76
+ deploy, smoke, rollback, health, callback, webhook, export, or observability
77
+ check cannot run without that exact item.
73
78
  - Treat a staging or production origin as known only when it appears in direct
74
79
  evidence: current user input, env/config values, deployment config, CI
75
80
  variable references, IaC output, hosting CLI output, or deployment docs that
@@ -122,6 +127,6 @@ Write `.godpowers/deploy/STATE.md`:
122
127
  - Paper canary (label without traffic split)
123
128
  - Broad provider checklist with no scripts or exact access bundle
124
129
  - Marks deploy done when the only verified target is missing
125
- - Requests all provider keys before the staging URL smoke check has run
130
+ - Requests provider keys before an exact scripted check proves they are needed
126
131
  - Invents or guesses a staging or production domain
127
132
  - Treats production as staging without explicit user approval
@@ -71,7 +71,8 @@ For each channel:
71
71
  `.godpowers/observe/STATE.md`.
72
72
  - If deploy or observe is waiting on external access, do not create a broad
73
73
  dashboard checklist. Reference only the smallest next access item from the
74
- waiting bundle and write launch state as `waiting-for-external-access`.
74
+ waiting bundle and write launch state as local-ready with deployed
75
+ verification deferred unless the user explicitly requested staging now.
75
76
  - If a staging or production URL is available, run or specify the exact smoke
76
77
  command and record the result.
77
78
  - If only local staging is available, run local launch-readiness checks and
@@ -85,7 +86,10 @@ For each channel:
85
86
  current. Never infer a launch URL from product name, repo name, package name,
86
87
  README title, brand name, or common TLDs.
87
88
  - If only production is known, do not treat it as staging. If no deployed
88
- origin is known, pause for `STAGING_APP_URL=<deployed staging origin>`.
89
+ origin is known, do not pause mid-arc for the staging URL. Record deployed
90
+ launch verification as deferred and ask for
91
+ `STAGING_APP_URL=<deployed staging origin>` only when the user requests
92
+ staging or final project sign-off begins.
89
93
 
90
94
  ## Output
91
95
 
@@ -17,7 +17,8 @@ Wire observability.
17
17
 
18
18
  `.godpowers/deploy/STATE.md` exists. App is deployed and reachable, or deploy
19
19
  state documents a tested local staging harness plus a single external access
20
- bundle.
20
+ bundle. A deferred staging URL must not block observability setup when local or
21
+ CI-verifiable checks can still run.
21
22
 
22
23
  ## Process
23
24
 
@@ -69,7 +70,9 @@ For each PRD success metric, define an SLO:
69
70
  Prefer local definitions as code, runbook dry-runs, log-shape checks, and CI
70
71
  verification first.
71
72
  - If a credential is truly required, append one exact access item to the single
72
- waiting access bundle, with the command that will run next.
73
+ waiting access bundle, with the command that will run next. Do not pause
74
+ mid-arc just to request the deployed staging origin unless the user has
75
+ explicitly asked to stage now.
73
76
  - Under `/god-mode --yolo`, continue through every local or CI-verifiable
74
77
  observability check before pausing for external access.
75
78
 
@@ -382,6 +382,14 @@ The shipping tier must not end by listing a broad provider checklist. God Mode
382
382
  either ships, creates the automation needed to ship, or pauses on one precise
383
383
  external access bundle.
384
384
 
385
+ Default behavior: do not pause mid-arc just to ask for a staging URL. If the
386
+ user has not explicitly requested deployed staging verification and no live
387
+ target URL is evidenced, complete every local and CI-verifiable shipping gate,
388
+ write the missing deployed-origin item to
389
+ `.godpowers/deploy/WAITING-FOR-EXTERNAL-ACCESS.md`, and continue. Ask for
390
+ `STAGING_APP_URL` only when the user requests staging, invokes `/god-deploy`
391
+ or `/god-launch` for deployed verification, or reaches final project sign-off.
392
+
385
393
  For deploy, observe, harden, and launch:
386
394
  1. Detect the target environment from deploy config, org context, env files,
387
395
  CI config, README, existing scripts, and provider CLIs.
@@ -399,29 +407,41 @@ For deploy, observe, harden, and launch:
399
407
  access bundle needed
400
408
  5. Under `--yolo`, auto-pick safe defaults for provider-neutral choices and
401
409
  continue through every local and CI-verifiable gate.
402
- 6. Only pause when real external access is required and absent. The pause must
403
- ask for the smallest next input needed to run the next concrete check. The
404
- first pause should usually ask only for the deployed staging origin, for
405
- example `STAGING_APP_URL=<staging-origin>`. Do not ask for API keys,
406
- provider dashboards, DNS tokens, production secrets, or admin consoles until
407
- a specific scripted check cannot run without that exact access.
408
- 7. Do not say "Suggested next" for a blocked shipping tier. Say either
409
- `Arc complete` or `PAUSE: external access required`, with the exact artifact
410
- that lists the required bundle.
410
+ 6. If deployed verification is deferred by default, mark the shipping artifact
411
+ as local/CI ready and continue. Do not pause for `STAGING_APP_URL` yet.
412
+ 7. Only pause when the user explicitly requested deployed staging or final
413
+ sign-off requires a real deployed check. The pause must ask for the smallest
414
+ next input needed to run the next concrete check. The first external pause
415
+ should usually ask only for the deployed staging origin, for example
416
+ `STAGING_APP_URL=<staging-origin>`. Do not ask for API keys, provider
417
+ dashboards, DNS tokens, production secrets, or admin consoles until a
418
+ specific scripted check cannot run without that exact access.
419
+ 8. At final sign-off, if deployed verification is still deferred, present:
420
+ "Local and CI-verifiable closure is complete. Provide
421
+ `STAGING_APP_URL=<deployed staging origin>` to run deployed smoke now, say
422
+ `sign off local-only` to finish with deployed verification deferred, or run
423
+ `/god-deploy --stage` later."
424
+ 9. Do not say "Suggested next" for a blocked shipping tier. Say either
425
+ `Arc complete`, `Arc complete with deployed verification deferred`, or
426
+ `PAUSE: external access required`, with the exact artifact that lists the
427
+ required bundle.
411
428
 
412
429
  ### External Access Ladder
413
430
 
414
431
  Use this order when external access is missing:
415
432
 
416
- 1. Ask for the deployed staging origin only if no live target URL is known from
417
- explicit evidence.
418
- 2. Run the real staging smoke command against that origin.
419
- 3. Ask for a provider key, dashboard, admin console, or test user only when a
433
+ 1. If no live target URL is known from explicit evidence, defer the deployed
434
+ staging origin request unless the user asked to stage now or the arc has
435
+ reached final sign-off.
436
+ 2. When staging is requested or final sign-off begins, ask for the deployed
437
+ staging origin only.
438
+ 3. Run the real staging smoke command against that origin.
439
+ 4. Ask for a provider key, dashboard, admin console, or test user only when a
420
440
  named smoke, callback, webhook, export, observability, or rollback check
421
441
  fails or cannot execute without that exact item.
422
- 4. Add at most one new access item per pause unless several items are required
442
+ 5. Add at most one new access item per pause unless several items are required
423
443
  by the same command invocation.
424
- 5. Every access request must include the command that will run next and the
444
+ 6. Every access request must include the command that will run next and the
425
445
  artifact that will be updated after it runs.
426
446
 
427
447
  Never request every possible key or API at the start of shipping. Keys and API
@@ -441,8 +461,10 @@ evidence:
441
461
  Never invent domains from the product name, package name, repo name, README
442
462
  title, brand name, or common TLDs. Never turn `scriven` into
443
463
  `https://scriven.app`, or any similar guessed URL. If only production is known,
444
- do not call it staging. If only local URLs exist, run local smoke only and pause
445
- for `STAGING_APP_URL=<deployed staging origin>` before deployed staging smoke.
464
+ do not call it staging. If only local URLs exist, run local smoke only, record
465
+ deployed staging as deferred, and ask for
466
+ `STAGING_APP_URL=<deployed staging origin>` only when staging is explicitly
467
+ requested or final sign-off begins.
446
468
 
447
469
  ## YOLO Behavior with Design + Linkage
448
470
 
@@ -726,8 +748,8 @@ Hide:
726
748
 
727
749
  When a private rule affects a pause, translate it into the smallest
728
750
  user-facing question. Do not expose the rule itself. Example: ask for
729
- `STAGING_APP_URL=<deployed staging origin>` rather than showing the Shipping
730
- Closure Protocol.
751
+ `STAGING_APP_URL=<deployed staging origin>` at final sign-off rather than
752
+ showing the Shipping Closure Protocol.
731
753
 
732
754
  ## Step Narration Protocol
733
755
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "godpowers",
3
- "version": "1.6.7",
3
+ "version": "1.6.9",
4
4
  "description": "AI-powered development system: 106 slash commands and 39 specialist agents that take a project from raw idea to hardened production. Runs inside Claude Code, Codex, Cursor, Windsurf, Gemini, and 10+ other AI coding tools.",
5
5
  "bin": {
6
6
  "godpowers": "./bin/install.js"
@@ -62,6 +62,13 @@ Warnings:
62
62
 
63
63
  Infos: 90 missing-recommended-section suggestions across agents
64
64
  (run with --json for full list)
65
+
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]
65
72
  ```
66
73
 
67
74
  ## Backward-compatibility promise
@@ -45,4 +45,11 @@ Suggested next:
45
45
  /god-reconstruct - reverse-engineer planning artifacts from this code
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
+
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.
48
55
  ```
@@ -52,6 +52,16 @@ 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:
56
+
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]
64
+ ```
55
65
 
56
66
  ## Output Format
57
67
 
@@ -89,6 +89,19 @@ Suggested next:
89
89
  2. Accept the 2 new todos: /god-check-todos
90
90
  ```
91
91
 
92
+ ## Proposition Closeout
93
+
94
+ End every context scan report with a proposition block:
95
+
96
+ ```
97
+ Proposition:
98
+ 1. Implement partial: [first suggested action, usually /god-locate or /god-repair]
99
+ 2. Implement complete: resolve all error and warn drifts, then rerun /god-context-scan
100
+ 3. Discuss more: /god-discuss context drift
101
+ 4. Inspect status: /god-status after re-orientation
102
+ Recommended: [one option and why]
103
+ ```
104
+
92
105
  ## What this does NOT do
93
106
 
94
107
  - Does not modify state. Read-only.
@@ -27,11 +27,12 @@ After god-deploy-engineer returns:
27
27
  - real staging or production target tested
28
28
  - local staging harness tested with equivalent health, smoke, and rollback
29
29
  commands
30
- - paused on `.godpowers/deploy/WAITING-FOR-EXTERNAL-ACCESS.md` with one
31
- exact missing access bundle
32
- 4. Update `.godpowers/PROGRESS.md`: Deploy status = done only for a tested real
33
- target or tested local staging harness. If external access is missing, mark
34
- Deploy = waiting-for-external-access, not done.
30
+ - local/CI deploy readiness complete with deployed staging verification
31
+ deferred in `.godpowers/deploy/WAITING-FOR-EXTERNAL-ACCESS.md`
32
+ 4. Update `.godpowers/PROGRESS.md`: Deploy status can be done when a tested
33
+ real target or tested local staging harness exists. If deployed staging is
34
+ deferred, annotate Deploy as done-local with the waiting artifact path and
35
+ do not pause unless the user explicitly requested staging.
35
36
 
36
37
  ## On Completion
37
38
 
@@ -44,11 +45,14 @@ Suggested next: /god-observe (wire SLOs, alerts, runbooks)
44
45
  Under `/god-mode --yolo`, do not stop with a provider checklist. Create or
45
46
  update the deploy scripts, smoke command, rollback command, health endpoints,
46
47
  env manifest, and local staging harness first. If real external access is still
47
- required, pause on the single access bundle in
48
- `.godpowers/deploy/WAITING-FOR-EXTERNAL-ACCESS.md`.
49
-
50
- The single access bundle must be incremental. Ask for the smallest next item
51
- needed to run the next command. If no live target URL is known, ask only for
48
+ required, record the single access bundle in
49
+ `.godpowers/deploy/WAITING-FOR-EXTERNAL-ACCESS.md` and continue until the user
50
+ requests staging or final sign-off begins.
51
+
52
+ The single access bundle must be incremental. Do not ask for
53
+ `STAGING_APP_URL` mid-arc unless the user requested deployed staging. At final
54
+ sign-off or explicit staging, ask for the smallest next item needed to run the
55
+ next command. If no live target URL is known, ask only for
52
56
  `STAGING_APP_URL=<staging-origin>` and the exact smoke command that will run.
53
57
  Do not ask for provider keys, API tokens, dashboards, DNS tokens, production
54
58
  secrets, admin consoles, or test users until a specific scripted check proves
@@ -59,8 +63,8 @@ values, deployment config, CI variable references, IaC output, hosting CLI
59
63
  output, or deployment docs that explicitly label the URL as owned and current.
60
64
  Never invent a domain from the product name, repo name, package name, README
61
65
  title, brand name, or common TLDs. If only local URLs exist, run local smoke
62
- only and pause for `STAGING_APP_URL=<deployed staging origin>`. If only
63
- production is known, do not use it as staging without explicit user approval.
66
+ only, record deployed staging as deferred, and continue. If only production is
67
+ known, do not use it as staging without explicit user approval.
64
68
 
65
69
 
66
70
  ## Re-invocation contract
@@ -65,6 +65,14 @@ Transitive (depth 2):
65
65
 
66
66
  Recommendation: Run /god-design with this change to apply.
67
67
  god-design-reviewer will gate via two-stage review.
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 arc
74
+ Recommended: apply the smallest design change first when severity is warning
75
+ or higher.
68
76
  ```
69
77
 
70
78
  ## When this skill helps
@@ -67,4 +67,11 @@ Key findings:
67
67
  - [term or ambiguity resolved]
68
68
 
69
69
  Suggested next: [the planning command this discussion was for]
70
+
71
+ Proposition:
72
+ 1. Implement partial: [smallest safe slice or planning command]
73
+ 2. Implement complete: [full command that consumes this brief]
74
+ 3. Discuss more: /god-discuss [specific unresolved question]
75
+ 4. Run God Mode: /god-mode [scope] if the user wants autonomous execution
76
+ Recommended: [one option and why]
70
77
  ```
@@ -65,6 +65,23 @@ Suggested next steps:
65
65
  2. /god-restore (review trash)
66
66
  ```
67
67
 
68
+ ## Proposition Closeout
69
+
70
+ End every human-readable doctor report with a proposition block:
71
+
72
+ ```
73
+ Proposition:
74
+ 1. Implement partial: [safest single fix or diagnostic follow-up]
75
+ 2. Implement complete: /god-doctor --fix when all proposed fixes are safe categories
76
+ 3. Discuss more: /god-discuss [highest-risk warning or unclear repair]
77
+ 4. Inspect status: /god-status after repair
78
+ Recommended: [one option and why it is safe]
79
+ ```
80
+
81
+ If the report contains errors that need manual repair, do not recommend
82
+ `/god-doctor --fix` as complete. Recommend the highest-priority manual repair
83
+ or `/god-repair` instead.
84
+
68
85
  ## Subcommands
69
86
 
70
87
  ### `/god-doctor`
@@ -47,4 +47,12 @@ Idea explored. Suggested framing:
47
47
 
48
48
  Suggested next: /god-init (commit to this framing) or /god-explore again
49
49
  (if you want to try another angle)
50
+
51
+ Proposition:
52
+ 1. Implement partial: /god-init with this framing and stop after PRD
53
+ 2. Implement complete: /god-mode with this framing for the full arc
54
+ 3. Discuss more: /god-explore again with the weakest assumption
55
+ 4. Run God Mode: /god-mode if the user is ready to build now
56
+ Recommended: /god-init when the framing feels stable enough to turn into
57
+ requirements.
50
58
  ```
@@ -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
@@ -52,12 +52,15 @@ Or: /god-status (see the final state)
52
52
  Under `/god-mode --yolo`, do not stop by listing provider dashboards. Create
53
53
  the launch runbook, smoke command, source attribution plan, and local
54
54
  launch-readiness checks. If real launch is blocked by missing external access,
55
- pause on the single access bundle from deploy or launch state.
55
+ record the single access bundle from deploy or launch state and continue until
56
+ the user requests staging or final sign-off begins.
56
57
 
57
58
  The launch pause must not expand into every possible channel, analytics, or
58
59
  provider credential. Ask only for the next missing access item needed to run a
59
- named live smoke, launch-readiness, attribution, or monitoring check. If no
60
- live target URL is known, ask only for `STAGING_APP_URL=<staging-origin>`.
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.
62
+ At final sign-off, if no live target URL is known, ask only for
63
+ `STAGING_APP_URL=<staging-origin>`.
61
64
 
62
65
  Live target URLs must be evidence-backed. Never invent a domain from the
63
66
  product name, repo name, package name, README title, brand name, or common TLDs.
@@ -111,6 +111,31 @@ Suggested next: /god-spike with narrower question
111
111
  Or: archive the spike if no longer relevant
112
112
  ```
113
113
 
114
+ ## Proposition Closeout
115
+
116
+ Every lifecycle report must end with a proposition block. Use the detected
117
+ phase to fill in concrete commands:
118
+
119
+ ```
120
+ Proposition:
121
+ 1. Implement partial: [smallest safe next command from the lifecycle report]
122
+ 2. Implement complete: /god-mode [resume or scope] when the phase is safe for an autonomous arc
123
+ 3. Discuss more: /god-discuss [unclear phase, blocker, or choice]
124
+ 4. Inspect status: /god-status or /god-next
125
+ Recommended: [one option and why it matches the detected phase]
126
+ ```
127
+
128
+ For hard blockers, such as post-incident pending, replace the broad options
129
+ with the required next command plus inspect and discuss alternatives:
130
+
131
+ ```
132
+ Proposition:
133
+ 1. Resolve required next: /god-postmortem
134
+ 2. Inspect first: /god-status
135
+ 3. Discuss blocker: /god-discuss incident follow-up
136
+ Recommended: /god-postmortem because the incident learning loop is still open.
137
+ ```
138
+
114
139
  ## Have-Nots
115
140
 
116
141
  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 arc 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"
@@ -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
  ```
@@ -94,18 +94,20 @@ You are receiving a /god-mode invocation. Your job is to spawn the
94
94
  security or a genuine human-only decision.
95
95
  - Instruction that deploy, observe, harden, and launch must follow the
96
96
  Shipping Closure Protocol: verify a real environment when available,
97
- otherwise create local/CI-verifiable deploy automation and pause only
98
- for one exact external access bundle.
97
+ otherwise create local/CI-verifiable deploy automation, defer deployed
98
+ staging by default, and continue until the user requests staging or the
99
+ arc reaches final sign-off.
99
100
  - Instruction that keys, API tokens, dashboards, admin consoles, and
100
- provider-specific access are last-mile inputs. The first external pause
101
- should ask only for the smallest next item needed by a concrete command,
102
- usually `STAGING_APP_URL=<staging-origin>`. Ask for additional provider
103
- access only after a named check proves it is needed.
101
+ provider-specific access are last-mile inputs. Do not pause mid-arc for
102
+ `STAGING_APP_URL` unless the user requested deployed staging. At final
103
+ sign-off, ask only for the smallest next item needed by a concrete
104
+ command, usually `STAGING_APP_URL=<staging-origin>`. Ask for additional
105
+ provider access only after a named check proves it is needed.
104
106
  - Instruction that staging, preview, and production URLs must come from
105
107
  direct evidence. Never infer or invent a domain from project name,
106
108
  package name, repo name, README title, or brand name. If no deployed
107
- origin is evidenced, pause for
108
- `STAGING_APP_URL=<deployed staging origin>`.
109
+ origin is evidenced, record deployed staging as deferred and continue
110
+ until staging is requested or final sign-off begins.
109
111
  - Instruction that brownfield and bluefield greenfield simulation audits
110
112
  must be acted on by god-greenfieldifier. The greenfieldifier writes
111
113
  `.godpowers/audit/GREENFIELDIFY-PLAN.md`, pauses before risky canonical
@@ -181,8 +183,8 @@ Hide:
181
183
 
182
184
  If an internal instruction must influence a pause, translate it into the
183
185
  smallest user-facing question. For example, ask for
184
- `STAGING_APP_URL=<deployed staging origin>` instead of exposing the full
185
- Shipping Closure Protocol.
186
+ `STAGING_APP_URL=<deployed staging origin>` at final sign-off instead of
187
+ exposing the full Shipping Closure Protocol.
186
188
 
187
189
  ## Step Cards
188
190
 
@@ -312,3 +312,21 @@ Previous tier had standards failures. Address before proceeding:
312
312
  - [failure 2]
313
313
  Suggested: /god-redo [tier] OR /god-skip [tier] --reason="..."
314
314
  ```
315
+
316
+ ## Proposition Closeout
317
+
318
+ Every `/god-next` response must end with a proposition block unless it already
319
+ launched the selected command:
320
+
321
+ ```
322
+ Proposition:
323
+ 1. Implement partial: [single suggested command]
324
+ 2. Implement complete: [recipe sequence or /god-mode when safe]
325
+ 3. Discuss more: /god-discuss [routing ambiguity or missing prerequisite]
326
+ 4. Inspect status: /god-status or /god-locate
327
+ Recommended: [one option and why]
328
+ ```
329
+
330
+ For missing prerequisites, the partial option is the auto-completable
331
+ prerequisite. For standards failures, the partial option is `/god-redo` with
332
+ feedback and the complete option is blocked until the gate passes.
@@ -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 arc-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.
@@ -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 arc
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
 
@@ -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 arc
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
@@ -92,6 +92,23 @@ Suite (Mode D) status:
92
92
  Next: god roadmap
93
93
  ```
94
94
 
95
+ ## Proposition Closeout
96
+
97
+ Every status report must end with a proposition block so the user can choose
98
+ how much momentum to give Godpowers:
99
+
100
+ ```
101
+ Proposition:
102
+ 1. Implement partial: [single next command from "What happens next"]
103
+ 2. Implement complete: /god-mode to continue the current arc when no blockers are present
104
+ 3. Discuss more: /god-discuss [unclear state, blocker, or inconsistency]
105
+ 4. Inspect status: /god-locate or /god-next for a smaller routing view
106
+ Recommended: [one option and why it fits the disk-derived state]
107
+ ```
108
+
109
+ If inconsistencies are present, make `/god-repair` the partial option and do
110
+ not recommend `/god-mode` until disk state is coherent.
111
+
95
112
  ## Mode D awareness
96
113
 
97
114
  If `lib/multi-repo-detector.detect(projectRoot)` returns
@@ -53,4 +53,12 @@ Suggested next:
53
53
  - /god-update-deps if dependency debt is a P0/P1 driver
54
54
  - /god-upgrade for major-version migrations
55
55
  - Re-run /god-tech-debt quarterly
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 arc
62
+ Recommended: start with the top P0 item, then re-run /god-tech-debt after it
63
+ lands.
56
64
  ```
package/skills/god.md CHANGED
@@ -112,6 +112,22 @@ Recipes that fit your current state:
112
112
  Run structural next? (yes / pick recipe / cancel)
113
113
  ```
114
114
 
115
+ If the answer is exploratory and proposes an approach instead of selecting or
116
+ running a command, close with:
117
+
118
+ ```
119
+ Proposition:
120
+ 1. Implement partial: <smallest safe command or slice>
121
+ 2. Implement complete: <full command sequence>
122
+ 3. Discuss more: /god-discuss <topic or unresolved question>
123
+ 4. Run God Mode: /god-mode <scope> if the user wants the full autonomous arc
124
+ Recommended: <one option and why>
125
+ ```
126
+
127
+ Do not include a God Mode option when the request is clearly a tiny fix,
128
+ single-file change, or narrow question. In that case, replace it with the
129
+ smallest matching command, such as `/god-fast`, `/god-spike`, or `/god-next`.
130
+
115
131
  ### Step 4: execute or hand off
116
132
 
117
133
  If user confirms a recipe: