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/bin/install.js CHANGED
@@ -647,7 +647,7 @@ function main() {
647
647
  log('');
648
648
  log(`\x1b[36mNext steps:\x1b[0m`);
649
649
  log(` 1. Open your AI coding tool in any project directory`);
650
- log(` 2. Type: \x1b[36m/god-mode\x1b[0m for full autonomous arc`);
650
+ log(` 2. Type: \x1b[36m/god-mode\x1b[0m for the full autonomous project run`);
651
651
  log(` Or: \x1b[36m/god-next\x1b[0m to see what to run next`);
652
652
  log(` Or: \x1b[36m/god-init\x1b[0m to start a new project`);
653
653
  log('');
@@ -52,7 +52,7 @@ if [ -f "$STATE_FILE" ]; then
52
52
  jq -r '
53
53
  " project: " + (.project.name // "(unnamed)"),
54
54
  " mode: " + (.mode // "?") + (if ."mode-d-suite" then " (in suite)" else "" end),
55
- " lifecycle: " + (."lifecycle-phase" // "in-arc")
55
+ " lifecycle: " + (if (."lifecycle-phase" // "in-arc") == "in-arc" then "in progress" else (."lifecycle-phase" // "in-arc") end)
56
56
  ' "$STATE_FILE" 2>/dev/null || head -20 "$STATE_FILE"
57
57
  else
58
58
  head -20 "$STATE_FILE"
@@ -66,7 +66,7 @@ fi
66
66
  cat <<'EOF'
67
67
 
68
68
  Next step: run /god-next (it inspects disk state and proposes the next command)
69
- Or: /god-mode for the full autonomous arc
69
+ Or: /god-mode for the full autonomous project run
70
70
  Or: /god-help to see the catalog
71
71
  Or: /god-status for the full project snapshot
72
72
 
package/lib/checkpoint.js CHANGED
@@ -128,6 +128,9 @@ function write(projectRoot, state) {
128
128
  const facts = (state.facts || []).slice(0, MAX_FACTS);
129
129
  const factsHash = sha256(JSON.stringify(facts));
130
130
  const progress = state.progress || null;
131
+ const lifecycleDisplay = state.lifecycle === 'in-arc'
132
+ ? 'in progress'
133
+ : (state.lifecycle || 'in progress');
131
134
 
132
135
  const fm = [
133
136
  '---',
@@ -171,7 +174,7 @@ function write(projectRoot, state) {
171
174
  '',
172
175
  `- Project: **${state.project || 'unnamed'}**`,
173
176
  `- Mode: **${state.mode || '?'}**${state.modeDSuite ? ' (in multi-repo suite)' : ''}`,
174
- `- Lifecycle phase: **${state.lifecycle || 'in-arc'}**`,
177
+ `- Lifecycle phase: **${lifecycleDisplay}**`,
175
178
  progressLine,
176
179
  `- Current tier: **${state.currentTier || 'tier-0'}** / **${state.currentSubstep || 'orchestration'}**`,
177
180
  `- Last action: \`${state.lastAction || 'unknown'}\` by ${state.lastActor || 'unknown'} at ${ts}`,
@@ -98,7 +98,7 @@ function buildCanonicalContent(state, opts = {}) {
98
98
  lines.push('- `/god-status` - re-derive state from disk');
99
99
  lines.push('- `/god-next` - what to run next, with reason');
100
100
  lines.push('- `/god <free text>` - match intent to a recipe');
101
- lines.push('- `/god-mode` - run the full autonomous arc');
101
+ lines.push('- `/god-mode` - run the full autonomous project run');
102
102
  lines.push('- `/god-lint` - validate artifacts against have-nots');
103
103
  lines.push('- `/god-scan` - rebuild linkage map from code');
104
104
  lines.push('- `/god-review-changes` - walk REVIEW-REQUIRED.md');
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "godpowers",
3
- "version": "1.6.9",
3
+ "version": "1.6.10",
4
4
  "description": "AI-powered development system: 106 slash commands and 39 specialist agents that take a project from raw idea to hardened production. Runs inside Claude Code, Codex, Cursor, Windsurf, Gemini, and 10+ other AI coding tools.",
5
5
  "bin": {
6
6
  "godpowers": "./bin/install.js"
@@ -454,7 +454,7 @@ Trust boundaries declared in docs but absent in code. Fail.
454
454
 
455
455
  ## Workflow-Specific Have-Nots
456
456
 
457
- These apply to artifacts produced by non-arc workflows (postmortem, spike,
457
+ These apply to artifacts produced by focused workflows (postmortem, spike,
458
458
  migration, docs, deps).
459
459
 
460
460
  ### Postmortem Have-Nots
@@ -8,7 +8,7 @@
8
8
  |-------|---------|---------------------|
9
9
  | Trivial | Single-file change, bug fix, config tweak | /god-fast (skip planning) |
10
10
  | Small | One feature, one service, <1 week | /god-quick OR lightweight /god-mode |
11
- | Medium | Multiple features, 1-3 services, 1-4 weeks | /god-mode (full arc) |
11
+ | Medium | Multiple features, 1-3 services, 1-4 weeks | /god-mode (full project run) |
12
12
  | Large | Multiple services, team coordination, 1-3 months | /god-mode + /god-sprint (sprints) |
13
13
  | Enterprise | Multiple teams, compliance, 3+ months | /god-mode + extension packs (security, etc.) |
14
14
 
@@ -5,7 +5,7 @@
5
5
 
6
6
  ## Core abstractions
7
7
 
8
- **Tier**: a phase of the dev arc (0: Orchestration, 1: Planning, 2: Building, 3: Shipping).
8
+ **Tier**: a phase of the development workflow (0: Orchestration, 1: Planning, 2: Building, 3: Shipping).
9
9
 
10
10
  **Sub-step**: a bounded unit within a tier (PRD, ARCH, Roadmap, Stack, Repo, Build, Deploy, Observe, Launch, Harden).
11
11
 
@@ -69,7 +69,7 @@ frontmatter. There's no proprietary binary state. To leave:
69
69
  ## What Godpowers does not try to be
70
70
 
71
71
  Godpowers is opinionated about: artifact discipline, bidirectional
72
- linkage, the four-tier arc, the single-orchestrator rule, headless
72
+ linkage, the four-tier workflow, the single-orchestrator rule, headless
73
73
  runtime verification, and the substitution / three-label / have-nots
74
74
  gates. It is intentionally not opinionated about: team ceremonies,
75
75
  sprint cadence, ticket trackers, knowledge graphs, prompt engineering
@@ -2,7 +2,7 @@ apiVersion: godpowers/v1
2
2
  kind: CommandRouting
3
3
  metadata:
4
4
  command: /god-mode
5
- description: Full autonomous arc
5
+ description: Full autonomous project run
6
6
  tier: 0
7
7
 
8
8
  prerequisites:
@@ -2,7 +2,7 @@ apiVersion: godpowers/v1
2
2
  kind: CommandRouting
3
3
  metadata:
4
4
  command: /god-preflight
5
- description: Read-only intake audit before arc-ready and pillars
5
+ description: Read-only intake audit before project-run readiness and pillars
6
6
  tier: 0
7
7
 
8
8
  prerequisites:
@@ -3,7 +3,7 @@ kind: Recipe
3
3
  metadata:
4
4
  name: add-feature-mid-arc-pause
5
5
  category: feature-addition
6
- description: "Bigger feature mid-arc; reconcile with roadmap, pause arc, do feature, update roadmap, resume"
6
+ description: "Bigger feature during the current project run; reconcile with roadmap, pause, do feature, update roadmap, resume"
7
7
 
8
8
  triggers:
9
9
  intent-keywords:
@@ -16,18 +16,18 @@ triggers:
16
16
 
17
17
  sequences:
18
18
  default:
19
- description: "Bigger feature mid-arc; reconcile with roadmap, pause arc, do feature, update roadmap, resume"
19
+ description: "Bigger feature during the current project run; reconcile with roadmap, pause, do feature, update roadmap, resume"
20
20
  steps:
21
21
  - command: "/god-reconcile"
22
22
  why: "Multi-artifact reconciliation across PRD/ARCH/ROADMAP/STACK/etc."
23
23
  - command: "/god-pause-work"
24
- why: "Save current arc state"
24
+ why: "Save current project-run state"
25
25
  skip-when: reconciliation-says-already-done-or-prereq
26
26
  - command: "/god-feature"
27
27
  why: "Run feature workflow with full discipline"
28
28
  - command: "/god-sync"
29
29
  why: "Update all affected artifacts (PRD, ARCH, ROADMAP, etc.)"
30
30
  - command: "/god-resume-work"
31
- why: "Restore arc state"
31
+ why: "Restore project-run state"
32
32
 
33
33
  default-sequence: default
@@ -20,7 +20,7 @@ sequences:
20
20
  - command: "/god-org-context init"
21
21
  why: "Capture org-level standards and constraints"
22
22
  - command: "/god-preflight"
23
- why: "Inspect inherited context before arc-ready and pillars"
23
+ why: "Inspect inherited context before project-run readiness and pillars"
24
24
  - command: "/god-init"
25
25
  why: "Detect bluefield mode"
26
26
  - command: "/god-mode --bluefield"
@@ -19,7 +19,7 @@ sequences:
19
19
  description: "Inheriting an existing codebase; preflight before archaeology"
20
20
  steps:
21
21
  - command: "/god-preflight"
22
- why: "Read-only intake audit before arc-ready and pillars"
22
+ why: "Read-only intake audit before project-run readiness and pillars"
23
23
  - command: "/god-archaeology"
24
24
  why: "Deep history, decisions, conventions, risks"
25
25
  - command: "/god-reconstruct"
@@ -20,6 +20,6 @@ sequences:
20
20
  description: "Greenfield idea to production with one command"
21
21
  steps:
22
22
  - command: "/god-mode"
23
- why: "Full autonomous arc, idea to hardened production"
23
+ why: "Full autonomous project run, idea to hardened production"
24
24
 
25
25
  default-sequence: default
@@ -24,6 +24,6 @@ sequences:
24
24
  - command: "/god-init"
25
25
  why: "Commit to clarified framing"
26
26
  - command: "/god-mode"
27
- why: "Run autonomous arc"
27
+ why: "Run autonomous project run"
28
28
 
29
29
  default-sequence: default
@@ -23,7 +23,7 @@ Spawn the **god-auditor** agent in a fresh context via Task tool.
23
23
  When invoked by `brownfield-arc` or `bluefield-arc` with
24
24
  `mode: greenfield-simulation`, spawn god-auditor with the current project
25
25
  evidence and ask it to compare the repo or org constraints against the
26
- canonical Godpowers greenfield arc. The agent writes
26
+ canonical Godpowers greenfield project run. The agent writes
27
27
  `.godpowers/audit/GREENFIELD-SIMULATION.md`.
28
28
 
29
29
  This mode builds nothing and rewrites no planning artifacts. It exists so
@@ -132,7 +132,7 @@ Done. AI tools will no longer see Godpowers context on this project.
132
132
 
133
133
  ## Auto-refresh
134
134
 
135
- When `/god-sync` runs (post-arc, or any sync), `god-updater` calls this skill
135
+ When `/god-sync` runs (after a project run, or any sync), `god-updater` calls this skill
136
136
  with `refresh` to keep `AGENTS.md` content aligned with the latest project
137
137
  state (mode, scale, completed tiers, active artifacts).
138
138
 
@@ -50,7 +50,7 @@ required, record the single access bundle in
50
50
  requests staging or final sign-off begins.
51
51
 
52
52
  The single access bundle must be incremental. Do not ask for
53
- `STAGING_APP_URL` mid-arc unless the user requested deployed staging. At final
53
+ `STAGING_APP_URL` mid-run unless the user requested deployed staging. At final
54
54
  sign-off or explicit staging, ask for the smallest next item needed to run the
55
55
  next command. If no live target URL is known, ask only for
56
56
  `STAGING_APP_URL=<staging-origin>` and the exact smoke command that will run.
@@ -70,7 +70,7 @@ Proposition:
70
70
  1. Implement partial: /god-design for only the lowest-risk token or component change
71
71
  2. Implement complete: /god-design with the full proposed change
72
72
  3. Discuss more: /god-discuss the design tradeoff before changing files
73
- 4. Run God Mode: /god-mode only if this design change is part of a wider arc
73
+ 4. Run God Mode: /god-mode only if this design change is part of a wider project run
74
74
  Recommended: apply the smallest design change first when severity is warning
75
75
  or higher.
76
76
  ```
@@ -50,7 +50,7 @@ Suggested next: /god-init (commit to this framing) or /god-explore again
50
50
 
51
51
  Proposition:
52
52
  1. Implement partial: /god-init with this framing and stop after PRD
53
- 2. Implement complete: /god-mode with this framing for the full arc
53
+ 2. Implement complete: /god-mode with this framing for the full project run
54
54
  3. Discuss more: /god-explore again with the weakest assumption
55
55
  4. Run God Mode: /god-mode if the user is ready to build now
56
56
  Recommended: /god-init when the framing feels stable enough to turn into
@@ -15,7 +15,7 @@ Capture institutional knowledge from a completed phase or milestone.
15
15
  ## When to use
16
16
 
17
17
  - After completing a milestone (Now -> Done)
18
- - After a successful /god-mode arc
18
+ - After a successful /god-mode project run
19
19
  - Before a /god-postmortem (different focus: that's for incidents)
20
20
 
21
21
  ## Process
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: god-feature
3
3
  description: |
4
- Add a feature to an existing project. Skips the full-arc setup (no /god-init,
4
+ Add a feature to an existing project. Skips the full project-run setup (no /god-init,
5
5
  no repo scaffolding, no /god-stack). Mini-PRD for the feature, optional
6
6
  micro-architecture, build, deploy via existing pipeline, harden new code.
7
7
 
@@ -17,7 +17,7 @@ Urgent production bug fix. Speed matters; discipline still applies.
17
17
 
18
18
  - Production is broken or degraded
19
19
  - Users are affected right now
20
- - Waiting for a normal /god-mode arc is unacceptable
20
+ - Waiting for a normal /god-mode project run is unacceptable
21
21
 
22
22
  ## When NOT to use
23
23
 
@@ -23,7 +23,7 @@ Periodic health check. Three audits in one slash command.
23
23
  ## When NOT to use
24
24
 
25
25
  - Mid-incident: focus on /god-hotfix or /god-debug
26
- - Right after /god-mode: hygiene was already optional during arc
26
+ - Right after /god-mode: hygiene was already optional during the project run
27
27
 
28
28
  ## Orchestration
29
29
 
@@ -260,5 +260,5 @@ without explicit user invocation of /god-suite-init.
260
260
  After init completes, print:
261
261
 
262
262
  ```
263
- Suggested next: /god-prd for requirements, or /god-mode for the full autonomous arc.
263
+ Suggested next: /god-prd for requirements, or /god-mode for the full autonomous project run.
264
264
  ```
@@ -58,7 +58,7 @@ the user requests staging or final sign-off begins.
58
58
  The launch pause must not expand into every possible channel, analytics, or
59
59
  provider credential. Ask only for the next missing access item needed to run a
60
60
  named live smoke, launch-readiness, attribution, or monitoring check. Do not
61
- ask mid-arc for `STAGING_APP_URL` unless the user requested deployed staging.
61
+ ask mid-run for `STAGING_APP_URL` unless the user requested deployed staging.
62
62
  At final sign-off, if no live target URL is known, ask only for
63
63
  `STAGING_APP_URL=<staging-origin>`.
64
64
 
@@ -17,7 +17,7 @@ Show project phase and contextually appropriate workflows.
17
17
 
18
18
  1. Detect lifecycle phase from disk:
19
19
  - **No `.godpowers/`** -> Pre-init
20
- - **`.godpowers/PROGRESS.md` exists, not all tiers done** -> In-arc
20
+ - **`.godpowers/PROGRESS.md` exists, not all tiers done** -> In progress
21
21
  - **All tiers done, no special markers** -> Steady state
22
22
  - **`.godpowers/postmortems/<id>/` exists with no POSTMORTEM.md** -> Post-incident pending
23
23
  - **`.godpowers/migrations/<slug>/MIGRATION.md` exists, status != complete** -> In-migration
@@ -36,15 +36,18 @@ Lifecycle: Pre-init (no Godpowers project here)
36
36
  Available actions:
37
37
  /god-init Initialize a Godpowers project
38
38
  /god-explore Brainstorm before committing
39
- /god-mode Run full autonomous arc (will init first)
39
+ /god-mode Run full autonomous project run (will init first)
40
40
  ```
41
41
 
42
- ### In-arc
42
+ ### In Progress
43
43
  ```
44
- Lifecycle: In-arc (planning/building/shipping)
44
+ Lifecycle: In progress (planning/building/shipping)
45
45
 
46
46
  Current state:
47
47
  PRD: [done/pending]
48
+ Roadmap: [done/pending]
49
+ Current step: [phase, tier, or roadmap milestone]
50
+ Completion: [pct]% ([done] of [total] tracked steps)
48
51
  Architecture: [done/pending]
49
52
  ...
50
53
 
@@ -55,7 +58,7 @@ Or run /god-mode to autonomously continue from here.
55
58
 
56
59
  ### Steady state
57
60
  ```
58
- Lifecycle: Steady state (full-arc complete, in maintenance)
61
+ Lifecycle: Steady state (project run complete, in maintenance)
59
62
 
60
63
  Last full audit: [N days ago]
61
64
  Last dep audit: [N days ago]
@@ -119,7 +122,7 @@ phase to fill in concrete commands:
119
122
  ```
120
123
  Proposition:
121
124
  1. Implement partial: [smallest safe next command from the lifecycle report]
122
- 2. Implement complete: /god-mode [resume or scope] when the phase is safe for an autonomous arc
125
+ 2. Implement complete: /god-mode [resume or scope] when the phase is safe for an autonomous project run
123
126
  3. Discuss more: /god-discuss [unclear phase, blocker, or choice]
124
127
  4. Inspect status: /god-status or /god-next
125
128
  Recommended: [one option and why it matches the detected phase]
@@ -80,7 +80,7 @@ The orientation summary must end with a compact proposition block:
80
80
  ```
81
81
  Proposition:
82
82
  1. Implement partial: [next suggested command]
83
- 2. Implement complete: /god-mode to continue the arc when no drift is flagged
83
+ 2. Implement complete: /god-mode to continue the project run when no drift is flagged
84
84
  3. Discuss more: /god-discuss [unclear state or stale checkpoint]
85
85
  4. Inspect status: /god-status for the full report
86
86
  Recommended: [one option and why]
@@ -3,7 +3,7 @@ name: god-logs
3
3
  description: |
4
4
  View events.jsonl as a readable timeline. Each line: timestamp,
5
5
  event name, tier, agent, duration if available. Use to inspect
6
- what happened during a run, debug a stuck arc, or audit
6
+ what happened during a run, debug a stuck project run, or audit
7
7
  retroactively.
8
8
 
9
9
  Triggers on: "god logs", "/god-logs", "show logs", "what happened",
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: god-mode
3
3
  description: |
4
- Full autonomous arc orchestrator. Spawns the god-orchestrator agent in a
4
+ Full autonomous project-run orchestrator. Spawns the god-orchestrator agent in a
5
5
  fresh context which runs the entire workflow: idea to hardened production.
6
6
  Pauses only for legitimate human-only decisions.
7
7
 
@@ -12,11 +12,12 @@ description: |
12
12
  # /god-mode
13
13
 
14
14
  You are receiving a /god-mode invocation. Your job is to spawn the
15
- **god-orchestrator** agent in a fresh context to run the autonomous arc.
15
+ **god-orchestrator** agent in a fresh context to run the autonomous project
16
+ workflow.
16
17
 
17
18
  ## Process
18
19
 
19
- 1. Resolve whether this is a new arc or a resume:
20
+ 1. Resolve whether this is a new project run or a resume:
20
21
  - If `.godpowers/state.json`, `.godpowers/PROGRESS.md`, or
21
22
  `.godpowers/CHECKPOINT.md` exists, this is a resume. Do not ask the user
22
23
  to describe the project again. Call
@@ -64,7 +65,7 @@ You are receiving a /god-mode invocation. Your job is to spawn the
64
65
  `workflows/<name>.yaml`, run via `lib/workflow-runner`)
65
66
  - `--plan` (v0.14; emit plan to `.godpowers/runs/<id>/plan.yaml`
66
67
  and stop. Same effect as `--dry-run`. Use with `--workflow` for
67
- a specific arc's plan.)
68
+ a specific project run's plan.)
68
69
  - `--brownfield` (force brownfield path even if detection says greenfield)
69
70
  - `--bluefield` (force bluefield path)
70
71
  - `--greenfield` (force greenfield, skip archaeology even if code exists)
@@ -89,16 +90,16 @@ You are receiving a /god-mode invocation. Your job is to spawn the
89
90
  `/god-arch` when initial findings, imported planning context, the PRD,
90
91
  or the codebase show UI or product-experience signals
91
92
  - Instruction that a red test, typecheck, lint, build, or check command
92
- is not a completed arc. It must enter the autonomous repair loop and
93
+ is not a completed project run. It must enter the autonomous repair loop and
93
94
  continue the same `/god-mode` run until green, except for Critical
94
95
  security or a genuine human-only decision.
95
96
  - Instruction that deploy, observe, harden, and launch must follow the
96
97
  Shipping Closure Protocol: verify a real environment when available,
97
98
  otherwise create local/CI-verifiable deploy automation, defer deployed
98
99
  staging by default, and continue until the user requests staging or the
99
- arc reaches final sign-off.
100
+ project run reaches final sign-off.
100
101
  - Instruction that keys, API tokens, dashboards, admin consoles, and
101
- provider-specific access are last-mile inputs. Do not pause mid-arc for
102
+ provider-specific access are last-mile inputs. Do not pause mid-run for
102
103
  `STAGING_APP_URL` unless the user requested deployed staging. At final
103
104
  sign-off, ask only for the smallest next item needed by a concrete
104
105
  command, usually `STAGING_APP_URL=<staging-origin>`. Ask for additional
@@ -114,7 +115,7 @@ You are receiving a /god-mode invocation. Your job is to spawn the
114
115
  artifact rewrites, and updates every affected artifact after approval.
115
116
  - Instruction that brownfield and bluefield arcs run `/god-preflight`
116
117
  automatically when `.godpowers/preflight/PREFLIGHT.md` is absent.
117
- Greenfield arcs skip preflight unless the user explicitly requests it.
118
+ Greenfield project runs skip preflight unless the user explicitly requests it.
118
119
  - Instruction to run routing prerequisites through `lib/router.js`
119
120
  `checkPrerequisites` before every direct command dispatch. If
120
121
  `safe-sync-clear` fails, run
@@ -129,7 +130,7 @@ You are receiving a /god-mode invocation. Your job is to spawn the
129
130
  - Name the project root.
130
131
  - Name the invocation flags.
131
132
  - Name the handoff file path.
132
- - Say: "Read the handoff file first, then run the autonomous arc from disk
133
+ - Say: "Read the handoff file first, then run the autonomous workflow from disk
133
134
  state. Return only user-facing progress and final status."
134
135
 
135
136
  Do not put recovered checkpoint facts, safe-sync plans, local file lists,
@@ -141,12 +142,12 @@ You are receiving a /god-mode invocation. Your job is to spawn the
141
142
  loadout lists, or internal routing payloads into the user-visible transcript.
142
143
  The visible transcript may say only what phase is running, what durable state
143
144
  was detected, what commands are running, what changed, and the final
144
- `Arc complete` or `PAUSE: external access required` block.
145
+ `Project run complete` or `PAUSE: external access required` block.
145
146
 
146
147
  8. Orchestrator runs the appropriate workflow:
147
- - Greenfield -> full-arc
148
- - Brownfield -> brownfield-arc (preflight -> archaeology -> reconstruct -> debt-assess -> greenfield simulation audit -> greenfieldify plan and approved artifact updates -> proceed)
149
- - Bluefield -> bluefield-arc (org-context -> preflight -> greenfield simulation audit -> greenfieldify plan and approved artifact updates -> arc with constraints)
148
+ - Greenfield -> full project run
149
+ - Brownfield -> brownfield project run (preflight -> archaeology -> reconstruct -> debt-assess -> greenfield simulation audit -> greenfieldify plan and approved artifact updates -> proceed)
150
+ - Bluefield -> bluefield project run (org-context -> preflight -> greenfield simulation audit -> greenfieldify plan and approved artifact updates -> workflow with constraints)
150
151
 
151
152
  9. Relay only the orchestrator's user-facing output to the user. If the
152
153
  platform displays raw spawn details automatically, the displayed payload
@@ -168,9 +169,15 @@ Show:
168
169
  - detected resume or project mode in plain language
169
170
  - a compact "Next step" card before each visible phase or tier sub-step
170
171
  - a compact "Step result" card after each visible phase or tier sub-step
172
+ - plain-language workflow names. Say "project run" or "workflow" instead of
173
+ unexplained "arc" in visible output
174
+ - PRD and roadmap visibility in status and closeout blocks when artifacts
175
+ exist or are expected
171
176
  - short progress updates for phases, commands, validations, and file edits
172
177
  - concise validation summaries instead of full command noise when possible
173
178
  - final changed paths, validation results, and completion or pause status
179
+ - final current status, open items, worktree/index state, and recommended next
180
+ action
174
181
 
175
182
  Hide:
176
183
  - raw Task input
@@ -280,7 +287,7 @@ complete. This ensures all 14 artifact categories are in a consistent state:
280
287
 
281
288
  - 10 Tier 0-3 artifacts validated (have-nots passing)
282
289
  - 4 capture artifacts noted as `not-yet-created` (graceful handling)
283
- - SYNC-LOG.md updated with arc completion entry
290
+ - SYNC-LOG.md updated with project-run completion entry
284
291
  - state.json reflects final tier statuses
285
292
 
286
293
  Under `--yolo`, the sync step auto-applies (no pause). Under
@@ -297,7 +304,7 @@ If `/god-mode` resumes an existing `.godpowers` project that lacks Pillars,
297
304
  it Pillar-izes the project before continuing. Existing `.godpowers` artifacts
298
305
  become managed source references in the relevant `agents/*.md` files.
299
306
 
300
- The sync step is what closes the loop between greenfield arc creation and
307
+ The sync step is what closes the loop between greenfield project-run creation and
301
308
  the comprehensive 14-artifact reconciliation system. See
302
309
  `docs/greenfield-coverage.md` for what's created when.
303
310
 
@@ -306,7 +313,19 @@ the comprehensive 14-artifact reconciliation system. See
306
313
  When orchestrator returns "complete", display:
307
314
 
308
315
  ```
309
- Godpowers full-arc complete.
316
+ Godpowers project run complete.
317
+
318
+ Current status:
319
+ State: complete
320
+ Progress: <pct>% (<done> of <total> steps complete; current step <n> of <total>)
321
+ Worktree: <clean | modified files unstaged | staged changes | mixed>
322
+ Index: <untouched | staged files listed>
323
+
324
+ Planning visibility:
325
+ PRD: <done | pending | missing | deferred> <artifact path when present>
326
+ Roadmap: <done | pending | missing | deferred> <artifact path when present>
327
+ Current milestone: <roadmap milestone, tier, or next planning gate when known>
328
+ Completion: <pct>% <brief basis, for example done steps over total tracked steps>
310
329
 
311
330
  Artifacts on disk:
312
331
  + PRD .godpowers/prd/PRD.md
@@ -337,5 +356,24 @@ Periodic hygiene:
337
356
  Quality audit: /god-audit
338
357
  Health check: /god-hygiene
339
358
 
340
- Or describe what you want and /god-next will route.
359
+ Open items:
360
+ 1. <none, or deployed staging deferred, pending review, unstaged files, etc.>
361
+
362
+ Next:
363
+ Recommended: <single safest command or decision>
364
+ Why: <one sentence tied to disk state>
365
+
366
+ Proposition:
367
+ 1. Review status: /god-status
368
+ 2. Continue work: /god-next or describe the next intent
369
+ 3. Commit release-ready changes: stage only the intended files, then commit
370
+ 4. Run deployed staging: provide STAGING_APP_URL=<deployed staging origin> when needed
341
371
  ```
372
+
373
+ If the run edited code but did not stage or commit, the completion block must
374
+ say so. If unrelated or pre-existing worktree changes are present, do not imply
375
+ the worktree is clean. Recommend a scoped review or explicit staging path.
376
+
377
+ If the run is a focused brownfield/refactor workflow rather than a full greenfield
378
+ project run, adapt the same closeout shape and replace "Project is now in STEADY
379
+ STATE" with the actual disk-derived lifecycle and next route.
@@ -158,6 +158,16 @@ Path ahead:
158
158
 
159
159
  Keep the route to 3 lines unless the user asks for the full plan.
160
160
 
161
+ Also show planning visibility when the artifacts exist or are expected:
162
+
163
+ ```
164
+ Planning visibility:
165
+ PRD: <done | pending | missing> <path when present>
166
+ Roadmap: <done | pending | missing> <path when present>
167
+ Current milestone: <roadmap milestone, tier, or next planning gate>
168
+ Completion: <pct>% <basis from state.json or PROGRESS.md>
169
+ ```
170
+
161
171
  ## Process for Mode 4 (intent-based)
162
172
 
163
173
  ```
@@ -175,9 +185,9 @@ Returns ranked recipes matching:
175
185
  Display top match with the recipe's sequence:
176
186
  "Best match: add-feature-mid-arc-pause
177
187
  Sequence:
178
- 1. /god-pause-work (Save current /god-mode arc state)
188
+ 1. /god-pause-work (Save current /god-mode project-run state)
179
189
  2. /god-feature (Run feature workflow)
180
- 3. /god-resume-work (Restore arc)
190
+ 3. /god-resume-work (Restore project run)
181
191
 
182
192
  Run this sequence? Or see other matches?"
183
193
  ```
@@ -277,13 +287,13 @@ When in steady state, match keywords to workflows:
277
287
  | upgrade, migrate, bump major | /god-upgrade |
278
288
  | docs, documentation, README | /god-docs |
279
289
  | deps, dependencies, audit | /god-update-deps |
280
- | preflight, intake, audit before arc-ready, audit before pillars | /god-preflight |
290
+ | preflight, intake, audit before project run readiness, audit before pillars | /god-preflight |
281
291
  | audit, score, quality check | /god-audit |
282
292
  | health check, hygiene | /god-hygiene |
283
293
 
284
294
  If mode detection indicates brownfield or bluefield and
285
295
  `.godpowers/preflight/PREFLIGHT.md` is missing, prefer `/god-preflight` before
286
- recommending archaeology, reconstruction, arc-ready, pillars, or refactor work.
296
+ recommending archaeology, reconstruction, project-run readiness, pillars, or refactor work.
287
297
 
288
298
  ## Output Format
289
299
 
@@ -67,7 +67,7 @@ Constraints that will apply to this project:
67
67
  - Observability: Datadog
68
68
  ...
69
69
 
70
- Downstream agents will respect these throughout the arc.
70
+ Downstream agents will respect these throughout the project run.
71
71
 
72
72
  Suggested next: /god-init (or /god-mode if you're ready to build)
73
73
  ```