claude-code-workflow 7.2.30 → 7.3.0

package/.claude/skills/ccw-chain/chains/ccw-team.json

@@ -2,9 +2,14 @@
   "chain_id": "ccw-team",
   "name": "CCW Team Workflows",
   "description": "Team workflow: team-planex planner + executor wave pipeline",
-  "version": "2.0",
+  "version": "2.1",
   "entry": "S1",
+  "triggers": {
+    "task_types": ["team-planex"],
+    "keywords": ["team.*plan.*exec|team.*planex|wave.*pipeline"],
+    "scope": "Team: planner + executor wave pipeline"
+  },
   "nodes": {
-    "S1": { "type": "step", "name": "Team: team-planex", "content_ref": "@phases/team-planex.md", "next": null }
+    "S1": { "type": "step", "name": "Team: team-planex", "content_ref": "@skills/team-planex/SKILL.md", "next": null }
   }
 }

package/.claude/skills/ccw-chain/chains/ccw-with-file.json

@@ -2,8 +2,21 @@
   "chain_id": "ccw-with-file",
   "name": "CCW With-File Workflows",
   "description": "With-File workflow routing: documented exploration with auto-chain to downstream skills",
-  "version": "2.0",
+  "version": "2.2",
   "entry": "D1",
+  "entries": [
+    { "name": "default", "node": "D1", "description": "Select flow via decision node" },
+    { "name": "analyze", "node": "S_AP1", "description": "Direct: Analyze → Plan flow" },
+    { "name": "debug", "node": "S_DB1", "description": "Direct: Debug flow (standalone)" },
+    { "name": "collab-plan", "node": "S_CP1", "description": "Direct: Collaborative Plan → Execute" },
+    { "name": "roadmap", "node": "S_RM1", "description": "Direct: Roadmap → Team flow" },
+    { "name": "investigate", "node": "S_INV1", "description": "Direct: Systematic investigation with Iron Law gate" }
+  ],
+  "triggers": {
+    "task_types": ["analyze-file", "debug-file", "collaborative-plan", "roadmap"],
+    "keywords": ["analyze.*document|collaborative analysis", "hypothesis.*debug|systematic debug|investigate", "collaborative.*plan|multi.*agent.*plan", "roadmap"],
+    "scope": "With-File: documented exploration with auto-chain to downstream skills"
+  },
   "nodes": {
     "D1": {
       "type": "decision",
@@ -13,19 +26,22 @@
         { "label": "Analyze → Plan", "description": "analyze-with-file → lite-plan", "next": "S_AP1" },
         { "label": "Debug", "description": "debug-with-file (standalone)", "next": "S_DB1" },
         { "label": "Collaborative Plan", "description": "collaborative-plan → unified-execute", "next": "S_CP1" },
-        { "label": "Roadmap → Team", "description": "roadmap-with-file → team-planex", "next": "S_RM1" }
+        { "label": "Roadmap → Team", "description": "roadmap-with-file → team-planex", "next": "S_RM1" },
+        { "label": "Investigate", "description": "Systematic investigation with Iron Law gate", "next": "S_INV1" }
       ],
       "default": "S_AP1"
     },
-    "S_AP1": { "type": "step", "name": "Analyze: analyze-with-file", "content_ref": "@phases/analyze-with-file.md", "next": "S_AP2" },
-    "S_AP2": { "type": "step", "name": "Analyze: workflow-lite-plan", "content_ref": "@phases/workflow-lite-plan.md", "next": null },
+    "S_AP1": { "type": "step", "name": "Analyze: analyze-with-file", "content_ref": "@commands/workflow/analyze-with-file.md", "next": "S_AP2" },
+    "S_AP2": { "type": "step", "name": "Analyze: workflow-lite-plan", "content_ref": "@skills/workflow-lite-plan/SKILL.md", "next": null },
 
-    "S_DB1": { "type": "step", "name": "Debug: debug-with-file", "content_ref": "@phases/debug-with-file.md", "next": null },
+    "S_DB1": { "type": "step", "name": "Debug: debug-with-file", "content_ref": "@commands/workflow/debug-with-file.md", "next": null },
 
-    "S_CP1": { "type": "step", "name": "Collab: collaborative-plan-with-file", "content_ref": "@phases/collaborative-plan-with-file.md", "next": "S_CP2" },
-    "S_CP2": { "type": "step", "name": "Collab: unified-execute-with-file", "content_ref": "@phases/unified-execute-with-file.md", "next": null },
+    "S_CP1": { "type": "step", "name": "Collab: collaborative-plan-with-file", "content_ref": "@commands/workflow/collaborative-plan-with-file.md", "next": "S_CP2" },
+    "S_CP2": { "type": "step", "name": "Collab: unified-execute-with-file", "content_ref": "@commands/workflow/unified-execute-with-file.md", "next": null },
 
-    "S_RM1": { "type": "step", "name": "Roadmap: roadmap-with-file", "content_ref": "@phases/roadmap-with-file.md", "next": "S_RM2" },
-    "S_RM2": { "type": "step", "name": "Roadmap: team-planex", "content_ref": "@phases/team-planex.md", "next": null }
+    "S_RM1": { "type": "step", "name": "Roadmap: roadmap-with-file", "content_ref": "@commands/workflow/roadmap-with-file.md", "next": "S_RM2" },
+    "S_RM2": { "type": "step", "name": "Roadmap: team-planex", "content_ref": "@skills/team-planex/SKILL.md", "next": null },
+
+    "S_INV1": { "type": "delegate", "name": "Investigate: ccw-investigate", "chain": "ccw-investigate", "pass_variables": ["goal", "auto_yes"], "receive_variables": ["root_cause", "confidence"], "next": null }
   }
 }

package/.claude/skills/chain-loader/phases/01-analyze-skill.md

@@ -1,53 +1,53 @@
-# Phase 1: Analyze Target Skill
-
-Understand the target skill's workflow to identify nodes, decision points, and content files.
-
-## Step 1.1: Identify Target
-
-Determine if adding chains to an existing skill or creating new:
-
-**Existing skill**: Read its SKILL.md and list its phases/ directory
-```bash
-# Find the skill
-ls .claude/skills/{skill-name}/SKILL.md
-ls .claude/skills/{skill-name}/phases/
-```
-
-**New skill**: Collect requirements from user — what workflow steps, what branches, what content.
-
-## Step 1.2: Map Workflow Steps
-
-For existing skills, read each phase file and identify:
-
-1. **Sequential steps** — each phase becomes a StepNode with `content_ref: "@phases/{file}"`
-2. **Decision points** — look for conditional language ("if...", "based on...", "choose...") that implies branching
-3. **Sub-workflows** — sections that reference other skills or could be extracted as separate chains
-
-For new skills, work with the user to define:
-- What are the execution steps?
-- Where does the LLM need to make a routing decision?
-- What content should each step load?
-
-## Step 1.3: Inventory Content Files
-
-List all files that chain nodes will reference:
-
-| Type | Source | content_ref Format |
-|------|--------|--------------------|
-| Phase files | `phases/01-xxx.md` | `@phases/01-xxx.md` |
-| Skill subdirs | `phases/workflow-plan/SKILL.md` | `@phases/workflow-plan/SKILL.md` |
-| Commands | `.claude/commands/workflow/xxx.md` | Copy to phases/ first, then `@phases/xxx.md` |
-| Inline content | Short instructions (<200 chars) | Use `content_inline` instead |
-
-**Key lesson from ccw-chain**: phases/ should contain **actual command/skill documents** that the LLM executes, not orchestration pseudocode.
-
-## Output
-
-- Skill name and directory path
-- List of workflow steps with their content file mappings
-- Identified decision points with branch options
-- List of content files that need to be created or copied
-
-## Next Phase
-
-Proceed to [Phase 2: Design Node Graph](02-design-graph.md).
+# Phase 1: Analyze Target Skill
+
+Understand the target skill's workflow to identify nodes, decision points, and content files.
+
+## Step 1.1: Identify Target
+
+Determine if adding chains to an existing skill or creating new:
+
+**Existing skill**: Read its SKILL.md and list its phases/ directory
+```bash
+# Find the skill
+ls .claude/skills/{skill-name}/SKILL.md
+ls .claude/skills/{skill-name}/phases/
+```
+
+**New skill**: Collect requirements from user — what workflow steps, what branches, what content.
+
+## Step 1.2: Map Workflow Steps
+
+For existing skills, read each phase file and identify:
+
+1. **Sequential steps** — each phase becomes a StepNode with `content_ref: "@phases/{file}"`
+2. **Decision points** — look for conditional language ("if...", "based on...", "choose...") that implies branching
+3. **Sub-workflows** — sections that reference other skills or could be extracted as separate chains
+
+For new skills, work with the user to define:
+- What are the execution steps?
+- Where does the LLM need to make a routing decision?
+- What content should each step load?
+
+## Step 1.3: Inventory Content Files
+
+List all files that chain nodes will reference:
+
+| Type | Source | content_ref Format |
+|------|--------|--------------------|
+| Phase files | `phases/01-xxx.md` | `@phases/01-xxx.md` |
+| Skill subdirs | `phases/workflow-plan/SKILL.md` | `@skills/workflow-plan/SKILL.md` |
+| Commands | `.claude/commands/workflow/xxx.md` | Copy to phases/ first, then `@phases/xxx.md` |
+| Inline content | Short instructions (<200 chars) | Use `content_inline` instead |
+
+**Key lesson from ccw-chain**: phases/ should contain **actual command/skill documents** that the LLM executes, not orchestration pseudocode.
+
+## Output
+
+- Skill name and directory path
+- List of workflow steps with their content file mappings
+- Identified decision points with branch options
+- List of content files that need to be created or copied
+
+## Next Phase
+
+Proceed to [Phase 2: Design Node Graph](02-design-graph.md).

package/.claude/skills/chain-loader/specs/chain-schema.md

@@ -12,9 +12,35 @@ Files live at `.claude/skills/{skill}/chains/{chain-name}.json`.
 | `name` | string | Human-readable name |
 | `description` | string | What this chain does |
 | `version` | string | Semantic version |
-| `entry` | string | Node ID of entry point (must exist in nodes) |
+| `entry` | string? | Node ID of single entry point (backward compat) |
+| `entries` | array? | Multiple named entry points (preferred over `entry`) |
+| `triggers` | object? | Self-describing trigger conditions |
 | `nodes` | object | Map of node ID to node definition |
 
+### Entries (multiple entry points)
+
+```json
+"entries": [
+  { "name": "default", "node": "D1", "description": "Select flow via decision" },
+  { "name": "bugfix", "node": "S_B1", "description": "Direct: Bugfix flow" }
+]
+```
+- First entry is the default when no `entry_name` or `node` specified in `start`
+- Resolution priority: explicit `node` > `entry_name` lookup > `entries[0]` > `entry`
+
+### Triggers (self-describing)
+
+```json
+"triggers": {
+  "task_types": ["bugfix", "bugfix-hotfix", "quick-task"],
+  "keywords": ["fix|bug|error", "urgent|production"],
+  "scope": "Level 2: rapid, bugfix, hotfix, docs"
+}
+```
+- `task_types`: array of task_type values this chain handles
+- `keywords`: array of regex patterns for intent matching
+- `scope`: human-readable description of when to use this chain
+
 ### StepNode
 
 ```json
@@ -90,8 +116,9 @@ pending → active → completed
 
 | cmd | Params | Description |
 |-----|--------|-------------|
-| `list` | `skill?` | List chains (auto-detects skill from cwd) |
-| `start` | `chain`, `skill?` | Create session, load entry node |
+| `list` | `skill?` | List chains with triggers/entries |
+| `inspect` | `chain`, `skill?` | Show chain node graph and entries |
+| `start` | `chain`, `skill?`, `node?`, `entry_name?` | Create session from entry, named entry, or any node |
 | `next` | `session_id` | Read current node (idempotent if active) |
 | `done` | `session_id`, `choice?` | Complete current node, advance |
 | `status` | `session_id` | Query session state |

package/.claude/skills/chain-loader/templates/chain-json.md

@@ -1,63 +1,63 @@
-# Chain JSON Template
-
-## Minimal Linear Chain
-
-```json
-{
-  "chain_id": "my-workflow",
-  "name": "My Workflow",
-  "description": "Sequential 3-step workflow",
-  "version": "1.0",
-  "entry": "S1",
-  "nodes": {
-    "S1": { "type": "step", "name": "Step 1", "content_ref": "@phases/01-step.md", "next": "S2" },
-    "S2": { "type": "step", "name": "Step 2", "content_ref": "@phases/02-step.md", "next": "S3" },
-    "S3": { "type": "step", "name": "Step 3", "content_ref": "@phases/03-step.md", "next": null }
-  }
-}
-```
-
-## Decision Router (from ccw-chain/ccw-lightweight)
-
-```json
-{
-  "chain_id": "ccw-lightweight",
-  "name": "CCW Lightweight Workflows",
-  "description": "Level 2: rapid, bugfix, hotfix, docs-only",
-  "version": "2.0",
-  "entry": "D1",
-  "nodes": {
-    "D1": {
-      "type": "decision",
-      "name": "Select Lightweight Flow",
-      "prompt": "Based on the detected task_type, select the flow:\n1. Rapid\n2. Bugfix\n3. Hotfix\n4. Docs",
-      "choices": [
-        { "label": "Rapid", "description": "lite-plan + test-fix", "next": "S_R1" },
-        { "label": "Bugfix", "description": "lite-plan(--bugfix) + test-fix", "next": "S_B1" },
-        { "label": "Hotfix", "description": "lite-plan(--hotfix)", "next": "S_H1" },
-        { "label": "Docs", "description": "lite-plan(--docs)", "next": "S_D1" }
-      ],
-      "default": "S_R1"
-    },
-    "S_R1": { "type": "step", "name": "Rapid: workflow-lite-plan", "content_ref": "@phases/workflow-lite-plan.md", "next": "S_R2" },
-    "S_R2": { "type": "step", "name": "Rapid: workflow-test-fix", "content_ref": "@phases/workflow-test-fix/SKILL.md", "next": null },
-    "S_B1": { "type": "step", "name": "Bugfix: workflow-lite-plan", "content_ref": "@phases/workflow-lite-plan.md", "next": "S_B2" },
-    "S_B2": { "type": "step", "name": "Bugfix: workflow-test-fix", "content_ref": "@phases/workflow-test-fix/SKILL.md", "next": null },
-    "S_H1": { "type": "step", "name": "Hotfix: workflow-lite-plan", "content_ref": "@phases/workflow-lite-plan.md", "next": null },
-    "S_D1": { "type": "step", "name": "Docs: workflow-lite-plan", "content_ref": "@phases/workflow-lite-plan.md", "next": null }
-  }
-}
-```
-
-## Cross-Chain Routing (from ccw-chain/ccw-main)
-
-Decision choice with `"next": "->ccw-lightweight"` jumps to another chain's entry node.
-
-## Node ID Conventions
-
-| Prefix | Type | Example |
-|--------|------|---------|
-| `S{n}` | Sequential step | S1, S2, S3 |
-| `S_{prefix}{n}` | Flow-scoped step | S_R1, S_B1, S_CP2 |
-| `D{n}` | Decision | D1, D2 |
-| `DEL{n}` | Delegate | DEL1 |
+# Chain JSON Template
+
+## Minimal Linear Chain
+
+```json
+{
+  "chain_id": "my-workflow",
+  "name": "My Workflow",
+  "description": "Sequential 3-step workflow",
+  "version": "1.0",
+  "entry": "S1",
+  "nodes": {
+    "S1": { "type": "step", "name": "Step 1", "content_ref": "@phases/01-step.md", "next": "S2" },
+    "S2": { "type": "step", "name": "Step 2", "content_ref": "@phases/02-step.md", "next": "S3" },
+    "S3": { "type": "step", "name": "Step 3", "content_ref": "@phases/03-step.md", "next": null }
+  }
+}
+```
+
+## Decision Router (from ccw-chain/ccw-lightweight)
+
+```json
+{
+  "chain_id": "ccw-lightweight",
+  "name": "CCW Lightweight Workflows",
+  "description": "Level 2: rapid, bugfix, hotfix, docs-only",
+  "version": "2.0",
+  "entry": "D1",
+  "nodes": {
+    "D1": {
+      "type": "decision",
+      "name": "Select Lightweight Flow",
+      "prompt": "Based on the detected task_type, select the flow:\n1. Rapid\n2. Bugfix\n3. Hotfix\n4. Docs",
+      "choices": [
+        { "label": "Rapid", "description": "lite-plan + test-fix", "next": "S_R1" },
+        { "label": "Bugfix", "description": "lite-plan(--bugfix) + test-fix", "next": "S_B1" },
+        { "label": "Hotfix", "description": "lite-plan(--hotfix)", "next": "S_H1" },
+        { "label": "Docs", "description": "lite-plan(--docs)", "next": "S_D1" }
+      ],
+      "default": "S_R1"
+    },
+    "S_R1": { "type": "step", "name": "Rapid: workflow-lite-plan", "content_ref": "@phases/workflow-lite-plan.md", "next": "S_R2" },
+    "S_R2": { "type": "step", "name": "Rapid: workflow-test-fix", "content_ref": "@skills/workflow-test-fix/SKILL.md", "next": null },
+    "S_B1": { "type": "step", "name": "Bugfix: workflow-lite-plan", "content_ref": "@phases/workflow-lite-plan.md", "next": "S_B2" },
+    "S_B2": { "type": "step", "name": "Bugfix: workflow-test-fix", "content_ref": "@skills/workflow-test-fix/SKILL.md", "next": null },
+    "S_H1": { "type": "step", "name": "Hotfix: workflow-lite-plan", "content_ref": "@phases/workflow-lite-plan.md", "next": null },
+    "S_D1": { "type": "step", "name": "Docs: workflow-lite-plan", "content_ref": "@phases/workflow-lite-plan.md", "next": null }
+  }
+}
+```
+
+## Cross-Chain Routing (from ccw-chain/ccw-main)
+
+Decision choice with `"next": "->ccw-lightweight"` jumps to another chain's entry node.
+
+## Node ID Conventions
+
+| Prefix | Type | Example |
+|--------|------|---------|
+| `S{n}` | Sequential step | S1, S2, S3 |
+| `S_{prefix}{n}` | Flow-scoped step | S_R1, S_B1, S_CP2 |
+| `D{n}` | Decision | D1, D2 |
+| `DEL{n}` | Delegate | DEL1 |

package/.claude/skills/workflow-plan/SKILL.md

@@ -377,6 +377,7 @@ See phase files for detailed update code.
 - Initialize TodoWrite before any command (Phase 3 added dynamically after Phase 2)
 - Execute Phase 1 immediately with structured description
 - Parse session ID from Phase 1 output, store in memory
+- **Session Integrity**: If reusing existing session, verify `sessionIntegrity` from Step 1.2.5; log warnings for incomplete brainstorm artifacts
 - Pass session ID and structured description to Phase 2 command
 - Parse context path from Phase 2 output, store in memory
 - **Extract conflictRisk from context-package.json**: Determine Phase 3 execution

package/.claude/skills/workflow-plan/phases/01-session-discovery.md

@@ -40,11 +40,28 @@ CONTEXT: Existing user database schema, REST API endpoints
 
 **Note**: Session directory contains `workflow-session.json` (metadata). Do NOT look for `manifest.json` here - it only exists in `.workflow/archives/` for archived sessions.
 
+### Step 1.2.5: Session Integrity Check
+
+For reused sessions (not newly created), validate key artifact completeness:
+
+1. **Baseline**: `workflow-session.json` exists and is valid JSON; `.process/` and `.task/` directories exist (create if missing)
+2. **Brainstorm inheritance**: If `.brainstorming/` directory exists, check:
+   - `guidance-specification.md` exists → missing = WARN brainstorm Phase 2 incomplete
+   - `*/analysis.md` count → 0 = WARN brainstorm Phase 3 incomplete
+   - `feature-specs/` or `feature-index.json` → missing = WARN brainstorm Phase 4 (synthesis) incomplete
+3. **Existing notes detection**: Store `existingNotes = file_exists(planning-notes.md)`
+
+Store results in `sessionIntegrity` variable for downstream phases. Warnings are logged but **do not block** execution.
+
 **TodoWrite**: Mark phase 1 completed, phase 2 in_progress
 
-### Step 1.3: Initialize Planning Notes
+### Step 1.3: Initialize Planning Notes (Conditional)
+
+After Phase 1, initialize planning-notes.md with user intent.
 
-After Phase 1, initialize planning-notes.md with user intent:
+**Conditional logic**:
+- If `existingNotes = true`: Only append `## User Intent (Phase 1)` section when missing from the file; do NOT overwrite existing content
+- If `existingNotes = false`: Create new file using template below
 
 ```javascript
 // Create planning notes document with N+1 context support

package/.claude/skills/workflow-plan/phases/02-context-gathering.md

@@ -33,10 +33,10 @@ if (file_exists(contextPackagePath)) {
     console.log("Valid context-package found for session:", sessionId);
     console.log("Stats:", existing.statistics);
     console.log("Conflict Risk:", existing.conflict_detection.risk_level);
-    // Skip execution, store variables and proceed to Step 2.5
+    // Skip Steps 2.2-2.4, but STILL execute Step 2.5 (planning-notes update)
     contextPath = contextPackagePath;
     conflictRisk = existing.conflict_detection.risk_level;
-    return; // Early exit - skip Steps 2.2-2.4
+    // → Jump to Step 2.5 (do NOT return before updating planning-notes)
   }
 }
 ```

package/.claude/skills/workflow-plan/phases/04-task-generation.md

@@ -212,7 +212,15 @@ If prioritized_context is incomplete, fall back to exploration_results:
 - Reference aggregated_insights.all_patterns for implementation approach
 - Use aggregated_insights.all_integration_points for precise modification locations
 
-## FEATURE SPECIFICATIONS (conditional)
+## BRAINSTORM ARTIFACT VALIDATION (before feature spec loading)
+If .brainstorming/ directory exists in session, verify completeness:
+- guidance-specification.md missing → WARN: brainstorm Phase 2 incomplete, planning proceeds without framework
+- */analysis.md count = 0 → WARN: brainstorm Phase 3 incomplete, no role analyses available
+- feature-specs/ AND feature-index.json both missing → WARN: brainstorm Phase 4 incomplete, skip feature specs
+
+Log warnings to console. Populate agent prompt FEATURE SPECIFICATIONS section only when artifacts actually exist.
+
+## FEATURE SPECIFICATIONS (conditional — only when validated above)
 If context-package has brainstorm_artifacts.feature_index_path:
   Feature Index: [from context-package]
   Feature Spec Dir: [from context-package]