godpowers 2.3.1 → 2.4.1

package/routing/god-tech-debt.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-tech-debt
   description: Assess and prioritize technical debt
   tier: 0
+  family: maintain
 
 prerequisites:
   required: []

package/routing/god-test-extension.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-test-extension
   description: 
   tier: 0
+  family: extend
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-test-runtime.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-test-runtime
   description: Headless browser runtime verification
   tier: 3
+  family: verify
 
 prerequisites:
   required:

package/routing/god-thread.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-thread
   description: Persistent context threads
   tier: 0
+  family: capture
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-trace.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-trace
   description: 
   tier: 0
+  family: operate
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-undo.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-undo
   description: Revert last operation
   tier: 0
+  family: recover
 
 prerequisites:
   required:

package/routing/god-update-deps.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-update-deps
   description: Audit and update dependencies
   tier: 0
+  family: maintain
 
 prerequisites:
   required:

package/routing/god-upgrade.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-upgrade
   description: Framework migration
   tier: 0
+  family: maintain
 
 prerequisites:
   required:

package/routing/god-version.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-version
   description: Print installed version + capability summary
   tier: 0
+  family: configure
 
 prerequisites:
   required: []

package/routing/god-workstream.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-workstream
   description: Parallel workspace management
   tier: 0
+  family: collaborate
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/routing/god.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god
   description: Front door: free-text intent matcher
   tier: 0
+  family: start
 
 prerequisites:
   required: []
@@ -15,6 +16,11 @@ execution:
 
 success-path:
   next-recommended: varies
+  outcome:
+    type: contextual
+    label: Context-specific next route
+    reason: The next route depends on current disk state, command arguments, or user choice.
+    allowed-next: [/god-status, /god-next, /god-help]
 
 failure-path:
   on-error: /god-doctor

package/schema/routing.v1.json

@@ -20,9 +20,29 @@
       "properties": {
         "command": {
           "type": "string",
-          "pattern": "^/god-[a-z-]+$"
+          "pattern": "^/god(?:-[a-z-]+)?$"
         },
         "description": { "type": "string" },
+        "family": {
+          "type": "string",
+          "enum": [
+            "start",
+            "continue",
+            "build",
+            "verify",
+            "operate",
+            "maintain",
+            "capture",
+            "recover",
+            "extend",
+            "collaborate",
+            "configure"
+          ]
+        },
+        "trigger-precedence": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/TriggerPrecedence" }
+        },
         "tier": {
           "type": "integer",
           "minimum": 0,
@@ -110,7 +130,10 @@
       "properties": {
         "next-recommended": {
           "type": "string",
-          "pattern": "^/god-[a-z-]+$"
+          "pattern": "^(?:/god(?:-[a-z-]+)?(?:\\s.*)?|varies|varies-by-verdict|steady-state|session-end)(?:\\sor\\s/god-[a-z-]+(?:\\s.*)?)*$"
+        },
+        "outcome": {
+          "$ref": "#/$defs/RouteOutcome"
         },
         "alternatives": {
           "type": "array",
@@ -162,7 +185,7 @@
         },
         "auto-complete": {
           "type": "string",
-          "pattern": "^/god-[a-z-]+$",
+          "pattern": "^/god(?:-[a-z-]+)?(?:\\s.*)?$",
           "description": "Command to run if prerequisite missing"
         },
         "human-required": {
@@ -175,9 +198,44 @@
       "type": "object",
       "required": ["command"],
       "properties": {
-        "command": { "type": "string", "pattern": "^/god-[a-z-]+$" },
+        "command": { "type": "string", "pattern": "^/god(?:-[a-z-]+)?(?:\\s.*)?$" },
         "when": { "type": "string", "description": "Condition for this recommendation" }
       }
+    },
+    "RouteOutcome": {
+      "type": "object",
+      "required": ["type", "label", "reason"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "contextual",
+            "verdict-based",
+            "steady-state",
+            "session-end",
+            "requires-selection",
+            "no-next-command",
+            "explicit-command"
+          ]
+        },
+        "label": { "type": "string" },
+        "reason": { "type": "string" },
+        "allowed-next": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "TriggerPrecedence": {
+      "type": "object",
+      "required": ["trigger", "prefer"],
+      "properties": {
+        "trigger": { "type": "string" },
+        "prefer": { "type": "string" },
+        "when": { "type": "string" },
+        "fallback": { "type": "string" },
+        "reason": { "type": "string" }
+      }
     }
   }
 }

package/schema/workflow.v1.json

@@ -106,6 +106,20 @@
             ]
           }
         },
+        "local-helper-groups": {
+          "type": "array",
+          "description": "Named helper groups expanded by the workflow runner into explicit local-helpers in serialized plans.",
+          "items": {
+            "type": "string",
+            "enum": [
+              "standard-closeout",
+              "repo-maintenance-closeout",
+              "runtime-awareness-closeout",
+              "release-readiness-closeout",
+              "source-sync-closeout"
+            ]
+          }
+        },
         "per": { "type": "string", "enum": ["slice", "wave"] },
         "parallel-by": { "type": "string", "enum": ["slice", "wave"] },
         "on-pass": { "type": "string" },

package/skills/god-doctor.md

@@ -157,7 +157,7 @@ Built-in, no spawned agent. Reads:
 - `lib/repo-surface-sync.detect(projectRoot)` for structural repo surface
   freshness
 - `lib/route-quality-sync.detect(projectRoot)` through repo surface sync for
-  atomic spawn and contextual route exit freshness
+  atomic spawn and typed route outcome freshness
 - `lib/recipe-coverage-sync.detect(projectRoot)` through repo surface sync for
   high-frequency intent recipe coverage freshness
 - `lib/release-surface-sync.detect(projectRoot)` through repo surface sync for

package/skills/god-help.md

@@ -12,7 +12,8 @@ description: |
 
 # /god-help
 
-List Godpowers commands organized by category. Show the catalog.
+List Godpowers commands organized by family first, then by full catalog
+category. Show the map without hiding any installed command.
 
 ## Output sections
 
@@ -23,11 +24,39 @@ One line summary of project state from `state.json`:
 ### 2. Suggested next
 The same suggestion `/god-next` would make. One command.
 
-### 3. Catalog
+### 3. Command families
+Load `<runtimeRoot>/lib/command-families.js` and render family cards before the
+full catalog:
+
+- Start: start or import a project.
+- Continue: understand state and choose the next move.
+- Build: plan, implement, test, and ship product work.
+- Verify: check artifacts, code, runtime behavior, and release readiness.
+- Operate: deploy, observe, harden, launch, and respond in production.
+- Maintain: keep artifacts, docs, dependencies, context, and repo surfaces current.
+- Capture: save thoughts, tasks, backlog items, seeds, and learnings.
+- Recover: undo, repair, restore, skip, or diagnose broken state.
+- Extend: install, inspect, test, remove, or author extension packs.
+- Collaborate: coordinate people, workstreams, suites, sprints, and pull requests.
+- Configure: tune settings, budgets, cache, profiles, help, and version info.
+
+### 4. Decision ladders
+Show the compact ladders when the user asks about capture, work size, or
+verification:
+
+- Capture ladder: `/god-note`, `/god-add-todo`, `/god-add-backlog`, `/god-plant-seed`.
+- Work size ladder: `/god-fast`, `/god-quick`, `/god-story`, `/god-feature`, `/god-build`, `/god-debug`, `/god-hotfix`.
+- Verification ladder: `/god-lint`, `/god-standards`, `/god-review`, `/god-test-runtime`, `/god-audit`, `/god-hygiene`, `/god-preflight`, `/god-dogfood`.
+
+### 5. Status views
+Present `/god-status` as the hub view and list the direct shortcuts:
+`/god-progress`, `/god-lifecycle`, `/god-locate`, and `/god-next`.
+
+### 6. Full catalog
 All installed skills grouped by category. Categories match
 `docs/reference.md` order.
 
-### 4. Where to go for more
+### 7. Where to go for more
 - Full reference: https://github.com/aihxp/godpowers/blob/main/docs/reference.md
 - Concepts: https://github.com/aihxp/godpowers/blob/main/docs/concepts.md
 - Roadmap: https://github.com/aihxp/godpowers/blob/main/docs/ROADMAP.md
@@ -44,6 +73,11 @@ Description of one specific command (reads the skill's frontmatter description).
 ### `/god-help search <keyword>`
 Filter the catalog by keyword match against descriptions.
 
+### `/god-help <family>`
+Show one family card plus its leaf commands. Valid families are start,
+continue, build, verify, operate, maintain, capture, recover, extend,
+collaborate, and configure.
+
 ### `/god-help --category=<name>`
 Show only one category (lifecycle, planning, building, shipping, etc.).
 
@@ -53,6 +87,7 @@ Built-in, no spawned agent. Reads:
 - `<runtime>/skills/*.md` frontmatter
 - `.godpowers/state.json` (for current state line)
 - `<runtimeRoot>/lib/recipes.js` (for suggested next)
+- `<runtimeRoot>/lib/command-families.js` (for family cards and ladders)
 
 Resolve `<runtimeRoot>` as `<projectRoot>` when `<projectRoot>/lib/recipes.js` exists. Otherwise use the installed bundle at `<tool-config-dir>/godpowers-runtime`, where `<tool-config-dir>` is the directory that contains this installed skill.
 

package/skills/god-next.md

@@ -22,10 +22,12 @@ Before reading routing data or calling runtime modules, resolve the Godpowers ru
 1. If `<projectRoot>/lib/router.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. Read routing definitions from `<runtimeRoot>/routing/*.yaml` and recipes from `<runtimeRoot>/routing/recipes/*.yaml`.
-4. For status output, load `<runtimeRoot>/lib/dashboard.js` and call
+4. Load `<runtimeRoot>/lib/command-families.js` for work size, verification,
+   capture, and trigger precedence hints.
+5. For status output, load `<runtimeRoot>/lib/dashboard.js` and call
    `dashboard.compute(projectRoot)`. Use `dashboard.render(result)` for the
    shared dashboard section before adding route-specific detail.
-5. If the checkout runtime and installed runtime differ, say which runtime root
+6. If the checkout runtime and installed runtime differ, say which runtime root
    was used. Only call the output a manual disk scan when `lib/dashboard.js`
    cannot be loaded at all.
 
@@ -72,6 +74,11 @@ Get success-path.next-recommended (e.g., "/god-arch"), then apply any
 conditional-next rule such as UI-detected -> "/god-design"
    |
    v
+Read success-path.outcome when present. Use it to label contextual,
+verdict-based, steady-state, session-end, and selection outcomes before
+showing allowed next commands.
+   |
+   v
 Display: "PRD complete: .godpowers/prd/PRD.md
           Suggested next: /god-arch (design the architecture)"
 ```
@@ -128,6 +135,16 @@ If prereqs missing and NOT auto-completable:
 
 ## Process for Mode 3 (standalone)
 
+When the user asks a broad next-step question, use the family helpers before
+falling back to raw route order:
+
+- Capture intent routes through the capture ladder.
+- Implementation intent routes through the work size ladder.
+- Check or audit intent routes through the verification ladder.
+- Duplicate trigger phrases use `resolveTrigger` so `continue`, `think through`,
+  `what happened`, `what's done`, and `where am i` pick the context-aware
+  command.
+
 ```
 User types: /god-next
    |

package/skills/god-status.md

@@ -11,6 +11,19 @@ description: |
 
 Re-derive state from disk. Your memory is not authoritative. The file system is.
 
+## Status family views
+
+`/god-status` is the hub for the continue family. It should render the overview
+first, then offer direct shortcuts when the user wants a narrower view:
+
+| View | Shortcut | Purpose |
+|------|----------|---------|
+| Overview | `/god-status` | Operational state, proactive checks, and blockers. |
+| Progress ledger | `/god-progress` | Requirement and roadmap increment completion. |
+| Lifecycle phase | `/god-lifecycle` | Project phase and fitting workflows. |
+| Resume location | `/god-locate` | Orientation from checkpoint, handoff, and disk state. |
+| Next action | `/god-next` | Single recommended command with reason. |
+
 ## Process
 
 1. Check if `.godpowers/PROGRESS.md` exists

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: