claude-code-workflow 6.3.53 → 7.0.0

package/.claude/commands/workflow/session/start.md

@@ -1,203 +1,203 @@
----
-name: start
-description: Discover existing sessions or start new workflow session with intelligent session management and conflict detection
-argument-hint: [--type <workflow|review|tdd|test|docs>] [--auto|--new] [optional: task description for new session]
-examples:
-  - /workflow:session:start
-  - /workflow:session:start --auto "implement OAuth2 authentication"
-  - /workflow:session:start --type review "Code review for auth module"
-  - /workflow:session:start --type tdd --auto "implement user authentication"
-  - /workflow:session:start --type test --new "test payment flow"
----
-
-# Start Workflow Session (/workflow:session:start)
-
-## Overview
-Manages workflow sessions with three operation modes: discovery (manual), auto (intelligent), and force-new.
-
-**Dual Responsibility**:
-1. **Project-level initialization** (first-time only): Creates `.workflow/project-tech.json` for feature registry
-2. **Session-level initialization** (always): Creates session directory structure
-
-## Session Types
-
-The `--type` parameter classifies sessions for CCW dashboard organization:
-
-| Type | Description | Default For |
-|------|-------------|-------------|
-| `workflow` | Standard implementation (default) | `/workflow:plan` |
-| `review` | Code review sessions | `/workflow:review-module-cycle` |
-| `tdd` | TDD-based development | `/workflow:tdd-plan` |
-| `test` | Test generation/fix sessions | `/workflow:test-fix-gen` |
-| `docs` | Documentation sessions | `/memory:docs` |
-
-**Validation**: If `--type` is provided with invalid value, return error:
-```
-ERROR: Invalid session type. Valid types: workflow, review, tdd, test, docs
-```
-
-## Step 0: Initialize Project State (First-time Only)
-
-**Executed before all modes** - Ensures project-level state files exist by calling `/workflow:init`.
-
-### Check and Initialize
-```bash
-# Check if project state exists (both files required)
-bash(test -f .workflow/project-tech.json && echo "TECH_EXISTS" || echo "TECH_NOT_FOUND")
-bash(test -f .workflow/project-guidelines.json && echo "GUIDELINES_EXISTS" || echo "GUIDELINES_NOT_FOUND")
-```
-
-**If either NOT_FOUND**, delegate to `/workflow:init`:
-```javascript
-// Call workflow:init for intelligent project analysis
-SlashCommand({command: "/workflow:init"});
-
-// Wait for init completion
-// project-tech.json and project-guidelines.json will be created
-```
-
-**Output**:
-- If BOTH_EXIST: `PROJECT_STATE: initialized`
-- If NOT_FOUND: Calls `/workflow:init` → creates:
-  - `.workflow/project-tech.json` with full technical analysis
-  - `.workflow/project-guidelines.json` with empty scaffold
-
-**Note**: `/workflow:init` uses cli-explore-agent to build comprehensive project understanding (technology stack, architecture, key components). This step runs once per project. Subsequent executions skip initialization.
-
-## Mode 1: Discovery Mode (Default)
-
-### Usage
-```bash
-/workflow:session:start
-```
-
-### Step 1: List Active Sessions
-```bash
-bash(ls -1 .workflow/active/ 2>/dev/null | head -5)
-```
-
-### Step 2: Display Session Metadata
-```bash
-bash(cat .workflow/active/WFS-promptmaster-platform/workflow-session.json)
-```
-
-### Step 4: User Decision
-Present session information and wait for user to select or create session.
-
-**Output**: `SESSION_ID: WFS-[user-selected-id]`
-
-## Mode 2: Auto Mode (Intelligent)
-
-### Usage
-```bash
-/workflow:session:start --auto "task description"
-```
-
-### Step 1: Check Active Sessions Count
-```bash
-bash(find .workflow/active/ -name "WFS-*" -type d 2>/dev/null | wc -l)
-```
-
-### Step 2a: No Active Sessions → Create New
-```bash
-# Generate session slug
-bash(echo "implement OAuth2 auth" | sed 's/[^a-zA-Z0-9]/-/g' | tr '[:upper:]' '[:lower:]' | cut -c1-50)
-
-# Create directory structure
-bash(mkdir -p .workflow/active/WFS-implement-oauth2-auth/.process)
-bash(mkdir -p .workflow/active/WFS-implement-oauth2-auth/.task)
-bash(mkdir -p .workflow/active/WFS-implement-oauth2-auth/.summaries)
-
-# Create metadata (include type field, default to "workflow" if not specified)
-bash(echo '{"session_id":"WFS-implement-oauth2-auth","project":"implement OAuth2 auth","status":"planning","type":"workflow","created_at":"2024-12-04T08:00:00Z"}' > .workflow/active/WFS-implement-oauth2-auth/workflow-session.json)
-```
-
-**Output**: `SESSION_ID: WFS-implement-oauth2-auth`
-
-### Step 2b: Single Active Session → Check Relevance
-```bash
-# Extract session ID
-bash(find .workflow/active/ -name "WFS-*" -type d 2>/dev/null | head -1 | xargs basename)
-
-# Read project name from metadata
-bash(cat .workflow/active/WFS-promptmaster-platform/workflow-session.json | grep -o '"project":"[^"]*"' | cut -d'"' -f4)
-
-# Check keyword match (manual comparison)
-# If task contains project keywords → Reuse session
-# If task unrelated → Create new session (use Step 2a)
-```
-
-**Output (reuse)**: `SESSION_ID: WFS-promptmaster-platform`
-**Output (new)**: `SESSION_ID: WFS-[new-slug]`
-
-### Step 2c: Multiple Active Sessions → Use First
-```bash
-# Get first active session
-bash(find .workflow/active/ -name "WFS-*" -type d 2>/dev/null | head -1 | xargs basename)
-
-# Output warning and session ID
-# WARNING: Multiple active sessions detected
-# SESSION_ID: WFS-first-session
-```
-
-## Mode 3: Force New Mode
-
-### Usage
-```bash
-/workflow:session:start --new "task description"
-```
-
-### Step 1: Generate Unique Session Slug
-```bash
-# Convert to slug
-bash(echo "fix login bug" | sed 's/[^a-zA-Z0-9]/-/g' | tr '[:upper:]' '[:lower:]' | cut -c1-50)
-
-# Check if exists, add counter if needed
-bash(ls .workflow/active/WFS-fix-login-bug 2>/dev/null && echo "WFS-fix-login-bug-2" || echo "WFS-fix-login-bug")
-```
-
-### Step 2: Create Session Structure
-```bash
-bash(mkdir -p .workflow/active/WFS-fix-login-bug/.process)
-bash(mkdir -p .workflow/active/WFS-fix-login-bug/.task)
-bash(mkdir -p .workflow/active/WFS-fix-login-bug/.summaries)
-```
-
-### Step 3: Create Metadata
-```bash
-# Include type field from --type parameter (default: "workflow")
-bash(echo '{"session_id":"WFS-fix-login-bug","project":"fix login bug","status":"planning","type":"workflow","created_at":"2024-12-04T08:00:00Z"}' > .workflow/active/WFS-fix-login-bug/workflow-session.json)
-```
-
-**Output**: `SESSION_ID: WFS-fix-login-bug`
-
-## Execution Guideline
-
-- **Non-interrupting**: When called from other commands, this command completes and returns control to the caller without interrupting subsequent tasks.
-
-## Output Format Specification
-
-### Success
-```
-SESSION_ID: WFS-session-slug
-```
-
-### Error
-```
-ERROR: --auto mode requires task description
-ERROR: Failed to create session directory
-```
-
-### Analysis (Auto Mode)
-```
-ANALYSIS: Task relevance = high
-DECISION: Reusing existing session
-SESSION_ID: WFS-promptmaster-platform
-```
-
-
-## Session ID Format
-- Pattern: `WFS-[lowercase-slug]`
-- Characters: `a-z`, `0-9`, `-` only
-- Max length: 50 characters
+---
+name: start
+description: Discover existing sessions or start new workflow session with intelligent session management and conflict detection
+argument-hint: [--type <workflow|review|tdd|test|docs>] [--auto|--new] [optional: task description for new session]
+examples:
+  - /workflow:session:start
+  - /workflow:session:start --auto "implement OAuth2 authentication"
+  - /workflow:session:start --type review "Code review for auth module"
+  - /workflow:session:start --type tdd --auto "implement user authentication"
+  - /workflow:session:start --type test --new "test payment flow"
+---
+
+# Start Workflow Session (/workflow:session:start)
+
+## Overview
+Manages workflow sessions with three operation modes: discovery (manual), auto (intelligent), and force-new.
+
+**Dual Responsibility**:
+1. **Project-level initialization** (first-time only): Creates `.workflow/project-tech.json` for feature registry
+2. **Session-level initialization** (always): Creates session directory structure
+
+## Session Types
+
+The `--type` parameter classifies sessions for CCW dashboard organization:
+
+| Type | Description | Default For |
+|------|-------------|-------------|
+| `workflow` | Standard implementation (default) | `workflow-plan` skill |
+| `review` | Code review sessions | `review-cycle` skill |
+| `tdd` | TDD-based development | `workflow-tdd` skill |
+| `test` | Test generation/fix sessions | `workflow-test-fix` skill |
+| `docs` | Documentation sessions | `memory-manage` skill |
+
+**Validation**: If `--type` is provided with invalid value, return error:
+```
+ERROR: Invalid session type. Valid types: workflow, review, tdd, test, docs
+```
+
+## Step 0: Initialize Project State (First-time Only)
+
+**Executed before all modes** - Ensures project-level state files exist by calling `/workflow:init`.
+
+### Check and Initialize
+```bash
+# Check if project state exists (both files required)
+bash(test -f .workflow/project-tech.json && echo "TECH_EXISTS" || echo "TECH_NOT_FOUND")
+bash(test -f .workflow/specs/*.md && echo "GUIDELINES_EXISTS" || echo "GUIDELINES_NOT_FOUND")
+```
+
+**If either NOT_FOUND**, delegate to `/workflow:init`:
+```javascript
+// Call workflow:init for intelligent project analysis
+Skill(skill="workflow:init");
+
+// Wait for init completion
+// project-tech.json and specs/*.md will be created
+```
+
+**Output**:
+- If BOTH_EXIST: `PROJECT_STATE: initialized`
+- If NOT_FOUND: Calls `/workflow:init` → creates:
+  - `.workflow/project-tech.json` with full technical analysis
+  - `.workflow/specs/*.md` with empty scaffold
+
+**Note**: `/workflow:init` uses cli-explore-agent to build comprehensive project understanding (technology stack, architecture, key components). This step runs once per project. Subsequent executions skip initialization.
+
+## Mode 1: Discovery Mode (Default)
+
+### Usage
+```bash
+/workflow:session:start
+```
+
+### Step 1: List Active Sessions
+```bash
+bash(ls -1 .workflow/active/ 2>/dev/null | head -5)
+```
+
+### Step 2: Display Session Metadata
+```bash
+bash(cat .workflow/active/WFS-promptmaster-platform/workflow-session.json)
+```
+
+### Step 4: User Decision
+Present session information and wait for user to select or create session.
+
+**Output**: `SESSION_ID: WFS-[user-selected-id]`
+
+## Mode 2: Auto Mode (Intelligent)
+
+### Usage
+```bash
+/workflow:session:start --auto "task description"
+```
+
+### Step 1: Check Active Sessions Count
+```bash
+bash(find .workflow/active/ -name "WFS-*" -type d 2>/dev/null | wc -l)
+```
+
+### Step 2a: No Active Sessions → Create New
+```bash
+# Generate session slug
+bash(echo "implement OAuth2 auth" | sed 's/[^a-zA-Z0-9]/-/g' | tr '[:upper:]' '[:lower:]' | cut -c1-50)
+
+# Create directory structure
+bash(mkdir -p .workflow/active/WFS-implement-oauth2-auth/.process)
+bash(mkdir -p .workflow/active/WFS-implement-oauth2-auth/.task)
+bash(mkdir -p .workflow/active/WFS-implement-oauth2-auth/.summaries)
+
+# Create metadata (include type field, default to "workflow" if not specified)
+bash(echo '{"session_id":"WFS-implement-oauth2-auth","project":"implement OAuth2 auth","status":"planning","type":"workflow","created_at":"2024-12-04T08:00:00Z"}' > .workflow/active/WFS-implement-oauth2-auth/workflow-session.json)
+```
+
+**Output**: `SESSION_ID: WFS-implement-oauth2-auth`
+
+### Step 2b: Single Active Session → Check Relevance
+```bash
+# Extract session ID
+bash(find .workflow/active/ -name "WFS-*" -type d 2>/dev/null | head -1 | xargs basename)
+
+# Read project name from metadata
+bash(cat .workflow/active/WFS-promptmaster-platform/workflow-session.json | grep -o '"project":"[^"]*"' | cut -d'"' -f4)
+
+# Check keyword match (manual comparison)
+# If task contains project keywords → Reuse session
+# If task unrelated → Create new session (use Step 2a)
+```
+
+**Output (reuse)**: `SESSION_ID: WFS-promptmaster-platform`
+**Output (new)**: `SESSION_ID: WFS-[new-slug]`
+
+### Step 2c: Multiple Active Sessions → Use First
+```bash
+# Get first active session
+bash(find .workflow/active/ -name "WFS-*" -type d 2>/dev/null | head -1 | xargs basename)
+
+# Output warning and session ID
+# WARNING: Multiple active sessions detected
+# SESSION_ID: WFS-first-session
+```
+
+## Mode 3: Force New Mode
+
+### Usage
+```bash
+/workflow:session:start --new "task description"
+```
+
+### Step 1: Generate Unique Session Slug
+```bash
+# Convert to slug
+bash(echo "fix login bug" | sed 's/[^a-zA-Z0-9]/-/g' | tr '[:upper:]' '[:lower:]' | cut -c1-50)
+
+# Check if exists, add counter if needed
+bash(ls .workflow/active/WFS-fix-login-bug 2>/dev/null && echo "WFS-fix-login-bug-2" || echo "WFS-fix-login-bug")
+```
+
+### Step 2: Create Session Structure
+```bash
+bash(mkdir -p .workflow/active/WFS-fix-login-bug/.process)
+bash(mkdir -p .workflow/active/WFS-fix-login-bug/.task)
+bash(mkdir -p .workflow/active/WFS-fix-login-bug/.summaries)
+```
+
+### Step 3: Create Metadata
+```bash
+# Include type field from --type parameter (default: "workflow")
+bash(echo '{"session_id":"WFS-fix-login-bug","project":"fix login bug","status":"planning","type":"workflow","created_at":"2024-12-04T08:00:00Z"}' > .workflow/active/WFS-fix-login-bug/workflow-session.json)
+```
+
+**Output**: `SESSION_ID: WFS-fix-login-bug`
+
+## Execution Guideline
+
+- **Non-interrupting**: When called from other commands, this command completes and returns control to the caller without interrupting subsequent tasks.
+
+## Output Format Specification
+
+### Success
+```
+SESSION_ID: WFS-session-slug
+```
+
+### Error
+```
+ERROR: --auto mode requires task description
+ERROR: Failed to create session directory
+```
+
+### Analysis (Auto Mode)
+```
+ANALYSIS: Task relevance = high
+DECISION: Reusing existing session
+SESSION_ID: WFS-promptmaster-platform
+```
+
+
+## Session ID Format
+- Pattern: `WFS-[lowercase-slug]`
+- Characters: `a-z`, `0-9`, `-` only
+- Max length: 50 characters
 - Uniqueness: Add numeric suffix if collision (`WFS-auth-2`, `WFS-auth-3`)

package/.claude/commands/workflow/session/sync.md

@@ -0,0 +1,201 @@
+---
+name: sync
+description: Quick-sync session work to specs/*.md and project-tech
+argument-hint: "[-y|--yes] [\"what was done\"]"
+allowed-tools: Bash(*), Read(*), Write(*), Edit(*)
+---
+
+# Session Sync (/workflow:session:sync)
+
+One-shot update `specs/*.md` + `project-tech.json` from current session context.
+
+**Design**: Scan context → extract → write. No interactive wizards.
+
+## Auto Mode
+
+`--yes` or `-y`: Skip confirmation, auto-write both files.
+
+## Process
+
+```
+Step 1: Gather Context
+   ├─ git diff --stat HEAD~3..HEAD (recent changes)
+   ├─ Active session folder (.workflow/.lite-plan/*) if exists
+   └─ User summary ($ARGUMENTS or auto-generate from git log)
+
+Step 2: Extract Updates
+   ├─ Guidelines: conventions / constraints / learnings
+   └─ Tech: development_index entry
+
+Step 3: Preview & Confirm (skip if --yes)
+
+Step 4: Write both files
+
+Step 5: One-line confirmation
+```
+
+## Step 1: Gather Context
+
+```javascript
+const autoYes = $ARGUMENTS.includes('--yes') || $ARGUMENTS.includes('-y')
+const userSummary = $ARGUMENTS.replace(/--yes|-y/g, '').trim()
+
+// Recent changes
+const gitStat = Bash('git diff --stat HEAD~3..HEAD 2>/dev/null || git diff --stat HEAD 2>/dev/null')
+const gitLog = Bash('git log --oneline -5')
+
+// Active session (optional)
+const sessionFolders = Glob('.workflow/.lite-plan/*/plan.json')
+let sessionContext = null
+if (sessionFolders.length > 0) {
+  const latest = sessionFolders[sessionFolders.length - 1]
+  sessionContext = JSON.parse(Read(latest))
+}
+
+// Build summary
+const summary = userSummary
+  || sessionContext?.summary
+  || gitLog.split('\n')[0].replace(/^[a-f0-9]+ /, '')
+```
+
+## Step 2: Extract Updates
+
+Analyze context and produce two update payloads. Use LLM reasoning (current agent) — no CLI calls.
+
+```javascript
+// ── Guidelines extraction ──
+// Scan git diff + session for:
+//   - New patterns adopted → convention
+//   - Restrictions discovered → constraint
+//   - Surprises / gotchas → learning
+//
+// Output: array of { type, category, text }
+// RULE: Only extract genuinely reusable insights. Skip trivial/obvious items.
+// RULE: Deduplicate against existing guidelines before adding.
+
+// Load existing specs via ccw spec load
+const existingSpecs = Bash('ccw spec load --dimension specs 2>/dev/null || echo ""')
+const guidelineUpdates = [] // populated by agent analysis
+
+// ── Tech extraction ──
+// Build one development_index entry from session work
+
+function detectCategory(text) {
+  text = text.toLowerCase()
+  if (/\b(fix|bug|error|crash)\b/.test(text)) return 'bugfix'
+  if (/\b(refactor|cleanup|reorganize)\b/.test(text)) return 'refactor'
+  if (/\b(doc|readme|comment)\b/.test(text)) return 'docs'
+  if (/\b(add|new|create|implement)\b/.test(text)) return 'feature'
+  return 'enhancement'
+}
+
+function detectSubFeature(gitStat) {
+  // Most-changed directory from git diff --stat
+  const dirs = gitStat.match(/\S+\//g) || []
+  const counts = {}
+  dirs.forEach(d => {
+    const seg = d.split('/').filter(Boolean).slice(-2, -1)[0] || 'general'
+    counts[seg] = (counts[seg] || 0) + 1
+  })
+  return Object.entries(counts).sort((a, b) => b[1] - a[1])[0]?.[0] || 'general'
+}
+
+const techEntry = {
+  title: summary.slice(0, 60),
+  sub_feature: detectSubFeature(gitStat),
+  date: new Date().toISOString().split('T')[0],
+  description: summary.slice(0, 100),
+  status: 'completed',
+  session_id: sessionContext ? sessionFolders[sessionFolders.length - 1].match(/lite-plan\/([^/]+)/)?.[1] : null
+}
+```
+
+## Step 3: Preview & Confirm
+
+```javascript
+// Show preview
+console.log(`
+── Sync Preview ──
+
+Guidelines (${guidelineUpdates.length} items):
+${guidelineUpdates.map(g => `  [${g.type}/${g.category}] ${g.text}`).join('\n') || '  (none)'}
+
+Tech [${detectCategory(summary)}]:
+  ${techEntry.title}
+
+Target files:
+  .workflow/specs/*.md
+  .workflow/project-tech.json
+`)
+
+if (!autoYes) {
+  const confirm = AskUserQuestion("Apply these updates? (modify/skip items if needed)")
+  // User can say "skip guidelines" or "change category to bugfix" etc.
+}
+```
+
+## Step 4: Write
+
+```javascript
+// ── Update specs/*.md ──
+if (guidelineUpdates.length > 0) {
+  // Map guideline types to spec files
+  const specFileMap = {
+    convention: '.workflow/specs/coding-conventions.md',
+    constraint: '.workflow/specs/architecture-constraints.md',
+    learning: '.workflow/specs/coding-conventions.md' // learnings appended to conventions
+  }
+
+  for (const g of guidelineUpdates) {
+    const targetFile = specFileMap[g.type]
+    const existing = Read(targetFile)
+    const ruleText = g.type === 'learning'
+      ? `- [${g.category}] ${g.text} (learned: ${new Date().toISOString().split('T')[0]})`
+      : `- [${g.category}] ${g.text}`
+
+    // Deduplicate: skip if text already in file
+    if (!existing.includes(g.text)) {
+      const newContent = existing.trimEnd() + '\n' + ruleText + '\n'
+      Write(targetFile, newContent)
+    }
+  }
+
+  // Rebuild spec index after writing
+  Bash('ccw spec rebuild')
+}
+
+// ── Update project-tech.json ──
+const techPath = '.workflow/project-tech.json'
+const tech = JSON.parse(Read(techPath))
+
+if (!tech.development_index) {
+  tech.development_index = { feature: [], enhancement: [], bugfix: [], refactor: [], docs: [] }
+}
+
+const category = detectCategory(summary)
+tech.development_index[category].push(techEntry)
+tech._metadata.last_updated = new Date().toISOString()
+
+Write(techPath, JSON.stringify(tech, null, 2))
+```
+
+## Step 5: Confirm
+
+```
+✓ Synced: ${guidelineUpdates.length} guidelines + 1 tech entry [${category}]
+```
+
+## Error Handling
+
+| Error | Resolution |
+|-------|------------|
+| File missing | Create scaffold (same as solidify Step 1) |
+| No git history | Use user summary or session context only |
+| No meaningful updates | Skip guidelines, still add tech entry |
+| Duplicate entry | Skip silently (dedup check in Step 4) |
+
+## Related Commands
+
+- `/workflow:init` - Initialize project with specs scaffold
+- `/workflow:init-specs` - Interactive wizard to create individual specs with scope selection
+- `/workflow:session:solidify` - Add individual rules one at a time