godpowers 1.6.4 → 1.6.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,60 @@ 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.6] - 2026-05-16
9
+
10
+ Non-God-Mode handoff privacy patch. Extends the display-safe handoff pattern
11
+ from `/god-mode` to other orchestrator entrypoints.
12
+
13
+ ### Added
14
+ - Added private handoff guidance for `/god-init` before it spawns
15
+ `god-orchestrator`.
16
+ - Added private handoff guidance for `/god-suite-init`,
17
+ `/god-suite-release`, and `/god-suite-patch` before they spawn
18
+ `god-coordinator`.
19
+ - Added `god-coordinator` guidance for display-safe per-repo
20
+ `god-orchestrator` spawns.
21
+ - Added regression coverage for non-`/god-mode` handoff entrypoints.
22
+
23
+ ### Changed
24
+ - `god-orchestrator` now documents handoff files from `/god-init`,
25
+ `god-coordinator`, or any other caller, not only `/god-mode`.
26
+ - `/god-hygiene` routing no longer lists `god-orchestrator` as a secondary
27
+ spawn because the skill only runs the three hygiene audits.
28
+
29
+ ### Guardrails
30
+ - This patch does not add slash commands, agents, workflows, recipes, schemas,
31
+ or public artifact formats.
32
+ - The handoff change affects transcript hygiene only. It does not weaken
33
+ release-truth gates or per-repo Quarterback ownership.
34
+
35
+ ## [1.6.5] - 2026-05-16
36
+
37
+ God Mode handoff privacy patch. Keeps the 1.6 command surface stable while
38
+ making Codex-spawned `god-orchestrator` runs display a small safe pointer
39
+ instead of detailed orchestration payloads.
40
+
41
+ ### Added
42
+ - Added a private `.godpowers/runs/<run-id>/ORCHESTRATOR-HANDOFF.md` handoff
43
+ pattern for `/god-mode` orchestration context.
44
+ - Added `god-orchestrator` instructions to read handoff files before planning
45
+ or mutation and keep handoff contents out of the visible transcript.
46
+ - Added regression coverage proving agent validation ignores non-specialist
47
+ Pillars files under `agents/`.
48
+
49
+ ### Changed
50
+ - `/god-mode` now spawns `god-orchestrator` with only a display-safe project
51
+ root, flags, and handoff file path.
52
+ - Agent validation and smoke tests now inspect `agents/god-*.md` specialist
53
+ files while allowing Pillars context files like `agents/context.md` and
54
+ `agents/repo.md` to coexist.
55
+
56
+ ### Guardrails
57
+ - This patch does not add slash commands, agents, workflows, recipes, schemas,
58
+ or public artifact formats.
59
+ - `--yolo` still respects safe-sync and Critical harden blockers. The handoff
60
+ change affects transcript hygiene, not gate policy.
61
+
8
62
  ## [1.6.4] - 2026-05-16
9
63
 
10
64
  Release gate propagation patch. Keeps the 1.6 command surface stable while
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.4-blue)](CHANGELOG.md)
5
+ [![Version](https://img.shields.io/badge/version-1.6.6-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,10 +12,11 @@ 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.4 hardens Godpowers routing around release truth: safe-sync
16
- blockers and unresolved Critical harden findings now gate direct Tier 3
17
- commands, `/god-mode`, and `/god-mode --yolo`, while Codex installs keep
18
- per-agent TOML metadata for all 39 specialist agents.
15
+ Version 1.6.6 keeps the stable Godpowers surface while making more Codex
16
+ orchestrator spawns transcript-safe: `/god-mode`, `/god-init`, and Mode D
17
+ suite coordinator paths now use private handoff files with small display-safe
18
+ pointers. Safe-sync and unresolved Critical harden findings still gate direct
19
+ Tier 3 commands, `/god-mode`, and `/god-mode --yolo`.
19
20
 
20
21
  It fuses four disciplines into one unified workflow:
21
22
 
package/RELEASE.md CHANGED
@@ -1,11 +1,11 @@
1
- # Godpowers 1.6.4 Release
1
+ # Godpowers 1.6.6 Release
2
2
 
3
3
  Date: 2026-05-16
4
4
 
5
- Godpowers 1.6.4 hardens release-truth routing around the stable 1.6 surface.
6
- The goal of this patch is to make safe sync and unresolved Critical harden
7
- findings block direct Tier 3 commands, `/god-mode`, and `/god-mode --yolo`,
8
- without changing the public command surface.
5
+ Godpowers 1.6.6 extends transcript-safe spawn handling beyond `/god-mode`.
6
+ The goal of this patch is to keep Codex-visible spawn messages small and safe
7
+ for `/god-init` and Mode D suite coordination while preserving the same
8
+ orchestrator and coordinator behavior.
9
9
 
10
10
  ## What is stable
11
11
 
@@ -27,33 +27,40 @@ without changing the public command surface.
27
27
 
28
28
  ## What is new
29
29
 
30
- - `/god-next` detects `.godpowers/sync/SAFE-SYNC-PLAN.md` and routes to
31
- `/god-reconcile Release Truth And Safe Sync` before `/god-deploy`.
32
- - Direct `/god-observe`, `/god-harden`, `/god-launch`, and `/god-mode`
33
- invocations also require `safe-sync-clear`.
34
- - `/god-launch` now executes the `no-critical-findings` prerequisite instead
35
- of treating it as an unknown pass-through check.
36
- - `god-orchestrator` now checks router prerequisites before command dispatch,
37
- including under `--yolo`.
38
- - Router tests cover unresolved safe sync plans, checkpoint blockers, direct
39
- Tier 3 gates, `/god-mode`, unresolved Critical findings, and resolved gates.
40
-
41
- ## What 1.6.4 means
42
-
43
- Godpowers 1.6.4 does not expand the public command surface. It tightens the
44
- runtime decision path so project truth can override structural tier order for
45
- safe sync and harden Critical gates.
46
-
47
- The domain glossary remains preparation context. PRD, ARCH, ROADMAP, STACK,
48
- docs, and Pillars files still carry durable decisions for their own domains.
30
+ - `/god-init` now writes detailed initialization context to
31
+ `.godpowers/runs/<run-id>/INIT-ORCHESTRATOR-HANDOFF.md` before spawning
32
+ `god-orchestrator`.
33
+ - `/god-suite-init`, `/god-suite-release`, and `/god-suite-patch` now write
34
+ suite coordination context to
35
+ `.godpowers/runs/<run-id>/COORDINATOR-HANDOFF.md` before spawning
36
+ `god-coordinator`.
37
+ - `god-coordinator` now writes per-repo orchestrator context to
38
+ `.godpowers/runs/<run-id>/COORDINATOR-ORCHESTRATOR-HANDOFF.md` before
39
+ spawning a target repo's `god-orchestrator`.
40
+ - `god-orchestrator` now treats handoff files as a general caller protocol,
41
+ not only as a `/god-mode` protocol.
42
+ - `/god-hygiene` routing no longer lists `god-orchestrator` as a secondary
43
+ spawn because the skill only runs artifact, dependency, and documentation
44
+ audits.
45
+
46
+ ## What 1.6.6 means
47
+
48
+ Godpowers 1.6.6 does not expand the public command surface. It fixes more
49
+ Codex spawn integration paths so the right agent is still started, but the host
50
+ UI only sees a small pointer to disk state instead of raw project description,
51
+ suite metadata, release notes, patch directives, dependency graphs, routing
52
+ rules, or local-file details.
53
+
54
+ Safe sync and unresolved Critical harden findings remain release-truth gates.
55
+ Per-repo Quarterback ownership remains intact for Mode D suite work.
49
56
 
50
57
  ## Stability policy
51
58
 
52
59
  During the 1.x stability window, do not add broad new command families, change
53
60
  schema formats, or rename public artifacts without evidence from real use.
54
61
 
55
- The `v1.6.4` git tag points to the release commit that matches the npm
56
- `godpowers@1.6.4` package. Public publishes should prefer the tag-triggered
62
+ The `v1.6.6` git tag points to the release commit that matches the npm
63
+ `godpowers@1.6.6` package. Public publishes should prefer the tag-triggered
57
64
  GitHub workflow so npm provenance, git history, and release notes stay aligned.
58
65
 
59
66
  Allowed changes:
@@ -44,6 +44,20 @@ suite (the collection of repos), not individual repos.
44
44
  - Per-repo `state.json` files
45
45
  - Optionally: a specific operation (sync, release, patch, status)
46
46
 
47
+ ## Coordinator Handoff
48
+
49
+ When spawned by a suite command, the visible spawn message may include only a
50
+ display-safe operation summary plus a path like
51
+ `.godpowers/runs/<run-id>/COORDINATOR-HANDOFF.md`.
52
+
53
+ If a handoff path is provided:
54
+ 1. Read the handoff file before planning, spawning, or mutating suite state.
55
+ 2. Treat the handoff as private suite coordination context.
56
+ 3. Do not quote, summarize, or expose the full handoff in the visible
57
+ transcript.
58
+ 4. If the handoff conflicts with durable suite artifacts, prefer disk
59
+ artifacts and record the conflict as an open question or repair target.
60
+
47
61
  ## Process per operation
48
62
 
49
63
  ### Mode 1: status (`/god-suite-status`)
@@ -66,7 +80,8 @@ suite (the collection of repos), not individual repos.
66
80
 
67
81
  1. User provides repo + new version
68
82
  2. Run impact analysis: which sibling repos depend on this one?
69
- 3. For each affected sibling: spawn its `god-orchestrator` with a
83
+ 3. For each affected sibling: write a per-repo orchestrator handoff file and
84
+ spawn its `god-orchestrator` with only a display-safe pointer for the
70
85
  `version-bump` directive (NOT a full arc)
71
86
  4. Aggregate results into a release report
72
87
  5. Update `.godpowers/suite-config.yaml` version-table
@@ -75,8 +90,9 @@ suite (the collection of repos), not individual repos.
75
90
  ### Mode 4: patch (`/god-suite-patch`)
76
91
 
77
92
  1. User describes a change that touches multiple repos
78
- 2. For each repo in scope: spawn its `god-orchestrator` with the
79
- patch description
93
+ 2. For each repo in scope: write a per-repo orchestrator handoff file and
94
+ spawn its `god-orchestrator` with only a display-safe pointer for the
95
+ patch directive
80
96
  3. Coordinate atomicity: if any repo fails, mark the suite-level
81
97
  patch as incomplete and report
82
98
  4. Append to SYNC-LOG.md
@@ -117,8 +133,25 @@ For each operation, return to the spawning skill with:
117
133
  ## Coordination with per-repo orchestrators
118
134
 
119
135
  When you need work done IN a repo (version bump, patch slice, etc.),
120
- spawn that repo's `god-orchestrator` via the Task tool with the
121
- specific directive. Do not bypass it. The Quarterback rule:
136
+ create a private handoff in that repo first, then spawn that repo's
137
+ `god-orchestrator` via the Task tool with only a display-safe pointer.
138
+
139
+ Per-repo handoff path:
140
+ `.godpowers/runs/<run-id>/COORDINATOR-ORCHESTRATOR-HANDOFF.md`
141
+
142
+ Put the version-bump directive, patch directive, suite impact analysis,
143
+ affected dependency facts, release notes, and repo-specific notes in the
144
+ handoff file. The visible spawn message may include only:
145
+ - The target repo root
146
+ - The suite operation name
147
+ - The handoff file path
148
+ - "Read the handoff file first, then run the requested scoped work from disk
149
+ state. Return only user-facing progress and final status."
150
+
151
+ Do not put suite metadata, dependency graphs, local file lists, release notes,
152
+ patch descriptions, hidden routing rules, or detailed instructions in the
153
+ visible spawn message. Do not bypass the target repo orchestrator. The
154
+ Quarterback rule:
122
155
 
123
156
  > Each repo has exactly one orchestrator. The coordinator is a peer
124
157
  > at suite scope, not a higher-tier overseer.
@@ -21,6 +21,25 @@ You orchestrate the full Godpowers arc. 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
 
24
+ ## Orchestrator Handoff
25
+
26
+ When spawned by `/god-mode`, `/god-init`, `god-coordinator`, or any other
27
+ caller, the visible spawn message may include only a display-safe summary plus
28
+ a path like
29
+ `.godpowers/runs/<run-id>/ORCHESTRATOR-HANDOFF.md`.
30
+
31
+ If a handoff path is provided:
32
+ 1. Read the handoff file before any planning, spawning, or state mutation.
33
+ 2. Treat the handoff as private orchestration context and disk evidence.
34
+ 3. Do not quote, summarize, or expose the full handoff in the user-visible
35
+ transcript.
36
+ 4. If the handoff conflicts with durable artifacts, prefer disk artifacts and
37
+ record the conflict as an open question or repair target.
38
+
39
+ If no handoff path is provided, recover from durable disk state. Do not ask the
40
+ user to restate the project when `.godpowers` artifacts, Pillars files, or
41
+ repository evidence identify the work.
42
+
24
43
  ## Quarterback responsibilities (Tier 0 ownership)
25
44
 
26
45
  You and only you are responsible for:
@@ -230,14 +230,18 @@ function crossValidate(agents, opts = {}) {
230
230
  }
231
231
 
232
232
  /**
233
- * Walk agents/ and audit all.
233
+ * Walk agents/ and audit all shipped specialist agents.
234
+ *
235
+ * Godpowers projects may also have Pillars files under agents/ (for example
236
+ * agents/context.md and agents/repo.md). Those are project context, not
237
+ * specialist agent specs, so they are intentionally excluded here.
234
238
  */
235
239
  function auditAll(projectRoot, opts = {}) {
236
240
  const agentsDir = path.join(projectRoot, 'agents');
237
241
  if (!fs.existsSync(agentsDir)) {
238
242
  return { results: [], summary: { errors: 0, warnings: 0, infos: 0 } };
239
243
  }
240
- const files = fs.readdirSync(agentsDir).filter(f => f.endsWith('.md'));
244
+ const files = fs.readdirSync(agentsDir).filter(f => /^god-.*\.md$/.test(f));
241
245
  const agents = files.map(f => parseAgentFile(path.join(agentsDir, f)));
242
246
 
243
247
  const allFindings = [];
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "godpowers",
3
- "version": "1.6.4",
3
+ "version": "1.6.6",
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"
@@ -12,7 +12,7 @@ prerequisites:
12
12
  execution:
13
13
  spawns: [god-auditor]
14
14
  context: fresh
15
- secondary-spawns: [god-deps-auditor, god-docs-writer, god-orchestrator]
15
+ secondary-spawns: [god-deps-auditor, god-docs-writer]
16
16
  writes:
17
17
  - .godpowers/HYGIENE-REPORT.md
18
18
 
@@ -48,7 +48,7 @@ GODPOWERS DOCTOR
48
48
  Install: claude (~/.claude/)
49
49
  [OK] 106 skills installed
50
50
  [OK] 39 agents installed
51
- [OK] VERSION matches (1.6.4)
51
+ [OK] VERSION matches (1.6.6)
52
52
  [WARN] routing/god-doctor.yaml exists but skill file did not until now
53
53
 
54
54
  Project: /Users/.../my-project/.godpowers/
@@ -81,10 +81,27 @@ needs to specify a mode.
81
81
  - Code present + org context: "Detected: existing codebase + org standards.
82
82
  I'll archaeology, reconstruct, and respect your org's standards."
83
83
 
84
- 4. Ask the user to describe what they want to build. Accept any format.
85
-
86
- 5. Spawn **god-orchestrator** in fresh context with the user's description and
87
- the detected mode/context.
84
+ 5. Ask the user to describe what they want to build. Accept any format.
85
+
86
+ 6. Create a private disk handoff before spawning the orchestrator:
87
+ - Path: `.godpowers/runs/<run-id>/INIT-ORCHESTRATOR-HANDOFF.md`
88
+ - Create parent directories if needed.
89
+ - Put the user's description, detected mode, detected context, initial
90
+ findings summary, imported context summary, Pillars status, and next-step
91
+ routing notes in this file.
92
+
93
+ 7. Spawn **god-orchestrator** in fresh context with only a display-safe
94
+ payload:
95
+ - Name the project root.
96
+ - Name the invocation as `/god-init`.
97
+ - Name the handoff file path.
98
+ - Say: "Read the handoff file first, then initialize or resume from disk
99
+ state. Return only user-facing progress and final status."
100
+
101
+ Do not put recovered planning context, local file lists, org standards,
102
+ imported planning-system summaries, hidden routing rules, or detailed
103
+ instructions in the visible spawn message. Assume the host UI may display
104
+ the raw spawn message to the user.
88
105
 
89
106
  The orchestrator will:
90
107
  - Run Mode Detection (announced in plain English; stored as A/B/C/E internally)
@@ -100,14 +117,14 @@ needs to specify a mode.
100
117
  - Write PROGRESS.md with mode, scale, timestamp, tier states
101
118
  - Return mode/scale/announcement to this skill
102
119
 
103
- 4. Detect scale by analyzing the description:
120
+ 8. Detect scale by analyzing the description:
104
121
  - **Trivial**: Single file change, bug fix, config tweak
105
122
  - **Small**: One feature, one service, <1 week
106
123
  - **Medium**: Multiple features, 1-3 services, 1-4 weeks
107
124
  - **Large**: Multiple services, team coordination, 1-3 months
108
125
  - **Enterprise**: Multiple teams, compliance, 3+ months
109
126
 
110
- 5. Create the directory structure:
127
+ 9. Create the directory structure:
111
128
  ```
112
129
  AGENTS.md
113
130
  agents/
@@ -140,9 +157,9 @@ needs to specify a mode.
140
157
  harden/
141
158
  ```
142
159
 
143
- 6. Write PROGRESS.md with mode, scale, timestamp, all tiers set to `pending`
160
+ 10. Write PROGRESS.md with mode, scale, timestamp, all tiers set to `pending`
144
161
 
145
- 7. Report to the user:
162
+ 11. Report to the user:
146
163
  - Detected mode and scale
147
164
  - Which tiers and personas will activate
148
165
  - What to run next (suggest `god prd` or `god mode`)
@@ -69,75 +69,94 @@ You are receiving a /god-mode invocation. Your job is to spawn the
69
69
  - `--bluefield` (force bluefield path)
70
70
  - `--greenfield` (force greenfield, skip archaeology even if code exists)
71
71
 
72
- 5. Spawn the **god-orchestrator** agent via Task tool with:
73
- - The user's project description, or durable intent recovered from disk
74
- - The detected mode (A/B/C/E)
75
- - The active flags
76
- - Instruction that existing `.godpowers` state means resume, not prompt
77
- - Instruction to read `.godpowers/PROGRESS.md` from disk if it exists
78
- - Instruction to read `.godpowers/prep/INITIAL-FINDINGS.md` and
79
- `.godpowers/prep/IMPORTED-CONTEXT.md` if present before choosing the
80
- first planning or build step
81
- - Instruction to read `.godpowers/preflight/PREFLIGHT.md` if present before
82
- choosing the first brownfield or bluefield action
83
- - Instruction to compute and load the Pillars load set before every major
84
- command, because Pillars is the native project context layer
85
- - Instruction to run `/god-design` after `/god-prd` and before `/god-arch`
86
- when initial findings, imported planning context, the PRD, or the
87
- codebase show UI or product-experience signals
88
- - Instruction that a red test, typecheck, lint, build, or check command is
89
- not a completed arc. It must enter the autonomous repair loop and continue
90
- the same `/god-mode` run until green, except for Critical security or a
91
- genuine human-only decision.
92
- - Instruction that deploy, observe, harden, and launch must follow the
93
- Shipping Closure Protocol: verify a real environment when available,
94
- otherwise create local/CI-verifiable deploy automation and pause only for
95
- one exact external access bundle.
96
- - Instruction that keys, API tokens, dashboards, admin consoles, and
97
- provider-specific access are last-mile inputs. The first external pause
98
- should ask only for the smallest next item needed by a concrete command,
99
- usually `STAGING_APP_URL=<staging-origin>`. Ask for additional provider
100
- access only after a named check proves it is needed.
101
- - Instruction that staging, preview, and production URLs must come from
102
- direct evidence. Never infer or invent a domain from project name, package
103
- name, repo name, README title, or brand name. If no deployed origin is
104
- evidenced, pause for `STAGING_APP_URL=<deployed staging origin>`.
105
- - Instruction that brownfield and bluefield greenfield simulation audits
106
- must be acted on by god-greenfieldifier. The greenfieldifier writes
107
- `.godpowers/audit/GREENFIELDIFY-PLAN.md`, pauses before risky canonical
108
- artifact rewrites, and updates every affected artifact after approval.
109
- - Instruction that brownfield and bluefield arcs run `/god-preflight`
110
- automatically when `.godpowers/preflight/PREFLIGHT.md` is absent.
111
- Greenfield arcs skip preflight unless the user explicitly requests it.
112
- - Instruction to run routing prerequisites through `lib/router.js`
113
- `checkPrerequisites` before every direct command dispatch. If
114
- `safe-sync-clear` fails, run
115
- `/god-reconcile Release Truth And Safe Sync` before deploy, observe,
116
- harden, launch, broad migration, or resume work.
117
- - Instruction that `--yolo` cannot bypass safe sync blockers or unresolved
118
- Critical harden findings. These are release-truth gates, not preference
119
- pauses.
120
-
121
- 6. Keep the spawn payload private. Do not echo or summarize raw Task input,
72
+ 5. Create a private disk handoff before spawning the orchestrator:
73
+ - Path: `.godpowers/runs/<run-id>/ORCHESTRATOR-HANDOFF.md`
74
+ - Create parent directories if needed.
75
+ - Put all detailed orchestration context in this file, including:
76
+ - The user's project description, or durable intent recovered from disk
77
+ - The detected mode (A/B/C/E)
78
+ - The active flags
79
+ - Instruction that existing `.godpowers` state means resume, not prompt
80
+ - Instruction to read `.godpowers/PROGRESS.md` from disk if it exists
81
+ - Instruction to read `.godpowers/prep/INITIAL-FINDINGS.md` and
82
+ `.godpowers/prep/IMPORTED-CONTEXT.md` if present before choosing the
83
+ first planning or build step
84
+ - Instruction to read `.godpowers/preflight/PREFLIGHT.md` if present
85
+ before choosing the first brownfield or bluefield action
86
+ - Instruction to compute and load the Pillars load set before every major
87
+ command, because Pillars is the native project context layer
88
+ - Instruction to run `/god-design` after `/god-prd` and before
89
+ `/god-arch` when initial findings, imported planning context, the PRD,
90
+ or the codebase show UI or product-experience signals
91
+ - 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
+ continue the same `/god-mode` run until green, except for Critical
94
+ security or a genuine human-only decision.
95
+ - Instruction that deploy, observe, harden, and launch must follow the
96
+ Shipping Closure Protocol: verify a real environment when available,
97
+ otherwise create local/CI-verifiable deploy automation and pause only
98
+ for one exact external access bundle.
99
+ - Instruction that keys, API tokens, dashboards, admin consoles, and
100
+ provider-specific access are last-mile inputs. The first external pause
101
+ should ask only for the smallest next item needed by a concrete command,
102
+ usually `STAGING_APP_URL=<staging-origin>`. Ask for additional provider
103
+ access only after a named check proves it is needed.
104
+ - Instruction that staging, preview, and production URLs must come from
105
+ direct evidence. Never infer or invent a domain from project name,
106
+ package name, repo name, README title, or brand name. If no deployed
107
+ origin is evidenced, pause for
108
+ `STAGING_APP_URL=<deployed staging origin>`.
109
+ - Instruction that brownfield and bluefield greenfield simulation audits
110
+ must be acted on by god-greenfieldifier. The greenfieldifier writes
111
+ `.godpowers/audit/GREENFIELDIFY-PLAN.md`, pauses before risky canonical
112
+ artifact rewrites, and updates every affected artifact after approval.
113
+ - Instruction that brownfield and bluefield arcs run `/god-preflight`
114
+ automatically when `.godpowers/preflight/PREFLIGHT.md` is absent.
115
+ Greenfield arcs skip preflight unless the user explicitly requests it.
116
+ - Instruction to run routing prerequisites through `lib/router.js`
117
+ `checkPrerequisites` before every direct command dispatch. If
118
+ `safe-sync-clear` fails, run
119
+ `/god-reconcile Release Truth And Safe Sync` before deploy, observe,
120
+ harden, launch, broad migration, or resume work.
121
+ - Instruction that `--yolo` cannot bypass safe sync blockers or
122
+ unresolved Critical harden findings. These are release-truth gates, not
123
+ preference pauses.
124
+
125
+ 6. Spawn the **god-orchestrator** agent via Task tool with only a
126
+ display-safe payload:
127
+ - Name the project root.
128
+ - Name the invocation flags.
129
+ - Name the handoff file path.
130
+ - Say: "Read the handoff file first, then run the autonomous arc from disk
131
+ state. Return only user-facing progress and final status."
132
+
133
+ Do not put recovered checkpoint facts, safe-sync plans, local file lists,
134
+ hidden routing rules, or detailed instructions in the spawn message.
135
+ Assume the host UI may display the raw spawn message to the user.
136
+
137
+ 7. Keep the spawn payload display-safe. Do not echo or summarize raw Task input,
122
138
  "Hard instructions", hidden orchestration rules, agent prompts, file
123
139
  loadout lists, or internal routing payloads into the user-visible transcript.
124
140
  The visible transcript may say only what phase is running, what durable state
125
141
  was detected, what commands are running, what changed, and the final
126
142
  `Arc complete` or `PAUSE: external access required` block.
127
143
 
128
- 7. Orchestrator runs the appropriate workflow:
144
+ 8. Orchestrator runs the appropriate workflow:
129
145
  - Greenfield -> full-arc
130
146
  - Brownfield -> brownfield-arc (preflight -> archaeology -> reconstruct -> debt-assess -> greenfield simulation audit -> greenfieldify plan and approved artifact updates -> proceed)
131
147
  - Bluefield -> bluefield-arc (org-context -> preflight -> greenfield simulation audit -> greenfieldify plan and approved artifact updates -> arc with constraints)
132
148
 
133
- 8. Relay only the orchestrator's user-facing output to the user. If the
134
- platform displays raw spawn details automatically, immediately follow with a
135
- clean public summary and never repeat the leaked payload.
149
+ 9. Relay only the orchestrator's user-facing output to the user. If the
150
+ platform displays raw spawn details automatically, the displayed payload
151
+ should already be safe. Immediately follow with a clean public summary and
152
+ never repeat detailed handoff contents.
136
153
 
137
- 9. When the orchestrator pauses, present the question to the user using the
154
+ 10. When the orchestrator pauses, present the question to the user using the
138
155
  pause format (What / Why / Options / Default).
139
156
 
140
- 10. When the user answers, re-spawn god-orchestrator with the answer.
157
+ 11. When the user answers, append the answer to the existing handoff file or
158
+ create a new handoff file, then re-spawn god-orchestrator with only the
159
+ display-safe pointer.
141
160
 
142
161
  ## User-Visible Transcript Contract
143
162
 
@@ -153,6 +172,7 @@ Hide:
153
172
  - raw Task input
154
173
  - "Hard instructions" sections
155
174
  - spawned-agent prompt text
175
+ - detailed handoff file contents
156
176
  - system, developer, or AGENTS.md rule recitations
157
177
  - complete file loadout lists
158
178
  - internal routing metadata unless it directly affects a user decision
@@ -32,12 +32,23 @@ are listed manually; godpowers does NOT auto-walk parent dirs.
32
32
  - Byte-identical files to track (one per line; e.g., LICENSE, .editorconfig)
33
33
  - Version-table entries (optional; can be added later)
34
34
  - Shared standards (node-version, linter; optional)
35
- 3. Spawn `god-coordinator` agent in `init` mode with collected inputs.
36
- 4. god-coordinator writes `.godpowers/suite-config.yaml` and updates
35
+ 3. Create `.godpowers/runs/<run-id>/COORDINATOR-HANDOFF.md` with the
36
+ collected suite name, sibling paths, byte-identical files, version-table
37
+ entries, shared standards, and init-mode instruction.
38
+ 4. Spawn `god-coordinator` agent in `init` mode with only a display-safe
39
+ payload:
40
+ - Name the hub path.
41
+ - Name the operation as `init`.
42
+ - Name the handoff file path.
43
+ - Say: "Read the handoff file first, then perform suite init from disk
44
+ state. Return only user-facing progress and final status."
45
+ Do not put sibling paths, version-table entries, shared standards, local
46
+ file lists, or detailed instructions in the visible spawn message.
47
+ 5. god-coordinator writes `.godpowers/suite-config.yaml` and updates
37
48
  each sibling's state.json with `suite.hubPath`.
38
- 5. Initial `lib/suite-state.refreshFromRepos` runs to populate
49
+ 6. Initial `lib/suite-state.refreshFromRepos` runs to populate
39
50
  `.godpowers/suite/state.json` and `STATE.md`.
40
- 6. Report registration complete; suggest `/god-suite-status` next.
51
+ 7. Report registration complete; suggest `/god-suite-status` next.
41
52
 
42
53
  ## Output
43
54
 
@@ -22,11 +22,23 @@ locally; the coordinator tracks atomicity.
22
22
  - Patch description (what's the change)
23
23
  - Repos in scope (defaults: all siblings; user can subset)
24
24
  - Per-repo any specific notes
25
- 3. Spawn `god-coordinator` in `patch` mode.
26
- 4. For each repo in scope:
27
- - Spawn that repo's `god-orchestrator` with the patch directive
25
+ 3. Create `.godpowers/runs/<run-id>/COORDINATOR-HANDOFF.md` with the patch
26
+ description, repos in scope, per-repo notes, dry-run flag, and patch-mode
27
+ instruction.
28
+ 4. Spawn `god-coordinator` in `patch` mode with only a display-safe payload:
29
+ - Name the hub path.
30
+ - Name the operation as `patch`.
31
+ - Name the handoff file path.
32
+ - Say: "Read the handoff file first, then coordinate the suite patch from
33
+ disk state. Return only user-facing progress and final status."
34
+ Do not put patch descriptions, per-repo notes, sibling paths, local file
35
+ lists, or detailed instructions in the visible spawn message.
36
+ 5. For each repo in scope:
37
+ - Write a per-repo orchestrator handoff file and spawn that repo's
38
+ `god-orchestrator` with only a display-safe pointer for the patch
39
+ directive
28
40
  - Track success/failure
29
- 5. Coordinator aggregates results:
41
+ 6. Coordinator aggregates results:
30
42
  - All succeeded: report success; append to SYNC-LOG.md
31
43
  - Some failed: report partial; suggest manual continuation OR
32
44
  rollback (`/god-suite-patch --rollback <patch-id>`)
@@ -17,15 +17,27 @@ A version bump that knows about dependents. Different from `/god-launch`
17
17
 
18
18
  1. Verify suite is registered.
19
19
  2. Prompt for: which repo, new version, release notes.
20
- 3. Spawn `god-coordinator` in `release` mode.
21
- 4. god-coordinator:
20
+ 3. Create `.godpowers/runs/<run-id>/COORDINATOR-HANDOFF.md` with the repo,
21
+ new version, release notes, propagation flags, and suite release
22
+ instruction.
23
+ 4. Spawn `god-coordinator` in `release` mode with only a display-safe
24
+ payload:
25
+ - Name the hub path.
26
+ - Name the operation as `release`.
27
+ - Name the handoff file path.
28
+ - Say: "Read the handoff file first, then coordinate the suite release
29
+ from disk state. Return only user-facing progress and final status."
30
+ Do not put release notes, dependency impact, sibling paths, local file
31
+ lists, or detailed instructions in the visible spawn message.
32
+ 5. god-coordinator:
22
33
  - Scans suite version-table for repos that depend on the bumped repo
23
- - For each dependent: spawns its `god-orchestrator` with a
34
+ - For each dependent: writes a per-repo orchestrator handoff file and
35
+ spawns its `god-orchestrator` with only a display-safe pointer for the
24
36
  `version-bump` directive (NOT a full arc)
25
37
  - Aggregates results per-repo
26
38
  - Updates `.godpowers/suite-config.yaml` version-table to match
27
39
  - Appends to `.godpowers/suite/SYNC-LOG.md`
28
- 5. Reports aggregated outcome (bumped + propagated repos).
40
+ 6. Reports aggregated outcome (bumped + propagated repos).
29
41
 
30
42
  ## Forms
31
43
 
@@ -14,7 +14,7 @@ Print version and a short capability summary.
14
14
  ## Output
15
15
 
16
16
  ```
17
- Godpowers v1.6.4
17
+ Godpowers v1.6.6
18
18
  Install: /Users/.../.claude/ (matches package.json)
19
19
  Surface: 106 skills, 39 agents, 13 workflows, 36 recipes
20
20
  Schema: intent.v1, state.v1, events.v1, workflow.v1, routing.v1, recipe.v1