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.
- package/CHANGELOG.md +67 -0
- package/README.md +9 -8
- package/RELEASE.md +33 -32
- package/SKILL.md +91 -2
- package/agents/god-auditor.md +4 -4
- package/agents/god-coordinator.md +4 -4
- package/agents/god-deploy-engineer.md +1 -1
- package/agents/god-greenfieldifier.md +1 -1
- package/agents/god-launch-strategist.md +1 -1
- package/agents/god-observability-engineer.md +1 -1
- package/agents/god-orchestrator.md +82 -24
- package/agents/god-reconciler.md +1 -1
- package/bin/install.js +1 -1
- package/hooks/session-start.sh +2 -2
- package/lib/checkpoint.js +4 -1
- package/lib/context-writer.js +1 -1
- package/package.json +1 -1
- package/references/HAVE-NOTS.md +1 -1
- package/references/orchestration/SCALE-DETECTION.md +1 -1
- package/references/shared/GLOSSARY.md +1 -1
- package/references/shared/ORCHESTRATORS.md +1 -1
- package/routing/god-mode.yaml +1 -1
- package/routing/god-preflight.yaml +1 -1
- package/routing/recipes/add-feature-mid-arc-pause.yaml +4 -4
- package/routing/recipes/bluefield-org-aware.yaml +1 -1
- package/routing/recipes/brownfield-onboarding.yaml +1 -1
- package/routing/recipes/greenfield-fast.yaml +1 -1
- package/routing/recipes/greenfield-with-ideation.yaml +1 -1
- package/skills/god-agent-audit.md +7 -0
- package/skills/god-archaeology.md +7 -0
- package/skills/god-audit.md +11 -1
- package/skills/god-context-scan.md +13 -0
- package/skills/god-context.md +1 -1
- package/skills/god-deploy.md +1 -1
- package/skills/god-design-impact.md +8 -0
- package/skills/god-discuss.md +7 -0
- package/skills/god-doctor.md +17 -0
- package/skills/god-explore.md +8 -0
- package/skills/god-extract-learnings.md +1 -1
- package/skills/god-feature.md +1 -1
- package/skills/god-hotfix.md +1 -1
- package/skills/god-hygiene.md +8 -1
- package/skills/god-init.md +1 -1
- package/skills/god-launch.md +1 -1
- package/skills/god-lifecycle.md +33 -5
- package/skills/god-list-assumptions.md +13 -0
- package/skills/god-locate.md +16 -0
- package/skills/god-logs.md +1 -1
- package/skills/god-map-codebase.md +8 -0
- package/skills/god-mode.md +55 -17
- package/skills/god-next.md +32 -4
- package/skills/god-org-context.md +1 -1
- package/skills/god-preflight.md +18 -4
- package/skills/god-quick.md +1 -1
- package/skills/god-reconcile.md +6 -1
- package/skills/god-reconstruct.md +8 -0
- package/skills/god-refactor.md +23 -0
- package/skills/god-roadmap-check.md +10 -0
- package/skills/god-roadmap-update.md +1 -1
- package/skills/god-skip.md +1 -1
- package/skills/god-spike.md +7 -0
- package/skills/god-standards.md +7 -0
- package/skills/god-status.md +25 -0
- package/skills/god-suite-init.md +1 -1
- package/skills/god-suite-release.md +1 -1
- package/skills/god-suite-status.md +1 -1
- package/skills/god-suite-sync.md +1 -1
- package/skills/god-tech-debt.md +8 -0
- package/skills/god.md +23 -7
- package/workflows/bluefield-arc.yaml +1 -1
- package/workflows/brownfield-arc.yaml +1 -1
- package/workflows/feature-arc.yaml +1 -1
package/skills/god-hotfix.md
CHANGED
|
@@ -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
|
|
20
|
+
- Waiting for a normal /god-mode project run is unacceptable
|
|
21
21
|
|
|
22
22
|
## When NOT to use
|
|
23
23
|
|
package/skills/god-hygiene.md
CHANGED
|
@@ -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
|
|
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
|
package/skills/god-init.md
CHANGED
|
@@ -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
|
|
263
|
+
Suggested next: /god-prd for requirements, or /god-mode for the full autonomous project run.
|
|
264
264
|
```
|
package/skills/god-launch.md
CHANGED
|
@@ -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-
|
|
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
|
|
package/skills/god-lifecycle.md
CHANGED
|
@@ -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
|
|
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
|
|
39
|
+
/god-mode Run full autonomous project run (will init first)
|
|
40
40
|
```
|
|
41
41
|
|
|
42
|
-
### In
|
|
42
|
+
### In Progress
|
|
43
43
|
```
|
|
44
|
-
Lifecycle: In
|
|
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 (
|
|
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")
|
package/skills/god-locate.md
CHANGED
|
@@ -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"
|
package/skills/god-logs.md
CHANGED
|
@@ -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
|
|
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
|
```
|
package/skills/god-mode.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: god-mode
|
|
3
3
|
description: |
|
|
4
|
-
Full autonomous
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
-
|
|
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-
|
|
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
|
|
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
|
|
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
|
-
`
|
|
145
|
+
`Project run complete` or `PAUSE: external access required` block.
|
|
145
146
|
|
|
146
147
|
8. Orchestrator runs the appropriate workflow:
|
|
147
|
-
- Greenfield -> full
|
|
148
|
-
- Brownfield -> brownfield
|
|
149
|
-
- Bluefield -> bluefield
|
|
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
|
|
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
|
|
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
|
|
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
|
-
|
|
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.
|
package/skills/god-next.md
CHANGED
|
@@ -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
|
|
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
|
|
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
|
|
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,
|
|
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
|
|
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
|
```
|
package/skills/god-preflight.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: god-preflight
|
|
3
3
|
description: |
|
|
4
|
-
Run a read-only intake audit before
|
|
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
|
|
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
|
|
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
|
|
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.
|
package/skills/god-quick.md
CHANGED
package/skills/god-reconcile.md
CHANGED
|
@@ -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
|
-
|
|
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
|
package/skills/god-refactor.md
CHANGED
|
@@ -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-
|
|
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
|
|
package/skills/god-skip.md
CHANGED
|
@@ -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
|
|
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
|
|
package/skills/god-spike.md
CHANGED
|
@@ -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
|
|
package/skills/god-standards.md
CHANGED
|
@@ -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
|