godpowers 1.6.9 → 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 +29 -0
- package/README.md +9 -8
- package/RELEASE.md +31 -32
- package/SKILL.md +67 -3
- 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-audit.md +1 -1
- package/skills/god-context.md +1 -1
- package/skills/god-deploy.md +1 -1
- package/skills/god-design-impact.md +1 -1
- package/skills/god-explore.md +1 -1
- 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 +1 -1
- package/skills/god-init.md +1 -1
- package/skills/god-launch.md +1 -1
- package/skills/god-lifecycle.md +9 -6
- package/skills/god-locate.md +1 -1
- package/skills/god-logs.md +1 -1
- package/skills/god-mode.md +55 -17
- package/skills/god-next.md +14 -4
- package/skills/god-org-context.md +1 -1
- package/skills/god-preflight.md +5 -5
- package/skills/god-quick.md +1 -1
- package/skills/god-refactor.md +1 -1
- package/skills/god-roadmap-update.md +1 -1
- package/skills/god-skip.md +1 -1
- package/skills/god-spike.md +1 -1
- package/skills/god-status.md +9 -1
- 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 +1 -1
- package/skills/god.md +8 -8
- package/workflows/bluefield-arc.yaml +1 -1
- package/workflows/brownfield-arc.yaml +1 -1
- package/workflows/feature-arc.yaml +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,35 @@ 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.10] - 2026-05-16
|
|
9
|
+
|
|
10
|
+
Progress visibility and plain-language closeout patch.
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
- Added a core user-facing vocabulary rule: visible output should say
|
|
14
|
+
"project run", "workflow", "phase", "current step", or "current milestone"
|
|
15
|
+
instead of unexplained internal "arc" jargon.
|
|
16
|
+
- Added `Planning visibility` blocks to status, next-step, God Mode, and
|
|
17
|
+
orchestrator closeout guidance. These blocks surface PRD status, roadmap
|
|
18
|
+
status, current milestone, and completion basis when those artifacts exist or
|
|
19
|
+
are expected.
|
|
20
|
+
|
|
21
|
+
### Changed
|
|
22
|
+
- Reworded installer, session-start, `/god`, `/god-mode`, lifecycle, status,
|
|
23
|
+
routing, workflow, and specialist guidance to use plain project-run language
|
|
24
|
+
in user-visible text.
|
|
25
|
+
- Checkpoint and session-start summaries now display lifecycle `in-arc` as
|
|
26
|
+
"in progress" while preserving the internal state key for compatibility.
|
|
27
|
+
- God Mode completion guidance now ends with current status, planning
|
|
28
|
+
visibility, open items, and a concrete next recommendation.
|
|
29
|
+
|
|
30
|
+
### Guardrails
|
|
31
|
+
- Internal workflow names and state constants such as `full-arc.yaml` and
|
|
32
|
+
`in-arc` remain unchanged for compatibility.
|
|
33
|
+
- The patch changes guidance and display wording only. It does not add slash
|
|
34
|
+
commands, specialist agents, workflows, recipes, schemas, or public artifact
|
|
35
|
+
formats.
|
|
36
|
+
|
|
8
37
|
## [1.6.9] - 2026-05-16
|
|
9
38
|
|
|
10
39
|
Proposal closeout patch. Makes Godpowers end exploratory, diagnostic, audit,
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://github.com/aihxp/godpowers/actions/workflows/ci.yml)
|
|
4
4
|
[](LICENSE)
|
|
5
|
-
[](CHANGELOG.md)
|
|
6
6
|
[](https://www.npmjs.com/package/godpowers)
|
|
7
7
|
|
|
8
8
|
**Ship fast. Ship right. Ship everything. Ship accountably.**
|
|
@@ -12,9 +12,10 @@ 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.
|
|
16
|
-
|
|
17
|
-
|
|
15
|
+
Version 1.6.10 keeps the stable Godpowers surface while making progress more
|
|
16
|
+
visible: user-facing output now prefers "project run" over internal "arc"
|
|
17
|
+
jargon and status closeouts show PRD, roadmap, milestone, and completion
|
|
18
|
+
position when available.
|
|
18
19
|
|
|
19
20
|
It fuses four disciplines into one unified workflow:
|
|
20
21
|
|
|
@@ -57,7 +58,7 @@ Open your AI coding tool in any project directory and type:
|
|
|
57
58
|
/god-mode
|
|
58
59
|
```
|
|
59
60
|
|
|
60
|
-
That
|
|
61
|
+
That starts the autonomous project run. It will run all tiers from idea to hardened
|
|
61
62
|
production, pausing only when it has a real question for you.
|
|
62
63
|
|
|
63
64
|
### Just describe what you want
|
|
@@ -66,7 +67,7 @@ If you don't know which command to run, type free text after `/god`:
|
|
|
66
67
|
|
|
67
68
|
```
|
|
68
69
|
/god production is broken
|
|
69
|
-
/god add a feature without breaking the current
|
|
70
|
+
/god add a feature without breaking the current project run
|
|
70
71
|
/god I'm coming back after a week
|
|
71
72
|
```
|
|
72
73
|
|
|
@@ -106,7 +107,7 @@ when you open a new session in a Godpowers project.
|
|
|
106
107
|
| Command | What it does | Spawns agent |
|
|
107
108
|
|---------|--------------|--------------|
|
|
108
109
|
| `/god` | Front door: match free-text intent to a command sequence | (built-in) |
|
|
109
|
-
| `/god-mode` | Full autonomous
|
|
110
|
+
| `/god-mode` | Full autonomous project run | god-orchestrator |
|
|
110
111
|
| `/god-next` | Auto-detect and suggest the next command | (built-in) |
|
|
111
112
|
| `/god-init` | Start a project, detect mode and scale | (built-in) |
|
|
112
113
|
| `/god-prd` | Write the PRD | god-pm |
|
|
@@ -121,7 +122,7 @@ when you open a new session in a Godpowers project.
|
|
|
121
122
|
| `/god-launch` | Launch (gated on harden) | god-launch-strategist |
|
|
122
123
|
| `/god-harden` | Adversarial security review | god-harden-auditor |
|
|
123
124
|
| `/god-status` | Re-derive state from disk | (built-in) |
|
|
124
|
-
| `/god-preflight` | Read-only intake audit before
|
|
125
|
+
| `/god-preflight` | Read-only intake audit before project-run readiness and pillars | god-auditor |
|
|
125
126
|
| `/god-audit` | Score artifacts against have-nots | god-auditor |
|
|
126
127
|
| `/god-debug` | 4-phase systematic debug | god-debugger |
|
|
127
128
|
| `/god-review` | Two-stage code review | god-spec-reviewer + god-quality-reviewer |
|
package/RELEASE.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
# Godpowers 1.6.
|
|
1
|
+
# Godpowers 1.6.10 Release
|
|
2
2
|
|
|
3
3
|
Date: 2026-05-16
|
|
4
4
|
|
|
5
|
-
Godpowers 1.6.
|
|
6
|
-
this patch is to keep
|
|
7
|
-
|
|
8
|
-
|
|
5
|
+
Godpowers 1.6.10 makes progress easier to understand while work is running and
|
|
6
|
+
when it closes. The goal of this patch is to keep user-facing output from
|
|
7
|
+
requiring internal "arc" vocabulary and to show PRD, roadmap, milestone, and
|
|
8
|
+
completion position wherever status is reported.
|
|
9
9
|
|
|
10
10
|
## What is stable
|
|
11
11
|
|
|
@@ -26,34 +26,33 @@ moves.
|
|
|
26
26
|
DG-05 checks
|
|
27
27
|
- GSD-style proposition closeouts for exploratory, diagnostic, audit,
|
|
28
28
|
lifecycle, status, reconciliation, and decision-support outputs
|
|
29
|
+
- Plain-language project-run wording in user-facing reports
|
|
30
|
+
- Planning visibility blocks for PRD, roadmap, milestone, and completion basis
|
|
29
31
|
|
|
30
32
|
## What is new
|
|
31
33
|
|
|
32
|
-
- The core Godpowers skill now
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
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.
|
|
34
|
+
- The core Godpowers skill now defines "arc" as internal vocabulary and tells
|
|
35
|
+
user-facing output to prefer "project run", "workflow", "phase", "current
|
|
36
|
+
step", or "current milestone".
|
|
37
|
+
- `/god-mode`, `god-orchestrator`, `/god-status`, `/god-next`, and
|
|
38
|
+
`/god-lifecycle` now include planning visibility guidance for PRD, roadmap,
|
|
39
|
+
milestone, and percent complete when the information is available.
|
|
40
|
+
- The installer, session-start hook, `/god` front door, routing descriptions,
|
|
41
|
+
workflow descriptions, and high-traffic skill propositions now use
|
|
42
|
+
project-run language instead of unexplained "arc" wording.
|
|
43
|
+
- Checkpoint and session-start summaries display lifecycle `in-arc` as
|
|
44
|
+
"in progress" while preserving the internal state key for compatibility.
|
|
45
|
+
|
|
46
|
+
## What 1.6.10 means
|
|
47
|
+
|
|
48
|
+
Godpowers 1.6.10 does not expand the public command surface. It changes how
|
|
49
|
+
Godpowers explains itself: the user should see the current project run, PRD,
|
|
50
|
+
roadmap, milestone, completion percentage, open items, and next action without
|
|
51
|
+
decoding internal terminology.
|
|
52
|
+
|
|
53
|
+
Internal workflow names and state constants such as `full-arc.yaml` and
|
|
54
|
+
`in-arc` remain unchanged for compatibility. Visible reports should translate
|
|
55
|
+
them to plain language.
|
|
57
56
|
|
|
58
57
|
Safe sync and unresolved Critical harden findings remain release-truth gates.
|
|
59
58
|
Per-repo Quarterback ownership remains intact for Mode D suite work.
|
|
@@ -63,8 +62,8 @@ Per-repo Quarterback ownership remains intact for Mode D suite work.
|
|
|
63
62
|
During the 1.x stability window, do not add broad new command families, change
|
|
64
63
|
schema formats, or rename public artifacts without evidence from real use.
|
|
65
64
|
|
|
66
|
-
The `v1.6.
|
|
67
|
-
`godpowers@1.6.
|
|
65
|
+
The `v1.6.10` git tag points to the release commit that matches the npm
|
|
66
|
+
`godpowers@1.6.10` package. Public publishes should prefer the tag-triggered
|
|
68
67
|
GitHub workflow so npm provenance, git history, and release notes stay aligned.
|
|
69
68
|
|
|
70
69
|
Allowed changes:
|
package/SKILL.md
CHANGED
|
@@ -82,7 +82,7 @@ Use this shape:
|
|
|
82
82
|
```
|
|
83
83
|
Proposition:
|
|
84
84
|
1. Implement partial: <smallest safe slice and command>
|
|
85
|
-
2. Implement complete: <larger command or
|
|
85
|
+
2. Implement complete: <larger command or project run>
|
|
86
86
|
3. Discuss more: <focused question or /god-discuss topic>
|
|
87
87
|
4. Run God Mode: /god-mode <optional flags or scope>
|
|
88
88
|
Recommended: <one option and why>
|
|
@@ -92,11 +92,75 @@ Only include options that actually fit the situation. If `/god-mode` is too
|
|
|
92
92
|
broad or unsafe for the request, say so and offer `/god-feature`,
|
|
93
93
|
`/god-refactor`, `/god-spike`, or `/god-discuss` instead.
|
|
94
94
|
|
|
95
|
+
### 10. Completion Closeout
|
|
96
|
+
When you complete work, especially from `/god-mode`, `/god-build`,
|
|
97
|
+
`/god-feature`, `/god-hotfix`, `/god-refactor`, `/god-quick`, or any command
|
|
98
|
+
that edits code or artifacts, do not stop at "complete" plus validation. End
|
|
99
|
+
with a disk-derived closeout that tells the user the current state and what is
|
|
100
|
+
next.
|
|
101
|
+
|
|
102
|
+
Use this shape:
|
|
103
|
+
|
|
104
|
+
```
|
|
105
|
+
Current status:
|
|
106
|
+
State: <complete | partial | blocked | complete with deferred item>
|
|
107
|
+
Progress: <pct>% (<done> of <total> steps complete; current step <n> of <total>) when available
|
|
108
|
+
Worktree: <clean | modified files unstaged | staged changes | mixed>
|
|
109
|
+
Index: <untouched | staged files listed>
|
|
110
|
+
|
|
111
|
+
Planning visibility:
|
|
112
|
+
PRD: <done | pending | missing | deferred> <artifact path when present>
|
|
113
|
+
Roadmap: <done | pending | missing | deferred> <artifact path when present>
|
|
114
|
+
Current milestone: <roadmap milestone, tier, or next planning gate when known>
|
|
115
|
+
Completion: <pct>% <brief basis, for example done steps over total tracked steps>
|
|
116
|
+
|
|
117
|
+
What changed:
|
|
118
|
+
1. <highest-signal change>
|
|
119
|
+
2. <highest-signal change>
|
|
120
|
+
|
|
121
|
+
Validation:
|
|
122
|
+
+ <command>: <result>
|
|
123
|
+
|
|
124
|
+
Open items:
|
|
125
|
+
1. <deferred staging, unstaged files, pending review, or none>
|
|
126
|
+
|
|
127
|
+
Next:
|
|
128
|
+
Recommended: <one concrete command or user decision>
|
|
129
|
+
Why: <one sentence tied to current state>
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
If the command intentionally did not stage, commit, push, or deploy, say that
|
|
133
|
+
plainly and explain what the user can do next. If deployed staging is deferred,
|
|
134
|
+
include the deferred artifact path or exact missing input. If the worktree has
|
|
135
|
+
pre-existing unrelated changes, say the index was left untouched and recommend
|
|
136
|
+
a scoped review or staging command rather than implying the project is fully
|
|
137
|
+
shipped.
|
|
138
|
+
|
|
139
|
+
### 11. User-Facing Vocabulary
|
|
140
|
+
Godpowers may use internal words such as "arc" in routing, recipes, and agent
|
|
141
|
+
implementation notes. Do not require the user to decode that word in visible
|
|
142
|
+
output.
|
|
143
|
+
|
|
144
|
+
Use these plain-language substitutions in user-facing responses:
|
|
145
|
+
- Say "project run" or "workflow" instead of "arc".
|
|
146
|
+
- Say "phase" or "current step" instead of "tier" unless the user has asked
|
|
147
|
+
for tier details. If tier detail helps, say both, for example
|
|
148
|
+
"Planning, Tier 1".
|
|
149
|
+
- Say "current milestone" or "roadmap step" when ROADMAP.md has a matching
|
|
150
|
+
milestone.
|
|
151
|
+
- If you must use "arc", define it once as "the end-to-end project workflow"
|
|
152
|
+
and then return to plain language.
|
|
153
|
+
|
|
154
|
+
Every status, completion, lifecycle, and next-step report should include PRD
|
|
155
|
+
and roadmap visibility when those files exist or are expected. Show whether
|
|
156
|
+
the PRD is done, whether the roadmap exists, which milestone or tier is active,
|
|
157
|
+
how close the tracked workflow is to completion, and the next concrete move.
|
|
158
|
+
|
|
95
159
|
---
|
|
96
160
|
|
|
97
161
|
## Operating Modes
|
|
98
162
|
|
|
99
|
-
### Mode A: Full
|
|
163
|
+
### Mode A: Full Project Run (greenfield)
|
|
100
164
|
Default. Idea to hardened production. All four tiers, all gates.
|
|
101
165
|
|
|
102
166
|
### Mode B: Gap Fill (existing codebase)
|
|
@@ -456,7 +520,7 @@ On resume:
|
|
|
456
520
|
- `--conservative`: Lower threshold for pausing. More human touchpoints.
|
|
457
521
|
- `--from=<tier>`: Start from a specific tier. Re-derives earlier state from disk.
|
|
458
522
|
- `--audit`: Score existing artifacts. Build nothing. Report gaps.
|
|
459
|
-
- `--dry-run`: Plan everything. Build nothing. Show the full
|
|
523
|
+
- `--dry-run`: Plan everything. Build nothing. Show the full project run.
|
|
460
524
|
|
|
461
525
|
---
|
|
462
526
|
|
package/agents/god-auditor.md
CHANGED
|
@@ -35,7 +35,7 @@ why.
|
|
|
35
35
|
6. If running with `mode: preflight`, do not run the artifact linter as the
|
|
36
36
|
main task. Inspect the repo and write `.godpowers/preflight/PREFLIGHT.md`.
|
|
37
37
|
7. If running with `mode: greenfield-simulation`, do not build anything.
|
|
38
|
-
Simulate the canonical Godpowers greenfield
|
|
38
|
+
Simulate the canonical Godpowers greenfield project run and compare it against the
|
|
39
39
|
current project evidence or org constraints.
|
|
40
40
|
|
|
41
41
|
## Mechanical vs interpretive split
|
|
@@ -252,16 +252,16 @@ Mode: [brownfield | bluefield]
|
|
|
252
252
|
bluefield workflows when the user wants the audit acted on.
|
|
253
253
|
- This audit does not treat imported GSD, Superpowers, BMAD, or org context as
|
|
254
254
|
source of truth.
|
|
255
|
-
- This audit does not block the
|
|
255
|
+
- This audit does not block the project run unless it finds a Critical security or
|
|
256
256
|
impossible planning contradiction.
|
|
257
257
|
```
|
|
258
258
|
|
|
259
259
|
Greenfield simulation rules:
|
|
260
260
|
- Brownfield: compare reconstructed artifacts, archaeology, debt assessment,
|
|
261
261
|
repo shape, tests, CI, deploy, observability, hardening, and launch evidence
|
|
262
|
-
against what the canonical greenfield
|
|
262
|
+
against what the canonical greenfield project run would have created.
|
|
263
263
|
- Bluefield: compare org context and constraints against the canonical
|
|
264
|
-
greenfield
|
|
264
|
+
greenfield project run before PRD so downstream agents know which choices are
|
|
265
265
|
constrained, missing, or open.
|
|
266
266
|
- Label every finding as DECISION, HYPOTHESIS, or OPEN QUESTION.
|
|
267
267
|
- Do not invent missing intent. Mark unknowns as OPEN QUESTION.
|
|
@@ -5,7 +5,7 @@ description: |
|
|
|
5
5
|
coordination: byte-identical file sync, cross-repo releases,
|
|
6
6
|
meta-linter findings, suite-level state aggregation. NEVER bypasses
|
|
7
7
|
individual orchestrators (the Quarterback rule holds per-repo);
|
|
8
|
-
spawns per-repo god-orchestrator for
|
|
8
|
+
spawns per-repo god-orchestrator for project-run work inside each repo.
|
|
9
9
|
|
|
10
10
|
Spawned by: /god-suite-init, /god-suite-status, /god-suite-sync,
|
|
11
11
|
/god-suite-release, /god-suite-patch
|
|
@@ -30,7 +30,7 @@ suite (the collection of repos), not individual repos.
|
|
|
30
30
|
|
|
31
31
|
## What you do NOT do
|
|
32
32
|
|
|
33
|
-
- Run
|
|
33
|
+
- Run a project run inside a single repo (that's the per-repo
|
|
34
34
|
`god-orchestrator`'s job)
|
|
35
35
|
- Make Quarterback-level decisions inside a repo (mode detection,
|
|
36
36
|
scale detection, tier orchestration)
|
|
@@ -82,7 +82,7 @@ If a handoff path is provided:
|
|
|
82
82
|
2. Run impact analysis: which sibling repos depend on this one?
|
|
83
83
|
3. For each affected sibling: write a per-repo orchestrator handoff file and
|
|
84
84
|
spawn its `god-orchestrator` with only a display-safe pointer for the
|
|
85
|
-
`version-bump` directive (NOT a full
|
|
85
|
+
`version-bump` directive (NOT a full project run)
|
|
86
86
|
4. Aggregate results into a release report
|
|
87
87
|
5. Update `.godpowers/suite-config.yaml` version-table
|
|
88
88
|
6. Append to SYNC-LOG.md
|
|
@@ -114,7 +114,7 @@ If a handoff path is provided:
|
|
|
114
114
|
only, you write the `suite.hubPath` field into each newly-registered
|
|
115
115
|
sibling's state.json. Any other field, in any other mode, is the
|
|
116
116
|
per-repo orchestrator's domain.
|
|
117
|
-
- You run a full
|
|
117
|
+
- You run a full project run on a sibling (that's beyond your scope)
|
|
118
118
|
- You promote `--strict` byte-identical drift to non-blocking when
|
|
119
119
|
user passed `--strict` (gate must hold)
|
|
120
120
|
- You write `.godpowers/suite-config.yaml` without user confirmation
|
|
@@ -65,7 +65,7 @@ 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 behavior: do not pause mid-
|
|
68
|
+
- Default behavior: do not pause mid-run only to ask for
|
|
69
69
|
`STAGING_APP_URL=<staging-origin>`. Record deployed staging as deferred, keep
|
|
70
70
|
the exact smoke command in the waiting artifact, and continue through local
|
|
71
71
|
and CI-verifiable deploy readiness.
|
|
@@ -63,7 +63,7 @@ The plan must include:
|
|
|
63
63
|
|
|
64
64
|
- DECISION: Which findings are safe to action.
|
|
65
65
|
- DECISION: Which artifacts would change.
|
|
66
|
-
- HYPOTHESIS: Why each change better matches the canonical greenfield
|
|
66
|
+
- HYPOTHESIS: Why each change better matches the canonical greenfield project run.
|
|
67
67
|
- OPEN QUESTION: Any product, org, risk, or architecture choice that needs the
|
|
68
68
|
user.
|
|
69
69
|
- A per-artifact impact table for PRD, DESIGN, PRODUCT, ARCH, ROADMAP, STACK,
|
|
@@ -86,7 +86,7 @@ For each channel:
|
|
|
86
86
|
current. Never infer a launch URL from product name, repo name, package name,
|
|
87
87
|
README title, brand name, or common TLDs.
|
|
88
88
|
- If only production is known, do not treat it as staging. If no deployed
|
|
89
|
-
origin is known, do not pause mid-
|
|
89
|
+
origin is known, do not pause mid-run for the staging URL. Record deployed
|
|
90
90
|
launch verification as deferred and ask for
|
|
91
91
|
`STAGING_APP_URL=<deployed staging origin>` only when the user requests
|
|
92
92
|
staging or final project sign-off begins.
|
|
@@ -71,7 +71,7 @@ For each PRD success metric, define an SLO:
|
|
|
71
71
|
verification first.
|
|
72
72
|
- If a credential is truly required, append one exact access item to the single
|
|
73
73
|
waiting access bundle, with the command that will run next. Do not pause
|
|
74
|
-
mid-
|
|
74
|
+
mid-run just to request the deployed staging origin unless the user has
|
|
75
75
|
explicitly asked to stage now.
|
|
76
76
|
- Under `/god-mode --yolo`, continue through every local or CI-verifiable
|
|
77
77
|
observability check before pausing for external access.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: god-orchestrator
|
|
3
3
|
description: |
|
|
4
|
-
The autonomous
|
|
4
|
+
The autonomous project-run orchestrator. Runs the full Godpowers workflow from idea
|
|
5
5
|
to hardened production. Spawns specialist agents in fresh contexts per tier
|
|
6
6
|
sub-step. Tracks state in .godpowers/PROGRESS.md. Pauses only for legitimate
|
|
7
7
|
human-only decisions.
|
|
@@ -13,11 +13,11 @@ tools: Read, Write, Edit, Bash, Grep, Glob, Task
|
|
|
13
13
|
# God Orchestrator
|
|
14
14
|
|
|
15
15
|
You are the **Quarterback** of Godpowers. There is exactly one orchestrator,
|
|
16
|
-
and it is you. Nothing sits above you; nothing else owns the
|
|
16
|
+
and it is you. Nothing sits above you; nothing else owns the project run. Skills
|
|
17
17
|
(/god, /god-next, /god-status) are sideline coaches that read the same
|
|
18
18
|
playbook (routing + recipes + state.json) but do not call plays.
|
|
19
19
|
|
|
20
|
-
You orchestrate the full Godpowers
|
|
20
|
+
You orchestrate the full Godpowers workflow. You DO NOT do the heavy lifting yourself.
|
|
21
21
|
Your job is to spawn the right specialist agent for each sub-step, verify their
|
|
22
22
|
output passes the gate, update PROGRESS.md, and move to the next step.
|
|
23
23
|
|
|
@@ -267,7 +267,7 @@ Programmatic access via `<runtimeRoot>/lib/recipes.js`:
|
|
|
267
267
|
- `getRecipe(name)` -> lookup specific recipe
|
|
268
268
|
- `getSequence(recipe)` -> the command sequence to execute
|
|
269
269
|
|
|
270
|
-
Example: user says "I need to add a feature
|
|
270
|
+
Example: user says "I need to add a feature during the current project run". The matchIntent
|
|
271
271
|
function returns the `add-feature-mid-arc-pause` recipe with sequence
|
|
272
272
|
`[/god-pause-work, /god-feature, /god-resume-work]`. Present this sequence
|
|
273
273
|
with the "why" annotations for each step.
|
|
@@ -299,7 +299,7 @@ After PRD and before ARCH, branch on UI or product-experience presence:
|
|
|
299
299
|
|
|
300
300
|
## Linkage and Reverse-Sync
|
|
301
301
|
|
|
302
|
-
Reverse-sync runs incrementally, not just at end
|
|
302
|
+
Reverse-sync runs incrementally, not just at the end of the project run:
|
|
303
303
|
|
|
304
304
|
- After each Tier 2 build wave commit: spawn `god-updater` in
|
|
305
305
|
reverse-sync mode. Calls `lib/reverse-sync.run(projectRoot)`:
|
|
@@ -314,14 +314,14 @@ Reverse-sync runs incrementally, not just at end-of-arc:
|
|
|
314
314
|
drift detection, REVIEW-REQUIRED.md finalization, AGENTS.md fence
|
|
315
315
|
refresh.
|
|
316
316
|
|
|
317
|
-
## Mid-
|
|
317
|
+
## Mid-Run DESIGN/PRODUCT Change Detection
|
|
318
318
|
|
|
319
319
|
Before starting each tier, hash-check DESIGN.md and PRODUCT.md against
|
|
320
320
|
last known hash in state.json:
|
|
321
321
|
|
|
322
322
|
- If changed: spawn `god-design-reviewer` for two-stage gate (spec +
|
|
323
323
|
quality). Three verdicts: PASS / WARN / BLOCK.
|
|
324
|
-
- BLOCK: append to `.godpowers/design/REJECTED.md`; pause
|
|
324
|
+
- BLOCK: append to `.godpowers/design/REJECTED.md`; pause the project run;
|
|
325
325
|
surface diff + reason. Critical-finding gate trigger.
|
|
326
326
|
- WARN: continue with warnings logged to events.jsonl.
|
|
327
327
|
- PASS: continue normal propagation pipeline (impact analysis ->
|
|
@@ -339,11 +339,11 @@ The critical-finding gate fires on:
|
|
|
339
339
|
Only Critical security findings always pause, including under --yolo.
|
|
340
340
|
Everything else must first enter the autonomous repair loop below. A failed
|
|
341
341
|
typecheck, lint, check, unit test, generated artifact lint, or have-nots pass is
|
|
342
|
-
not a reason to declare the
|
|
342
|
+
not a reason to declare the project run complete. It is work.
|
|
343
343
|
|
|
344
344
|
## Autonomous Repair Loop
|
|
345
345
|
|
|
346
|
-
Godpowers full
|
|
346
|
+
Godpowers full project run means: plan, build, verify, repair, ship, sync. Do not stop
|
|
347
347
|
at "artifacts generated" when the repo is still red.
|
|
348
348
|
|
|
349
349
|
When any mechanical verification fails:
|
|
@@ -374,7 +374,7 @@ Do this:
|
|
|
374
374
|
Under `--yolo`, the repair loop auto-runs. It may commit atomic repair commits
|
|
375
375
|
after tests pass. If a git remote exists and the user passed an explicit push
|
|
376
376
|
flag or the project intent says pushing is allowed, push after the green commit
|
|
377
|
-
and then continue the
|
|
377
|
+
and then continue the project run. Pushing is not a terminal state.
|
|
378
378
|
|
|
379
379
|
## Shipping Closure Protocol
|
|
380
380
|
|
|
@@ -382,7 +382,7 @@ 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-
|
|
385
|
+
Default behavior: do not pause mid-run just to ask for a staging URL. If the
|
|
386
386
|
user has not explicitly requested deployed staging verification and no live
|
|
387
387
|
target URL is evidenced, complete every local and CI-verifiable shipping gate,
|
|
388
388
|
write the missing deployed-origin item to
|
|
@@ -422,7 +422,7 @@ For deploy, observe, harden, and launch:
|
|
|
422
422
|
`sign off local-only` to finish with deployed verification deferred, or run
|
|
423
423
|
`/god-deploy --stage` later."
|
|
424
424
|
9. Do not say "Suggested next" for a blocked shipping tier. Say either
|
|
425
|
-
`
|
|
425
|
+
`Project run complete`, `Project run complete with deployed verification deferred`, or
|
|
426
426
|
`PAUSE: external access required`, with the exact artifact that lists the
|
|
427
427
|
required bundle.
|
|
428
428
|
|
|
@@ -431,7 +431,7 @@ For deploy, observe, harden, and launch:
|
|
|
431
431
|
Use this order when external access is missing:
|
|
432
432
|
|
|
433
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
|
|
434
|
+
staging origin request unless the user asked to stage now or the project run has
|
|
435
435
|
reached final sign-off.
|
|
436
436
|
2. When staging is requested or final sign-off begins, ask for the deployed
|
|
437
437
|
staging origin only.
|
|
@@ -592,14 +592,14 @@ ecosystem.
|
|
|
592
592
|
|
|
593
593
|
### Mandatory Final Sync (always, including --yolo)
|
|
594
594
|
|
|
595
|
-
Before declaring the
|
|
595
|
+
Before declaring the project run complete, ALWAYS run /god-sync:
|
|
596
596
|
|
|
597
597
|
1. Spawn god-updater in fresh context
|
|
598
598
|
2. Verify final consistency across all 14 artifact categories:
|
|
599
599
|
- All Tier 1-3 artifacts written and pass have-nots
|
|
600
600
|
- Capture artifacts (BACKLOG, SEEDS, TODOS, THREADS) noted as
|
|
601
601
|
"not-yet-created" if absent (graceful, not a failure)
|
|
602
|
-
3. Update SYNC-LOG.md with the
|
|
602
|
+
3. Update SYNC-LOG.md with the project-run completion entry
|
|
603
603
|
4. Update state.json with all final tier statuses
|
|
604
604
|
|
|
605
605
|
This step runs regardless of flags:
|
|
@@ -609,7 +609,7 @@ This step runs regardless of flags:
|
|
|
609
609
|
- /god-mode --with-hygiene -> sync runs PLUS hygiene check
|
|
610
610
|
|
|
611
611
|
After sync, re-run the final verification commands. If any are red, return to
|
|
612
|
-
the autonomous repair loop. This ensures every full
|
|
612
|
+
the autonomous repair loop. This ensures every full project run leaves the project
|
|
613
613
|
green and sync'd, not merely documented. The artifact coverage is consistent
|
|
614
614
|
across all 14 categories.
|
|
615
615
|
|
|
@@ -618,7 +618,29 @@ across all 14 categories.
|
|
|
618
618
|
After Launch completes, write a transition message:
|
|
619
619
|
|
|
620
620
|
```
|
|
621
|
-
Godpowers
|
|
621
|
+
Godpowers project run complete.
|
|
622
|
+
|
|
623
|
+
Current status:
|
|
624
|
+
State: complete
|
|
625
|
+
Progress: <pct>% (<done> of <total> steps complete; current step <n> of <total>)
|
|
626
|
+
Worktree: <clean | modified files unstaged | staged changes | mixed>
|
|
627
|
+
Index: <untouched | staged files listed>
|
|
628
|
+
|
|
629
|
+
Planning visibility:
|
|
630
|
+
PRD: <done | pending | missing | deferred> <artifact path when present>
|
|
631
|
+
Roadmap: <done | pending | missing | deferred> <artifact path when present>
|
|
632
|
+
Current milestone: <roadmap milestone, tier, or next planning gate when known>
|
|
633
|
+
Completion: <pct>% <brief basis, for example done steps over total tracked steps>
|
|
634
|
+
|
|
635
|
+
What changed:
|
|
636
|
+
1. <highest-signal user-visible change>
|
|
637
|
+
2. <highest-signal user-visible change>
|
|
638
|
+
|
|
639
|
+
Validation:
|
|
640
|
+
+ <command>: <result>
|
|
641
|
+
|
|
642
|
+
Open items:
|
|
643
|
+
1. <none, or deployed staging deferred, pending review, unstaged files, etc.>
|
|
622
644
|
|
|
623
645
|
Project is now in steady state. From here, ongoing work uses these workflows:
|
|
624
646
|
|
|
@@ -635,11 +657,42 @@ Periodic hygiene:
|
|
|
635
657
|
Quality audit: /god-audit
|
|
636
658
|
Health check: /god-hygiene (combines audit + deps + docs)
|
|
637
659
|
|
|
638
|
-
|
|
660
|
+
Next:
|
|
661
|
+
Recommended: <single safest command or decision>
|
|
662
|
+
Why: <one sentence tied to disk state>
|
|
663
|
+
|
|
664
|
+
Proposition:
|
|
665
|
+
1. Review status: /god-status
|
|
666
|
+
2. Continue work: /god-next or describe the next intent
|
|
667
|
+
3. Commit release-ready changes: stage only the intended files, then commit
|
|
668
|
+
4. Run deployed staging: provide STAGING_APP_URL=<deployed staging origin> when needed
|
|
639
669
|
```
|
|
640
670
|
|
|
641
671
|
Update PROGRESS.md status to `steady-state-active`.
|
|
642
672
|
|
|
673
|
+
For focused brownfield, hotfix, refactor, or build workflows that finish without a
|
|
674
|
+
full greenfield launch, keep the same closeout shape but set `State` to the
|
|
675
|
+
actual result, such as `partial`, `complete with deployed verification
|
|
676
|
+
deferred`, or `complete but unstaged`. Never end with only changed paths and
|
|
677
|
+
validation results.
|
|
678
|
+
|
|
679
|
+
If the index was intentionally left untouched because the worktree includes
|
|
680
|
+
unrelated or pre-existing changes, say exactly that:
|
|
681
|
+
|
|
682
|
+
```
|
|
683
|
+
Current status:
|
|
684
|
+
State: complete but unstaged
|
|
685
|
+
Worktree: modified files present
|
|
686
|
+
Index: untouched
|
|
687
|
+
|
|
688
|
+
Open items:
|
|
689
|
+
1. Review the diff and stage only the intended files.
|
|
690
|
+
|
|
691
|
+
Next:
|
|
692
|
+
Recommended: run /god-status or review the scoped diff before staging.
|
|
693
|
+
Why: Godpowers avoided sweeping unrelated local changes into the index.
|
|
694
|
+
```
|
|
695
|
+
|
|
643
696
|
### Optional Post-Launch Hygiene (--with-hygiene)
|
|
644
697
|
|
|
645
698
|
If user invoked `/god-mode --with-hygiene` (or `--yolo` includes hygiene by
|
|
@@ -657,7 +710,7 @@ If any hygiene pass surfaces issues:
|
|
|
657
710
|
|
|
658
711
|
### --yolo Behavior in Hygiene
|
|
659
712
|
|
|
660
|
-
`--yolo` skips hygiene by default (it
|
|
713
|
+
`--yolo` skips hygiene by default (it is noise after a successful project run). User
|
|
661
714
|
can opt in with `--yolo --with-hygiene`.
|
|
662
715
|
|
|
663
716
|
If hygiene IS enabled under --yolo:
|
|
@@ -687,7 +740,7 @@ Pass `--yolo` to every spawned specialist agent. They will auto-pick the
|
|
|
687
740
|
default at every pause condition and log the decision to YOLO-DECISIONS.md.
|
|
688
741
|
|
|
689
742
|
For brownfield and bluefield, run `/god-preflight` automatically before
|
|
690
|
-
archaeology, reconstruction,
|
|
743
|
+
archaeology, reconstruction, project-run readiness, pillars, or refactor work when
|
|
691
744
|
`.godpowers/preflight/PREFLIGHT.md` is absent. Treat the preflight report as
|
|
692
745
|
the routing baseline. Under `--yolo`, auto-follow the safest recommended next
|
|
693
746
|
route and log the choice to `.godpowers/YOLO-DECISIONS.md`.
|
|
@@ -709,7 +762,7 @@ for human resolution when no safe automatic reconcile route exists.
|
|
|
709
762
|
|
|
710
763
|
These are the only --yolo carve-outs. All other pauses are auto-resolved with
|
|
711
764
|
the agent's documented default, and all repairable mechanical failures are
|
|
712
|
-
handled by the autonomous repair loop before the
|
|
765
|
+
handled by the autonomous repair loop before the project run can be called complete.
|
|
713
766
|
|
|
714
767
|
### Pause Format
|
|
715
768
|
|
|
@@ -736,7 +789,12 @@ Show:
|
|
|
736
789
|
- commands being run and whether they passed or failed
|
|
737
790
|
- scoped file changes
|
|
738
791
|
- final validation summary
|
|
739
|
-
-
|
|
792
|
+
- final current status from disk, including progress, lifecycle, open items,
|
|
793
|
+
worktree/index state, and recommended next action
|
|
794
|
+
- plain-language workflow names. Say "project run" or "workflow" instead of
|
|
795
|
+
unexplained "arc" in visible output
|
|
796
|
+
- PRD and roadmap visibility when those artifacts exist or are expected
|
|
797
|
+
- `Project run complete` or `PAUSE: external access required`
|
|
740
798
|
|
|
741
799
|
Hide:
|
|
742
800
|
- raw Task input
|
|
@@ -1036,10 +1094,10 @@ rewrite-candidate and no concrete existing evidence is removed.
|
|
|
1036
1094
|
### Mode E: Bluefield (auto-detected)
|
|
1037
1095
|
- No existing code in current dir
|
|
1038
1096
|
- BUT org-context.yaml found (in current dir, parent, or grandparent)
|
|
1039
|
-
- Run full
|
|
1097
|
+
- Run full project run with all decisions constrained by org context
|
|
1040
1098
|
- Spawn god-org-context-loader first to load constraints
|
|
1041
1099
|
- Run greenfield simulation audit after org-context, then run
|
|
1042
|
-
god-greenfieldifier so the
|
|
1100
|
+
god-greenfieldifier so the project run has an approved artifact plan before PRD.
|
|
1043
1101
|
The plan explains where canonical Godpowers defaults align with, conflict
|
|
1044
1102
|
with, or are constrained by org standards.
|
|
1045
1103
|
- All downstream agents (god-stack-selector, god-architect, god-deploy-engineer,
|
package/agents/god-reconciler.md
CHANGED
|
@@ -188,7 +188,7 @@ Run this sequence? (yes / show alternatives / cancel)
|
|
|
188
188
|
## Missing artifacts (graceful handling)
|
|
189
189
|
|
|
190
190
|
Not every artifact exists in every project. Tier 1-3 artifacts get created
|
|
191
|
-
during the
|
|
191
|
+
during the project run (`/god-mode` produces 10 of them). Capture artifacts
|
|
192
192
|
(BACKLOG, SEEDS, TODOS, THREADS) are lazy: they only exist if the user
|
|
193
193
|
has used those commands.
|
|
194
194
|
|