godpowers 1.6.9 → 1.6.11

package/skills/god-observe.md

@@ -9,7 +9,7 @@ description: |
 
 # /god-observe
 
-Spawn the **god-observability-engineer** agent in a fresh context via Task tool.
+Spawn the **god-observability-engineer** agent in a fresh context via the host platform's native agent spawning mechanism.
 
 ## Setup
 

package/skills/god-org-context.md

@@ -67,7 +67,7 @@ Constraints that will apply to this project:
   - Observability: Datadog
   ...
 
-Downstream agents will respect these throughout the arc.
+Downstream agents will respect these throughout the project run.
 
 Suggested next: /god-init (or /god-mode if you're ready to build)
 ```

package/skills/god-party.md

@@ -30,7 +30,7 @@ Get multiple specialist perspectives on a single question.
    - Harden auditor (god-harden-auditor) - security implications
    - Launch strategist (god-launch-strategist) - go-to-market implications
 
-3. Spawn each selected persona IN PARALLEL via Task tool:
+3. Spawn each selected persona IN PARALLEL via the host platform's native agent spawning mechanism:
    - Each gets fresh context
    - Each receives ONLY the question and the relevant artifact subset
    - Each is instructed: respond as your specialist, do not soften or hedge

package/skills/god-prd.md

@@ -9,7 +9,7 @@ description: |
 
 # /god-prd
 
-Spawn the **god-pm** agent in a fresh context via Task tool.
+Spawn the **god-pm** agent in a fresh context via the host platform's native agent spawning mechanism.
 
 ## Setup
 

package/skills/god-preflight.md

@@ -1,12 +1,12 @@
 ---
 name: god-preflight
 description: |
-  Run a read-only intake audit before arc-ready, pillars, archaeology, or
+  Run a read-only intake audit before project-run readiness, pillars, archaeology, or
   reconstruction work. Inventory the codebase, surface blockers, and recommend
   the safest next pass without changing project code.
 
   Triggers on: "god preflight", "/god-preflight", "preflight audit",
-  "audit before arc-ready", "audit before pillars", "intake audit"
+  "audit before project-run readiness", "audit before pillars", "intake audit"
 ---
 
 # /god-preflight
@@ -15,7 +15,7 @@ Read-only intake audit for an existing codebase.
 
 ## When to use
 
-- Before applying arc-ready direction to an existing repo
+- Before applying project-run direction to an existing repo
 - Before scoring the repo against pillars
 - Before brownfield archaeology or reconstruction
 - When deciding whether to restructure, refactor, initialize Godpowers, or pause
@@ -28,7 +28,7 @@ It answers:
 
 - What kind of project is this?
 - What structure, tooling, tests, docs, CI, deploy paths, and agent instructions exist?
-- What is missing before arc-ready can make good decisions?
+- What is missing before the project run can make good decisions?
 - Which pillar weaknesses are already visible?
 - What areas are risky to refactor before more evidence exists?
 - What is the safest next pass?
@@ -147,7 +147,7 @@ Proposition:
   1. Implement partial: [first recommended command or task]
   2. Implement complete: [full recommended sequence]
   3. Discuss more: /god-discuss [highest uncertainty or blocker]
-  4. Run God Mode: /god-mode only when the preflight says the repo is arc-ready or the remaining gaps are acceptable
+  4. Run God Mode: /god-mode only when the preflight says the repo is ready or the remaining gaps are acceptable
 Recommended: [first command and why it should happen before the rest]
 ```
 

package/skills/god-quick.md

@@ -11,7 +11,7 @@ description: |
 # /god-quick
 
 Run a focused task with TDD and atomic commits, but skip the full planning
-arc.
+workflow.
 
 ## When to use
 

package/skills/god-refactor.md

@@ -102,7 +102,7 @@ Proposition:
   1. Implement partial: /god-spike <measurement or smallest safe slice>
   2. Implement complete: /god-refactor <full scoped refactor>
   3. Discuss more: /god-discuss <unresolved scope question>
-  4. Run God Mode: /god-mode <scope> if the user wants the full autonomous arc
+  4. Run God Mode: /god-mode <scope> if the user wants the full autonomous project run
 Recommended: <one option and why>
 ```
 

package/skills/god-repo.md

@@ -9,7 +9,7 @@ description: |
 
 # /god-repo
 
-Spawn the **god-repo-scaffolder** agent in a fresh context via Task tool.
+Spawn the **god-repo-scaffolder** agent in a fresh context via the host platform's native agent spawning mechanism.
 
 ## Setup
 

package/skills/god-review-changes.md

@@ -52,6 +52,23 @@ When showing "affected files," this skill cross-references
 `lib/linkage.queryByFile(projectRoot, file)` so the user sees which
 artifact IDs that file is linked to. Helps decide what to fix.
 
+## Proactive invocation
+
+Godpowers should suggest this skill automatically when
+`REVIEW-REQUIRED.md` gains pending entries from reverse-sync, design impact,
+runtime verification, docs drift, or security-sensitive changes.
+
+Default behavior is suggestion only:
+
+```text
+Proactive checks:
+  Reviews: <N> pending, suggest /god-review-changes
+```
+
+Do not auto-run the interactive walkthrough unless the user asks to address
+the pending items now. Do not auto-clear review items under default mode or
+`--yolo`.
+
 ## Output
 
 ```

package/skills/god-review.md

@@ -9,7 +9,7 @@ description: |
 
 # /god-review
 
-Spawn two specialist review agents in fresh contexts via Task tool.
+Spawn two specialist review agents in fresh contexts via the host platform's native agent spawning mechanism.
 
 ## Setup
 

package/skills/god-roadmap-update.md

@@ -16,7 +16,7 @@ Keep ROADMAP.md as a living artifact.
 ## When to use
 
 - After completing a milestone (mark done, gate passed)
-- After adding a feature mid-arc that wasn't on the original roadmap
+- After adding a feature mid-run that wasn't on the original roadmap
 - When priorities shift (move between Now / Next / Later)
 - When a planned milestone is superseded
 

package/skills/god-roadmap.md

@@ -9,7 +9,7 @@ description: |
 
 # /god-roadmap
 
-Spawn the **god-roadmapper** agent in a fresh context via Task tool.
+Spawn the **god-roadmapper** agent in a fresh context via the host platform's native agent spawning mechanism.
 
 ## Setup
 

package/skills/god-scan.md

@@ -17,6 +17,19 @@ god-build, god-feature, god-hotfix etc. trigger automatically (per
 Phase 7 workflow integration). Useful when you want to refresh state
 between automatic triggers, or after manual code edits.
 
+Because `/god-scan` calls the local reverse-sync runtime directly, it must be
+explicit when no agent is spawned:
+
+```
+Auto-invoked:
+  Trigger: /god-scan
+  Agent: none, local runtime only
+  Local syncs:
+    + reverse-sync: pending
+  Artifacts: pending
+  Log: REVIEW-REQUIRED.md if drift is found
+```
+
 ## Forms
 
 | Form | Action |
@@ -43,6 +56,17 @@ between automatic triggers, or after manual code edits.
    - Drift findings (errors, warnings, infos)
    - Footers updated
    - REVIEW-REQUIRED items added
+4. End with sync status:
+
+```
+Sync status:
+  Trigger: /god-scan
+  Agent: none, local runtime only
+  Local syncs:
+    + reverse-sync: <scanned N files, updated M footers, populated K review items>
+  Artifacts: <changed linkage files, fenced artifacts, REVIEW-REQUIRED.md, or no-op>
+  Log: <REVIEW-REQUIRED.md or none>
+```
 
 ## Fence rules
 

package/skills/god-skip.md

@@ -45,7 +45,7 @@ The reason is required. Skips without reason are rejected.
 ## Mandatory non-skippable steps
 
 These cannot be skipped:
-- The final `/god-sync` at end of arc
+- The final `/god-sync` at the end of the project run
 - `/god-harden` for projects with `public-facing: true` in intent.yaml
 - Standards gates between tiers (use `/god-standards --override` to bypass with reason)
 

package/skills/god-spike.md

@@ -88,7 +88,7 @@ Proposition:
   1. Implement partial: /god-feature for the smallest proven slice
   2. Implement complete: /god-feature with the full recommendation
   3. Discuss more: /god-discuss the remaining uncertainty
-  4. Run God Mode: /god-mode only if this spike unblocks the full arc
+  4. Run God Mode: /god-mode only if this spike unblocks the full project run
 Recommended: proceed only when SPIKE.md has a clear DECISION and evidence.
 
 REMINDER: spike code is throwaway. Do NOT merge to main.

package/skills/god-stack.md

@@ -9,7 +9,7 @@ description: |
 
 # /god-stack
 
-Spawn the **god-stack-selector** agent in a fresh context via Task tool.
+Spawn the **god-stack-selector** agent in a fresh context via the host platform's native agent spawning mechanism.
 
 ## Setup
 

package/skills/god-status.md

@@ -27,6 +27,8 @@ Re-derive state from disk. Your memory is not authoritative. The file system is.
    - `.godpowers/observe/STATE.md`
    - `.godpowers/launch/STATE.md`
    - `.godpowers/harden/FINDINGS.md`
+   - `.godpowers/SYNC-LOG.md`
+   - `.godpowers/CHECKPOINT.md`
 4. For each artifact found: run a lightweight have-nots check
 5. Compare disk state to PROGRESS.md state:
    - If PROGRESS.md says "done" but artifact is missing: FLAG as phantom resume
@@ -34,7 +36,11 @@ Re-derive state from disk. Your memory is not authoritative. The file system is.
 6. Report:
    - Current mode and scale
    - Progress summary: percentage, completed step count, current step number
+   - Planning visibility: PRD status, roadmap status, active milestone, and
+     completion basis
    - What happened recently, using CHECKPOINT.md actions when available
+   - Last sync status, using SYNC-LOG.md when available
+   - Proactive opportunities based on the auto-invoke policy
    - What happens next, using routing and disk state
    - Per-tier status (with disk verification)
    - Any inconsistencies between PROGRESS.md and disk
@@ -51,10 +57,36 @@ Started: 2026-05-09
 Progress: 15% (2 of 13 steps complete; current step 3 of 13)
 Current: Tier 1 Planning / Architecture
 
+Planning visibility:
+  PRD: done .godpowers/prd/PRD.md
+  Roadmap: pending
+  Current milestone: Planning / Architecture
+  Completion: 15% based on PROGRESS.md tracked steps
+
 What happened recently:
   1. PRD artifact verified on disk
   2. Tier state refreshed from state.json
 
+Last sync:
+  Trigger: /god-mode final sync
+  Agent: god-updater
+  Local syncs:
+    + reverse-sync: scanned 14 files, updated 2 footers, populated 0 review items
+    + pillars-sync: no-op
+    + checkpoint-sync: CHECKPOINT.md updated
+    + context-refresh: no-op
+  Log: .godpowers/SYNC-LOG.md
+
+Proactive opportunities:
+  Checkpoint: fresh
+  Reviews: 5 pending, suggest /god-review-changes
+  Sync: fresh
+  Docs: possible drift, suggest /god-docs
+  Runtime: known local URL, suggest /god-test-runtime
+  Security: clear
+  Dependencies: clear
+  Hygiene: stale, suggest /god-hygiene
+
 What happens next:
   1. Run /god-arch
   2. Verify architecture artifact
@@ -100,7 +132,7 @@ how much momentum to give Godpowers:
 ```
 Proposition:
   1. Implement partial: [single next command from "What happens next"]
-  2. Implement complete: /god-mode to continue the current arc when no blockers are present
+  2. Implement complete: /god-mode to continue the current project run when no blockers are present
   3. Discuss more: /god-discuss [unclear state, blocker, or inconsistency]
   4. Inspect status: /god-locate or /god-next for a smaller routing view
 Recommended: [one option and why it fits the disk-derived state]
@@ -109,6 +141,24 @@ Recommended: [one option and why it fits the disk-derived state]
 If inconsistencies are present, make `/god-repair` the partial option and do
 not recommend `/god-mode` until disk state is coherent.
 
+## Proactive Opportunity Rules
+
+Use the master auto-invoke policy to populate `Proactive opportunities`.
+`/god-status` is read-only by default, so it suggests Level 3 agents instead of
+spawning them unless the user asked status to continue work.
+
+Report:
+- Checkpoint: `fresh`, `missing`, `stale`, or `conflicts with state.json`
+- Reviews: `none` or `<N> pending, suggest /god-review-changes`
+- Sync: `fresh`, `missing`, `stale`, or `suggest /god-sync`
+- Docs: `fresh`, `possible drift, suggest /god-docs`, or
+  `docs drift-check already logged`
+- Runtime: `not-applicable`, `known URL, suggest /god-test-runtime`, or
+  `no known URL, defer deployed verification`
+- Security: `clear` or `sensitive files changed, suggest /god-harden`
+- Dependencies: `clear` or `dependency files changed, suggest /god-update-deps`
+- Hygiene: `fresh` or `stale, suggest /god-hygiene`
+
 ## Mode D awareness
 
 If `lib/multi-repo-detector.detect(projectRoot)` returns

package/skills/god-suite-init.md

@@ -81,6 +81,6 @@ shared-standards:
 ## What this does NOT do
 
 - Modify any repo's source code
-- Run an arc on any repo
+- Run a project run on any repo
 - Override existing per-repo state.json beyond adding the
   `suite.hubPath` pointer

package/skills/god-suite-release.md

@@ -33,7 +33,7 @@ A version bump that knows about dependents. Different from `/god-launch`
    - Scans suite version-table for repos that depend on the bumped repo
    - For each dependent: writes a per-repo orchestrator handoff file and
      spawns its `god-orchestrator` with only a display-safe pointer for the
-     `version-bump` directive (NOT a full arc)
+     `version-bump` directive (NOT a full project run)
    - Aggregates results per-repo
    - Updates `.godpowers/suite-config.yaml` version-table to match
    - Appends to `.godpowers/suite/SYNC-LOG.md`

package/skills/god-suite-status.md

@@ -39,7 +39,7 @@ Aggregate
 Per-repo
 | Repo      | Mode | Phase     | Artifacts | Coverage | Drift | Reviews |
 |-----------|------|-----------|-----------|----------|-------|---------|
-| dashboard | A    | in-arc    | 12        | 92%      | 0     | 1       |
+| dashboard | A    | in progress | 12        | 92%      | 0     | 1       |
 | api       | A    | steady    | 18        | 85%      | 2     | 2       |
 | docs      | A    | steady    | 12        | 84%      | 1     | 2       |
 

package/skills/god-suite-sync.md

@@ -46,4 +46,4 @@ warnings by default; surfaces in REVIEW-REQUIRED.md per repo.
 - Touch files NOT declared in `byte-identical:` of suite-config.yaml
 - Modify per-repo state.json (only the syncer agent writes; no
   Quarterback-level changes)
-- Run any arc inside a sibling repo
+- Run any project run inside a sibling repo

package/skills/god-sync.md

@@ -37,6 +37,18 @@ User runs `/god-sync` after manual changes. Useful for:
    - Or: re-run reconciliation against current state to detect what changed
    - Recent commits for context
 
+Before spawning, show a visible auto-invoke card:
+
+```
+Auto-invoked:
+  Trigger: <manual /god-sync, recipe closeout, /god-mode final sync, or other source>
+  Agent: god-updater
+  Local syncs:
+    - pending: reverse-sync, pillars-sync, checkpoint-sync, context-refresh
+  Artifacts: pending
+  Log: .godpowers/SYNC-LOG.md
+```
+
 ## Verification
 
 After god-updater returns:
@@ -52,6 +64,21 @@ After god-updater returns:
 ```
 Sync complete.
 
+Sync status:
+  Trigger: /god-mode final sync
+  Agent: god-updater spawned
+  Local syncs:
+    + reverse-sync: <scanned N files, updated M footers, populated K review items>
+    + pillars-sync: <updated N pillar files, no-op, or proposed>
+    + checkpoint-sync: <CHECKPOINT.md updated or skipped>
+    + context-refresh: <updated AGENTS.md/tool pointers, no-op, or skipped by setting>
+  Artifacts: <changed files, no-op, or deferred>
+  Log: .godpowers/SYNC-LOG.md
+
+If this path ran only a local helper, say:
+  Agent: none, local runtime only
+  Why: this path called lib/reverse-sync.run directly
+
 Updated:
   - prd/PRD.md (added requirement P-MUST-12)
   - arch/ARCH.md (added ADR-007)
@@ -65,7 +92,13 @@ Updated:
 Have-nots: all passing
 SYNC-LOG.md updated.
 
-Suggested next: /god-status
+Current status:
+  State: <complete | partial | blocked | no-op>
+  Progress: <pct>% when available
+
+Next:
+  Recommended: /god-status
+  Why: verify the disk-derived state after sync.
 ```
 
 ## What this prevents

package/skills/god-tech-debt.md

@@ -58,7 +58,7 @@ Proposition:
   1. Implement partial: run the command for the top P0 item only
   2. Implement complete: /god-feature or /god-refactor for the full P0 bundle
   3. Discuss more: /god-discuss the highest-cost or highest-risk debt item
-  4. Run God Mode: /god-mode only if debt work should join the full arc
+  4. Run God Mode: /god-mode only if debt work should join the full project run
 Recommended: start with the top P0 item, then re-run /god-tech-debt after it
 lands.
 ```

package/skills/god-test-runtime.md

@@ -96,6 +96,32 @@ critical findings have the same gate semantics.
 | `/god-harden` | a11y portion | warning |
 | `/god-design` (post-change) | audit | warning |
 
+Automatic runtime verification requires evidenced URL input:
+
+- A local dev server URL from `state.json.dev-server.url`
+- A deploy URL from `state.json.deploy.url`
+- A user-provided URL in the current session
+- A checked-in config or Godpowers artifact that explicitly identifies the URL
+  as current
+
+If frontend-visible files changed but no URL is evidenced, do not guess. Add a
+proactive suggestion for `/god-test-runtime` and explain what URL source is
+missing. If only a local URL is evidenced, run local verification and defer
+deployed staging verification until the user provides
+`STAGING_APP_URL=<deployed staging origin>` or reaches final sign-off.
+
+When auto-invoked, show:
+
+```text
+Auto-invoked:
+  Trigger: frontend-visible files changed and URL was evidenced
+  Agent: god-browser-tester
+  Local syncs:
+    + runtime-verification: <audit | test | full pipeline>
+  Artifacts: .godpowers/runtime/<run-id>/
+  Log: .godpowers/runtime/<run-id>/summary.md
+```
+
 ## Output to events.jsonl
 
 ```json

package/skills/god.md

@@ -28,7 +28,7 @@ Before calling runtime modules, resolve the Godpowers runtime root:
 
 Slash commands are precise but require the user to know the command name.
 Recipes are scenario-shaped ("I'm coming back after a week", "production is
-broken", "add a feature mid-arc") and match free-text intent. `/god` is the
+broken", "add a feature during the current project run") and match free-text intent. `/god` is the
 front door that turns intent into the right slash command.
 
 This skill complements `/god-next` rather than replacing it:
@@ -39,7 +39,7 @@ This skill complements `/god-next` rather than replacing it:
 | `/god-next` | "I just finished X, what's next?" or pre-flight checks |
 | `/god-status` | "Where are we? what's done?" |
 | `/god-init` | "Start a project here" |
-| `/god-mode` | "Run the whole arc autonomously" |
+| `/god-mode` | "Run the whole project run autonomously" |
 
 ## Process
 
@@ -48,8 +48,8 @@ This skill complements `/god-next` rather than replacing it:
 Treat everything after `/god` as free text. If empty, treat as state-driven.
 
 ```
-/god add a feature without breaking the current arc
-   text = "add a feature without breaking the current arc"
+/god add a feature without breaking the current project run
+   text = "add a feature without breaking the current project run"
 
 /god
    text = "" -> state-driven mode
@@ -120,7 +120,7 @@ Proposition:
   1. Implement partial: <smallest safe command or slice>
   2. Implement complete: <full command sequence>
   3. Discuss more: /god-discuss <topic or unresolved question>
-  4. Run God Mode: /god-mode <scope> if the user wants the full autonomous arc
+  4. Run God Mode: /god-mode <scope> if the user wants the full autonomous project run
 Recommended: <one option and why>
 ```
 
@@ -178,8 +178,8 @@ User: /god add a new feature
 
 Top matches for "add a new feature":
 
-  1. add-feature-mid-arc-pause       (15)   Pause /god-mode arc, run feature, resume
-  2. add-feature-small               (10)   Lightweight feature, no arc context
+  1. add-feature-mid-arc-pause       (15)   Pause /god-mode, run feature, resume
+  2. add-feature-small               (10)   Lightweight feature, no project-run context
   3. add-feature-next-milestone      (10)   Defer to next milestone
 
 Pick one (1/2/3) or describe more specifically.
@@ -210,7 +210,7 @@ User: /god make me a sandwich
 No recipe matched. Falling back to state-driven suggestion.
 
 Where you are: tier-3 launched
-Structural next: (none, arc complete)
+Structural next: (none, project run complete)
 
 Suggested: /god-next   show all valid next-step options
        or: /god-status   re-derive state from disk

package/workflows/bluefield-arc.yaml

@@ -12,7 +12,7 @@ metadata:
     Bluefield: new code, existing org context. Loads org standards first,
     runs a preflight intake against the surrounding environment, runs a
     greenfield simulation audit against those constraints, then runs a
-    user-approved greenfieldification pass before the full arc.
+    user-approved greenfieldification pass before the full project run.
 
 on: [/god-bluefield, /god-mode --bluefield]
 

package/workflows/brownfield-arc.yaml

@@ -11,7 +11,7 @@ metadata:
   description: |
     Brownfield: existing codebase, inspect before prescribing. Preflight +
     archaeology + reconstruction + debt assessment + greenfield simulation
-    audit, then a user-approved greenfieldification pass before normal arc
+    audit, then a user-approved greenfieldification pass before normal project-run
     workflows.
 
 on: [/god-brownfield, /god-mode --brownfield]

package/workflows/feature-arc.yaml

@@ -9,7 +9,7 @@ metadata:
   name: feature-arc
   version: 1.0.0
   description: |
-    Add a feature to an existing project. Skips full-arc setup.
+    Add a feature to an existing project. Skips full project-run setup.
     Run by /god-feature.
 
 on: [/god-feature]