godpowers 1.6.10 → 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.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,45 @@ 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.11] - 2026-05-16
9
+
10
+ Auto-invoke visibility and platform-neutral spawning patch.
11
+
12
+ ### Added
13
+ - Added a core auto-invoke visibility rule requiring Godpowers to show when it
14
+ automatically runs a command, spawns an agent, or calls a local runtime
15
+ helper.
16
+ - Added a proactive auto-invoke policy with four levels: read-only
17
+ suggestions, visible local helpers, bounded specialist agent spawns, and
18
+ explicit-approval-only actions.
19
+ - Added proactive checks to `/god-next`, `/god-status`, and God Mode closeouts
20
+ so users can see checkpoint, review, sync, docs, runtime, security,
21
+ dependency, and hygiene opportunities without asking.
22
+ - Added docs drift, runtime verification, and review queue guidance for
23
+ proactive closeouts.
24
+ - Added `docs/auto-invoke-visibility.md` as a local design note for the
25
+ auto-invoke policy.
26
+
27
+ ### Changed
28
+ - Replaced Claude-specific "Task tool" spawning wording in high-traffic skills
29
+ with platform-neutral host-agent spawning language.
30
+ - Clarified that Claude, Codex, Cursor, Windsurf, Gemini, OpenCode, Copilot,
31
+ Augment, Trae, Cline, Kilo, Antigravity, Qwen, CodeBuddy, and Pi may expose
32
+ specialist spawning differently while sharing the same Markdown agent
33
+ contracts.
34
+ - Updated the Codex installer path to replace skill directories before copying
35
+ `SKILL.md`, preventing stale nested files from older install shapes.
36
+ - `/god-sync`, `/god-scan`, `god-updater`, and `god-orchestrator` now describe
37
+ local sync helpers separately from spawned agents.
38
+
39
+ ### Guardrails
40
+ - Production launch, guessed staging URLs, provider dashboards, credentials,
41
+ destructive repair, review clearing, Critical security acceptance, git
42
+ staging, commits, pushes, packages, releases, and npm publishing still require
43
+ explicit user intent.
44
+ - If a host platform cannot provide a true fresh-context spawn, Godpowers must
45
+ say so instead of pretending a background agent ran.
46
+
8
47
  ## [1.6.10] - 2026-05-16
9
48
 
10
49
  Progress visibility and plain-language closeout patch.
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.10-blue)](CHANGELOG.md)
5
+ [![Version](https://img.shields.io/badge/version-1.6.11-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,10 @@ idea to hardened production. It runs as **slash commands inside your AI coding
12
12
  tool** (Claude Code, Codex, Cursor, etc.) that orchestrate **specialist agents**
13
13
  in fresh contexts to do the work.
14
14
 
15
- Version 1.6.10 keeps the stable Godpowers surface while making progress more
16
- visible: user-facing output now prefers "project run" over internal "arc"
17
- jargon and status closeouts show PRD, roadmap, milestone, and completion
18
- position when available.
15
+ Version 1.6.11 keeps the stable Godpowers surface while making automatic work
16
+ more visible and portable: syncs, proactive checks, and specialist spawning now
17
+ report what ran, what changed, and which host-platform agent mechanism is being
18
+ used.
19
19
 
20
20
  It fuses four disciplines into one unified workflow:
21
21
 
@@ -50,6 +50,13 @@ The installer copies:
50
50
  - Codex agent metadata to `<runtime>/agents/*.toml`
51
51
  - SessionStart hook (Claude Code only) to `<runtime>/hooks/`
52
52
 
53
+ Agent spawning is host-native. Claude uses its native agent/task interface,
54
+ Codex uses installed `agents/*.toml` metadata backed by the same Markdown agent
55
+ contracts, and the other runtimes use their supported agent or subagent
56
+ mechanism against the installed `agents/god-*.md` files. If a host cannot
57
+ provide a true fresh-context spawn, Godpowers must report that limitation
58
+ instead of pretending a background agent ran.
59
+
53
60
  ## Usage
54
61
 
55
62
  Open your AI coding tool in any project directory and type:
package/RELEASE.md CHANGED
@@ -1,11 +1,11 @@
1
- # Godpowers 1.6.10 Release
1
+ # Godpowers 1.6.11 Release
2
2
 
3
3
  Date: 2026-05-16
4
4
 
5
- Godpowers 1.6.10 makes progress easier to understand while work is running and
6
- when it closes. The goal of this patch is to keep user-facing output from
7
- requiring internal "arc" vocabulary and to show PRD, roadmap, milestone, and
8
- completion position wherever status is reported.
5
+ Godpowers 1.6.11 makes automatic work easier to trust across supported AI
6
+ coding tools. The release keeps the existing 106 slash commands, 39 specialist
7
+ agents, 13 workflows, and 36 recipes, while clarifying when Godpowers spawned
8
+ an agent, called a local runtime helper, or only suggested the next action.
9
9
 
10
10
  ## What is stable
11
11
 
@@ -14,7 +14,8 @@ completion position wherever status is reported.
14
14
  - 13 executable workflows
15
15
  - 36 intent recipes
16
16
  - 15-runtime installer
17
- - Codex installs with 39 generated `god-*.toml` agent metadata files
17
+ - Codex installs with generated `god-*.toml` agent metadata files
18
+ - Markdown specialist agent contracts at `<runtime>/agents/god-*.md`
18
19
  - Safe-sync routing before deploy, observe, harden, launch, or god-mode work
19
20
  - Critical harden finding gate before launch
20
21
  - Native Pillars project context through `AGENTS.md` and `agents/*.md`
@@ -22,8 +23,6 @@ completion position wherever status is reported.
22
23
  - Core schemas: intent, state, events, workflow, routing, recipes, extension
23
24
  manifests
24
25
  - Extension pack compatibility range for the 1.x line
25
- - Domain precision through `.godpowers/domain/GLOSSARY.md` and DG-01 through
26
- DG-05 checks
27
26
  - GSD-style proposition closeouts for exploratory, diagnostic, audit,
28
27
  lifecycle, status, reconciliation, and decision-support outputs
29
28
  - Plain-language project-run wording in user-facing reports
@@ -31,58 +30,60 @@ completion position wherever status is reported.
31
30
 
32
31
  ## What is new
33
32
 
34
- - The core Godpowers skill now defines "arc" as internal vocabulary and tells
35
- user-facing output to prefer "project run", "workflow", "phase", "current
36
- step", or "current milestone".
37
- - `/god-mode`, `god-orchestrator`, `/god-status`, `/god-next`, and
38
- `/god-lifecycle` now include planning visibility guidance for PRD, roadmap,
39
- milestone, and percent complete when the information is available.
40
- - The installer, session-start hook, `/god` front door, routing descriptions,
41
- workflow descriptions, and high-traffic skill propositions now use
42
- project-run language instead of unexplained "arc" wording.
43
- - Checkpoint and session-start summaries display lifecycle `in-arc` as
44
- "in progress" while preserving the internal state key for compatibility.
45
-
46
- ## What 1.6.10 means
47
-
48
- Godpowers 1.6.10 does not expand the public command surface. It changes how
49
- Godpowers explains itself: the user should see the current project run, PRD,
50
- roadmap, milestone, completion percentage, open items, and next action without
51
- decoding internal terminology.
52
-
53
- Internal workflow names and state constants such as `full-arc.yaml` and
54
- `in-arc` remain unchanged for compatibility. Visible reports should translate
55
- them to plain language.
56
-
57
- Safe sync and unresolved Critical harden findings remain release-truth gates.
58
- Per-repo Quarterback ownership remains intact for Mode D suite work.
59
-
60
- ## Stability policy
61
-
62
- During the 1.x stability window, do not add broad new command families, change
63
- schema formats, or rename public artifacts without evidence from real use.
64
-
65
- The `v1.6.10` git tag points to the release commit that matches the npm
66
- `godpowers@1.6.10` package. Public publishes should prefer the tag-triggered
67
- GitHub workflow so npm provenance, git history, and release notes stay aligned.
68
-
69
- Allowed changes:
70
-
71
- - Critical bug fixes
72
- - Documentation clarity
73
- - Test coverage for frozen behavior
74
- - Compatibility fixes for supported AI coding tools
75
- - Small fixes that make existing 1.x behavior work as documented
76
-
77
- Deferred changes:
78
-
79
- - New lifecycle phases
80
- - New schema versions
81
- - Pillars format changes
82
- - Major routing semantics
83
- - Large extension API changes
84
-
85
- ## Adoption ask
86
-
87
- Run `npm run release:check` before publishing changes. Report any release path
88
- step that still depends on memory, manual inspection, or local machine state.
33
+ - The master skill now defines a proactive auto-invoke policy with four levels:
34
+ read-only suggestions, visible local helpers, bounded specialist agent spawns,
35
+ and explicit-approval-only actions.
36
+ - `/god-next`, `/god-status`, and God Mode closeouts now include proactive
37
+ checks for checkpoint freshness, pending reviews, sync state, docs drift,
38
+ runtime verification, security, dependencies, and hygiene.
39
+ - `/god-sync`, `/god-scan`, `god-updater`, and `god-orchestrator` now distinguish
40
+ spawned agents from local runtime helpers such as reverse-sync, Pillars sync,
41
+ checkpoint sync, and context refresh.
42
+ - Docs drift, runtime verification, and review queue workflows now document when
43
+ they may be suggested or auto-invoked.
44
+ - Spawning instructions now use platform-neutral host-agent language instead of
45
+ Claude-specific "Task tool" wording.
46
+ - The installer now replaces Codex skill directories before writing `SKILL.md`,
47
+ which removes stale nested files from older Codex install shapes.
48
+
49
+ ## Platform behavior
50
+
51
+ Claude Code, Codex, Cursor, Windsurf, Gemini, OpenCode, Copilot, Augment,
52
+ Trae, Cline, Kilo, Antigravity, Qwen, CodeBuddy, and Pi all receive the same
53
+ portable Markdown agent contracts. Codex also receives `god-*.toml` files as
54
+ its registry adapter.
55
+
56
+ If a host platform cannot provide a true fresh-context agent spawn, Godpowers
57
+ must say so visibly and report the work as local runtime only or simulated in
58
+ current context. It must not imply that a detached background agent ran.
59
+
60
+ ## Safety policy
61
+
62
+ Godpowers may proactively suggest next steps and may run directly evidenced
63
+ local helpers. It may spawn bounded agents only when the current workflow owns
64
+ that surface.
65
+
66
+ Godpowers still must not auto-run these without explicit user intent:
67
+
68
+ - deployed staging verification against a guessed URL
69
+ - production launch
70
+ - provider dashboard, admin console, DNS, credential, or secret checks
71
+ - broad dependency upgrades
72
+ - destructive repair, rollback, reset, delete, or cleanup
73
+ - clearing `.godpowers/REVIEW-REQUIRED.md`
74
+ - accepting Critical security findings
75
+ - git stage, commit, push, package, release, or publish
76
+
77
+ ## Validation
78
+
79
+ Release validation should include:
80
+
81
+ - `node scripts/validate-skills.js`
82
+ - `bash scripts/smoke.sh`
83
+ - `node scripts/test-agent-validator.js`
84
+ - `node scripts/test-install-smoke.js`
85
+ - `node scripts/check-package-contents.js`
86
+ - `npm run release:check`
87
+
88
+ The `v1.6.11` git tag should point to the release commit that matches the npm
89
+ `godpowers@1.6.11` package.
package/SKILL.md CHANGED
@@ -49,6 +49,19 @@ unresolved Critical security findings.
49
49
  Every execution agent gets a fresh context window. The orchestrator is thin; it
50
50
  spawns workers with full context budgets. This defeats context rot.
51
51
 
52
+ Spawning is platform-neutral. Use the host platform's native agent spawning
53
+ mechanism and the installed `agents/god-*.md` contract:
54
+ - Claude Code: spawn the matching Markdown agent from `~/.claude/agents/`.
55
+ - Codex: spawn the matching Codex agent type from `~/.codex/agents/*.toml`;
56
+ the Markdown copy remains the source contract.
57
+ - Cursor, Windsurf, Gemini, OpenCode, Copilot, Augment, Trae, Cline, Kilo,
58
+ Antigravity, Qwen, CodeBuddy, and Pi: use the platform's supported agent or
59
+ subagent mechanism against the installed Markdown files.
60
+
61
+ When a platform cannot spawn a true fresh-context agent, say so plainly,
62
+ preserve the same role contract, and report `Agent: none, local runtime only`
63
+ or `Agent: simulated in current context` in the visible auto-invoked card.
64
+
52
65
  ### 6. TDD Enforcement
53
66
  Tests are written before implementation. Code written before its test is flagged
54
67
  and must be rewritten. RED-GREEN-REFACTOR is not optional.
@@ -156,6 +169,103 @@ and roadmap visibility when those files exist or are expected. Show whether
156
169
  the PRD is done, whether the roadmap exists, which milestone or tier is active,
157
170
  how close the tracked workflow is to completion, and the next concrete move.
158
171
 
172
+ ### 12. Auto-Invoke Visibility
173
+ When Godpowers automatically runs another command, agent, or local runtime
174
+ helper, show the user what happened. Do not describe these as "background"
175
+ unless they are truly detached from the current run. Most Godpowers sync work
176
+ is auto-invoked but still part of the current workflow.
177
+
178
+ Use this shape whenever an automatic step runs or is skipped:
179
+
180
+ ```
181
+ Auto-invoked:
182
+ Trigger: <what caused this automatic step>
183
+ Agent: <god-updater | god-context-writer | none, local runtime only>
184
+ Local syncs:
185
+ + <reverse-sync | pillars-sync | checkpoint-sync | context-refresh>: <result or skipped reason>
186
+ Artifacts: <changed files, no-op, or deferred>
187
+ Log: <SYNC-LOG.md, CHECKPOINT.md, REVIEW-REQUIRED.md, or none>
188
+ ```
189
+
190
+ If no agent was spawned, say so plainly:
191
+
192
+ ```
193
+ Agent: none, local runtime only
194
+ Why: this path calls lib/reverse-sync.run directly
195
+ ```
196
+
197
+ Automatic steps that especially need visible reporting:
198
+ - `/god-sync` spawning `god-updater`
199
+ - `god-updater` calling reverse-sync, Pillars sync, checkpoint sync, or
200
+ AI-tool context refresh
201
+ - `/god-mode` mandatory final sync
202
+ - standards checks between routed stages
203
+ - brownfield and bluefield automatic `/god-preflight`
204
+ - DESIGN/PRODUCT change detection that spawns `god-design-reviewer`
205
+ - `/god-scan` when it runs reverse-sync directly without an agent
206
+ - checkpoint refresh after state mutations
207
+
208
+ ### 13. Proactive Auto-Invoke Policy
209
+ Godpowers should be proactive from disk evidence, not from guesswork. Before
210
+ auto-invoking anything, classify the action by risk and apply the safest
211
+ allowed behavior.
212
+
213
+ #### Level 1: Auto-suggest, read-only
214
+ Run or apply these by default in every relevant closeout:
215
+ - Compute `/god-next` routing after successful commands.
216
+ - Show `/god-status` style progress after `/god-sync`, `/god-scan`, and
217
+ `/god-mode`.
218
+ - Suggest `/god-review-changes` when `.godpowers/REVIEW-REQUIRED.md` has
219
+ pending items.
220
+ - Suggest `/god-hygiene` after a full project run, after 30 days, or when
221
+ status shows stale docs, deps, or review queues.
222
+ - Suggest `/god-locate` when `.godpowers/CHECKPOINT.md` is missing, stale, or
223
+ conflicts with `state.json`.
224
+
225
+ #### Level 2: Auto-run local helpers, visible and logged
226
+ Run these local runtime helpers automatically when their trigger is present:
227
+ - `lib/checkpoint.syncFromState` after every `state.json` or
228
+ `PROGRESS.md` mutation.
229
+ - Lightweight reverse-sync or linkage scan after code or artifact edits.
230
+ - Pillars sync planning after durable artifact truth changes.
231
+ - Context refresh dry-run after `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`,
232
+ `.cursor/rules/`, `.windsurfrules`, `.github/copilot-instructions.md`,
233
+ `.clinerules`, `.roo/`, or `.continue/` changes.
234
+ - Progress recomputation after every command that changes artifacts.
235
+
236
+ #### Level 3: Auto-spawn scoped specialist agents
237
+ Spawn these agents only when the trigger is direct and scope is bounded:
238
+ - `god-design-reviewer` when `DESIGN.md` or `PRODUCT.md` changed.
239
+ - `god-updater` after feature, hotfix, refactor, build, deploy, observe,
240
+ launch, harden, docs, upgrade, or dependency workflows change code or
241
+ artifacts.
242
+ - `god-docs-writer` in drift-check mode when docs changed after code changed,
243
+ or code changed after docs that claim current behavior.
244
+ - `god-browser-tester` when frontend-visible files changed and a known local,
245
+ preview, staging, or production URL is evidenced.
246
+ - `god-harden-auditor` suggestion after security-sensitive files changed;
247
+ auto-spawn only inside `/god-harden`, `/god-hotfix`, `/god-launch`, or
248
+ `/god-mode`.
249
+ - `god-deps-auditor` suggestion after dependency files changed; auto-spawn only
250
+ inside `/god-update-deps`, `/god-hygiene`, or an explicitly approved project
251
+ workflow.
252
+
253
+ #### Level 4: Explicit approval required
254
+ Never auto-run these from inference alone:
255
+ - deployed staging verification against a guessed URL
256
+ - production launch
257
+ - provider dashboard, admin console, DNS, credential, or secret checks
258
+ - broad dependency upgrades
259
+ - destructive repair, rollback, reset, delete, or cleanup
260
+ - clearing `.godpowers/REVIEW-REQUIRED.md`
261
+ - accepting Critical security findings
262
+ - git stage, commit, push, package, release, or publish
263
+
264
+ Every auto-invoke decision must be explainable from one of these inputs:
265
+ changed files, Godpowers artifacts, `state.json`, `PROGRESS.md`,
266
+ `CHECKPOINT.md`, `SYNC-LOG.md`, `REVIEW-REQUIRED.md`, routing YAML, recipe YAML,
267
+ or explicit user intent.
268
+
159
269
  ---
160
270
 
161
271
  ## Operating Modes
@@ -134,7 +134,7 @@ For each operation, return to the spawning skill with:
134
134
 
135
135
  When you need work done IN a repo (version bump, patch slice, etc.),
136
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.
137
+ `god-orchestrator` via the host platform's native agent spawning mechanism with only a display-safe pointer.
138
138
 
139
139
  Per-repo handoff path:
140
140
  `.godpowers/runs/<run-id>/COORDINATOR-ORCHESTRATOR-HANDOFF.md`
@@ -190,6 +190,11 @@ pillar sync work with `lib/pillars.planArtifactSync(projectRoot, artifacts,
190
190
  apply the pillar updates immediately and log the action to
191
191
  `.godpowers/YOLO-DECISIONS.md`.
192
192
 
193
+ Whenever Pillars sync is auto-invoked, show an auto-invoked status card. Say
194
+ whether this was an agent spawn or a local runtime call. For Pillars sync the
195
+ agent is usually `none, local runtime only` unless the current workflow
196
+ explicitly spawned `god-context-writer`.
197
+
193
198
  Before or alongside that import, write `.godpowers/prep/INITIAL-FINDINGS.md`
194
199
  using `templates/INITIAL-FINDINGS.md`. This artifact records what Godpowers
195
200
  observed directly during init:
@@ -277,6 +282,44 @@ This is the third layer of decision support:
277
282
  2. **Recipes** (`<runtimeRoot>/routing/recipes/<recipe>.yaml`): scenario-based sequences
278
283
  3. **Standards** (god-standards-check): quality gates between stages
279
284
 
285
+ ## Proactive Auto-Invoke Matrix
286
+
287
+ Before every user-visible closeout, and after every successful state mutation,
288
+ evaluate the master auto-invoke policy against disk state. The goal is to keep
289
+ Godpowers moving intelligently without hiding work from the user.
290
+
291
+ | Level | Default behavior | Orchestrator action |
292
+ |---|---|---|
293
+ | 1 | Auto-suggest | Compute `/god-next`, review queues, hygiene age, and status summary |
294
+ | 2 | Auto-run local helper | Run checkpoint, linkage, Pillars planning, context dry-run, or progress refresh |
295
+ | 3 | Auto-spawn bounded agent | Spawn only when trigger is direct and the workflow scope owns that surface |
296
+ | 4 | Require approval | Pause or list the exact user decision needed |
297
+
298
+ Use this trigger map:
299
+
300
+ | Trigger | Auto action | Visibility |
301
+ |---|---|---|
302
+ | `state.json` or `PROGRESS.md` changed | refresh `.godpowers/CHECKPOINT.md` | `Auto-invoked:` local runtime only |
303
+ | code or artifact files changed | run lightweight reverse-sync or spawn `god-updater` for workflow closeout | `Sync status:` |
304
+ | durable artifact truth changed | run Pillars sync plan | `Auto-invoked:` local runtime only |
305
+ | AI tool instruction files changed | spawn or dry-run `god-context-writer` | `Auto-invoked:` |
306
+ | `REVIEW-REQUIRED.md` gains entries | suggest `/god-review-changes` | closeout proposition |
307
+ | `DESIGN.md` or `PRODUCT.md` changed | spawn `god-design-reviewer` | gate card before propagation |
308
+ | docs and code both changed | spawn `god-docs-writer` in drift-check mode when current workflow owns docs, otherwise suggest `/god-docs` | `Auto-invoked:` or proposition |
309
+ | frontend-visible files changed and a known URL exists | spawn `god-browser-tester` inside build, design, launch, harden, or explicit runtime workflows | runtime status card |
310
+ | frontend-visible files changed and no known URL exists | suggest `/god-test-runtime` with local URL setup, defer deployed URL | proposition |
311
+ | security-sensitive files changed | auto-spawn only inside harden, hotfix, launch, or project run; otherwise suggest `/god-harden` | proposition |
312
+ | dependency files changed | auto-spawn only inside update-deps, hygiene, or approved project run; otherwise suggest `/god-update-deps` | proposition |
313
+ | full project run complete or hygiene stale | suggest `/god-hygiene` | proposition |
314
+
315
+ Never use this matrix to auto-run Level 4 actions: deployed staging against a
316
+ guessed URL, production launch, provider dashboard access, broad dependency
317
+ upgrades, destructive repair, review clearing, Critical security acceptance, or
318
+ git stage, commit, push, package, release, or publish.
319
+
320
+ Every auto action must emit either `Auto-invoked:`, `Sync status:`, or a
321
+ proposition explaining why it did not run.
322
+
280
323
  ## Detection-Driven Tier 1 Routing
281
324
 
282
325
  After PRD and before ARCH, branch on UI or product-experience presence:
@@ -496,8 +539,8 @@ requested or final sign-off begins.
496
539
  5. Spawn the appropriate specialist agent in a fresh context
497
540
  6. Verify their output exists on disk
498
541
  7. Run have-nots check on the artifact
499
- 8. If pass: update PROGRESS.md, sync CHECKPOINT.md, print the "Step result"
500
- card, then move to next sub-step
542
+ 8. If pass: update PROGRESS.md, sync CHECKPOINT.md, run the proactive
543
+ auto-invoke sweep, print the "Step result" card, then move to next sub-step
501
544
  9. If fail and repairable: print the failed result card, then enter the
502
545
  autonomous repair loop
503
546
  10. If fail and human-only: pause with the smallest needed question
@@ -522,7 +565,8 @@ For single-agent sub-steps:
522
565
  | Harden | god-harden-auditor | code | .godpowers/harden/FINDINGS.md |
523
566
 
524
567
  For all single-agent sub-steps:
525
- 1. Spawn the agent in a fresh context (Task tool)
568
+ 1. Spawn the agent in a fresh context using the host platform's native agent
569
+ spawning mechanism
526
570
  2. Pass `--yolo` flag if active so the agent auto-picks defaults
527
571
  3. Wait for the agent to return
528
572
  4. Verify artifact exists on disk
@@ -602,6 +646,21 @@ Before declaring the project run complete, ALWAYS run /god-sync:
602
646
  3. Update SYNC-LOG.md with the project-run completion entry
603
647
  4. Update state.json with all final tier statuses
604
648
 
649
+ Display the sync status before the final completion block:
650
+
651
+ ```
652
+ Sync status:
653
+ Trigger: /god-mode final sync
654
+ Agent: god-updater spawned
655
+ Local syncs:
656
+ + reverse-sync: <counts and result>
657
+ + pillars-sync: <counts and result>
658
+ + checkpoint-sync: <created, updated, no-op, or skipped>
659
+ + context-refresh: <spawned, no-op, or skipped>
660
+ Artifacts: <changed files or no-op>
661
+ Log: .godpowers/SYNC-LOG.md
662
+ ```
663
+
605
664
  This step runs regardless of flags:
606
665
  - /god-mode -> sync runs
607
666
  - /god-mode --yolo -> sync runs (no pause; auto-applies)
@@ -639,6 +698,16 @@ What changed:
639
698
  Validation:
640
699
  + <command>: <result>
641
700
 
701
+ Proactive checks:
702
+ Checkpoint: <fresh | refreshed | stale>
703
+ Reviews: <none | N pending, suggest /god-review-changes>
704
+ Sync: <fresh | suggested | local helper ran>
705
+ Docs: <fresh | suggested | drift-check spawned>
706
+ Runtime: <not-applicable | suggested | browser test spawned>
707
+ Security: <clear | suggested | harden spawned>
708
+ Dependencies: <clear | suggested | deps audit spawned>
709
+ Hygiene: <fresh | suggest /god-hygiene>
710
+
642
711
  Open items:
643
712
  1. <none, or deployed staging deferred, pending review, unstaged files, etc.>
644
713
 
@@ -785,6 +854,8 @@ Show:
785
854
  - concise phase status
786
855
  - before each visible tier/sub-step, a short "what will happen" card
787
856
  - after each visible tier/sub-step, a short "what happened" card
857
+ - every auto-invoked command, agent, and local runtime helper using an
858
+ `Auto-invoked:` or `Sync status:` card
788
859
  - durable state detected from disk
789
860
  - commands being run and whether they passed or failed
790
861
  - scoped file changes
@@ -797,7 +868,7 @@ Show:
797
868
  - `Project run complete` or `PAUSE: external access required`
798
869
 
799
870
  Hide:
800
- - raw Task input
871
+ - raw spawn input
801
872
  - "Hard instructions" sections
802
873
  - spawned-agent prompt text
803
874
  - system, developer, AGENTS.md, or internal policy recitations
@@ -809,6 +880,36 @@ user-facing question. Do not expose the rule itself. Example: ask for
809
880
  `STAGING_APP_URL=<deployed staging origin>` at final sign-off rather than
810
881
  showing the Shipping Closure Protocol.
811
882
 
883
+ ### Auto-Invoked Work Cards
884
+
885
+ Every automatic step that mutates state, writes artifacts, validates gates, or
886
+ spawns an agent must leave a visible trace in the transcript.
887
+
888
+ Use this shape:
889
+
890
+ ```
891
+ Auto-invoked:
892
+ Trigger: <event that caused the automatic step>
893
+ Agent: <agent name, or none, local runtime only>
894
+ Local syncs:
895
+ + <helper>: <result>
896
+ Artifacts: <changed files, no-op, or deferred>
897
+ Log: <path, or none>
898
+ ```
899
+
900
+ Required auto-invoked cards:
901
+ - `/god-preflight` started automatically for brownfield or bluefield work
902
+ - standards checks between routed stages
903
+ - design-reviewer checks after DESIGN.md or PRODUCT.md changes
904
+ - `god-updater` spawned for reverse-sync or final sync
905
+ - local `lib/reverse-sync.run` calls, including `/god-scan`
906
+ - Pillars sync through `lib/pillars.pillarizeExisting` or
907
+ `lib/pillars.applyArtifactSync`
908
+ - checkpoint refresh through `lib/checkpoint.syncFromState`
909
+ - AI-tool context refresh through `god-context-writer`
910
+
911
+ If an automatic step is skipped, still report it with the skipped reason.
912
+
812
913
  ## Step Narration Protocol
813
914
 
814
915
  Godpowers must make its work trackable without exposing hidden prompts or
@@ -850,7 +951,7 @@ Rules:
850
951
  - Use `lib/state.progressSummary(stateJson)` for the percentage and step count
851
952
  whenever state.json is available.
852
953
  - Use artifact paths and verification evidence from disk, not memory.
853
- - Do not print raw Task input, hidden instructions, or full file loadout lists.
954
+ - Do not print raw spawn input, hidden instructions, or full file loadout lists.
854
955
  - If a step is blocked, do not show a generic "Suggested next"; show the
855
956
  smallest concrete unblock action.
856
957
 
@@ -111,6 +111,12 @@ After feature work, every artifact that was impacted needs to reflect reality.
111
111
  `drift-count`, `review-required-items`
112
112
  - Emit events: `linkage.snapshot`, `drift.detected` (per finding),
113
113
  `review-required.populated`
114
+ - Report counts in the final sync status:
115
+ - scanned files
116
+ - links added, removed, or unchanged
117
+ - fenced footers updated
118
+ - drift findings
119
+ - REVIEW-REQUIRED.md items created
114
120
 
115
121
  ### Pillars sync (native context)
116
122
  - Call `lib/pillars.pillarizeExisting(projectRoot)` if Pillars is absent or
@@ -122,6 +128,8 @@ After feature work, every artifact that was impacted needs to reflect reality.
122
128
  immediately and log the decision to `.godpowers/YOLO-DECISIONS.md`.
123
129
  - Never read every file in `agents/` as project context. Only files with
124
130
  `pillar:` frontmatter are Pillars files.
131
+ - Report whether Pillars work was initialized, applied, proposed, skipped, or
132
+ no-op.
125
133
 
126
134
  ### AI-tool context refresh (always, unless never-ask)
127
135
  - Read `state.json` for `project.context-prompt-answered`
@@ -134,16 +142,36 @@ After feature work, every artifact that was impacted needs to reflect reality.
134
142
  - Idempotent: if content matches, no write occurs
135
143
  - Never touches content outside the `<!-- godpowers:begin -->` /
136
144
  `<!-- godpowers:end -->` fence
145
+ - Report whether context refresh spawned `god-context-writer`, changed files,
146
+ no-oped, or skipped because the project opted out.
147
+
148
+ ### Checkpoint sync
149
+ - After state changes, refresh `.godpowers/CHECKPOINT.md` from disk state using
150
+ `lib/checkpoint.syncFromState(projectRoot, { nextCommand, nextReason })`
151
+ when the runtime is available.
152
+ - If checkpoint sync is unavailable in the host tool, say it was skipped and
153
+ include the reason.
154
+ - Report the checkpoint path and whether it was created, updated, unchanged,
155
+ or skipped.
137
156
 
138
157
  ## Output
139
158
 
140
- Write summary to `.godpowers/SYNC-LOG.md` (append-only):
159
+ Write summary to `.godpowers/SYNC-LOG.md` (append-only). The summary must
160
+ include both user-visible status and machine-checkable counts:
141
161
 
142
162
  ```markdown
143
163
  ## Sync: [intent] [timestamp]
144
164
 
145
165
  Triggered by: [recipe name]
146
166
 
167
+ Sync status:
168
+ - Trigger: [manual /god-sync | /god-mode final sync | recipe closeout]
169
+ - Agent: god-updater
170
+ - Reverse-sync: scanned [N] files, updated [N] footers, created [N] review items
171
+ - Pillars sync: [applied/proposed/no-op/skipped], [N] pillar files
172
+ - Checkpoint sync: [created/updated/no-op/skipped] .godpowers/CHECKPOINT.md
173
+ - Context refresh: [spawned god-context-writer/no-op/skipped], [N] files
174
+
147
175
  Updated:
148
176
  - prd/PRD.md: added requirement P-MUST-12
149
177
  - arch/ARCH.md: added ADR-007 (auth refactor)
@@ -157,11 +185,32 @@ Updated:
157
185
 
158
186
  Have-nots re-validated: all passing.
159
187
 
160
- Suggested next: /god-status
188
+ Next: /god-status
161
189
  ```
162
190
 
163
191
  Update PROGRESS.md with the latest tier statuses.
164
192
 
193
+ Return a compact user-facing closeout in the same shape:
194
+
195
+ ```
196
+ Sync complete.
197
+
198
+ Sync status:
199
+ Trigger: <trigger>
200
+ Agent: god-updater
201
+ Local syncs:
202
+ + reverse-sync: <counts and result>
203
+ + pillars-sync: <counts and result>
204
+ + checkpoint-sync: <created, updated, no-op, or skipped>
205
+ + context-refresh: <spawned, no-op, or skipped>
206
+ Artifacts: <changed files or no-op>
207
+ Log: .godpowers/SYNC-LOG.md
208
+
209
+ Next:
210
+ Recommended: /god-status
211
+ Why: confirm the disk-derived project state after sync.
212
+ ```
213
+
165
214
  ## Have-Nots
166
215
 
167
216
  Sync FAILS if:
package/bin/install.js CHANGED
@@ -186,6 +186,9 @@ function installSkillFile(srcFile, skillsDest, runtimeKey, targetName = null) {
186
186
  const baseName = targetName || path.basename(srcFile, '.md');
187
187
  if (runtimeKey === 'codex') {
188
188
  const skillDir = path.join(skillsDest, baseName);
189
+ if (fs.existsSync(skillDir)) {
190
+ fs.rmSync(skillDir, { recursive: true, force: true });
191
+ }
189
192
  ensureDir(skillDir);
190
193
  fs.copyFileSync(srcFile, path.join(skillDir, 'SKILL.md'));
191
194
  return;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "godpowers",
3
- "version": "1.6.10",
3
+ "version": "1.6.11",
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"
@@ -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
 
@@ -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
 
@@ -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:
@@ -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
 
@@ -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
 
@@ -125,7 +125,7 @@ workflow.
125
125
  unresolved Critical harden findings. These are release-truth gates, not
126
126
  preference pauses.
127
127
 
128
- 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
129
129
  display-safe payload:
130
130
  - Name the project root.
131
131
  - Name the invocation flags.
@@ -137,7 +137,7 @@ workflow.
137
137
  hidden routing rules, or detailed instructions in the spawn message.
138
138
  Assume the host UI may display the raw spawn message to the user.
139
139
 
140
- 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,
141
141
  "Hard instructions", hidden orchestration rules, agent prompts, file
142
142
  loadout lists, or internal routing payloads into the user-visible transcript.
143
143
  The visible transcript may say only what phase is running, what durable state
@@ -169,6 +169,8 @@ Show:
169
169
  - detected resume or project mode in plain language
170
170
  - a compact "Next step" card before each visible phase or tier sub-step
171
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
172
174
  - plain-language workflow names. Say "project run" or "workflow" instead of
173
175
  unexplained "arc" in visible output
174
176
  - PRD and roadmap visibility in status and closeout blocks when artifacts
@@ -180,7 +182,7 @@ Show:
180
182
  action
181
183
 
182
184
  Hide:
183
- - raw Task input
185
+ - raw spawn input
184
186
  - "Hard instructions" sections
185
187
  - spawned-agent prompt text
186
188
  - detailed handoff file contents
@@ -294,6 +296,21 @@ Under `--yolo`, the sync step auto-applies (no pause). Under
294
296
  `--conservative`, it pauses for confirmation. Under `--with-hygiene`,
295
297
  it runs alongside the hygiene pass.
296
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
+
297
314
  The sync step also reconciles native Pillars context. When `.godpowers`
298
315
  artifacts create or change durable project truth, Godpowers maps those changes
299
316
  to relevant pillar files through `lib/pillars.planArtifactSync`. Default mode
@@ -315,6 +332,17 @@ When orchestrator returns "complete", display:
315
332
  ```
316
333
  Godpowers project run complete.
317
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
+
318
346
  Current status:
319
347
  State: complete
320
348
  Progress: <pct>% (<done> of <total> steps complete; current step <n> of <total>)
@@ -168,6 +168,42 @@ Planning visibility:
168
168
  Completion: <pct>% <basis from state.json or PROGRESS.md>
169
169
  ```
170
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
+
171
207
  ## Process for Mode 4 (intent-based)
172
208
 
173
209
  ```
@@ -321,6 +357,16 @@ Previous tier had standards failures. Address before proceeding:
321
357
  - [failure 1]
322
358
  - [failure 2]
323
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]
324
370
  ```
325
371
 
326
372
  ## Proposition Closeout
@@ -9,7 +9,7 @@ description: |
9
9
 
10
10
  # /god-observe
11
11
 
12
- Spawn the **god-observability-engineer** agent in a fresh context via Task tool.
12
+ Spawn the **god-observability-engineer** agent in a fresh context via the host platform's native agent spawning mechanism.
13
13
 
14
14
  ## Setup
15
15
 
@@ -30,7 +30,7 @@ Get multiple specialist perspectives on a single question.
30
30
  - Harden auditor (god-harden-auditor) - security implications
31
31
  - Launch strategist (god-launch-strategist) - go-to-market implications
32
32
 
33
- 3. Spawn each selected persona IN PARALLEL via Task tool:
33
+ 3. Spawn each selected persona IN PARALLEL via the host platform's native agent spawning mechanism:
34
34
  - Each gets fresh context
35
35
  - Each receives ONLY the question and the relevant artifact subset
36
36
  - Each is instructed: respond as your specialist, do not soften or hedge
package/skills/god-prd.md CHANGED
@@ -9,7 +9,7 @@ description: |
9
9
 
10
10
  # /god-prd
11
11
 
12
- Spawn the **god-pm** agent in a fresh context via Task tool.
12
+ Spawn the **god-pm** 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-repo
11
11
 
12
- Spawn the **god-repo-scaffolder** agent in a fresh context via Task tool.
12
+ Spawn the **god-repo-scaffolder** agent in a fresh context via the host platform's native agent spawning mechanism.
13
13
 
14
14
  ## Setup
15
15
 
@@ -52,6 +52,23 @@ When showing "affected files," this skill cross-references
52
52
  `lib/linkage.queryByFile(projectRoot, file)` so the user sees which
53
53
  artifact IDs that file is linked to. Helps decide what to fix.
54
54
 
55
+ ## Proactive invocation
56
+
57
+ Godpowers should suggest this skill automatically when
58
+ `REVIEW-REQUIRED.md` gains pending entries from reverse-sync, design impact,
59
+ runtime verification, docs drift, or security-sensitive changes.
60
+
61
+ Default behavior is suggestion only:
62
+
63
+ ```text
64
+ Proactive checks:
65
+ Reviews: <N> pending, suggest /god-review-changes
66
+ ```
67
+
68
+ Do not auto-run the interactive walkthrough unless the user asks to address
69
+ the pending items now. Do not auto-clear review items under default mode or
70
+ `--yolo`.
71
+
55
72
  ## Output
56
73
 
57
74
  ```
@@ -9,7 +9,7 @@ description: |
9
9
 
10
10
  # /god-review
11
11
 
12
- Spawn two specialist review agents in fresh contexts via Task tool.
12
+ Spawn two specialist review agents in fresh contexts 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-roadmap
11
11
 
12
- Spawn the **god-roadmapper** agent in a fresh context via Task tool.
12
+ Spawn the **god-roadmapper** agent in a fresh context via the host platform's native agent spawning mechanism.
13
13
 
14
14
  ## Setup
15
15
 
@@ -17,6 +17,19 @@ god-build, god-feature, god-hotfix etc. trigger automatically (per
17
17
  Phase 7 workflow integration). Useful when you want to refresh state
18
18
  between automatic triggers, or after manual code edits.
19
19
 
20
+ Because `/god-scan` calls the local reverse-sync runtime directly, it must be
21
+ explicit when no agent is spawned:
22
+
23
+ ```
24
+ Auto-invoked:
25
+ Trigger: /god-scan
26
+ Agent: none, local runtime only
27
+ Local syncs:
28
+ + reverse-sync: pending
29
+ Artifacts: pending
30
+ Log: REVIEW-REQUIRED.md if drift is found
31
+ ```
32
+
20
33
  ## Forms
21
34
 
22
35
  | Form | Action |
@@ -43,6 +56,17 @@ between automatic triggers, or after manual code edits.
43
56
  - Drift findings (errors, warnings, infos)
44
57
  - Footers updated
45
58
  - REVIEW-REQUIRED items added
59
+ 4. End with sync status:
60
+
61
+ ```
62
+ Sync status:
63
+ Trigger: /god-scan
64
+ Agent: none, local runtime only
65
+ Local syncs:
66
+ + reverse-sync: <scanned N files, updated M footers, populated K review items>
67
+ Artifacts: <changed linkage files, fenced artifacts, REVIEW-REQUIRED.md, or no-op>
68
+ Log: <REVIEW-REQUIRED.md or none>
69
+ ```
46
70
 
47
71
  ## Fence rules
48
72
 
@@ -9,7 +9,7 @@ description: |
9
9
 
10
10
  # /god-stack
11
11
 
12
- Spawn the **god-stack-selector** agent in a fresh context via Task tool.
12
+ Spawn the **god-stack-selector** agent in a fresh context via the host platform's native agent spawning mechanism.
13
13
 
14
14
  ## Setup
15
15
 
@@ -27,6 +27,8 @@ Re-derive state from disk. Your memory is not authoritative. The file system is.
27
27
  - `.godpowers/observe/STATE.md`
28
28
  - `.godpowers/launch/STATE.md`
29
29
  - `.godpowers/harden/FINDINGS.md`
30
+ - `.godpowers/SYNC-LOG.md`
31
+ - `.godpowers/CHECKPOINT.md`
30
32
  4. For each artifact found: run a lightweight have-nots check
31
33
  5. Compare disk state to PROGRESS.md state:
32
34
  - If PROGRESS.md says "done" but artifact is missing: FLAG as phantom resume
@@ -37,6 +39,8 @@ Re-derive state from disk. Your memory is not authoritative. The file system is.
37
39
  - Planning visibility: PRD status, roadmap status, active milestone, and
38
40
  completion basis
39
41
  - What happened recently, using CHECKPOINT.md actions when available
42
+ - Last sync status, using SYNC-LOG.md when available
43
+ - Proactive opportunities based on the auto-invoke policy
40
44
  - What happens next, using routing and disk state
41
45
  - Per-tier status (with disk verification)
42
46
  - Any inconsistencies between PROGRESS.md and disk
@@ -63,6 +67,26 @@ What happened recently:
63
67
  1. PRD artifact verified on disk
64
68
  2. Tier state refreshed from state.json
65
69
 
70
+ Last sync:
71
+ Trigger: /god-mode final sync
72
+ Agent: god-updater
73
+ Local syncs:
74
+ + reverse-sync: scanned 14 files, updated 2 footers, populated 0 review items
75
+ + pillars-sync: no-op
76
+ + checkpoint-sync: CHECKPOINT.md updated
77
+ + context-refresh: no-op
78
+ Log: .godpowers/SYNC-LOG.md
79
+
80
+ Proactive opportunities:
81
+ Checkpoint: fresh
82
+ Reviews: 5 pending, suggest /god-review-changes
83
+ Sync: fresh
84
+ Docs: possible drift, suggest /god-docs
85
+ Runtime: known local URL, suggest /god-test-runtime
86
+ Security: clear
87
+ Dependencies: clear
88
+ Hygiene: stale, suggest /god-hygiene
89
+
66
90
  What happens next:
67
91
  1. Run /god-arch
68
92
  2. Verify architecture artifact
@@ -117,6 +141,24 @@ Recommended: [one option and why it fits the disk-derived state]
117
141
  If inconsistencies are present, make `/god-repair` the partial option and do
118
142
  not recommend `/god-mode` until disk state is coherent.
119
143
 
144
+ ## Proactive Opportunity Rules
145
+
146
+ Use the master auto-invoke policy to populate `Proactive opportunities`.
147
+ `/god-status` is read-only by default, so it suggests Level 3 agents instead of
148
+ spawning them unless the user asked status to continue work.
149
+
150
+ Report:
151
+ - Checkpoint: `fresh`, `missing`, `stale`, or `conflicts with state.json`
152
+ - Reviews: `none` or `<N> pending, suggest /god-review-changes`
153
+ - Sync: `fresh`, `missing`, `stale`, or `suggest /god-sync`
154
+ - Docs: `fresh`, `possible drift, suggest /god-docs`, or
155
+ `docs drift-check already logged`
156
+ - Runtime: `not-applicable`, `known URL, suggest /god-test-runtime`, or
157
+ `no known URL, defer deployed verification`
158
+ - Security: `clear` or `sensitive files changed, suggest /god-harden`
159
+ - Dependencies: `clear` or `dependency files changed, suggest /god-update-deps`
160
+ - Hygiene: `fresh` or `stale, suggest /god-hygiene`
161
+
120
162
  ## Mode D awareness
121
163
 
122
164
  If `lib/multi-repo-detector.detect(projectRoot)` returns
@@ -37,6 +37,18 @@ User runs `/god-sync` after manual changes. Useful for:
37
37
  - Or: re-run reconciliation against current state to detect what changed
38
38
  - Recent commits for context
39
39
 
40
+ Before spawning, show a visible auto-invoke card:
41
+
42
+ ```
43
+ Auto-invoked:
44
+ Trigger: <manual /god-sync, recipe closeout, /god-mode final sync, or other source>
45
+ Agent: god-updater
46
+ Local syncs:
47
+ - pending: reverse-sync, pillars-sync, checkpoint-sync, context-refresh
48
+ Artifacts: pending
49
+ Log: .godpowers/SYNC-LOG.md
50
+ ```
51
+
40
52
  ## Verification
41
53
 
42
54
  After god-updater returns:
@@ -52,6 +64,21 @@ After god-updater returns:
52
64
  ```
53
65
  Sync complete.
54
66
 
67
+ Sync status:
68
+ Trigger: /god-mode final sync
69
+ Agent: god-updater spawned
70
+ Local syncs:
71
+ + reverse-sync: <scanned N files, updated M footers, populated K review items>
72
+ + pillars-sync: <updated N pillar files, no-op, or proposed>
73
+ + checkpoint-sync: <CHECKPOINT.md updated or skipped>
74
+ + context-refresh: <updated AGENTS.md/tool pointers, no-op, or skipped by setting>
75
+ Artifacts: <changed files, no-op, or deferred>
76
+ Log: .godpowers/SYNC-LOG.md
77
+
78
+ If this path ran only a local helper, say:
79
+ Agent: none, local runtime only
80
+ Why: this path called lib/reverse-sync.run directly
81
+
55
82
  Updated:
56
83
  - prd/PRD.md (added requirement P-MUST-12)
57
84
  - arch/ARCH.md (added ADR-007)
@@ -65,7 +92,13 @@ Updated:
65
92
  Have-nots: all passing
66
93
  SYNC-LOG.md updated.
67
94
 
68
- Suggested next: /god-status
95
+ Current status:
96
+ State: <complete | partial | blocked | no-op>
97
+ Progress: <pct>% when available
98
+
99
+ Next:
100
+ Recommended: /god-status
101
+ Why: verify the disk-derived state after sync.
69
102
  ```
70
103
 
71
104
  ## What this prevents
@@ -96,6 +96,32 @@ critical findings have the same gate semantics.
96
96
  | `/god-harden` | a11y portion | warning |
97
97
  | `/god-design` (post-change) | audit | warning |
98
98
 
99
+ Automatic runtime verification requires evidenced URL input:
100
+
101
+ - A local dev server URL from `state.json.dev-server.url`
102
+ - A deploy URL from `state.json.deploy.url`
103
+ - A user-provided URL in the current session
104
+ - A checked-in config or Godpowers artifact that explicitly identifies the URL
105
+ as current
106
+
107
+ If frontend-visible files changed but no URL is evidenced, do not guess. Add a
108
+ proactive suggestion for `/god-test-runtime` and explain what URL source is
109
+ missing. If only a local URL is evidenced, run local verification and defer
110
+ deployed staging verification until the user provides
111
+ `STAGING_APP_URL=<deployed staging origin>` or reaches final sign-off.
112
+
113
+ When auto-invoked, show:
114
+
115
+ ```text
116
+ Auto-invoked:
117
+ Trigger: frontend-visible files changed and URL was evidenced
118
+ Agent: god-browser-tester
119
+ Local syncs:
120
+ + runtime-verification: <audit | test | full pipeline>
121
+ Artifacts: .godpowers/runtime/<run-id>/
122
+ Log: .godpowers/runtime/<run-id>/summary.md
123
+ ```
124
+
99
125
  ## Output to events.jsonl
100
126
 
101
127
  ```json