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.
Files changed (61) hide show
  1. package/CHANGELOG.md +29 -0
  2. package/README.md +9 -8
  3. package/RELEASE.md +31 -32
  4. package/SKILL.md +67 -3
  5. package/agents/god-auditor.md +4 -4
  6. package/agents/god-coordinator.md +4 -4
  7. package/agents/god-deploy-engineer.md +1 -1
  8. package/agents/god-greenfieldifier.md +1 -1
  9. package/agents/god-launch-strategist.md +1 -1
  10. package/agents/god-observability-engineer.md +1 -1
  11. package/agents/god-orchestrator.md +82 -24
  12. package/agents/god-reconciler.md +1 -1
  13. package/bin/install.js +1 -1
  14. package/hooks/session-start.sh +2 -2
  15. package/lib/checkpoint.js +4 -1
  16. package/lib/context-writer.js +1 -1
  17. package/package.json +1 -1
  18. package/references/HAVE-NOTS.md +1 -1
  19. package/references/orchestration/SCALE-DETECTION.md +1 -1
  20. package/references/shared/GLOSSARY.md +1 -1
  21. package/references/shared/ORCHESTRATORS.md +1 -1
  22. package/routing/god-mode.yaml +1 -1
  23. package/routing/god-preflight.yaml +1 -1
  24. package/routing/recipes/add-feature-mid-arc-pause.yaml +4 -4
  25. package/routing/recipes/bluefield-org-aware.yaml +1 -1
  26. package/routing/recipes/brownfield-onboarding.yaml +1 -1
  27. package/routing/recipes/greenfield-fast.yaml +1 -1
  28. package/routing/recipes/greenfield-with-ideation.yaml +1 -1
  29. package/skills/god-audit.md +1 -1
  30. package/skills/god-context.md +1 -1
  31. package/skills/god-deploy.md +1 -1
  32. package/skills/god-design-impact.md +1 -1
  33. package/skills/god-explore.md +1 -1
  34. package/skills/god-extract-learnings.md +1 -1
  35. package/skills/god-feature.md +1 -1
  36. package/skills/god-hotfix.md +1 -1
  37. package/skills/god-hygiene.md +1 -1
  38. package/skills/god-init.md +1 -1
  39. package/skills/god-launch.md +1 -1
  40. package/skills/god-lifecycle.md +9 -6
  41. package/skills/god-locate.md +1 -1
  42. package/skills/god-logs.md +1 -1
  43. package/skills/god-mode.md +55 -17
  44. package/skills/god-next.md +14 -4
  45. package/skills/god-org-context.md +1 -1
  46. package/skills/god-preflight.md +5 -5
  47. package/skills/god-quick.md +1 -1
  48. package/skills/god-refactor.md +1 -1
  49. package/skills/god-roadmap-update.md +1 -1
  50. package/skills/god-skip.md +1 -1
  51. package/skills/god-spike.md +1 -1
  52. package/skills/god-status.md +9 -1
  53. package/skills/god-suite-init.md +1 -1
  54. package/skills/god-suite-release.md +1 -1
  55. package/skills/god-suite-status.md +1 -1
  56. package/skills/god-suite-sync.md +1 -1
  57. package/skills/god-tech-debt.md +1 -1
  58. package/skills/god.md +8 -8
  59. package/workflows/bluefield-arc.yaml +1 -1
  60. package/workflows/brownfield-arc.yaml +1 -1
  61. 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
  [![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.9-blue)](CHANGELOG.md)
5
+ [![Version](https://img.shields.io/badge/version-1.6.10-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,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.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.
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's the autonomous arc. It will run all tiers from idea to hardened
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 arc
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 arc | god-orchestrator |
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 arc-ready and pillars | god-auditor |
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.9 Release
1
+ # Godpowers 1.6.10 Release
2
2
 
3
3
  Date: 2026-05-16
4
4
 
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.
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 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.
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.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
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 arc>
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 Arc (greenfield)
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 arc.
523
+ - `--dry-run`: Plan everything. Build nothing. Show the full project run.
460
524
 
461
525
  ---
462
526
 
@@ -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 arc and compare it against the
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 arc unless it finds a Critical security or
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 arc would have created.
262
+ against what the canonical greenfield project run would have created.
263
263
  - Bluefield: compare org context and constraints against the canonical
264
- greenfield arc before PRD so downstream agents know which choices are
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 arc work inside each repo.
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 an arc inside a single repo (that's the per-repo
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 arc)
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 arc on a sibling (that's beyond your scope)
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-arc only to ask for
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 arc.
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-arc for the staging URL. Record deployed
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-arc just to request the deployed staging origin unless the user has
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 arc orchestrator. Runs the full Godpowers workflow from idea
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 arc. Skills
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 arc. You DO NOT do the heavy lifting yourself.
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 mid-arc". The matchIntent
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-of-arc:
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-Arc DESIGN/PRODUCT Change Detection
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 arc;
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 arc complete. It is work.
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-arc means: plan, build, verify, repair, ship, sync. Do not stop
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 arc. Pushing is not a terminal state.
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-arc just to ask for a staging URL. If the
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
- `Arc complete`, `Arc complete with deployed verification deferred`, or
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 arc has
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 arc complete, ALWAYS run /god-sync:
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 arc completion entry
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-arc run leaves the project
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 full-arc complete.
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
- Or describe what you want to do and /god-next will route.
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's noise after a successful arc). User
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, arc-ready, pillars, or refactor work when
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 arc can be called complete.
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
- - `Arc complete` or `PAUSE: external access required`
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 arc with all decisions constrained by org context
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 arc has an approved artifact plan before PRD.
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,
@@ -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 arc (`/god-mode` produces 10 of them). Capture artifacts
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