godpowers 1.6.9 → 1.6.11

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 (77) hide show
  1. package/CHANGELOG.md +68 -0
  2. package/README.md +16 -8
  3. package/RELEASE.md +66 -66
  4. package/SKILL.md +177 -3
  5. package/agents/god-auditor.md +4 -4
  6. package/agents/god-coordinator.md +5 -5
  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 +188 -29
  12. package/agents/god-reconciler.md +1 -1
  13. package/agents/god-updater.md +51 -2
  14. package/bin/install.js +4 -1
  15. package/hooks/session-start.sh +2 -2
  16. package/lib/checkpoint.js +4 -1
  17. package/lib/context-writer.js +1 -1
  18. package/package.json +1 -1
  19. package/references/HAVE-NOTS.md +1 -1
  20. package/references/orchestration/SCALE-DETECTION.md +1 -1
  21. package/references/shared/GLOSSARY.md +1 -1
  22. package/references/shared/ORCHESTRATORS.md +1 -1
  23. package/routing/god-mode.yaml +1 -1
  24. package/routing/god-preflight.yaml +1 -1
  25. package/routing/recipes/add-feature-mid-arc-pause.yaml +4 -4
  26. package/routing/recipes/bluefield-org-aware.yaml +1 -1
  27. package/routing/recipes/brownfield-onboarding.yaml +1 -1
  28. package/routing/recipes/greenfield-fast.yaml +1 -1
  29. package/routing/recipes/greenfield-with-ideation.yaml +1 -1
  30. package/skills/god-arch.md +1 -1
  31. package/skills/god-audit.md +2 -2
  32. package/skills/god-context.md +1 -1
  33. package/skills/god-debug.md +1 -1
  34. package/skills/god-deploy.md +2 -2
  35. package/skills/god-design-impact.md +1 -1
  36. package/skills/god-docs.md +22 -0
  37. package/skills/god-explore.md +1 -1
  38. package/skills/god-extract-learnings.md +1 -1
  39. package/skills/god-feature.md +1 -1
  40. package/skills/god-harden.md +1 -1
  41. package/skills/god-hotfix.md +1 -1
  42. package/skills/god-hygiene.md +1 -1
  43. package/skills/god-init.md +1 -1
  44. package/skills/god-launch.md +2 -2
  45. package/skills/god-lifecycle.md +9 -6
  46. package/skills/god-locate.md +1 -1
  47. package/skills/god-logs.md +1 -1
  48. package/skills/god-mode.md +86 -20
  49. package/skills/god-next.md +60 -4
  50. package/skills/god-observe.md +1 -1
  51. package/skills/god-org-context.md +1 -1
  52. package/skills/god-party.md +1 -1
  53. package/skills/god-prd.md +1 -1
  54. package/skills/god-preflight.md +5 -5
  55. package/skills/god-quick.md +1 -1
  56. package/skills/god-refactor.md +1 -1
  57. package/skills/god-repo.md +1 -1
  58. package/skills/god-review-changes.md +17 -0
  59. package/skills/god-review.md +1 -1
  60. package/skills/god-roadmap-update.md +1 -1
  61. package/skills/god-roadmap.md +1 -1
  62. package/skills/god-scan.md +24 -0
  63. package/skills/god-skip.md +1 -1
  64. package/skills/god-spike.md +1 -1
  65. package/skills/god-stack.md +1 -1
  66. package/skills/god-status.md +51 -1
  67. package/skills/god-suite-init.md +1 -1
  68. package/skills/god-suite-release.md +1 -1
  69. package/skills/god-suite-status.md +1 -1
  70. package/skills/god-suite-sync.md +1 -1
  71. package/skills/god-sync.md +34 -1
  72. package/skills/god-tech-debt.md +1 -1
  73. package/skills/god-test-runtime.md +26 -0
  74. package/skills/god.md +8 -8
  75. package/workflows/bluefield-arc.yaml +1 -1
  76. package/workflows/brownfield-arc.yaml +1 -1
  77. package/workflows/feature-arc.yaml +1 -1
@@ -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
@@ -9,7 +9,7 @@ description: |
9
9
 
10
10
  # /god-arch
11
11
 
12
- Spawn the **god-architect** agent in a fresh context via Task tool.
12
+ Spawn the **god-architect** agent in a fresh context via the host platform's native agent spawning mechanism.
13
13
 
14
14
  ## Setup
15
15
 
@@ -9,7 +9,7 @@ description: |
9
9
 
10
10
  # /god-audit
11
11
 
12
- Spawn the **god-auditor** agent in a fresh context via Task tool.
12
+ Spawn the **god-auditor** agent in a fresh context via the host platform's native agent spawning mechanism.
13
13
 
14
14
  ## Setup
15
15
 
@@ -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
 
@@ -9,7 +9,7 @@ description: |
9
9
 
10
10
  # /god-debug
11
11
 
12
- Spawn the **god-debugger** agent in a fresh context via Task tool.
12
+ Spawn the **god-debugger** agent in a fresh context via the host platform's native agent spawning mechanism.
13
13
 
14
14
  ## Setup
15
15
 
@@ -9,7 +9,7 @@ description: |
9
9
 
10
10
  # /god-deploy
11
11
 
12
- Spawn the **god-deploy-engineer** agent in a fresh context via Task tool.
12
+ Spawn the **god-deploy-engineer** agent in a fresh context via the host platform's native agent spawning mechanism.
13
13
 
14
14
  ## Setup
15
15
 
@@ -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
  ```
@@ -48,6 +48,28 @@ Update log: .godpowers/docs/UPDATE-LOG.md
48
48
  Suggested next: /god-status or continue with feature work
49
49
  ```
50
50
 
51
+ ## Proactive docs drift
52
+
53
+ Godpowers may invoke docs work proactively in two ways:
54
+
55
+ | Trigger | Action | Guardrail |
56
+ |---|---|---|
57
+ | Docs changed after code changed | Spawn `god-docs-writer` in drift-check mode when current workflow owns docs | Do not invent new docs scope |
58
+ | Code changed after docs that claim current behavior | Suggest `/god-docs` or spawn drift-check inside `/god-mode`, `/god-feature`, `/god-refactor`, or `/god-sync` closeout | Verify claims against code before editing |
59
+ | `REVIEW-REQUIRED.md` contains docs drift items | Suggest `/god-review-changes` first | Do not auto-clear review items |
60
+
61
+ When auto-invoked, show:
62
+
63
+ ```text
64
+ Auto-invoked:
65
+ Trigger: docs and code changed in the same workflow
66
+ Agent: god-docs-writer
67
+ Local syncs:
68
+ + docs-drift-check: <N claims checked, N drift items>
69
+ Artifacts: .godpowers/docs/UPDATE-LOG.md or no-op
70
+ Log: .godpowers/docs/UPDATE-LOG.md
71
+ ```
72
+
51
73
  ## Have-Nots
52
74
 
53
75
  Docs FAIL if:
@@ -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
 
@@ -9,7 +9,7 @@ description: |
9
9
 
10
10
  # /god-harden
11
11
 
12
- Spawn the **god-harden-auditor** agent in a fresh context via Task tool.
12
+ Spawn the **god-harden-auditor** agent in a fresh context via the host platform's native agent spawning mechanism.
13
13
 
14
14
  ## Setup
15
15
 
@@ -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
  ```
@@ -9,7 +9,7 @@ description: |
9
9
 
10
10
  # /god-launch
11
11
 
12
- Spawn the **god-launch-strategist** agent in a fresh context via Task tool.
12
+ Spawn the **god-launch-strategist** agent in a fresh context via the host platform's native agent spawning mechanism.
13
13
 
14
14
  ## Setup
15
15
 
@@ -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
@@ -124,29 +125,29 @@ You are receiving a /god-mode invocation. Your job is to spawn the
124
125
  unresolved Critical harden findings. These are release-truth gates, not
125
126
  preference pauses.
126
127
 
127
- 6. Spawn the **god-orchestrator** agent via Task tool with only a
128
+ 6. Spawn the **god-orchestrator** agent via the host platform's native agent spawning mechanism with only a
128
129
  display-safe payload:
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,
136
137
  hidden routing rules, or detailed instructions in the spawn message.
137
138
  Assume the host UI may display the raw spawn message to the user.
138
139
 
139
- 7. Keep the spawn payload display-safe. Do not echo or summarize raw Task input,
140
+ 7. Keep the spawn payload display-safe. Do not echo or summarize raw spawn input,
140
141
  "Hard instructions", hidden orchestration rules, agent prompts, file
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,12 +169,20 @@ 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
+ - every auto-invoked command, agent, and local runtime helper using an
173
+ `Auto-invoked:` or `Sync status:` card
174
+ - plain-language workflow names. Say "project run" or "workflow" instead of
175
+ unexplained "arc" in visible output
176
+ - PRD and roadmap visibility in status and closeout blocks when artifacts
177
+ exist or are expected
171
178
  - short progress updates for phases, commands, validations, and file edits
172
179
  - concise validation summaries instead of full command noise when possible
173
180
  - final changed paths, validation results, and completion or pause status
181
+ - final current status, open items, worktree/index state, and recommended next
182
+ action
174
183
 
175
184
  Hide:
176
- - raw Task input
185
+ - raw spawn input
177
186
  - "Hard instructions" sections
178
187
  - spawned-agent prompt text
179
188
  - detailed handoff file contents
@@ -280,13 +289,28 @@ complete. This ensures all 14 artifact categories are in a consistent state:
280
289
 
281
290
  - 10 Tier 0-3 artifacts validated (have-nots passing)
282
291
  - 4 capture artifacts noted as `not-yet-created` (graceful handling)
283
- - SYNC-LOG.md updated with arc completion entry
292
+ - SYNC-LOG.md updated with project-run completion entry
284
293
  - state.json reflects final tier statuses
285
294
 
286
295
  Under `--yolo`, the sync step auto-applies (no pause). Under
287
296
  `--conservative`, it pauses for confirmation. Under `--with-hygiene`,
288
297
  it runs alongside the hygiene pass.
289
298
 
299
+ Display this before the final completion block:
300
+
301
+ ```
302
+ Sync status:
303
+ Trigger: /god-mode final sync
304
+ Agent: god-updater spawned
305
+ Local syncs:
306
+ + reverse-sync: <counts and result>
307
+ + pillars-sync: <counts and result>
308
+ + checkpoint-sync: <created, updated, no-op, or skipped>
309
+ + context-refresh: <spawned, no-op, or skipped>
310
+ Artifacts: <changed files or no-op>
311
+ Log: .godpowers/SYNC-LOG.md
312
+ ```
313
+
290
314
  The sync step also reconciles native Pillars context. When `.godpowers`
291
315
  artifacts create or change durable project truth, Godpowers maps those changes
292
316
  to relevant pillar files through `lib/pillars.planArtifactSync`. Default mode
@@ -297,7 +321,7 @@ If `/god-mode` resumes an existing `.godpowers` project that lacks Pillars,
297
321
  it Pillar-izes the project before continuing. Existing `.godpowers` artifacts
298
322
  become managed source references in the relevant `agents/*.md` files.
299
323
 
300
- The sync step is what closes the loop between greenfield arc creation and
324
+ The sync step is what closes the loop between greenfield project-run creation and
301
325
  the comprehensive 14-artifact reconciliation system. See
302
326
  `docs/greenfield-coverage.md` for what's created when.
303
327
 
@@ -306,7 +330,30 @@ the comprehensive 14-artifact reconciliation system. See
306
330
  When orchestrator returns "complete", display:
307
331
 
308
332
  ```
309
- Godpowers full-arc complete.
333
+ Godpowers project run complete.
334
+
335
+ Sync status:
336
+ Trigger: /god-mode final sync
337
+ Agent: god-updater spawned
338
+ Local syncs:
339
+ + reverse-sync: <counts and result>
340
+ + pillars-sync: <counts and result>
341
+ + checkpoint-sync: <created, updated, no-op, or skipped>
342
+ + context-refresh: <spawned, no-op, or skipped>
343
+ Artifacts: <changed files or no-op>
344
+ Log: .godpowers/SYNC-LOG.md
345
+
346
+ Current status:
347
+ State: complete
348
+ Progress: <pct>% (<done> of <total> steps complete; current step <n> of <total>)
349
+ Worktree: <clean | modified files unstaged | staged changes | mixed>
350
+ Index: <untouched | staged files listed>
351
+
352
+ Planning visibility:
353
+ PRD: <done | pending | missing | deferred> <artifact path when present>
354
+ Roadmap: <done | pending | missing | deferred> <artifact path when present>
355
+ Current milestone: <roadmap milestone, tier, or next planning gate when known>
356
+ Completion: <pct>% <brief basis, for example done steps over total tracked steps>
310
357
 
311
358
  Artifacts on disk:
312
359
  + PRD .godpowers/prd/PRD.md
@@ -337,5 +384,24 @@ Periodic hygiene:
337
384
  Quality audit: /god-audit
338
385
  Health check: /god-hygiene
339
386
 
340
- Or describe what you want and /god-next will route.
387
+ Open items:
388
+ 1. <none, or deployed staging deferred, pending review, unstaged files, etc.>
389
+
390
+ Next:
391
+ Recommended: <single safest command or decision>
392
+ Why: <one sentence tied to disk state>
393
+
394
+ Proposition:
395
+ 1. Review status: /god-status
396
+ 2. Continue work: /god-next or describe the next intent
397
+ 3. Commit release-ready changes: stage only the intended files, then commit
398
+ 4. Run deployed staging: provide STAGING_APP_URL=<deployed staging origin> when needed
341
399
  ```
400
+
401
+ If the run edited code but did not stage or commit, the completion block must
402
+ say so. If unrelated or pre-existing worktree changes are present, do not imply
403
+ the worktree is clean. Recommend a scoped review or explicit staging path.
404
+
405
+ If the run is a focused brownfield/refactor workflow rather than a full greenfield
406
+ project run, adapt the same closeout shape and replace "Project is now in STEADY
407
+ STATE" with the actual disk-derived lifecycle and next route.
@@ -158,6 +158,52 @@ 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
+
171
+ ## Proactive Sweep
172
+
173
+ Before returning a suggestion, run the proactive auto-invoke policy from the
174
+ master skill against disk state. This is read-only unless a Level 2 local helper
175
+ has a direct trigger.
176
+
177
+ Check these signals:
178
+ - `.godpowers/CHECKPOINT.md` missing, stale, or conflicting with `state.json`
179
+ - `.godpowers/REVIEW-REQUIRED.md` contains pending entries
180
+ - `.godpowers/SYNC-LOG.md` missing after code or artifact edits
181
+ - docs changed after code changed, or code changed after docs that claim
182
+ current behavior
183
+ - frontend-visible files changed and a known local, preview, staging, or
184
+ production URL is evidenced
185
+ - security-sensitive files changed
186
+ - dependency files changed
187
+ - full project run completed and hygiene has not run recently
188
+
189
+ Display the result:
190
+
191
+ ```text
192
+ Proactive checks:
193
+ Checkpoint: <fresh | refreshed | stale, suggest /god-locate>
194
+ Reviews: <none | N pending, suggest /god-review-changes>
195
+ Sync: <fresh | suggest /god-sync | local linkage scan ran>
196
+ Docs: <fresh | suggest /god-docs | drift-check spawned>
197
+ Runtime: <not-applicable | suggest /god-test-runtime | browser test spawned>
198
+ Security: <clear | suggest /god-harden>
199
+ Dependencies: <clear | suggest /god-update-deps>
200
+ Hygiene: <fresh | suggest /god-hygiene>
201
+ ```
202
+
203
+ Do not auto-run Level 3 agents from standalone `/god-next` unless the user
204
+ explicitly asked it to continue work. In standalone mode, Level 3 items become
205
+ the recommended command or a proposition option.
206
+
161
207
  ## Process for Mode 4 (intent-based)
162
208
 
163
209
  ```
@@ -175,9 +221,9 @@ Returns ranked recipes matching:
175
221
  Display top match with the recipe's sequence:
176
222
  "Best match: add-feature-mid-arc-pause
177
223
  Sequence:
178
- 1. /god-pause-work (Save current /god-mode arc state)
224
+ 1. /god-pause-work (Save current /god-mode project-run state)
179
225
  2. /god-feature (Run feature workflow)
180
- 3. /god-resume-work (Restore arc)
226
+ 3. /god-resume-work (Restore project run)
181
227
 
182
228
  Run this sequence? Or see other matches?"
183
229
  ```
@@ -277,13 +323,13 @@ When in steady state, match keywords to workflows:
277
323
  | upgrade, migrate, bump major | /god-upgrade |
278
324
  | docs, documentation, README | /god-docs |
279
325
  | deps, dependencies, audit | /god-update-deps |
280
- | preflight, intake, audit before arc-ready, audit before pillars | /god-preflight |
326
+ | preflight, intake, audit before project run readiness, audit before pillars | /god-preflight |
281
327
  | audit, score, quality check | /god-audit |
282
328
  | health check, hygiene | /god-hygiene |
283
329
 
284
330
  If mode detection indicates brownfield or bluefield and
285
331
  `.godpowers/preflight/PREFLIGHT.md` is missing, prefer `/god-preflight` before
286
- recommending archaeology, reconstruction, arc-ready, pillars, or refactor work.
332
+ recommending archaeology, reconstruction, project-run readiness, pillars, or refactor work.
287
333
 
288
334
  ## Output Format
289
335
 
@@ -311,6 +357,16 @@ Previous tier had standards failures. Address before proceeding:
311
357
  - [failure 1]
312
358
  - [failure 2]
313
359
  Suggested: /god-redo [tier] OR /god-skip [tier] --reason="..."
360
+
361
+ Proactive checks:
362
+ Checkpoint: [fresh | refreshed | stale]
363
+ Reviews: [none | N pending]
364
+ Sync: [fresh | suggested | local helper ran]
365
+ Docs: [fresh | suggested]
366
+ Runtime: [not-applicable | suggested | ran]
367
+ Security: [clear | suggested]
368
+ Dependencies: [clear | suggested]
369
+ Hygiene: [fresh | suggested]
314
370
  ```
315
371
 
316
372
  ## Proposition Closeout