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 +39 -0
- package/README.md +12 -5
- package/RELEASE.md +64 -63
- package/SKILL.md +110 -0
- package/agents/god-coordinator.md +1 -1
- package/agents/god-orchestrator.md +106 -5
- package/agents/god-updater.md +51 -2
- package/bin/install.js +3 -0
- package/package.json +1 -1
- package/skills/god-arch.md +1 -1
- package/skills/god-audit.md +1 -1
- package/skills/god-debug.md +1 -1
- package/skills/god-deploy.md +1 -1
- package/skills/god-docs.md +22 -0
- package/skills/god-harden.md +1 -1
- package/skills/god-launch.md +1 -1
- package/skills/god-mode.md +31 -3
- package/skills/god-next.md +46 -0
- package/skills/god-observe.md +1 -1
- package/skills/god-party.md +1 -1
- package/skills/god-prd.md +1 -1
- package/skills/god-repo.md +1 -1
- package/skills/god-review-changes.md +17 -0
- package/skills/god-review.md +1 -1
- package/skills/god-roadmap.md +1 -1
- package/skills/god-scan.md +24 -0
- package/skills/god-stack.md +1 -1
- package/skills/god-status.md +42 -0
- package/skills/god-sync.md +34 -1
- package/skills/god-test-runtime.md +26 -0
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
|
[](https://github.com/aihxp/godpowers/actions/workflows/ci.yml)
|
|
4
4
|
[](LICENSE)
|
|
5
|
-
[](CHANGELOG.md)
|
|
6
6
|
[](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.
|
|
16
|
-
visible
|
|
17
|
-
|
|
18
|
-
|
|
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.
|
|
1
|
+
# Godpowers 1.6.11 Release
|
|
2
2
|
|
|
3
3
|
Date: 2026-05-16
|
|
4
4
|
|
|
5
|
-
Godpowers 1.6.
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
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
|
|
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
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
- `/god-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
-
|
|
72
|
-
-
|
|
73
|
-
-
|
|
74
|
-
-
|
|
75
|
-
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
-
|
|
83
|
-
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
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
|
|
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,
|
|
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
|
|
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
|
|
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
|
|
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
|
|
package/agents/god-updater.md
CHANGED
|
@@ -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
|
-
|
|
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.
|
|
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"
|
package/skills/god-arch.md
CHANGED
package/skills/god-audit.md
CHANGED
package/skills/god-debug.md
CHANGED
package/skills/god-deploy.md
CHANGED
package/skills/god-docs.md
CHANGED
|
@@ -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:
|
package/skills/god-harden.md
CHANGED
package/skills/god-launch.md
CHANGED
package/skills/god-mode.md
CHANGED
|
@@ -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
|
|
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
|
|
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
|
|
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>)
|
package/skills/god-next.md
CHANGED
|
@@ -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
|
package/skills/god-observe.md
CHANGED
|
@@ -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
|
|
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
|
|
package/skills/god-party.md
CHANGED
|
@@ -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
|
|
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
package/skills/god-repo.md
CHANGED
|
@@ -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
|
```
|
package/skills/god-review.md
CHANGED
package/skills/god-roadmap.md
CHANGED
package/skills/god-scan.md
CHANGED
|
@@ -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
|
|
package/skills/god-stack.md
CHANGED
package/skills/god-status.md
CHANGED
|
@@ -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
|
package/skills/god-sync.md
CHANGED
|
@@ -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
|
-
|
|
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
|