godpowers 2.3.1 → 2.4.0

package/routing/god-roadmap-update.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-roadmap-update
   description: Update ROADMAP.md after feature work or priority changes
   tier: 1
+  family: maintain
 
 prerequisites:
   required:

package/routing/god-roadmap.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-roadmap
   description: Sequence work into milestones
   tier: 1
+  family: start
 
 prerequisites:
   required:

package/routing/god-rollback.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-rollback
   description: Walk back tier and downstream
   tier: 0
+  family: recover
 
 prerequisites:
   required:

package/routing/god-scan.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-scan
   description: Full reverse-sync of the codebase
   tier: 0
+  family: maintain
 
 prerequisites:
   required: []

package/routing/god-set-profile.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-set-profile
   description: Switch model profile
   tier: 0
+  family: configure
 
 prerequisites:
   required: []

package/routing/god-settings.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-settings
   description: View/modify intent.yaml settings
   tier: 0
+  family: configure
 
 prerequisites:
   required: []

package/routing/god-skip.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-skip
   description: Explicit skip with audit
   tier: 0
+  family: recover
 
 prerequisites:
   required:

package/routing/god-smite.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-smite
   description: Hard-reset dependency cache; reinstall
   tier: 0
+  family: recover
 
 prerequisites:
   required: []

package/routing/god-spike.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-spike
   description: Time-boxed research
   tier: 0
+  family: build
 
 prerequisites:
   required:

package/routing/god-sprint.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-sprint
   description: Sprint plan / status / retro
   tier: 0
+  family: collaborate
 
 prerequisites:
   required:
@@ -16,6 +17,11 @@ execution:
 
 success-path:
   next-recommended: /god-feature or /god-story
+  outcome:
+    type: requires-selection
+    label: User selection required
+    reason: The route offers multiple valid next commands and the user should choose one.
+    allowed-next: [/god-feature, /god-story]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-stack.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-stack
   description: Pick technology stack
   tier: 1
+  family: start
 
 prerequisites:
   required:

package/routing/god-standards.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-standards
   description: Artifact standards check (substitution/three-label/have-nots)
   tier: 0
+  family: verify
 
 prerequisites:
   required: []

package/routing/god-status.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-status
   description: Re-derive state from disk
   tier: 0
+  family: continue
 
 prerequisites:
   required:

package/routing/god-stories.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-stories
   description: List STORY.md files grouped by status
   tier: 0
+  family: build
 
 prerequisites:
   required: []

package/routing/god-story-build.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-story-build
   description: Implement a single story
   tier: 2
+  family: build
 
 prerequisites:
   required:

package/routing/god-story-close.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-story-close
   description: Mark a story done after build+verify
   tier: 2
+  family: build
 
 prerequisites:
   required:

package/routing/god-story-verify.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-story-verify
   description: Run story's acceptance criteria as headless browser tests
   tier: 2
+  family: build
 
 prerequisites:
   required:

package/routing/god-story.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-story
   description: Write new STORY.md (fine-grained slice)
   tier: 1
+  family: build
 
 prerequisites:
   required: []

package/routing/god-suite-init.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-suite-init
   description: Register a multi-repo suite (Mode D)
   tier: 0
+  family: collaborate
 
 prerequisites:
   required: []

package/routing/god-suite-patch.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-suite-patch
   description: Coordinated change across multiple repos
   tier: 0
+  family: collaborate
 
 prerequisites:
   required:

package/routing/god-suite-release.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-suite-release
   description: Coordinate release across suite siblings
   tier: 3
+  family: collaborate
 
 prerequisites:
   required:

package/routing/god-suite-status.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-suite-status
   description: Side-by-side status of all suite repos
   tier: 0
+  family: collaborate
 
 prerequisites:
   required:
@@ -16,6 +17,11 @@ execution:
 
 success-path:
   next-recommended: /god-suite-sync or /god-suite-patch
+  outcome:
+    type: requires-selection
+    label: User selection required
+    reason: The route offers multiple valid next commands and the user should choose one.
+    allowed-next: [/god-suite-sync, /god-suite-patch]
 
 failure-path:
   on-error: /god-doctor

package/routing/god-suite-sync.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-suite-sync
   description: Propagate byte-identical files across suite
   tier: 0
+  family: collaborate
 
 prerequisites:
   required:

package/routing/god-sync.yaml

@@ -4,6 +4,7 @@ metadata:
   command: /god-sync
   description: Sync all affected artifacts after feature work
   tier: 0
+  family: maintain
 
 prerequisites:
   required:

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