godpowers 2.3.1 → 2.4.0

package/skills/god-sync.md

@@ -93,7 +93,7 @@ Sync status:
     + source-sync: <written legacy planning/BMAD/Superpowers companion files, no-op, or skipped>
     + repo-doc-sync: <refreshed README badges/counts, recommended god-docs-writer, or no-op>
     + repo-surface-sync: <checked routes/package/agents/workflows/extensions, recommended scoped agents, or no-op>
-    + route-quality-sync: <checked atomic spawns and contextual exits, no-op, or recommended god-auditor>
+    + route-quality-sync: <checked atomic spawns and typed route outcomes, no-op, or recommended god-auditor>
     + recipe-coverage-sync: <checked high-frequency intent recipes, no-op, or recommended god-roadmap-reconciler>
     + release-surface-sync: <checked badges/changelog/release/package guards, no-op, or recommended god-docs-writer>
     + pillars-sync: <updated N pillar files, no-op, or proposed>

package/skills/god.md

@@ -22,7 +22,7 @@ Before calling runtime modules, resolve the Godpowers runtime root:
 
 1. If `<projectRoot>/lib/recipes.js` exists, use the repository checkout runtime at `<projectRoot>`.
 2. Otherwise use the installed bundle at `<tool-config-dir>/godpowers-runtime`, where `<tool-config-dir>` is the directory that contains this installed skill, such as `~/.claude`, `~/.codex`, `~/.cursor`, `~/.windsurf`, or `~/.gemini`.
-3. Load recipes from `<runtimeRoot>/lib/recipes.js`, routing from `<runtimeRoot>/lib/router.js`, and recipe YAML from `<runtimeRoot>/routing/recipes/`.
+3. Load recipes from `<runtimeRoot>/lib/recipes.js`, routing from `<runtimeRoot>/lib/router.js`, command families from `<runtimeRoot>/lib/command-families.js`, and recipe YAML from `<runtimeRoot>/routing/recipes/`.
 
 ## Why this exists
 
@@ -41,6 +41,57 @@ This skill complements `/god-next` rather than replacing it:
 | `/god-init` | "Start a project here" |
 | `/god-mode` | "Run the whole project run autonomously" |
 
+## Command family UX
+
+Before showing individual leaf commands, use the family map from
+`lib/command-families.js`:
+
+| Family | User question |
+|--------|---------------|
+| start | "How do I begin or import this project?" |
+| continue | "Where are we and what should happen next?" |
+| build | "How big is this work and how should it run?" |
+| verify | "What is the cheapest sufficient check?" |
+| operate | "How do we run, observe, harden, or fix production?" |
+| maintain | "How do we keep docs, deps, routes, and context current?" |
+| capture | "Where should this thought, task, backlog item, or seed go?" |
+| recover | "How do we repair or walk back state?" |
+| extend | "How do we install or author skill packs?" |
+| collaborate | "How do we coordinate people, workstreams, suites, or PRs?" |
+| configure | "How do we tune settings, budgets, cache, profiles, or help?" |
+
+Use the classifiers from `lib/command-families.js` when intent is about
+capture, work size, verification, or duplicate trigger phrases. Keep every
+leaf command available as a direct shortcut.
+
+### Capture ladder
+
+- Save only: `/god-note`
+- Actionable soon: `/god-add-todo`
+- Optional later: `/god-add-backlog`
+- Conditional future trigger: `/god-plant-seed`
+
+### Work size ladder
+
+- Trivial direct edit: `/god-fast`
+- Small TDD task: `/god-quick`
+- Fine-grained planned slice: `/god-story`
+- Existing-product feature: `/god-feature`
+- Current milestone work: `/god-build`
+- Non-urgent bug: `/god-debug`
+- Production outage: `/god-hotfix`
+
+### Verification ladder
+
+- Mechanical artifact check: `/god-lint`
+- Artifact quality gate: `/god-standards`
+- Code diff review: `/god-review`
+- Live behavior check: `/god-test-runtime`
+- Artifact set score: `/god-audit`
+- Ongoing health check: `/god-hygiene`
+- Existing repo intake: `/god-preflight`
+- Release fixture readiness: `/god-dogfood`
+
 ## Process
 
 ### Step 1: parse the user's intent
@@ -64,6 +115,7 @@ text empty?
          also call <runtimeRoot>/lib/router.js suggestNext(projectRoot) for structural next
 
   no  -> intent-driven: call <runtimeRoot>/lib/recipes.js matchIntent(text, projectRoot)
+         call <runtimeRoot>/lib/command-families.js classifiers for capture, work size, verification, and trigger precedence hints
          take top 1-3 matches by score
          if highest score >= 10 (exact phrase match): propose directly
          if highest score 5-9 (all-words match): propose with confirmation

package/workflows/audit-only.yaml

@@ -25,9 +25,9 @@ jobs:
     tier: 0
     needs: audit-score
     uses: god-orchestrator@^1.0.0
+    local-helper-groups:
+      - repo-maintenance-closeout
     local-helpers:
-      - repo-doc-sync
-      - repo-surface-sync
       - host-capabilities
     with:
       action: audit-closeout

package/workflows/bluefield-arc.yaml

@@ -133,13 +133,9 @@ jobs:
     tier: 0
     needs: launch
     uses: god-orchestrator@^1.0.0
-    local-helpers:
-      - feature-awareness
-      - repo-doc-sync
-      - repo-surface-sync
-      - host-capabilities
-      - checkpoint-sync
-      - pillars-sync-plan
+    local-helper-groups:
+      - runtime-awareness-closeout
+      - standard-closeout
     with:
       action: final-sync
       dashboard: action-brief

package/workflows/brownfield-arc.yaml

@@ -89,14 +89,10 @@ jobs:
     tier: 0
     needs: steady-state-handoff
     uses: god-orchestrator@^1.0.0
-    local-helpers:
-      - feature-awareness
-      - source-sync-back
-      - repo-doc-sync
-      - repo-surface-sync
-      - host-capabilities
-      - checkpoint-sync
-      - pillars-sync-plan
+    local-helper-groups:
+      - runtime-awareness-closeout
+      - source-sync-closeout
+      - standard-closeout
     with:
       action: final-sync
       dashboard: action-brief

package/workflows/deps-audit.yaml

@@ -59,11 +59,8 @@ jobs:
     tier: 0
     needs: [deps-patch-batch, deps-minor-per-package, deps-major-handoff]
     uses: god-orchestrator@^1.0.0
-    local-helpers:
-      - repo-doc-sync
-      - repo-surface-sync
-      - checkpoint-sync
-      - pillars-sync-plan
+    local-helper-groups:
+      - standard-closeout
     with:
       action: final-sync
       dashboard: action-brief

package/workflows/docs-arc.yaml

@@ -18,9 +18,9 @@ jobs:
   mechanical-doc-sync:
     tier: 0
     uses: god-orchestrator@^1.0.0
+    local-helper-groups:
+      - repo-maintenance-closeout
     local-helpers:
-      - repo-doc-sync
-      - repo-surface-sync
       - host-capabilities
     with:
       action: local-helper-sync

package/workflows/feature-arc.yaml

@@ -62,12 +62,9 @@ jobs:
     tier: 0
     needs: feature-soft-launch
     uses: god-orchestrator@^1.0.0
-    local-helpers:
-      - source-sync-back
-      - repo-doc-sync
-      - repo-surface-sync
-      - checkpoint-sync
-      - pillars-sync-plan
+    local-helper-groups:
+      - source-sync-closeout
+      - standard-closeout
     with:
       action: final-sync
       dashboard: action-brief

package/workflows/full-arc.yaml

@@ -107,17 +107,11 @@ jobs:
     tier: 0
     needs: launch
     uses: god-orchestrator@^1.0.0
-    local-helpers:
-      - feature-awareness
-      - source-sync-back
-      - repo-doc-sync
-      - repo-surface-sync
-      - route-quality-sync
-      - recipe-coverage-sync
-      - release-surface-sync
-      - host-capabilities
-      - checkpoint-sync
-      - pillars-sync-plan
+    local-helper-groups:
+      - runtime-awareness-closeout
+      - source-sync-closeout
+      - standard-closeout
+      - release-readiness-closeout
     with:
       action: final-sync
       dashboard: action-brief

package/workflows/hotfix-arc.yaml

@@ -62,12 +62,9 @@ jobs:
     tier: 0
     needs: hotfix-postmortem-trigger
     uses: god-orchestrator@^1.0.0
-    local-helpers:
-      - source-sync-back
-      - repo-doc-sync
-      - repo-surface-sync
-      - checkpoint-sync
-      - pillars-sync-plan
+    local-helper-groups:
+      - source-sync-closeout
+      - standard-closeout
     with:
       action: final-sync
       dashboard: action-brief

package/workflows/hygiene.yaml

@@ -38,9 +38,9 @@ jobs:
     tier: 0
     needs: [hygiene-audit, hygiene-deps, hygiene-docs]
     uses: god-orchestrator@^1.0.0
+    local-helper-groups:
+      - repo-maintenance-closeout
     local-helpers:
-      - repo-doc-sync
-      - repo-surface-sync
       - host-capabilities
       - checkpoint-sync
     with:

package/workflows/migration-arc.yaml

@@ -76,13 +76,11 @@ jobs:
     tier: 0
     needs: migration-contract
     uses: god-orchestrator@^1.0.0
+    local-helper-groups:
+      - source-sync-closeout
+      - standard-closeout
     local-helpers:
-      - source-sync-back
-      - repo-doc-sync
-      - repo-surface-sync
       - host-capabilities
-      - checkpoint-sync
-      - pillars-sync-plan
     with:
       action: final-sync
       dashboard: action-brief

package/workflows/postmortem.yaml

@@ -34,11 +34,8 @@ jobs:
     tier: 0
     needs: postmortem-runbook-update
     uses: god-orchestrator@^1.0.0
-    local-helpers:
-      - repo-doc-sync
-      - repo-surface-sync
-      - checkpoint-sync
-      - pillars-sync-plan
+    local-helper-groups:
+      - standard-closeout
     with:
       action: final-sync
       dashboard: action-brief

package/workflows/refactor-arc.yaml

@@ -62,12 +62,9 @@ jobs:
     tier: 0
     needs: refactor-deploy
     uses: god-orchestrator@^1.0.0
-    local-helpers:
-      - source-sync-back
-      - repo-doc-sync
-      - repo-surface-sync
-      - checkpoint-sync
-      - pillars-sync-plan
+    local-helper-groups:
+      - source-sync-closeout
+      - standard-closeout
     with:
       action: final-sync
       dashboard: action-brief