godpowers 2.7.0 → 3.0.1

package/routing/god-extend.yaml

@@ -0,0 +1,47 @@
+apiVersion: godpowers/v1
+kind: CommandRouting
+metadata:
+  command: /god-extend
+  description: Extend verb dispatcher
+  tier: 0
+  family: extend
+
+prerequisites:
+  required: []
+
+execution:
+  spawns: [built-in]
+  context: fresh
+  reads:
+    - routing/god-extension-scaffold.yaml
+    - routing/god-extension-add.yaml
+    - routing/god-extension-list.yaml
+    - routing/god-extension-info.yaml
+    - routing/god-extension-remove.yaml
+    - routing/god-test-extension.yaml
+    - routing/god-build-agent.yaml
+  writes: []
+
+dispatch:
+  scaffold: /god-extension-scaffold
+  add: /god-extension-add
+  list: /god-extension-list
+  info: /god-extension-info
+  remove: /god-extension-remove
+  test: /god-test-extension
+  agent: /god-build-agent
+
+success-path:
+  next-recommended: varies
+  outcome:
+    type: contextual
+    label: Extend dispatch route
+    reason: The next route depends on the requested extension operation.
+    allowed-next: [/god-extension-scaffold, /god-extension-add, /god-extension-list, /god-extension-info, /god-extension-remove, /god-test-extension, /god-build-agent]
+
+failure-path:
+  on-error: /god-doctor
+
+endoff:
+  state-update: no direct state update; selected leaf command owns state
+  events: [agent.start, decision.route, agent.end]

package/routing/god-fix.yaml

@@ -0,0 +1,37 @@
+apiVersion: godpowers/v1
+kind: CommandRouting
+metadata:
+  command: /god-fix
+  description: Fix verb dispatcher
+  tier: 0
+  family: build
+
+prerequisites:
+  required: []
+
+execution:
+  spawns: [built-in]
+  context: fresh
+  reads:
+    - routing/god-debug.yaml
+    - routing/god-hotfix.yaml
+  writes: []
+
+dispatch:
+  debug: /god-debug
+  hotfix: /god-hotfix
+
+success-path:
+  next-recommended: varies
+  outcome:
+    type: contextual
+    label: Fix dispatch route
+    reason: The next route depends on whether production urgency is present.
+    allowed-next: [/god-debug, /god-hotfix]
+
+failure-path:
+  on-error: /god-doctor
+
+endoff:
+  state-update: no direct state update; selected leaf command owns state
+  events: [agent.start, decision.route, agent.end]

package/routing/god-lifecycle.yaml

@@ -4,7 +4,7 @@ metadata:
   command: /god-lifecycle
   description: Show project phase
   tier: 0
-  family: continue
+  family: compatibility
   trigger-precedence:
     - trigger: where am i
       prefer: /god-locate

package/routing/god-locate.yaml

@@ -4,7 +4,7 @@ metadata:
   command: /god-locate
   description: 
   tier: 0
-  family: continue
+  family: compatibility
 
 prerequisites:
   required: []

package/routing/god-plan.yaml

@@ -0,0 +1,45 @@
+apiVersion: godpowers/v1
+kind: CommandRouting
+metadata:
+  command: /god-plan
+  description: Planning verb dispatcher
+  tier: 0
+  family: start
+
+prerequisites:
+  required: []
+
+execution:
+  spawns: [built-in]
+  context: fresh
+  reads:
+    - routing/god-prd.yaml
+    - routing/god-design.yaml
+    - routing/god-arch.yaml
+    - routing/god-roadmap.yaml
+    - routing/god-stack.yaml
+    - routing/god-reconstruct.yaml
+  writes: []
+
+dispatch:
+  prd: /god-prd
+  design: /god-design
+  arch: /god-arch
+  roadmap: /god-roadmap
+  stack: /god-stack
+  reconstruct: /god-reconstruct
+
+success-path:
+  next-recommended: varies
+  outcome:
+    type: contextual
+    label: Planning dispatch route
+    reason: The next route depends on the requested planning artifact.
+    allowed-next: [/god-prd, /god-design, /god-arch, /god-roadmap, /god-stack, /god-reconstruct]
+
+failure-path:
+  on-error: /god-doctor
+
+endoff:
+  state-update: no direct state update; selected leaf command owns state
+  events: [agent.start, decision.route, agent.end]

package/routing/god-roadmap-check.yaml

@@ -2,7 +2,7 @@ apiVersion: godpowers/v1
 kind: CommandRouting
 metadata:
   command: /god-roadmap-check
-  description: Reconcile intent against ROADMAP.md before feature work
+  description: Legacy roadmap-only alias for /god-reconcile
   tier: 1
   family: compatibility
 
@@ -13,7 +13,7 @@ prerequisites:
       human-required: true
 
 execution:
-  spawns: [god-roadmap-reconciler]
+  spawns: [god-reconciler]
   context: fresh
   reads:
     - .godpowers/roadmap/ROADMAP.md

package/routing/god-ship.yaml

@@ -0,0 +1,39 @@
+apiVersion: godpowers/v1
+kind: CommandRouting
+metadata:
+  command: /god-ship
+  description: Ship verb dispatcher
+  tier: 0
+  family: operate
+
+prerequisites:
+  required: []
+
+execution:
+  spawns: [built-in]
+  context: fresh
+  reads:
+    - routing/god-deploy.yaml
+    - routing/god-observe.yaml
+    - routing/god-launch.yaml
+  writes: []
+
+dispatch:
+  deploy: /god-deploy
+  observe: /god-observe
+  launch: /god-launch
+
+success-path:
+  next-recommended: varies
+  outcome:
+    type: contextual
+    label: Ship dispatch route
+    reason: The next route depends on the requested shipping closure step.
+    allowed-next: [/god-deploy, /god-observe, /god-launch]
+
+failure-path:
+  on-error: /god-doctor
+
+endoff:
+  state-update: no direct state update; selected leaf command owns state
+  events: [agent.start, decision.route, agent.end]

package/skills/god-agent-audit.md

@@ -2,10 +2,10 @@
 name: god-agent-audit
 description: |
   Validates every `agents/god-*.md` against the agent contract:
-  required frontmatter, recommended sections (Have-Nots, Inputs,
-  Outputs, Handoff), hand-off targets exist, no dual-ownership of
-  output paths. Lenient by design: most issues are warnings; only
-  structural breakage errors.
+  required frontmatter, structured contract frontmatter, recommended
+  sections (Have-Nots, Inputs, Outputs, Handoff), hand-off targets exist,
+  no dual-ownership of output paths. Lenient by design: most issues are
+  warnings; only structural breakage errors.
 
   Triggers on: "god agent audit", "/god-agent-audit", "audit agents",
   "validate agent contracts"
@@ -32,6 +32,7 @@ Mechanical validation of agent contracts. Backed by `lib/agent-validator.js`.
 
 **Recommended (warnings)**:
 - Frontmatter `tools` field
+- Frontmatter `inputs`, `outputs`, `gates`, and `handoff` fields after at least 20 shipped agents have structured contracts
 - Hand-off targets that are referenced exist as agent files
 - Output paths claimed by 4+ agents (boundary review needed)
 
@@ -51,16 +52,16 @@ opportunities, not failures.
 Agent audit
 
 40 agents audited
-0 errors, 2 warnings, 90 infos
+40 structured contracts
+0 errors, 1 warning, 97 infos
 
 Errors:
 (none)
 
 Warnings:
-  [multi-ownership] STATE.md claimed by 4 agents (verify boundaries)
-  [multi-ownership] .godpowers/roadmap/ROADMAP.md claimed by 4 agents
+  [multi-ownership] .godpowers/state.json claimed by 5 agents (verify boundaries)
 
-Infos: 90 missing-recommended-section suggestions across agents
+Infos: 97 missing-recommended-section suggestions across agents
        (run with --json for full list)
 
 Proposition:
@@ -76,7 +77,9 @@ Recommended: [one option and why]
 This skill never breaks existing agents that don't yet have the
 recommended sections. Errors fire only on real structural issues
 (missing required frontmatter, broken hand-off targets, conflicting
-output ownership).
+output ownership). Missing structured contract frontmatter becomes a
+warning once a project has at least 20 agents with complete `inputs`,
+`outputs`, `gates`, and `handoff` fields.
 
 The `--fix` flag inserts placeholder sections so contributors can
 fill them in incrementally. It never modifies content that's already

package/skills/god-arch.md

@@ -69,6 +69,4 @@ The reflog records every god-arch invocation as `op:god-arch` for `/god-undo`.
   for `/god-repair` review. Re-running picks up cleanly.
 
 
-## Locking
-
-See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
+Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-build.md

@@ -108,6 +108,4 @@ increment before moving to Tier 3 unless the user explicitly asked to stop
 after the current increment.
 
 
-## Locking
-
-See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
+Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-capture.md

@@ -0,0 +1,45 @@
+---
+name: god-capture
+description: |
+  Capture verb dispatcher. Routes thoughts, todos, backlog items, and seeds
+  to the existing capture leaf commands.
+
+  Triggers on: "god capture", "/god-capture", "capture this", "note this",
+  "add todo", "add backlog", "plant seed"
+---
+
+# /god-capture
+
+Route capture intent to the smallest existing capture command.
+
+## Runtime module resolution
+
+Resolve the Godpowers runtime root before inspecting routes:
+
+1. If `<projectRoot>/routing/god-note.yaml` exists, use the repository checkout runtime at `<projectRoot>`.
+2. Otherwise use the installed bundle at `<tool-config-dir>/godpowers-runtime`.
+3. Read routing metadata from `<runtimeRoot>/routing/`.
+
+## Dispatch
+
+| Signal | Hand off to |
+|---|---|
+| `todo`, `task`, `remind`, `priority` | `/god-add-todo` |
+| `backlog`, `later`, `someday`, `future` | `/god-add-backlog` |
+| `when`, `if`, `after`, `once`, `trigger` | `/god-plant-seed` |
+| `note`, `thought`, `remember` | `/god-note` |
+
+Default to `/god-note` when no priority, backlog, or trigger signal exists.
+
+## Process
+
+1. Select the target leaf command from the table.
+2. Read the selected leaf route YAML so prerequisites and next-step metadata stay source-controlled.
+3. Show the selected command and the matched capture signal.
+4. Hand off to the selected leaf command after user confirmation.
+
+## Guardrails
+
+- Do not write notes, todos, backlog items, or seeds directly from this dispatcher.
+- Do not assign priority unless the user provided priority evidence.
+- Keep each capture leaf callable as a direct shortcut.

package/skills/god-deploy.md

@@ -95,6 +95,4 @@ The reflog records every god-deploy invocation as `op:god-deploy` for `/god-undo
   for `/god-repair` review. Re-running picks up cleanly.
 
 
-## Locking
-
-See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
+Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-design.md

@@ -69,6 +69,14 @@ producing DESIGN.md in the
 6. After god-designer returns: surface any lint findings, suggest
    `/god-design polish` if warnings exist.
 
+## Verification
+
+After god-designer returns:
+1. Verify `DESIGN.md` exists on disk when design was required.
+2. Run `npx godpowers gate --tier=design --project=.`
+3. If the gate returns a non-zero exit, do not mark Design complete. Report the gate output and repair the artifact first.
+4. Run `npx godpowers state advance --step=design --status=done --project=.`.
+
 ## Detection-driven behavior
 
 - **UI + impeccable installed**: bridges to impeccable's commands
@@ -267,6 +275,4 @@ The reflog records every god-design invocation as `op:god-design` for `/god-undo
   for `/god-repair` review. Re-running picks up cleanly.
 
 
-## Locking
-
-See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
+Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-doctor.md

@@ -48,7 +48,7 @@ Plain-text report grouped by severity:
 GODPOWERS DOCTOR
 
 Install: claude (~/.claude/)
-  [OK] 112 skills installed
+  [OK] 117 skills installed
   [OK] 40 agents installed
   [OK] VERSION matches (2.3.1)
   [WARN] routing/god-doctor.yaml exists but skill file did not until now

package/skills/god-extend.md

@@ -0,0 +1,48 @@
+---
+name: god-extend
+description: |
+  Extend verb dispatcher. Routes extension installation, inspection, removal,
+  testing, and authoring intent to existing extension leaf commands.
+
+  Triggers on: "god extend", "/god-extend", "install extension",
+  "list extensions", "remove extension", "scaffold extension"
+---
+
+# /god-extend
+
+Route extension intent to the smallest existing extension command.
+
+## Runtime module resolution
+
+Resolve the Godpowers runtime root before inspecting routes:
+
+1. If `<projectRoot>/routing/god-extension-add.yaml` exists, use the repository checkout runtime at `<projectRoot>`.
+2. Otherwise use the installed bundle at `<tool-config-dir>/godpowers-runtime`.
+3. Read routing metadata from `<runtimeRoot>/routing/`.
+
+## Dispatch
+
+| Signal | Hand off to |
+|---|---|
+| `scaffold`, `author`, `create pack` | `/god-extension-scaffold` |
+| `add`, `install` | `/god-extension-add` |
+| `list`, `installed` | `/god-extension-list` |
+| `info`, `inspect`, `details` | `/god-extension-info` |
+| `remove`, `uninstall` | `/god-extension-remove` |
+| `test`, `verify` | `/god-test-extension` |
+| `agent`, `custom agent` | `/god-build-agent` |
+
+Default to `/god-extension-list` when no stronger signal exists.
+
+## Process
+
+1. Select the target leaf command from the table.
+2. Read the selected leaf route YAML so prerequisites and next-step metadata stay source-controlled.
+3. Show the selected command, the matched signal, and whether the target mutates installed packs.
+4. Hand off to the selected leaf command after user confirmation.
+
+## Guardrails
+
+- Do not install, remove, scaffold, or test extension packs directly from this dispatcher.
+- Do not bypass package legitimacy checks from extension leaf commands.
+- Keep each extension leaf callable as a direct shortcut.

package/skills/god-feature.md

@@ -107,6 +107,4 @@ in the linkage system:
   via `/god-review-changes`.
 
 
-## Locking
-
-See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
+Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-fix.md

@@ -0,0 +1,43 @@
+---
+name: god-fix
+description: |
+  Fix verb dispatcher. Routes bug, regression, and production outage intent
+  to the existing debug or hotfix leaf commands.
+
+  Triggers on: "god fix", "/god-fix", "fix this bug", "debug this",
+  "production is broken", "hotfix"
+---
+
+# /god-fix
+
+Route fix intent to the smallest existing repair command.
+
+## Runtime module resolution
+
+Resolve the Godpowers runtime root before inspecting routes:
+
+1. If `<projectRoot>/routing/god-debug.yaml` exists, use the repository checkout runtime at `<projectRoot>`.
+2. Otherwise use the installed bundle at `<tool-config-dir>/godpowers-runtime`.
+3. Read routing metadata from `<runtimeRoot>/routing/`.
+
+## Dispatch
+
+| Signal | Hand off to |
+|---|---|
+| `hotfix`, `production`, `outage`, `urgent`, `down` | `/god-hotfix` |
+| `debug`, `bug`, `failing`, `error`, `regression` | `/god-debug` |
+
+Default to `/god-debug` when urgency is unclear.
+
+## Process
+
+1. Select the target leaf command from the table.
+2. Read the selected leaf route YAML so prerequisites and next-step metadata stay source-controlled.
+3. Show the selected command, the matched signal, and whether production urgency was detected.
+4. Hand off to the selected leaf command after user confirmation.
+
+## Guardrails
+
+- Do not edit code directly from this dispatcher.
+- Do not skip regression-test expectations from `/god-debug` or `/god-hotfix`.
+- Keep both leaf commands callable as direct shortcuts.

package/skills/god-harden.md

@@ -91,6 +91,4 @@ The reflog records every god-harden invocation as `op:god-harden` for `/god-undo
   for `/god-repair` review. Re-running picks up cleanly.
 
 
-## Locking
-
-See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
+Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-hotfix.md

@@ -123,6 +123,4 @@ in the linkage system:
   via `/god-review-changes`.
 
 
-## Locking
-
-See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
+Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-launch.md

@@ -97,6 +97,4 @@ The reflog records every god-launch invocation as `op:god-launch` for `/god-undo
   for `/god-repair` review. Re-running picks up cleanly.
 
 
-## Locking
-
-See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
+Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-lifecycle.md

@@ -1,5 +1,7 @@
 ---
 name: god-lifecycle
+deprecated: true
+successor: god-status --lifecycle
 description: |
   Show where the project is in its lifecycle and what workflows make sense
   next. Distinguishes: pre-init, planning, building, shipping, steady state,
@@ -11,6 +13,10 @@ description: |
 
 # /god-lifecycle
 
+Deprecated: prefer `/god-status --lifecycle` for new workflows. This command
+remains callable in the full profile for one minor release as a compatibility
+alias.
+
 Show project phase and contextually appropriate workflows.
 
 ## Process

package/skills/god-link.md

@@ -74,6 +74,4 @@ Updates:
 No source files are modified by this skill.
 
 
-## Locking
-
-See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
+Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-locate.md

@@ -1,5 +1,7 @@
 ---
 name: god-locate
+deprecated: true
+successor: god-status --locate
 description: |
   Orient a new chat session or new AI tool. Reads CHECKPOINT.md +
   state.json + events.jsonl tail + intent.yaml + reflog tail and
@@ -12,6 +14,10 @@ description: |
 
 # /god-locate
 
+Deprecated: prefer `/god-status --locate` for new workflows. This command
+remains callable in the full profile for one minor release as a compatibility
+alias.
+
 Orient a new session against disk reality. Single-screen output.
 
 ## When to use

package/skills/god-migrate.md

@@ -139,6 +139,4 @@ Suggested next:
   /god-audit to score imported seeds before treating them as authoritative.
 ```
 
-## Locking
-
-See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
+Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-mode.md

@@ -129,6 +129,11 @@ workflow.
      - Instruction that `--yolo` cannot bypass safe sync blockers or
        unresolved Critical harden findings. These are release-truth gates, not
        preference pauses.
+     - Instruction to run `npx godpowers gate --tier=<tier> --project=.` after
+       each completed `god-prd`, `god-design`, `god-arch`, `god-roadmap`,
+       `god-stack`, `god-repo`, `god-build`, and `god-harden` tier skill and
+       before starting the downstream tier. A non-zero exit blocks progress
+       until the artifact is repaired.
 
 6. Spawn the **god-orchestrator** agent via the host platform's native agent spawning mechanism with only a
    display-safe payload:

package/skills/god-observe.md

@@ -79,6 +79,4 @@ The reflog records every god-observe invocation as `op:god-observe` for `/god-un
   for `/god-repair` review. Re-running picks up cleanly.
 
 
-## Locking
-
-See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
+Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-plan.md

@@ -0,0 +1,51 @@
+---
+name: god-plan
+description: |
+  Planning verb dispatcher. Routes planning intent to PRD, design,
+  architecture, roadmap, stack, or reconstruction leaf commands without
+  replacing those commands.
+
+  Triggers on: "god plan", "/god-plan", "plan this", "write the prd",
+  "choose architecture", "roadmap this", "pick stack"
+---
+
+# /god-plan
+
+Route planning intent to the smallest existing planning command.
+
+## Runtime module resolution
+
+Resolve the Godpowers runtime root before inspecting routes:
+
+1. If `<projectRoot>/routing/god-prd.yaml` exists, use the repository checkout runtime at `<projectRoot>`.
+2. Otherwise use the installed bundle at `<tool-config-dir>/godpowers-runtime`.
+3. Read routing metadata from `<runtimeRoot>/routing/`.
+
+## Dispatch
+
+Use the first explicit argument when present. Otherwise classify the user text.
+
+| Signal | Hand off to |
+|---|---|
+| `prd`, `requirements`, `spec` | `/god-prd` |
+| `design`, `product`, `ux` | `/god-design` |
+| `arch`, `architecture`, `system` | `/god-arch` |
+| `roadmap`, `milestone`, `sequence` | `/god-roadmap` |
+| `stack`, `technology`, `dependency choice` | `/god-stack` |
+| `reconstruct`, `brownfield plan`, `existing code` | `/god-reconstruct` |
+
+Default to `/god-prd` when no stronger signal exists.
+
+## Process
+
+1. Select the target leaf command from the table.
+2. Read the selected leaf route YAML so prerequisites and next-step metadata stay source-controlled.
+3. Show the selected command, the matched signal, and the next command from the selected route.
+4. Hand off to the selected leaf command after user confirmation.
+
+## Guardrails
+
+- Do not create planning artifacts directly.
+- Do not spawn planning agents from this dispatcher.
+- Do not bypass executable gates declared by the selected leaf route.
+- Keep the selected leaf command callable as a direct shortcut.

package/skills/god-prd.md

@@ -82,6 +82,4 @@ The reflog records every god-prd invocation as `op:god-prd` for `/god-undo`.
   for `/god-repair` review. Re-running picks up cleanly.
 
 
-## Locking
-
-See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
+Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.

package/skills/god-reconcile.md

@@ -97,8 +97,8 @@ Recommended: [one option and why]
 |---|---|---|
 | Scope | ROADMAP only | Core artifacts plus runtime and repository surfaces |
 | Use | Quick check | Comprehensive |
-| Auto-invoked | by feature-addition recipes (legacy) | by feature-addition recipes (preferred) |
-| Replaces | -- | /god-roadmap-check (kept for back-compat) |
+| Auto-invoked | legacy compatibility only | by feature-addition recipes |
+| Replaces | delegated to /god-reconcile | primary command |
 
-For new projects, prefer /god-reconcile. /god-roadmap-check remains a
-narrower tool for when you only care about milestone overlap.
+For new projects, use /god-reconcile. /god-roadmap-check remains a
+compatibility alias that asks `god-reconciler` for ROADMAP-focused output.

package/skills/god-redo.md

@@ -57,6 +57,4 @@ that originally produced the artifact. Updates the linkage map via
 `/god-scan` after the artifact is rewritten.
 
 
-## Locking
-
-See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.
+Locking: See `<runtimeRoot>/references/shared/LOCKING.md` for the shared state-lock contract.