From 21d764127f785ea1e7474df679295bcd307bff40 Mon Sep 17 00:00:00 2001 From: catlog22 Date: Thu, 29 Jan 2026 17:29:37 +0800 Subject: [PATCH] Add command relationships, essential commands, and validation script - Introduced `command-relationships.json` to define internal calls, next steps, and prerequisites for various workflows. - Created `essential-commands.json` to document key commands, their descriptions, arguments, and usage scenarios. - Added `validate-help.py` script to check for the existence of source files referenced in command definitions, ensuring all necessary files are present. --- .claude/skills/ccw-help/index/all-agents.json | 97 ++ .../skills/ccw-help/index/all-commands.json | 805 +++++++++++++++++ .../skills/ccw-help/index/by-category.json | 833 ++++++++++++++++++ .../skills/ccw-help/index/by-use-case.json | 819 +++++++++++++++++ .../ccw-help/index/command-relationships.json | 160 ++++ .../ccw-help/index/essential-commands.json | 90 ++ ccw/src/core/routes/help-routes.ts | 2 +- ccw/src/templates/dashboard-js/views/help.js | 414 ++++++++- validate-help.py | 60 ++ 9 files changed, 3278 insertions(+), 2 deletions(-) create mode 100644 .claude/skills/ccw-help/index/all-agents.json create mode 100644 .claude/skills/ccw-help/index/all-commands.json create mode 100644 .claude/skills/ccw-help/index/by-category.json create mode 100644 .claude/skills/ccw-help/index/by-use-case.json create mode 100644 .claude/skills/ccw-help/index/command-relationships.json create mode 100644 .claude/skills/ccw-help/index/essential-commands.json create mode 100644 validate-help.py diff --git a/.claude/skills/ccw-help/index/all-agents.json b/.claude/skills/ccw-help/index/all-agents.json new file mode 100644 index 00000000..7b111545 --- /dev/null +++ b/.claude/skills/ccw-help/index/all-agents.json @@ -0,0 +1,97 @@ +[ + { + "name": "action-planning-agent", + "description": "|", + "source": "../../../agents/action-planning-agent.md" + }, + { + "name": "cli-discuss-agent", + "description": "|", + "source": "../../../agents/cli-discuss-agent.md" + }, + { + "name": "cli-execution-agent", + "description": "|", + "source": "../../../agents/cli-execution-agent.md" + }, + { + "name": "cli-explore-agent", + "description": "|", + "source": "../../../agents/cli-explore-agent.md" + }, + { + "name": "cli-lite-planning-agent", + "description": "|", + "source": "../../../agents/cli-lite-planning-agent.md" + }, + { + "name": "cli-planning-agent", + "description": "|", + "source": "../../../agents/cli-planning-agent.md" + }, + { + "name": "code-developer", + "description": "|", + "source": "../../../agents/code-developer.md" + }, + { + "name": "conceptual-planning-agent", + "description": "|", + "source": "../../../agents/conceptual-planning-agent.md" + }, + { + "name": "context-search-agent", + "description": "|", + "source": "../../../agents/context-search-agent.md" + }, + { + "name": "debug-explore-agent", + "description": "|", + "source": "../../../agents/debug-explore-agent.md" + }, + { + "name": "doc-generator", + "description": "|", + "source": "../../../agents/doc-generator.md" + }, + { + "name": "issue-plan-agent", + "description": "|", + "source": "../../../agents/issue-plan-agent.md" + }, + { + "name": "issue-queue-agent", + "description": "|", + "source": "../../../agents/issue-queue-agent.md" + }, + { + "name": "memory-bridge", + "description": "Execute complex project documentation updates using script coordination", + "source": "../../../agents/memory-bridge.md" + }, + { + "name": "tdd-developer", + "description": "|", + "source": "../../../agents/tdd-developer.md" + }, + { + "name": "test-context-search-agent", + "description": "|", + "source": "../../../agents/test-context-search-agent.md" + }, + { + "name": "test-fix-agent", + "description": "|", + "source": "../../../agents/test-fix-agent.md" + }, + { + "name": "ui-design-agent", + "description": "|", + "source": "../../../agents/ui-design-agent.md" + }, + { + "name": "universal-executor", + "description": "|", + "source": "../../../agents/universal-executor.md" + } +] \ No newline at end of file diff --git a/.claude/skills/ccw-help/index/all-commands.json b/.claude/skills/ccw-help/index/all-commands.json new file mode 100644 index 00000000..eefdb5da --- /dev/null +++ b/.claude/skills/ccw-help/index/all-commands.json @@ -0,0 +1,805 @@ +[ + { + "name": "ccw-coordinator", + "command": "/ccw-coordinator", + "description": "Command orchestration tool - analyze requirements, recommend chain, execute sequentially with state persistence", + "arguments": "[task description]", + "category": "general", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/ccw-coordinator.md" + }, + { + "name": "ccw-debug", + "command": "/ccw-debug", + "description": "Aggregated debug command - combines debugging diagnostics and test verification in a synergistic workflow supporting cli-quick / debug-first / test-first / bidirectional-verification modes", + "arguments": "[--mode cli|debug|test|bidirectional] [--yes|-y] [--hotfix] \\\"bug description or error message\\", + "category": "general", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/ccw-debug.md" + }, + { + "name": "ccw", + "command": "/ccw", + "description": "Main workflow orchestrator - analyze intent, select workflow, execute command chain in main process", + "arguments": "\\\"task description\\", + "category": "general", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/ccw.md" + }, + { + "name": "cli-init", + "command": "/cli:cli-init", + "description": "Generate .gemini/ and .qwen/ config directories with settings.json and ignore files based on workspace technology detection", + "arguments": "[--tool gemini|qwen|all] [--output path] [--preview]", + "category": "cli", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/cli/cli-init.md" + }, + { + "name": "codex-review", + "command": "/cli:codex-review", + "description": "Interactive code review using Codex CLI via ccw endpoint with configurable review target, model, and custom instructions", + "arguments": "[--uncommitted|--base |--commit ] [--model ] [--title ] [prompt]", + "category": "cli", + "subcategory": null, + "usage_scenario": "analysis", + "difficulty": "Intermediate", + "source": "../../../commands/cli/codex-review.md" + }, + { + "name": "convert-to-plan", + "command": "/issue:convert-to-plan", + "description": "Convert planning artifacts (lite-plan, workflow session, markdown) to issue solutions", + "arguments": "[-y|--yes] [--issue <id>] [--supplement] <SOURCE>", + "category": "issue", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/issue/convert-to-plan.md" + }, + { + "name": "issue:discover-by-prompt", + "command": "/issue:discover-by-prompt", + "description": "Discover issues from user prompt with Gemini-planned iterative multi-agent exploration. Uses ACE semantic search for context gathering and supports cross-module comparison (e.g., frontend vs backend API contracts).", + "arguments": "[-y|--yes] <prompt> [--scope=src/**] [--depth=standard|deep] [--max-iterations=5]", + "category": "issue", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/issue/discover-by-prompt.md" + }, + { + "name": "issue:discover", + "command": "/issue:discover", + "description": "Discover potential issues from multiple perspectives (bug, UX, test, quality, security, performance, maintainability, best-practices) using CLI explore. Supports Exa external research for security and best-practices perspectives.", + "arguments": "[-y|--yes] <path-pattern> [--perspectives=bug,ux,...] [--external]", + "category": "issue", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/issue/discover.md" + }, + { + "name": "execute", + "command": "/issue:execute", + "description": "Execute queue with DAG-based parallel orchestration (one commit per solution)", + "arguments": "[-y|--yes] --queue <queue-id> [--worktree [<existing-path>]]", + "category": "issue", + "subcategory": null, + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/issue/execute.md" + }, + { + "name": "from-brainstorm", + "command": "/issue:from-brainstorm", + "description": "Convert brainstorm session ideas into issue with executable solution for parallel-dev-cycle", + "arguments": "SESSION=\\\"<session-id>\\\" [--idea=<index>] [--auto] [-y|--yes]", + "category": "issue", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/issue/from-brainstorm.md" + }, + { + "name": "new", + "command": "/issue:new", + "description": "Create structured issue from GitHub URL or text description", + "arguments": "[-y|--yes] <github-url | text-description> [--priority 1-5]", + "category": "issue", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/issue/new.md" + }, + { + "name": "plan", + "command": "/issue:plan", + "description": "Batch plan issue resolution using issue-plan-agent (explore + plan closed-loop)", + "arguments": "[-y|--yes] --all-pending <issue-id>[,<issue-id>,...] [--batch-size 3]", + "category": "issue", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/issue/plan.md" + }, + { + "name": "queue", + "command": "/issue:queue", + "description": "Form execution queue from bound solutions using issue-queue-agent (solution-level)", + "arguments": "[-y|--yes] [--queues <n>] [--issue <id>]", + "category": "issue", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/issue/queue.md" + }, + { + "name": "compact", + "command": "/memory:compact", + "description": "Compact current session memory into structured text for session recovery, extracting objective/plan/files/decisions/constraints/state, and save via MCP core_memory tool", + "arguments": "[optional: session description]", + "category": "memory", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/memory/compact.md" + }, + { + "name": "docs-full-cli", + "command": "/memory:docs-full-cli", + "description": "Generate full project documentation using CLI execution (Layer 3→1) with batched agents (4 modules/agent) and gemini→qwen→codex fallback, <20 modules uses direct parallel", + "arguments": "[path] [--tool <gemini|qwen|codex>]", + "category": "memory", + "subcategory": null, + "usage_scenario": "documentation", + "difficulty": "Intermediate", + "source": "../../../commands/memory/docs-full-cli.md" + }, + { + "name": "docs-related-cli", + "command": "/memory:docs-related-cli", + "description": "Generate/update documentation for git-changed modules using CLI execution with batched agents (4 modules/agent) and gemini→qwen→codex fallback, <15 modules uses direct parallel", + "arguments": "[--tool <gemini|qwen|codex>]", + "category": "memory", + "subcategory": null, + "usage_scenario": "documentation", + "difficulty": "Intermediate", + "source": "../../../commands/memory/docs-related-cli.md" + }, + { + "name": "load", + "command": "/memory:load", + "description": "Delegate to universal-executor agent to analyze project via Gemini/Qwen CLI and return JSON core content package for task context", + "arguments": "[--tool gemini|qwen] \\\"task context description\\", + "category": "memory", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/memory/load.md" + }, + { + "name": "style-skill-memory", + "command": "/memory:style-skill-memory", + "description": "Generate SKILL memory package from style reference for easy loading and consistent design system usage", + "arguments": "[package-name] [--regenerate]", + "category": "memory", + "subcategory": null, + "usage_scenario": "documentation", + "difficulty": "Intermediate", + "source": "../../../commands/memory/style-skill-memory.md" + }, + { + "name": "tips", + "command": "/memory:tips", + "description": "Quick note-taking command to capture ideas, snippets, reminders, and insights for later reference", + "arguments": "<note content> [--tag <tag1,tag2>] [--context <context>]", + "category": "memory", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/memory/tips.md" + }, + { + "name": "update-full", + "command": "/memory:update-full", + "description": "Update all CLAUDE.md files using layer-based execution (Layer 3→1) with batched agents (4 modules/agent) and gemini→qwen→codex fallback, <20 modules uses direct parallel", + "arguments": "[--tool gemini|qwen|codex] [--path <directory>]", + "category": "memory", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/memory/update-full.md" + }, + { + "name": "update-related", + "command": "/memory:update-related", + "description": "Update CLAUDE.md for git-changed modules using batched agent execution (4 modules/agent) with gemini→qwen→codex fallback, <15 modules uses direct execution", + "arguments": "[--tool gemini|qwen|codex]", + "category": "memory", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/memory/update-related.md" + }, + { + "name": "ccw view", + "command": "/ccw view", + "description": "Dashboard - Open CCW workflow dashboard for managing tasks and sessions", + "arguments": "", + "category": "general", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/view.md" + }, + { + "name": "analyze-with-file", + "command": "/workflow:analyze-with-file", + "description": "Interactive collaborative analysis with documented discussions, CLI-assisted exploration, and evolving understanding", + "arguments": "[-y|--yes] [-c|--continue] \\\"topic or question\\", + "category": "workflow", + "subcategory": null, + "usage_scenario": "analysis", + "difficulty": "Beginner", + "source": "../../../commands/workflow/analyze-with-file.md" + }, + { + "name": "artifacts", + "command": "/workflow:brainstorm:artifacts", + "description": "Interactive clarification generating confirmed guidance specification through role-based analysis and synthesis", + "arguments": "[-y|--yes] topic or challenge description [--count N]", + "category": "workflow", + "subcategory": "brainstorm", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/brainstorm/artifacts.md" + }, + { + "name": "auto-parallel", + "command": "/workflow:brainstorm:auto-parallel", + "description": "Parallel brainstorming automation with dynamic role selection and concurrent execution across multiple perspectives", + "arguments": "[-y|--yes] topic or challenge description [--count N]", + "category": "workflow", + "subcategory": "brainstorm", + "usage_scenario": "general", + "difficulty": "Advanced", + "source": "../../../commands/workflow/brainstorm/auto-parallel.md" + }, + { + "name": "role-analysis", + "command": "/workflow:brainstorm:role-analysis", + "description": "Unified role-specific analysis generation with interactive context gathering and incremental updates", + "arguments": "[role-name] [--session session-id] [--update] [--include-questions] [--skip-questions]", + "category": "workflow", + "subcategory": "brainstorm", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/brainstorm/role-analysis.md" + }, + { + "name": "synthesis", + "command": "/workflow:brainstorm:synthesis", + "description": "Clarify and refine role analyses through intelligent Q&A and targeted updates with synthesis agent", + "arguments": "[-y|--yes] [optional: --session session-id]", + "category": "workflow", + "subcategory": "brainstorm", + "usage_scenario": "general", + "difficulty": "Advanced", + "source": "../../../commands/workflow/brainstorm/synthesis.md" + }, + { + "name": "brainstorm-with-file", + "command": "/workflow:brainstorm-with-file", + "description": "Interactive brainstorming with multi-CLI collaboration, idea expansion, and documented thought evolution", + "arguments": "[-y|--yes] [-c|--continue] [-m|--mode creative|structured] \\\"idea or topic\\", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/brainstorm-with-file.md" + }, + { + "name": "clean", + "command": "/workflow:clean", + "description": "Intelligent code cleanup with mainline detection, stale artifact discovery, and safe execution", + "arguments": "[-y|--yes] [--dry-run] [\\\"focus area\\\"]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/clean.md" + }, + { + "name": "debug-with-file", + "command": "/workflow:debug-with-file", + "description": "Interactive hypothesis-driven debugging with documented exploration, understanding evolution, and Gemini-assisted correction", + "arguments": "[-y|--yes] \\\"bug description or error message\\", + "category": "workflow", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/debug-with-file.md" + }, + { + "name": "execute", + "command": "/workflow:execute", + "description": "Coordinate agent execution for workflow tasks with automatic session discovery, parallel task processing, and status tracking", + "arguments": "[-y|--yes] [--resume-session=\\\"session-id\\\"]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/execute.md" + }, + { + "name": "init", + "command": "/workflow:init", + "description": "Initialize project-level state with intelligent project analysis using cli-explore-agent", + "arguments": "[--regenerate]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/init.md" + }, + { + "name": "lite-execute", + "command": "/workflow:lite-execute", + "description": "Execute tasks based on in-memory plan, prompt description, or file content", + "arguments": "[-y|--yes] [--in-memory] [\\\"task description\\\"|file-path]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/lite-execute.md" + }, + { + "name": "lite-fix", + "command": "/workflow:lite-fix", + "description": "Lightweight bug diagnosis and fix workflow with intelligent severity assessment and optional hotfix mode for production incidents", + "arguments": "[-y|--yes] [--hotfix] \\\"bug description or issue reference\\", + "category": "workflow", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/lite-fix.md" + }, + { + "name": "workflow:lite-lite-lite", + "command": "/workflow:lite-lite-lite", + "description": "Ultra-lightweight multi-tool analysis and direct execution. No artifacts for simple tasks; auto-creates planning docs in .workflow/.scratchpad/ for complex tasks. Auto tool selection based on task analysis, user-driven iteration via AskUser.", + "arguments": "[-y|--yes] <task description>", + "category": "workflow", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/lite-lite-lite.md" + }, + { + "name": "lite-plan", + "command": "/workflow:lite-plan", + "description": "Lightweight interactive planning workflow with in-memory planning, code exploration, and execution execute to lite-execute after user confirmation", + "arguments": "[-y|--yes] [-e|--explore] \\\"task description\\\"|file.md", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/lite-plan.md" + }, + { + "name": "workflow:multi-cli-plan", + "command": "/workflow:multi-cli-plan", + "description": "Multi-CLI collaborative planning workflow with ACE context gathering and iterative cross-verification. Uses cli-discuss-agent for Gemini+Codex+Claude analysis to converge on optimal execution plan.", + "arguments": "[-y|--yes] <task description> [--max-rounds=3] [--tools=gemini,codex] [--mode=parallel|serial]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/multi-cli-plan.md" + }, + { + "name": "plan-verify", + "command": "/workflow:plan-verify", + "description": "Perform READ-ONLY verification analysis between IMPL_PLAN.md, task JSONs, and brainstorming artifacts. Generates structured report with quality gate recommendation. Does NOT modify any files.", + "arguments": "[optional: --session session-id]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/plan-verify.md" + }, + { + "name": "plan", + "command": "/workflow:plan", + "description": "5-phase planning workflow with action-planning-agent task generation, outputs IMPL_PLAN.md and task JSONs", + "arguments": "[-y|--yes] \\\"text description\\\"|file.md", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/plan.md" + }, + { + "name": "replan", + "command": "/workflow:replan", + "description": "Interactive workflow replanning with session-level artifact updates and boundary clarification through guided questioning", + "arguments": "[-y|--yes] [--session session-id] [task-id] \\\"requirements\\\"|file.md [--interactive]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/replan.md" + }, + { + "name": "review-cycle-fix", + "command": "/workflow:review-cycle-fix", + "description": "Automated fixing of code review findings with AI-powered planning and coordinated execution. Uses intelligent grouping, multi-stage timeline coordination, and test-driven verification.", + "arguments": "<export-file|review-dir> [--resume] [--max-iterations=N]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "analysis", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/review-cycle-fix.md" + }, + { + "name": "review-module-cycle", + "command": "/workflow:review-module-cycle", + "description": "Independent multi-dimensional code review for specified modules/files. Analyzes specific code paths across 7 dimensions with hybrid parallel-iterative execution, independent of workflow sessions.", + "arguments": "<path-pattern> [--dimensions=security,architecture,...] [--max-iterations=N]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "analysis", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/review-module-cycle.md" + }, + { + "name": "review-session-cycle", + "command": "/workflow:review-session-cycle", + "description": "Session-based comprehensive multi-dimensional code review. Analyzes git changes from workflow session across 7 dimensions with hybrid parallel-iterative execution, aggregates findings, and performs focused deep-dives on critical issues until quality gates met.", + "arguments": "[session-id] [--dimensions=security,architecture,...] [--max-iterations=N]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "session-management", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/review-session-cycle.md" + }, + { + "name": "review", + "command": "/workflow:review", + "description": "Post-implementation review with specialized types (security/architecture/action-items/quality) using analysis agents and Gemini", + "arguments": "[--type=security|architecture|action-items|quality] [--archived] [optional: session-id]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "analysis", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/review.md" + }, + { + "name": "complete", + "command": "/workflow:session:complete", + "description": "Mark active workflow session as complete, archive with lessons learned, update manifest, remove active flag", + "arguments": "[-y|--yes] [--detailed]", + "category": "workflow", + "subcategory": "session", + "usage_scenario": "session-management", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/session/complete.md" + }, + { + "name": "list", + "command": "/workflow:session:list", + "description": "List all workflow sessions with status filtering, shows session metadata and progress information", + "arguments": "", + "category": "workflow", + "subcategory": "session", + "usage_scenario": "general", + "difficulty": "Beginner", + "source": "../../../commands/workflow/session/list.md" + }, + { + "name": "resume", + "command": "/workflow:session:resume", + "description": "Resume the most recently paused workflow session with automatic session discovery and status update", + "arguments": "", + "category": "workflow", + "subcategory": "session", + "usage_scenario": "session-management", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/session/resume.md" + }, + { + "name": "solidify", + "command": "/workflow:session:solidify", + "description": "Crystallize session learnings and user-defined constraints into permanent project guidelines", + "arguments": "[-y|--yes] [--type <convention|constraint|learning>] [--category <category>] \\\"rule or insight\\", + "category": "workflow", + "subcategory": "session", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/session/solidify.md" + }, + { + "name": "start", + "command": "/workflow:session:start", + "description": "Discover existing sessions or start new workflow session with intelligent session management and conflict detection", + "arguments": "[--type <workflow|review|tdd|test|docs>] [--auto|--new] [optional: task description for new session]", + "category": "workflow", + "subcategory": "session", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/session/start.md" + }, + { + "name": "tdd-plan", + "command": "/workflow:tdd-plan", + "description": "TDD workflow planning with Red-Green-Refactor task chain generation, test-first development structure, and cycle tracking", + "arguments": "\\\"feature description\\\"|file.md", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tdd-plan.md" + }, + { + "name": "tdd-verify", + "command": "/workflow:tdd-verify", + "description": "Verify TDD workflow compliance against Red-Green-Refactor cycles. Generates quality report with coverage analysis and quality gate recommendation. Orchestrates sub-commands for comprehensive validation.", + "arguments": "[optional: --session WFS-session-id]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "testing", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tdd-verify.md" + }, + { + "name": "test-cycle-execute", + "command": "/workflow:test-cycle-execute", + "description": "Execute test-fix workflow with dynamic task generation and iterative fix cycles until test pass rate >= 95% or max iterations reached. Uses @cli-planning-agent for failure analysis and task generation.", + "arguments": "[--resume-session=\\\"session-id\\\"] [--max-iterations=N]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/test-cycle-execute.md" + }, + { + "name": "test-fix-gen", + "command": "/workflow:test-fix-gen", + "description": "Create test-fix workflow session from session ID, description, or file path with test strategy generation and task planning", + "arguments": "(source-session-id | \\\"feature description\\\" | /path/to/file.md)", + "category": "workflow", + "subcategory": null, + "usage_scenario": "testing", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/test-fix-gen.md" + }, + { + "name": "test-gen", + "command": "/workflow:test-gen", + "description": "Create independent test-fix workflow session from completed implementation session, analyzes code to generate test tasks", + "arguments": "source-session-id", + "category": "workflow", + "subcategory": null, + "usage_scenario": "testing", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/test-gen.md" + }, + { + "name": "conflict-resolution", + "command": "/workflow:tools:conflict-resolution", + "description": "Detect and resolve conflicts between plan and existing codebase using CLI-powered analysis with Gemini/Qwen", + "arguments": "[-y|--yes] --session WFS-session-id --context path/to/context-package.json", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "general", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tools/conflict-resolution.md" + }, + { + "name": "gather", + "command": "/workflow:tools:gather", + "description": "Intelligently collect project context using context-search-agent based on task description, packages into standardized JSON", + "arguments": "--session WFS-session-id \\\"task description\\", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/tools/context-gather.md" + }, + { + "name": "task-generate-agent", + "command": "/workflow:tools:task-generate-agent", + "description": "Generate implementation plan documents (IMPL_PLAN.md, task JSONs, TODO_LIST.md) using action-planning-agent - produces planning artifacts, does NOT execute code implementation", + "arguments": "[-y|--yes] --session WFS-session-id", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "implementation", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tools/task-generate-agent.md" + }, + { + "name": "task-generate-tdd", + "command": "/workflow:tools:task-generate-tdd", + "description": "Autonomous TDD task generation using action-planning-agent with Red-Green-Refactor cycles, test-first structure, and cycle validation", + "arguments": "[-y|--yes] --session WFS-session-id", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "implementation", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tools/task-generate-tdd.md" + }, + { + "name": "tdd-coverage-analysis", + "command": "/workflow:tools:tdd-coverage-analysis", + "description": "Analyze test coverage and TDD cycle execution with Red-Green-Refactor compliance verification", + "arguments": "--session WFS-session-id", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "testing", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tools/tdd-coverage-analysis.md" + }, + { + "name": "test-concept-enhanced", + "command": "/workflow:tools:test-concept-enhanced", + "description": "Coordinate test analysis workflow using cli-execution-agent to generate test strategy via Gemini", + "arguments": "--session WFS-test-session-id --context path/to/test-context-package.json", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "testing", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/tools/test-concept-enhanced.md" + }, + { + "name": "test-context-gather", + "command": "/workflow:tools:test-context-gather", + "description": "Collect test coverage context using test-context-search-agent and package into standardized test-context JSON", + "arguments": "--session WFS-test-session-id", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "testing", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/tools/test-context-gather.md" + }, + { + "name": "test-task-generate", + "command": "/workflow:tools:test-task-generate", + "description": "Generate test planning documents (IMPL_PLAN.md, test task JSONs, TODO_LIST.md) using action-planning-agent - produces test planning artifacts, does NOT execute tests", + "arguments": "--session WFS-test-session-id", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/tools/test-task-generate.md" + }, + { + "name": "animation-extract", + "command": "/workflow:ui-design:animation-extract", + "description": "Extract animation and transition patterns from prompt inference and image references for design system documentation", + "arguments": "[-y|--yes] [--design-id <id>] [--session <id>] [--images \"<glob>\"] [--focus \"<types>\"] [--interactive] [--refine]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/animation-extract.md" + }, + { + "name": "workflow:ui-design:codify-style", + "command": "/workflow:ui-design:codify-style", + "description": "Orchestrator to extract styles from code and generate shareable reference package with preview (automatic file discovery)", + "arguments": "<path> [--package-name <name>] [--output-dir <path>] [--overwrite]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/codify-style.md" + }, + { + "name": "design-sync", + "command": "/workflow:ui-design:design-sync", + "description": "Synchronize finalized design system references to brainstorming artifacts, preparing them for /workflow:plan consumption", + "arguments": "--session <session_id> [--selected-prototypes \"<list>\"]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/design-sync.md" + }, + { + "name": "explore-auto", + "command": "/workflow:ui-design:explore-auto", + "description": "Interactive exploratory UI design workflow with style-centric batch generation, creates design variants from prompts/images with parallel execution and user selection", + "arguments": "[--input \"<value>\"] [--targets \"<list>\"] [--target-type \"page|component\"] [--session <id>] [--style-variants <count>] [--layout-variants <count>]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/explore-auto.md" + }, + { + "name": "generate", + "command": "/workflow:ui-design:generate", + "description": "Assemble UI prototypes by combining layout templates with design tokens (default animation support), pure assembler without new content generation", + "arguments": "[--design-id <id>] [--session <id>]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/generate.md" + }, + { + "name": "imitate-auto", + "command": "/workflow:ui-design:imitate-auto", + "description": "UI design workflow with direct code/image input for design token extraction and prototype generation", + "arguments": "[--input \"<value>\"] [--session <id>]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/imitate-auto.md" + }, + { + "name": "workflow:ui-design:import-from-code", + "command": "/workflow:ui-design:import-from-code", + "description": "Import design system from code files (CSS/JS/HTML/SCSS) with automatic file discovery and parallel agent analysis", + "arguments": "[--design-id <id>] [--session <id>] [--source <path>]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/import-from-code.md" + }, + { + "name": "layout-extract", + "command": "/workflow:ui-design:layout-extract", + "description": "Extract structural layout information from reference images or text prompts using Claude analysis with variant generation or refinement mode", + "arguments": "[-y|--yes] [--design-id <id>] [--session <id>] [--images \"<glob>\"] [--prompt \"<desc>\"] [--targets \"<list>\"] [--variants <count>] [--device-type <desktop|mobile|tablet|responsive>] [--interactive] [--refine]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/layout-extract.md" + }, + { + "name": "workflow:ui-design:reference-page-generator", + "command": "/workflow:ui-design:reference-page-generator", + "description": "Generate multi-component reference pages and documentation from design run extraction", + "arguments": "[--design-run <path>] [--package-name <name>] [--output-dir <path>]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/reference-page-generator.md" + }, + { + "name": "style-extract", + "command": "/workflow:ui-design:style-extract", + "description": "Extract design style from reference images or text prompts using Claude analysis with variant generation or refinement mode", + "arguments": "[-y|--yes] [--design-id <id>] [--session <id>] [--images \"<glob>\"] [--prompt \"<desc>\"] [--variants <count>] [--interactive] [--refine]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/style-extract.md" + }, + { + "name": "unified-execute-with-file", + "command": "/workflow:unified-execute-with-file", + "description": "Universal execution engine for consuming any planning/brainstorm/analysis output with minimal progress tracking, multi-agent coordination, and incremental execution", + "arguments": "[-y|--yes] [-p|--plan <path>] [-m|--mode sequential|parallel] [\\\"execution context or task name\\\"]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/unified-execute-with-file.md" + } +] \ No newline at end of file diff --git a/.claude/skills/ccw-help/index/by-category.json b/.claude/skills/ccw-help/index/by-category.json new file mode 100644 index 00000000..2762d9a0 --- /dev/null +++ b/.claude/skills/ccw-help/index/by-category.json @@ -0,0 +1,833 @@ +{ + "general": { + "_root": [ + { + "name": "ccw-coordinator", + "command": "/ccw-coordinator", + "description": "Command orchestration tool - analyze requirements, recommend chain, execute sequentially with state persistence", + "arguments": "[task description]", + "category": "general", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/ccw-coordinator.md" + }, + { + "name": "ccw-debug", + "command": "/ccw-debug", + "description": "Aggregated debug command - combines debugging diagnostics and test verification in a synergistic workflow supporting cli-quick / debug-first / test-first / bidirectional-verification modes", + "arguments": "[--mode cli|debug|test|bidirectional] [--yes|-y] [--hotfix] \\\"bug description or error message\\", + "category": "general", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/ccw-debug.md" + }, + { + "name": "ccw", + "command": "/ccw", + "description": "Main workflow orchestrator - analyze intent, select workflow, execute command chain in main process", + "arguments": "\\\"task description\\", + "category": "general", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/ccw.md" + }, + { + "name": "ccw view", + "command": "/ccw view", + "description": "Dashboard - Open CCW workflow dashboard for managing tasks and sessions", + "arguments": "", + "category": "general", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/view.md" + } + ] + }, + "cli": { + "_root": [ + { + "name": "cli-init", + "command": "/cli:cli-init", + "description": "Generate .gemini/ and .qwen/ config directories with settings.json and ignore files based on workspace technology detection", + "arguments": "[--tool gemini|qwen|all] [--output path] [--preview]", + "category": "cli", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/cli/cli-init.md" + }, + { + "name": "codex-review", + "command": "/cli:codex-review", + "description": "Interactive code review using Codex CLI via ccw endpoint with configurable review target, model, and custom instructions", + "arguments": "[--uncommitted|--base <branch>|--commit <sha>] [--model <model>] [--title <title>] [prompt]", + "category": "cli", + "subcategory": null, + "usage_scenario": "analysis", + "difficulty": "Intermediate", + "source": "../../../commands/cli/codex-review.md" + } + ] + }, + "issue": { + "_root": [ + { + "name": "convert-to-plan", + "command": "/issue:convert-to-plan", + "description": "Convert planning artifacts (lite-plan, workflow session, markdown) to issue solutions", + "arguments": "[-y|--yes] [--issue <id>] [--supplement] <SOURCE>", + "category": "issue", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/issue/convert-to-plan.md" + }, + { + "name": "issue:discover-by-prompt", + "command": "/issue:discover-by-prompt", + "description": "Discover issues from user prompt with Gemini-planned iterative multi-agent exploration. Uses ACE semantic search for context gathering and supports cross-module comparison (e.g., frontend vs backend API contracts).", + "arguments": "[-y|--yes] <prompt> [--scope=src/**] [--depth=standard|deep] [--max-iterations=5]", + "category": "issue", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/issue/discover-by-prompt.md" + }, + { + "name": "issue:discover", + "command": "/issue:discover", + "description": "Discover potential issues from multiple perspectives (bug, UX, test, quality, security, performance, maintainability, best-practices) using CLI explore. Supports Exa external research for security and best-practices perspectives.", + "arguments": "[-y|--yes] <path-pattern> [--perspectives=bug,ux,...] [--external]", + "category": "issue", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/issue/discover.md" + }, + { + "name": "execute", + "command": "/issue:execute", + "description": "Execute queue with DAG-based parallel orchestration (one commit per solution)", + "arguments": "[-y|--yes] --queue <queue-id> [--worktree [<existing-path>]]", + "category": "issue", + "subcategory": null, + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/issue/execute.md" + }, + { + "name": "from-brainstorm", + "command": "/issue:from-brainstorm", + "description": "Convert brainstorm session ideas into issue with executable solution for parallel-dev-cycle", + "arguments": "SESSION=\\\"<session-id>\\\" [--idea=<index>] [--auto] [-y|--yes]", + "category": "issue", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/issue/from-brainstorm.md" + }, + { + "name": "new", + "command": "/issue:new", + "description": "Create structured issue from GitHub URL or text description", + "arguments": "[-y|--yes] <github-url | text-description> [--priority 1-5]", + "category": "issue", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/issue/new.md" + }, + { + "name": "plan", + "command": "/issue:plan", + "description": "Batch plan issue resolution using issue-plan-agent (explore + plan closed-loop)", + "arguments": "[-y|--yes] --all-pending <issue-id>[,<issue-id>,...] [--batch-size 3]", + "category": "issue", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/issue/plan.md" + }, + { + "name": "queue", + "command": "/issue:queue", + "description": "Form execution queue from bound solutions using issue-queue-agent (solution-level)", + "arguments": "[-y|--yes] [--queues <n>] [--issue <id>]", + "category": "issue", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/issue/queue.md" + } + ] + }, + "memory": { + "_root": [ + { + "name": "compact", + "command": "/memory:compact", + "description": "Compact current session memory into structured text for session recovery, extracting objective/plan/files/decisions/constraints/state, and save via MCP core_memory tool", + "arguments": "[optional: session description]", + "category": "memory", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/memory/compact.md" + }, + { + "name": "docs-full-cli", + "command": "/memory:docs-full-cli", + "description": "Generate full project documentation using CLI execution (Layer 3→1) with batched agents (4 modules/agent) and gemini→qwen→codex fallback, <20 modules uses direct parallel", + "arguments": "[path] [--tool <gemini|qwen|codex>]", + "category": "memory", + "subcategory": null, + "usage_scenario": "documentation", + "difficulty": "Intermediate", + "source": "../../../commands/memory/docs-full-cli.md" + }, + { + "name": "docs-related-cli", + "command": "/memory:docs-related-cli", + "description": "Generate/update documentation for git-changed modules using CLI execution with batched agents (4 modules/agent) and gemini→qwen→codex fallback, <15 modules uses direct parallel", + "arguments": "[--tool <gemini|qwen|codex>]", + "category": "memory", + "subcategory": null, + "usage_scenario": "documentation", + "difficulty": "Intermediate", + "source": "../../../commands/memory/docs-related-cli.md" + }, + { + "name": "load", + "command": "/memory:load", + "description": "Delegate to universal-executor agent to analyze project via Gemini/Qwen CLI and return JSON core content package for task context", + "arguments": "[--tool gemini|qwen] \\\"task context description\\", + "category": "memory", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/memory/load.md" + }, + { + "name": "style-skill-memory", + "command": "/memory:style-skill-memory", + "description": "Generate SKILL memory package from style reference for easy loading and consistent design system usage", + "arguments": "[package-name] [--regenerate]", + "category": "memory", + "subcategory": null, + "usage_scenario": "documentation", + "difficulty": "Intermediate", + "source": "../../../commands/memory/style-skill-memory.md" + }, + { + "name": "tips", + "command": "/memory:tips", + "description": "Quick note-taking command to capture ideas, snippets, reminders, and insights for later reference", + "arguments": "<note content> [--tag <tag1,tag2>] [--context <context>]", + "category": "memory", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/memory/tips.md" + }, + { + "name": "update-full", + "command": "/memory:update-full", + "description": "Update all CLAUDE.md files using layer-based execution (Layer 3→1) with batched agents (4 modules/agent) and gemini→qwen→codex fallback, <20 modules uses direct parallel", + "arguments": "[--tool gemini|qwen|codex] [--path <directory>]", + "category": "memory", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/memory/update-full.md" + }, + { + "name": "update-related", + "command": "/memory:update-related", + "description": "Update CLAUDE.md for git-changed modules using batched agent execution (4 modules/agent) with gemini→qwen→codex fallback, <15 modules uses direct execution", + "arguments": "[--tool gemini|qwen|codex]", + "category": "memory", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/memory/update-related.md" + } + ] + }, + "workflow": { + "_root": [ + { + "name": "analyze-with-file", + "command": "/workflow:analyze-with-file", + "description": "Interactive collaborative analysis with documented discussions, CLI-assisted exploration, and evolving understanding", + "arguments": "[-y|--yes] [-c|--continue] \\\"topic or question\\", + "category": "workflow", + "subcategory": null, + "usage_scenario": "analysis", + "difficulty": "Beginner", + "source": "../../../commands/workflow/analyze-with-file.md" + }, + { + "name": "brainstorm-with-file", + "command": "/workflow:brainstorm-with-file", + "description": "Interactive brainstorming with multi-CLI collaboration, idea expansion, and documented thought evolution", + "arguments": "[-y|--yes] [-c|--continue] [-m|--mode creative|structured] \\\"idea or topic\\", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/brainstorm-with-file.md" + }, + { + "name": "clean", + "command": "/workflow:clean", + "description": "Intelligent code cleanup with mainline detection, stale artifact discovery, and safe execution", + "arguments": "[-y|--yes] [--dry-run] [\\\"focus area\\\"]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/clean.md" + }, + { + "name": "debug-with-file", + "command": "/workflow:debug-with-file", + "description": "Interactive hypothesis-driven debugging with documented exploration, understanding evolution, and Gemini-assisted correction", + "arguments": "[-y|--yes] \\\"bug description or error message\\", + "category": "workflow", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/debug-with-file.md" + }, + { + "name": "execute", + "command": "/workflow:execute", + "description": "Coordinate agent execution for workflow tasks with automatic session discovery, parallel task processing, and status tracking", + "arguments": "[-y|--yes] [--resume-session=\\\"session-id\\\"]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/execute.md" + }, + { + "name": "init", + "command": "/workflow:init", + "description": "Initialize project-level state with intelligent project analysis using cli-explore-agent", + "arguments": "[--regenerate]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/init.md" + }, + { + "name": "lite-execute", + "command": "/workflow:lite-execute", + "description": "Execute tasks based on in-memory plan, prompt description, or file content", + "arguments": "[-y|--yes] [--in-memory] [\\\"task description\\\"|file-path]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/lite-execute.md" + }, + { + "name": "lite-fix", + "command": "/workflow:lite-fix", + "description": "Lightweight bug diagnosis and fix workflow with intelligent severity assessment and optional hotfix mode for production incidents", + "arguments": "[-y|--yes] [--hotfix] \\\"bug description or issue reference\\", + "category": "workflow", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/lite-fix.md" + }, + { + "name": "workflow:lite-lite-lite", + "command": "/workflow:lite-lite-lite", + "description": "Ultra-lightweight multi-tool analysis and direct execution. No artifacts for simple tasks; auto-creates planning docs in .workflow/.scratchpad/ for complex tasks. Auto tool selection based on task analysis, user-driven iteration via AskUser.", + "arguments": "[-y|--yes] <task description>", + "category": "workflow", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/lite-lite-lite.md" + }, + { + "name": "lite-plan", + "command": "/workflow:lite-plan", + "description": "Lightweight interactive planning workflow with in-memory planning, code exploration, and execution execute to lite-execute after user confirmation", + "arguments": "[-y|--yes] [-e|--explore] \\\"task description\\\"|file.md", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/lite-plan.md" + }, + { + "name": "workflow:multi-cli-plan", + "command": "/workflow:multi-cli-plan", + "description": "Multi-CLI collaborative planning workflow with ACE context gathering and iterative cross-verification. Uses cli-discuss-agent for Gemini+Codex+Claude analysis to converge on optimal execution plan.", + "arguments": "[-y|--yes] <task description> [--max-rounds=3] [--tools=gemini,codex] [--mode=parallel|serial]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/multi-cli-plan.md" + }, + { + "name": "plan-verify", + "command": "/workflow:plan-verify", + "description": "Perform READ-ONLY verification analysis between IMPL_PLAN.md, task JSONs, and brainstorming artifacts. Generates structured report with quality gate recommendation. Does NOT modify any files.", + "arguments": "[optional: --session session-id]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/plan-verify.md" + }, + { + "name": "plan", + "command": "/workflow:plan", + "description": "5-phase planning workflow with action-planning-agent task generation, outputs IMPL_PLAN.md and task JSONs", + "arguments": "[-y|--yes] \\\"text description\\\"|file.md", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/plan.md" + }, + { + "name": "replan", + "command": "/workflow:replan", + "description": "Interactive workflow replanning with session-level artifact updates and boundary clarification through guided questioning", + "arguments": "[-y|--yes] [--session session-id] [task-id] \\\"requirements\\\"|file.md [--interactive]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/replan.md" + }, + { + "name": "review-cycle-fix", + "command": "/workflow:review-cycle-fix", + "description": "Automated fixing of code review findings with AI-powered planning and coordinated execution. Uses intelligent grouping, multi-stage timeline coordination, and test-driven verification.", + "arguments": "<export-file|review-dir> [--resume] [--max-iterations=N]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "analysis", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/review-cycle-fix.md" + }, + { + "name": "review-module-cycle", + "command": "/workflow:review-module-cycle", + "description": "Independent multi-dimensional code review for specified modules/files. Analyzes specific code paths across 7 dimensions with hybrid parallel-iterative execution, independent of workflow sessions.", + "arguments": "<path-pattern> [--dimensions=security,architecture,...] [--max-iterations=N]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "analysis", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/review-module-cycle.md" + }, + { + "name": "review-session-cycle", + "command": "/workflow:review-session-cycle", + "description": "Session-based comprehensive multi-dimensional code review. Analyzes git changes from workflow session across 7 dimensions with hybrid parallel-iterative execution, aggregates findings, and performs focused deep-dives on critical issues until quality gates met.", + "arguments": "[session-id] [--dimensions=security,architecture,...] [--max-iterations=N]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "session-management", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/review-session-cycle.md" + }, + { + "name": "review", + "command": "/workflow:review", + "description": "Post-implementation review with specialized types (security/architecture/action-items/quality) using analysis agents and Gemini", + "arguments": "[--type=security|architecture|action-items|quality] [--archived] [optional: session-id]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "analysis", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/review.md" + }, + { + "name": "tdd-plan", + "command": "/workflow:tdd-plan", + "description": "TDD workflow planning with Red-Green-Refactor task chain generation, test-first development structure, and cycle tracking", + "arguments": "\\\"feature description\\\"|file.md", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tdd-plan.md" + }, + { + "name": "tdd-verify", + "command": "/workflow:tdd-verify", + "description": "Verify TDD workflow compliance against Red-Green-Refactor cycles. Generates quality report with coverage analysis and quality gate recommendation. Orchestrates sub-commands for comprehensive validation.", + "arguments": "[optional: --session WFS-session-id]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "testing", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tdd-verify.md" + }, + { + "name": "test-cycle-execute", + "command": "/workflow:test-cycle-execute", + "description": "Execute test-fix workflow with dynamic task generation and iterative fix cycles until test pass rate >= 95% or max iterations reached. Uses @cli-planning-agent for failure analysis and task generation.", + "arguments": "[--resume-session=\\\"session-id\\\"] [--max-iterations=N]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/test-cycle-execute.md" + }, + { + "name": "test-fix-gen", + "command": "/workflow:test-fix-gen", + "description": "Create test-fix workflow session from session ID, description, or file path with test strategy generation and task planning", + "arguments": "(source-session-id | \\\"feature description\\\" | /path/to/file.md)", + "category": "workflow", + "subcategory": null, + "usage_scenario": "testing", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/test-fix-gen.md" + }, + { + "name": "test-gen", + "command": "/workflow:test-gen", + "description": "Create independent test-fix workflow session from completed implementation session, analyzes code to generate test tasks", + "arguments": "source-session-id", + "category": "workflow", + "subcategory": null, + "usage_scenario": "testing", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/test-gen.md" + }, + { + "name": "unified-execute-with-file", + "command": "/workflow:unified-execute-with-file", + "description": "Universal execution engine for consuming any planning/brainstorm/analysis output with minimal progress tracking, multi-agent coordination, and incremental execution", + "arguments": "[-y|--yes] [-p|--plan <path>] [-m|--mode sequential|parallel] [\\\"execution context or task name\\\"]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/unified-execute-with-file.md" + } + ], + "brainstorm": [ + { + "name": "artifacts", + "command": "/workflow:brainstorm:artifacts", + "description": "Interactive clarification generating confirmed guidance specification through role-based analysis and synthesis", + "arguments": "[-y|--yes] topic or challenge description [--count N]", + "category": "workflow", + "subcategory": "brainstorm", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/brainstorm/artifacts.md" + }, + { + "name": "auto-parallel", + "command": "/workflow:brainstorm:auto-parallel", + "description": "Parallel brainstorming automation with dynamic role selection and concurrent execution across multiple perspectives", + "arguments": "[-y|--yes] topic or challenge description [--count N]", + "category": "workflow", + "subcategory": "brainstorm", + "usage_scenario": "general", + "difficulty": "Advanced", + "source": "../../../commands/workflow/brainstorm/auto-parallel.md" + }, + { + "name": "role-analysis", + "command": "/workflow:brainstorm:role-analysis", + "description": "Unified role-specific analysis generation with interactive context gathering and incremental updates", + "arguments": "[role-name] [--session session-id] [--update] [--include-questions] [--skip-questions]", + "category": "workflow", + "subcategory": "brainstorm", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/brainstorm/role-analysis.md" + }, + { + "name": "synthesis", + "command": "/workflow:brainstorm:synthesis", + "description": "Clarify and refine role analyses through intelligent Q&A and targeted updates with synthesis agent", + "arguments": "[-y|--yes] [optional: --session session-id]", + "category": "workflow", + "subcategory": "brainstorm", + "usage_scenario": "general", + "difficulty": "Advanced", + "source": "../../../commands/workflow/brainstorm/synthesis.md" + } + ], + "session": [ + { + "name": "complete", + "command": "/workflow:session:complete", + "description": "Mark active workflow session as complete, archive with lessons learned, update manifest, remove active flag", + "arguments": "[-y|--yes] [--detailed]", + "category": "workflow", + "subcategory": "session", + "usage_scenario": "session-management", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/session/complete.md" + }, + { + "name": "list", + "command": "/workflow:session:list", + "description": "List all workflow sessions with status filtering, shows session metadata and progress information", + "arguments": "", + "category": "workflow", + "subcategory": "session", + "usage_scenario": "general", + "difficulty": "Beginner", + "source": "../../../commands/workflow/session/list.md" + }, + { + "name": "resume", + "command": "/workflow:session:resume", + "description": "Resume the most recently paused workflow session with automatic session discovery and status update", + "arguments": "", + "category": "workflow", + "subcategory": "session", + "usage_scenario": "session-management", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/session/resume.md" + }, + { + "name": "solidify", + "command": "/workflow:session:solidify", + "description": "Crystallize session learnings and user-defined constraints into permanent project guidelines", + "arguments": "[-y|--yes] [--type <convention|constraint|learning>] [--category <category>] \\\"rule or insight\\", + "category": "workflow", + "subcategory": "session", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/session/solidify.md" + }, + { + "name": "start", + "command": "/workflow:session:start", + "description": "Discover existing sessions or start new workflow session with intelligent session management and conflict detection", + "arguments": "[--type <workflow|review|tdd|test|docs>] [--auto|--new] [optional: task description for new session]", + "category": "workflow", + "subcategory": "session", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/session/start.md" + } + ], + "tools": [ + { + "name": "conflict-resolution", + "command": "/workflow:tools:conflict-resolution", + "description": "Detect and resolve conflicts between plan and existing codebase using CLI-powered analysis with Gemini/Qwen", + "arguments": "[-y|--yes] --session WFS-session-id --context path/to/context-package.json", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "general", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tools/conflict-resolution.md" + }, + { + "name": "gather", + "command": "/workflow:tools:gather", + "description": "Intelligently collect project context using context-search-agent based on task description, packages into standardized JSON", + "arguments": "--session WFS-session-id \\\"task description\\", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/tools/context-gather.md" + }, + { + "name": "task-generate-agent", + "command": "/workflow:tools:task-generate-agent", + "description": "Generate implementation plan documents (IMPL_PLAN.md, task JSONs, TODO_LIST.md) using action-planning-agent - produces planning artifacts, does NOT execute code implementation", + "arguments": "[-y|--yes] --session WFS-session-id", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "implementation", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tools/task-generate-agent.md" + }, + { + "name": "task-generate-tdd", + "command": "/workflow:tools:task-generate-tdd", + "description": "Autonomous TDD task generation using action-planning-agent with Red-Green-Refactor cycles, test-first structure, and cycle validation", + "arguments": "[-y|--yes] --session WFS-session-id", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "implementation", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tools/task-generate-tdd.md" + }, + { + "name": "tdd-coverage-analysis", + "command": "/workflow:tools:tdd-coverage-analysis", + "description": "Analyze test coverage and TDD cycle execution with Red-Green-Refactor compliance verification", + "arguments": "--session WFS-session-id", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "testing", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tools/tdd-coverage-analysis.md" + }, + { + "name": "test-concept-enhanced", + "command": "/workflow:tools:test-concept-enhanced", + "description": "Coordinate test analysis workflow using cli-execution-agent to generate test strategy via Gemini", + "arguments": "--session WFS-test-session-id --context path/to/test-context-package.json", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "testing", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/tools/test-concept-enhanced.md" + }, + { + "name": "test-context-gather", + "command": "/workflow:tools:test-context-gather", + "description": "Collect test coverage context using test-context-search-agent and package into standardized test-context JSON", + "arguments": "--session WFS-test-session-id", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "testing", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/tools/test-context-gather.md" + }, + { + "name": "test-task-generate", + "command": "/workflow:tools:test-task-generate", + "description": "Generate test planning documents (IMPL_PLAN.md, test task JSONs, TODO_LIST.md) using action-planning-agent - produces test planning artifacts, does NOT execute tests", + "arguments": "--session WFS-test-session-id", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/tools/test-task-generate.md" + } + ], + "ui-design": [ + { + "name": "animation-extract", + "command": "/workflow:ui-design:animation-extract", + "description": "Extract animation and transition patterns from prompt inference and image references for design system documentation", + "arguments": "[-y|--yes] [--design-id <id>] [--session <id>] [--images \"<glob>\"] [--focus \"<types>\"] [--interactive] [--refine]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/animation-extract.md" + }, + { + "name": "workflow:ui-design:codify-style", + "command": "/workflow:ui-design:codify-style", + "description": "Orchestrator to extract styles from code and generate shareable reference package with preview (automatic file discovery)", + "arguments": "<path> [--package-name <name>] [--output-dir <path>] [--overwrite]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/codify-style.md" + }, + { + "name": "design-sync", + "command": "/workflow:ui-design:design-sync", + "description": "Synchronize finalized design system references to brainstorming artifacts, preparing them for /workflow:plan consumption", + "arguments": "--session <session_id> [--selected-prototypes \"<list>\"]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/design-sync.md" + }, + { + "name": "explore-auto", + "command": "/workflow:ui-design:explore-auto", + "description": "Interactive exploratory UI design workflow with style-centric batch generation, creates design variants from prompts/images with parallel execution and user selection", + "arguments": "[--input \"<value>\"] [--targets \"<list>\"] [--target-type \"page|component\"] [--session <id>] [--style-variants <count>] [--layout-variants <count>]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/explore-auto.md" + }, + { + "name": "generate", + "command": "/workflow:ui-design:generate", + "description": "Assemble UI prototypes by combining layout templates with design tokens (default animation support), pure assembler without new content generation", + "arguments": "[--design-id <id>] [--session <id>]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/generate.md" + }, + { + "name": "imitate-auto", + "command": "/workflow:ui-design:imitate-auto", + "description": "UI design workflow with direct code/image input for design token extraction and prototype generation", + "arguments": "[--input \"<value>\"] [--session <id>]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/imitate-auto.md" + }, + { + "name": "workflow:ui-design:import-from-code", + "command": "/workflow:ui-design:import-from-code", + "description": "Import design system from code files (CSS/JS/HTML/SCSS) with automatic file discovery and parallel agent analysis", + "arguments": "[--design-id <id>] [--session <id>] [--source <path>]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/import-from-code.md" + }, + { + "name": "layout-extract", + "command": "/workflow:ui-design:layout-extract", + "description": "Extract structural layout information from reference images or text prompts using Claude analysis with variant generation or refinement mode", + "arguments": "[-y|--yes] [--design-id <id>] [--session <id>] [--images \"<glob>\"] [--prompt \"<desc>\"] [--targets \"<list>\"] [--variants <count>] [--device-type <desktop|mobile|tablet|responsive>] [--interactive] [--refine]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/layout-extract.md" + }, + { + "name": "workflow:ui-design:reference-page-generator", + "command": "/workflow:ui-design:reference-page-generator", + "description": "Generate multi-component reference pages and documentation from design run extraction", + "arguments": "[--design-run <path>] [--package-name <name>] [--output-dir <path>]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/reference-page-generator.md" + }, + { + "name": "style-extract", + "command": "/workflow:ui-design:style-extract", + "description": "Extract design style from reference images or text prompts using Claude analysis with variant generation or refinement mode", + "arguments": "[-y|--yes] [--design-id <id>] [--session <id>] [--images \"<glob>\"] [--prompt \"<desc>\"] [--variants <count>] [--interactive] [--refine]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/style-extract.md" + } + ] + } +} \ No newline at end of file diff --git a/.claude/skills/ccw-help/index/by-use-case.json b/.claude/skills/ccw-help/index/by-use-case.json new file mode 100644 index 00000000..3ad91b2d --- /dev/null +++ b/.claude/skills/ccw-help/index/by-use-case.json @@ -0,0 +1,819 @@ +{ + "general": [ + { + "name": "ccw-coordinator", + "command": "/ccw-coordinator", + "description": "Command orchestration tool - analyze requirements, recommend chain, execute sequentially with state persistence", + "arguments": "[task description]", + "category": "general", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/ccw-coordinator.md" + }, + { + "name": "ccw-debug", + "command": "/ccw-debug", + "description": "Aggregated debug command - combines debugging diagnostics and test verification in a synergistic workflow supporting cli-quick / debug-first / test-first / bidirectional-verification modes", + "arguments": "[--mode cli|debug|test|bidirectional] [--yes|-y] [--hotfix] \\\"bug description or error message\\", + "category": "general", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/ccw-debug.md" + }, + { + "name": "ccw", + "command": "/ccw", + "description": "Main workflow orchestrator - analyze intent, select workflow, execute command chain in main process", + "arguments": "\\\"task description\\", + "category": "general", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/ccw.md" + }, + { + "name": "cli-init", + "command": "/cli:cli-init", + "description": "Generate .gemini/ and .qwen/ config directories with settings.json and ignore files based on workspace technology detection", + "arguments": "[--tool gemini|qwen|all] [--output path] [--preview]", + "category": "cli", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/cli/cli-init.md" + }, + { + "name": "issue:discover-by-prompt", + "command": "/issue:discover-by-prompt", + "description": "Discover issues from user prompt with Gemini-planned iterative multi-agent exploration. Uses ACE semantic search for context gathering and supports cross-module comparison (e.g., frontend vs backend API contracts).", + "arguments": "[-y|--yes] <prompt> [--scope=src/**] [--depth=standard|deep] [--max-iterations=5]", + "category": "issue", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/issue/discover-by-prompt.md" + }, + { + "name": "issue:discover", + "command": "/issue:discover", + "description": "Discover potential issues from multiple perspectives (bug, UX, test, quality, security, performance, maintainability, best-practices) using CLI explore. Supports Exa external research for security and best-practices perspectives.", + "arguments": "[-y|--yes] <path-pattern> [--perspectives=bug,ux,...] [--external]", + "category": "issue", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/issue/discover.md" + }, + { + "name": "new", + "command": "/issue:new", + "description": "Create structured issue from GitHub URL or text description", + "arguments": "[-y|--yes] <github-url | text-description> [--priority 1-5]", + "category": "issue", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/issue/new.md" + }, + { + "name": "queue", + "command": "/issue:queue", + "description": "Form execution queue from bound solutions using issue-queue-agent (solution-level)", + "arguments": "[-y|--yes] [--queues <n>] [--issue <id>]", + "category": "issue", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/issue/queue.md" + }, + { + "name": "compact", + "command": "/memory:compact", + "description": "Compact current session memory into structured text for session recovery, extracting objective/plan/files/decisions/constraints/state, and save via MCP core_memory tool", + "arguments": "[optional: session description]", + "category": "memory", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/memory/compact.md" + }, + { + "name": "load", + "command": "/memory:load", + "description": "Delegate to universal-executor agent to analyze project via Gemini/Qwen CLI and return JSON core content package for task context", + "arguments": "[--tool gemini|qwen] \\\"task context description\\", + "category": "memory", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/memory/load.md" + }, + { + "name": "tips", + "command": "/memory:tips", + "description": "Quick note-taking command to capture ideas, snippets, reminders, and insights for later reference", + "arguments": "<note content> [--tag <tag1,tag2>] [--context <context>]", + "category": "memory", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/memory/tips.md" + }, + { + "name": "update-full", + "command": "/memory:update-full", + "description": "Update all CLAUDE.md files using layer-based execution (Layer 3→1) with batched agents (4 modules/agent) and gemini→qwen→codex fallback, <20 modules uses direct parallel", + "arguments": "[--tool gemini|qwen|codex] [--path <directory>]", + "category": "memory", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/memory/update-full.md" + }, + { + "name": "update-related", + "command": "/memory:update-related", + "description": "Update CLAUDE.md for git-changed modules using batched agent execution (4 modules/agent) with gemini→qwen→codex fallback, <15 modules uses direct execution", + "arguments": "[--tool gemini|qwen|codex]", + "category": "memory", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/memory/update-related.md" + }, + { + "name": "ccw view", + "command": "/ccw view", + "description": "Dashboard - Open CCW workflow dashboard for managing tasks and sessions", + "arguments": "", + "category": "general", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/view.md" + }, + { + "name": "artifacts", + "command": "/workflow:brainstorm:artifacts", + "description": "Interactive clarification generating confirmed guidance specification through role-based analysis and synthesis", + "arguments": "[-y|--yes] topic or challenge description [--count N]", + "category": "workflow", + "subcategory": "brainstorm", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/brainstorm/artifacts.md" + }, + { + "name": "auto-parallel", + "command": "/workflow:brainstorm:auto-parallel", + "description": "Parallel brainstorming automation with dynamic role selection and concurrent execution across multiple perspectives", + "arguments": "[-y|--yes] topic or challenge description [--count N]", + "category": "workflow", + "subcategory": "brainstorm", + "usage_scenario": "general", + "difficulty": "Advanced", + "source": "../../../commands/workflow/brainstorm/auto-parallel.md" + }, + { + "name": "role-analysis", + "command": "/workflow:brainstorm:role-analysis", + "description": "Unified role-specific analysis generation with interactive context gathering and incremental updates", + "arguments": "[role-name] [--session session-id] [--update] [--include-questions] [--skip-questions]", + "category": "workflow", + "subcategory": "brainstorm", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/brainstorm/role-analysis.md" + }, + { + "name": "synthesis", + "command": "/workflow:brainstorm:synthesis", + "description": "Clarify and refine role analyses through intelligent Q&A and targeted updates with synthesis agent", + "arguments": "[-y|--yes] [optional: --session session-id]", + "category": "workflow", + "subcategory": "brainstorm", + "usage_scenario": "general", + "difficulty": "Advanced", + "source": "../../../commands/workflow/brainstorm/synthesis.md" + }, + { + "name": "clean", + "command": "/workflow:clean", + "description": "Intelligent code cleanup with mainline detection, stale artifact discovery, and safe execution", + "arguments": "[-y|--yes] [--dry-run] [\\\"focus area\\\"]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/clean.md" + }, + { + "name": "debug-with-file", + "command": "/workflow:debug-with-file", + "description": "Interactive hypothesis-driven debugging with documented exploration, understanding evolution, and Gemini-assisted correction", + "arguments": "[-y|--yes] \\\"bug description or error message\\", + "category": "workflow", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/debug-with-file.md" + }, + { + "name": "init", + "command": "/workflow:init", + "description": "Initialize project-level state with intelligent project analysis using cli-explore-agent", + "arguments": "[--regenerate]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/init.md" + }, + { + "name": "lite-fix", + "command": "/workflow:lite-fix", + "description": "Lightweight bug diagnosis and fix workflow with intelligent severity assessment and optional hotfix mode for production incidents", + "arguments": "[-y|--yes] [--hotfix] \\\"bug description or issue reference\\", + "category": "workflow", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/lite-fix.md" + }, + { + "name": "workflow:lite-lite-lite", + "command": "/workflow:lite-lite-lite", + "description": "Ultra-lightweight multi-tool analysis and direct execution. No artifacts for simple tasks; auto-creates planning docs in .workflow/.scratchpad/ for complex tasks. Auto tool selection based on task analysis, user-driven iteration via AskUser.", + "arguments": "[-y|--yes] <task description>", + "category": "workflow", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/lite-lite-lite.md" + }, + { + "name": "list", + "command": "/workflow:session:list", + "description": "List all workflow sessions with status filtering, shows session metadata and progress information", + "arguments": "", + "category": "workflow", + "subcategory": "session", + "usage_scenario": "general", + "difficulty": "Beginner", + "source": "../../../commands/workflow/session/list.md" + }, + { + "name": "solidify", + "command": "/workflow:session:solidify", + "description": "Crystallize session learnings and user-defined constraints into permanent project guidelines", + "arguments": "[-y|--yes] [--type <convention|constraint|learning>] [--category <category>] \\\"rule or insight\\", + "category": "workflow", + "subcategory": "session", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/session/solidify.md" + }, + { + "name": "start", + "command": "/workflow:session:start", + "description": "Discover existing sessions or start new workflow session with intelligent session management and conflict detection", + "arguments": "[--type <workflow|review|tdd|test|docs>] [--auto|--new] [optional: task description for new session]", + "category": "workflow", + "subcategory": "session", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/session/start.md" + }, + { + "name": "conflict-resolution", + "command": "/workflow:tools:conflict-resolution", + "description": "Detect and resolve conflicts between plan and existing codebase using CLI-powered analysis with Gemini/Qwen", + "arguments": "[-y|--yes] --session WFS-session-id --context path/to/context-package.json", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "general", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tools/conflict-resolution.md" + }, + { + "name": "gather", + "command": "/workflow:tools:gather", + "description": "Intelligently collect project context using context-search-agent based on task description, packages into standardized JSON", + "arguments": "--session WFS-session-id \\\"task description\\", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/tools/context-gather.md" + }, + { + "name": "animation-extract", + "command": "/workflow:ui-design:animation-extract", + "description": "Extract animation and transition patterns from prompt inference and image references for design system documentation", + "arguments": "[-y|--yes] [--design-id <id>] [--session <id>] [--images \"<glob>\"] [--focus \"<types>\"] [--interactive] [--refine]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/animation-extract.md" + }, + { + "name": "explore-auto", + "command": "/workflow:ui-design:explore-auto", + "description": "Interactive exploratory UI design workflow with style-centric batch generation, creates design variants from prompts/images with parallel execution and user selection", + "arguments": "[--input \"<value>\"] [--targets \"<list>\"] [--target-type \"page|component\"] [--session <id>] [--style-variants <count>] [--layout-variants <count>]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/explore-auto.md" + }, + { + "name": "imitate-auto", + "command": "/workflow:ui-design:imitate-auto", + "description": "UI design workflow with direct code/image input for design token extraction and prototype generation", + "arguments": "[--input \"<value>\"] [--session <id>]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/imitate-auto.md" + }, + { + "name": "layout-extract", + "command": "/workflow:ui-design:layout-extract", + "description": "Extract structural layout information from reference images or text prompts using Claude analysis with variant generation or refinement mode", + "arguments": "[-y|--yes] [--design-id <id>] [--session <id>] [--images \"<glob>\"] [--prompt \"<desc>\"] [--targets \"<list>\"] [--variants <count>] [--device-type <desktop|mobile|tablet|responsive>] [--interactive] [--refine]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/layout-extract.md" + }, + { + "name": "style-extract", + "command": "/workflow:ui-design:style-extract", + "description": "Extract design style from reference images or text prompts using Claude analysis with variant generation or refinement mode", + "arguments": "[-y|--yes] [--design-id <id>] [--session <id>] [--images \"<glob>\"] [--prompt \"<desc>\"] [--variants <count>] [--interactive] [--refine]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/style-extract.md" + } + ], + "analysis": [ + { + "name": "codex-review", + "command": "/cli:codex-review", + "description": "Interactive code review using Codex CLI via ccw endpoint with configurable review target, model, and custom instructions", + "arguments": "[--uncommitted|--base <branch>|--commit <sha>] [--model <model>] [--title <title>] [prompt]", + "category": "cli", + "subcategory": null, + "usage_scenario": "analysis", + "difficulty": "Intermediate", + "source": "../../../commands/cli/codex-review.md" + }, + { + "name": "analyze-with-file", + "command": "/workflow:analyze-with-file", + "description": "Interactive collaborative analysis with documented discussions, CLI-assisted exploration, and evolving understanding", + "arguments": "[-y|--yes] [-c|--continue] \\\"topic or question\\", + "category": "workflow", + "subcategory": null, + "usage_scenario": "analysis", + "difficulty": "Beginner", + "source": "../../../commands/workflow/analyze-with-file.md" + }, + { + "name": "review-cycle-fix", + "command": "/workflow:review-cycle-fix", + "description": "Automated fixing of code review findings with AI-powered planning and coordinated execution. Uses intelligent grouping, multi-stage timeline coordination, and test-driven verification.", + "arguments": "<export-file|review-dir> [--resume] [--max-iterations=N]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "analysis", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/review-cycle-fix.md" + }, + { + "name": "review-module-cycle", + "command": "/workflow:review-module-cycle", + "description": "Independent multi-dimensional code review for specified modules/files. Analyzes specific code paths across 7 dimensions with hybrid parallel-iterative execution, independent of workflow sessions.", + "arguments": "<path-pattern> [--dimensions=security,architecture,...] [--max-iterations=N]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "analysis", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/review-module-cycle.md" + }, + { + "name": "review", + "command": "/workflow:review", + "description": "Post-implementation review with specialized types (security/architecture/action-items/quality) using analysis agents and Gemini", + "arguments": "[--type=security|architecture|action-items|quality] [--archived] [optional: session-id]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "analysis", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/review.md" + } + ], + "planning": [ + { + "name": "convert-to-plan", + "command": "/issue:convert-to-plan", + "description": "Convert planning artifacts (lite-plan, workflow session, markdown) to issue solutions", + "arguments": "[-y|--yes] [--issue <id>] [--supplement] <SOURCE>", + "category": "issue", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/issue/convert-to-plan.md" + }, + { + "name": "from-brainstorm", + "command": "/issue:from-brainstorm", + "description": "Convert brainstorm session ideas into issue with executable solution for parallel-dev-cycle", + "arguments": "SESSION=\\\"<session-id>\\\" [--idea=<index>] [--auto] [-y|--yes]", + "category": "issue", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/issue/from-brainstorm.md" + }, + { + "name": "plan", + "command": "/issue:plan", + "description": "Batch plan issue resolution using issue-plan-agent (explore + plan closed-loop)", + "arguments": "[-y|--yes] --all-pending <issue-id>[,<issue-id>,...] [--batch-size 3]", + "category": "issue", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/issue/plan.md" + }, + { + "name": "brainstorm-with-file", + "command": "/workflow:brainstorm-with-file", + "description": "Interactive brainstorming with multi-CLI collaboration, idea expansion, and documented thought evolution", + "arguments": "[-y|--yes] [-c|--continue] [-m|--mode creative|structured] \\\"idea or topic\\", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/brainstorm-with-file.md" + }, + { + "name": "lite-plan", + "command": "/workflow:lite-plan", + "description": "Lightweight interactive planning workflow with in-memory planning, code exploration, and execution execute to lite-execute after user confirmation", + "arguments": "[-y|--yes] [-e|--explore] \\\"task description\\\"|file.md", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/lite-plan.md" + }, + { + "name": "workflow:multi-cli-plan", + "command": "/workflow:multi-cli-plan", + "description": "Multi-CLI collaborative planning workflow with ACE context gathering and iterative cross-verification. Uses cli-discuss-agent for Gemini+Codex+Claude analysis to converge on optimal execution plan.", + "arguments": "[-y|--yes] <task description> [--max-rounds=3] [--tools=gemini,codex] [--mode=parallel|serial]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/multi-cli-plan.md" + }, + { + "name": "plan-verify", + "command": "/workflow:plan-verify", + "description": "Perform READ-ONLY verification analysis between IMPL_PLAN.md, task JSONs, and brainstorming artifacts. Generates structured report with quality gate recommendation. Does NOT modify any files.", + "arguments": "[optional: --session session-id]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/plan-verify.md" + }, + { + "name": "plan", + "command": "/workflow:plan", + "description": "5-phase planning workflow with action-planning-agent task generation, outputs IMPL_PLAN.md and task JSONs", + "arguments": "[-y|--yes] \\\"text description\\\"|file.md", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/plan.md" + }, + { + "name": "replan", + "command": "/workflow:replan", + "description": "Interactive workflow replanning with session-level artifact updates and boundary clarification through guided questioning", + "arguments": "[-y|--yes] [--session session-id] [task-id] \\\"requirements\\\"|file.md [--interactive]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/replan.md" + }, + { + "name": "tdd-plan", + "command": "/workflow:tdd-plan", + "description": "TDD workflow planning with Red-Green-Refactor task chain generation, test-first development structure, and cycle tracking", + "arguments": "\\\"feature description\\\"|file.md", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tdd-plan.md" + }, + { + "name": "workflow:ui-design:codify-style", + "command": "/workflow:ui-design:codify-style", + "description": "Orchestrator to extract styles from code and generate shareable reference package with preview (automatic file discovery)", + "arguments": "<path> [--package-name <name>] [--output-dir <path>] [--overwrite]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/codify-style.md" + }, + { + "name": "design-sync", + "command": "/workflow:ui-design:design-sync", + "description": "Synchronize finalized design system references to brainstorming artifacts, preparing them for /workflow:plan consumption", + "arguments": "--session <session_id> [--selected-prototypes \"<list>\"]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/design-sync.md" + }, + { + "name": "workflow:ui-design:import-from-code", + "command": "/workflow:ui-design:import-from-code", + "description": "Import design system from code files (CSS/JS/HTML/SCSS) with automatic file discovery and parallel agent analysis", + "arguments": "[--design-id <id>] [--session <id>] [--source <path>]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/import-from-code.md" + }, + { + "name": "workflow:ui-design:reference-page-generator", + "command": "/workflow:ui-design:reference-page-generator", + "description": "Generate multi-component reference pages and documentation from design run extraction", + "arguments": "[--design-run <path>] [--package-name <name>] [--output-dir <path>]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/reference-page-generator.md" + } + ], + "implementation": [ + { + "name": "execute", + "command": "/issue:execute", + "description": "Execute queue with DAG-based parallel orchestration (one commit per solution)", + "arguments": "[-y|--yes] --queue <queue-id> [--worktree [<existing-path>]]", + "category": "issue", + "subcategory": null, + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/issue/execute.md" + }, + { + "name": "execute", + "command": "/workflow:execute", + "description": "Coordinate agent execution for workflow tasks with automatic session discovery, parallel task processing, and status tracking", + "arguments": "[-y|--yes] [--resume-session=\\\"session-id\\\"]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/execute.md" + }, + { + "name": "lite-execute", + "command": "/workflow:lite-execute", + "description": "Execute tasks based on in-memory plan, prompt description, or file content", + "arguments": "[-y|--yes] [--in-memory] [\\\"task description\\\"|file-path]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/lite-execute.md" + }, + { + "name": "test-cycle-execute", + "command": "/workflow:test-cycle-execute", + "description": "Execute test-fix workflow with dynamic task generation and iterative fix cycles until test pass rate >= 95% or max iterations reached. Uses @cli-planning-agent for failure analysis and task generation.", + "arguments": "[--resume-session=\\\"session-id\\\"] [--max-iterations=N]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/test-cycle-execute.md" + }, + { + "name": "task-generate-agent", + "command": "/workflow:tools:task-generate-agent", + "description": "Generate implementation plan documents (IMPL_PLAN.md, task JSONs, TODO_LIST.md) using action-planning-agent - produces planning artifacts, does NOT execute code implementation", + "arguments": "[-y|--yes] --session WFS-session-id", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "implementation", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tools/task-generate-agent.md" + }, + { + "name": "task-generate-tdd", + "command": "/workflow:tools:task-generate-tdd", + "description": "Autonomous TDD task generation using action-planning-agent with Red-Green-Refactor cycles, test-first structure, and cycle validation", + "arguments": "[-y|--yes] --session WFS-session-id", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "implementation", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tools/task-generate-tdd.md" + }, + { + "name": "test-task-generate", + "command": "/workflow:tools:test-task-generate", + "description": "Generate test planning documents (IMPL_PLAN.md, test task JSONs, TODO_LIST.md) using action-planning-agent - produces test planning artifacts, does NOT execute tests", + "arguments": "--session WFS-test-session-id", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/tools/test-task-generate.md" + }, + { + "name": "generate", + "command": "/workflow:ui-design:generate", + "description": "Assemble UI prototypes by combining layout templates with design tokens (default animation support), pure assembler without new content generation", + "arguments": "[--design-id <id>] [--session <id>]", + "category": "workflow", + "subcategory": "ui-design", + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/ui-design/generate.md" + }, + { + "name": "unified-execute-with-file", + "command": "/workflow:unified-execute-with-file", + "description": "Universal execution engine for consuming any planning/brainstorm/analysis output with minimal progress tracking, multi-agent coordination, and incremental execution", + "arguments": "[-y|--yes] [-p|--plan <path>] [-m|--mode sequential|parallel] [\\\"execution context or task name\\\"]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/unified-execute-with-file.md" + } + ], + "documentation": [ + { + "name": "docs-full-cli", + "command": "/memory:docs-full-cli", + "description": "Generate full project documentation using CLI execution (Layer 3→1) with batched agents (4 modules/agent) and gemini→qwen→codex fallback, <20 modules uses direct parallel", + "arguments": "[path] [--tool <gemini|qwen|codex>]", + "category": "memory", + "subcategory": null, + "usage_scenario": "documentation", + "difficulty": "Intermediate", + "source": "../../../commands/memory/docs-full-cli.md" + }, + { + "name": "docs-related-cli", + "command": "/memory:docs-related-cli", + "description": "Generate/update documentation for git-changed modules using CLI execution with batched agents (4 modules/agent) and gemini→qwen→codex fallback, <15 modules uses direct parallel", + "arguments": "[--tool <gemini|qwen|codex>]", + "category": "memory", + "subcategory": null, + "usage_scenario": "documentation", + "difficulty": "Intermediate", + "source": "../../../commands/memory/docs-related-cli.md" + }, + { + "name": "style-skill-memory", + "command": "/memory:style-skill-memory", + "description": "Generate SKILL memory package from style reference for easy loading and consistent design system usage", + "arguments": "[package-name] [--regenerate]", + "category": "memory", + "subcategory": null, + "usage_scenario": "documentation", + "difficulty": "Intermediate", + "source": "../../../commands/memory/style-skill-memory.md" + } + ], + "session-management": [ + { + "name": "review-session-cycle", + "command": "/workflow:review-session-cycle", + "description": "Session-based comprehensive multi-dimensional code review. Analyzes git changes from workflow session across 7 dimensions with hybrid parallel-iterative execution, aggregates findings, and performs focused deep-dives on critical issues until quality gates met.", + "arguments": "[session-id] [--dimensions=security,architecture,...] [--max-iterations=N]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "session-management", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/review-session-cycle.md" + }, + { + "name": "complete", + "command": "/workflow:session:complete", + "description": "Mark active workflow session as complete, archive with lessons learned, update manifest, remove active flag", + "arguments": "[-y|--yes] [--detailed]", + "category": "workflow", + "subcategory": "session", + "usage_scenario": "session-management", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/session/complete.md" + }, + { + "name": "resume", + "command": "/workflow:session:resume", + "description": "Resume the most recently paused workflow session with automatic session discovery and status update", + "arguments": "", + "category": "workflow", + "subcategory": "session", + "usage_scenario": "session-management", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/session/resume.md" + } + ], + "testing": [ + { + "name": "tdd-verify", + "command": "/workflow:tdd-verify", + "description": "Verify TDD workflow compliance against Red-Green-Refactor cycles. Generates quality report with coverage analysis and quality gate recommendation. Orchestrates sub-commands for comprehensive validation.", + "arguments": "[optional: --session WFS-session-id]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "testing", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tdd-verify.md" + }, + { + "name": "test-fix-gen", + "command": "/workflow:test-fix-gen", + "description": "Create test-fix workflow session from session ID, description, or file path with test strategy generation and task planning", + "arguments": "(source-session-id | \\\"feature description\\\" | /path/to/file.md)", + "category": "workflow", + "subcategory": null, + "usage_scenario": "testing", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/test-fix-gen.md" + }, + { + "name": "test-gen", + "command": "/workflow:test-gen", + "description": "Create independent test-fix workflow session from completed implementation session, analyzes code to generate test tasks", + "arguments": "source-session-id", + "category": "workflow", + "subcategory": null, + "usage_scenario": "testing", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/test-gen.md" + }, + { + "name": "tdd-coverage-analysis", + "command": "/workflow:tools:tdd-coverage-analysis", + "description": "Analyze test coverage and TDD cycle execution with Red-Green-Refactor compliance verification", + "arguments": "--session WFS-session-id", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "testing", + "difficulty": "Advanced", + "source": "../../../commands/workflow/tools/tdd-coverage-analysis.md" + }, + { + "name": "test-concept-enhanced", + "command": "/workflow:tools:test-concept-enhanced", + "description": "Coordinate test analysis workflow using cli-execution-agent to generate test strategy via Gemini", + "arguments": "--session WFS-test-session-id --context path/to/test-context-package.json", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "testing", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/tools/test-concept-enhanced.md" + }, + { + "name": "test-context-gather", + "command": "/workflow:tools:test-context-gather", + "description": "Collect test coverage context using test-context-search-agent and package into standardized test-context JSON", + "arguments": "--session WFS-test-session-id", + "category": "workflow", + "subcategory": "tools", + "usage_scenario": "testing", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/tools/test-context-gather.md" + } + ] +} \ No newline at end of file diff --git a/.claude/skills/ccw-help/index/command-relationships.json b/.claude/skills/ccw-help/index/command-relationships.json new file mode 100644 index 00000000..f5260792 --- /dev/null +++ b/.claude/skills/ccw-help/index/command-relationships.json @@ -0,0 +1,160 @@ +{ + "workflow:plan": { + "calls_internally": [ + "workflow:session:start", + "workflow:tools:context-gather", + "workflow:tools:conflict-resolution", + "workflow:tools:task-generate-agent" + ], + "next_steps": [ + "workflow:plan-verify", + "workflow:status", + "workflow:execute" + ], + "alternatives": [ + "workflow:tdd-plan" + ], + "prerequisites": [] + }, + "workflow:tdd-plan": { + "calls_internally": [ + "workflow:session:start", + "workflow:tools:context-gather", + "workflow:tools:task-generate-tdd" + ], + "next_steps": [ + "workflow:tdd-verify", + "workflow:status", + "workflow:execute" + ], + "alternatives": [ + "workflow:plan" + ], + "prerequisites": [] + }, + "workflow:execute": { + "prerequisites": [ + "workflow:plan", + "workflow:tdd-plan" + ], + "related": [ + "workflow:status", + "workflow:resume" + ], + "next_steps": [ + "workflow:review", + "workflow:tdd-verify" + ] + }, + "workflow:plan-verify": { + "prerequisites": [ + "workflow:plan" + ], + "next_steps": [ + "workflow:execute" + ], + "related": [ + "workflow:status" + ] + }, + "workflow:tdd-verify": { + "prerequisites": [ + "workflow:execute" + ], + "related": [ + "workflow:tools:tdd-coverage-analysis" + ] + }, + "workflow:session:start": { + "next_steps": [ + "workflow:plan", + "workflow:execute" + ], + "related": [ + "workflow:session:list", + "workflow:session:resume" + ] + }, + "workflow:session:resume": { + "alternatives": [ + "workflow:resume" + ], + "related": [ + "workflow:session:list", + "workflow:status" + ] + }, + "workflow:lite-plan": { + "calls_internally": [ + "workflow:lite-execute" + ], + "next_steps": [ + "workflow:lite-execute", + "workflow:status" + ], + "alternatives": [ + "workflow:plan" + ], + "prerequisites": [] + }, + "workflow:lite-fix": { + "next_steps": [ + "workflow:lite-execute", + "workflow:status" + ], + "alternatives": [ + "workflow:lite-plan" + ], + "related": [ + "workflow:test-cycle-execute" + ] + }, + "workflow:lite-execute": { + "prerequisites": [ + "workflow:lite-plan", + "workflow:lite-fix" + ], + "related": [ + "workflow:execute", + "workflow:status" + ] + }, + "workflow:review-session-cycle": { + "prerequisites": [ + "workflow:execute" + ], + "next_steps": [ + "workflow:review-fix" + ], + "related": [ + "workflow:review-module-cycle" + ] + }, + "workflow:review-fix": { + "prerequisites": [ + "workflow:review-module-cycle", + "workflow:review-session-cycle" + ], + "related": [ + "workflow:test-cycle-execute" + ] + }, + "memory:docs": { + "calls_internally": [ + "workflow:session:start", + "workflow:tools:context-gather" + ], + "next_steps": [ + "workflow:execute" + ] + }, + "memory:skill-memory": { + "next_steps": [ + "workflow:plan", + "cli:analyze" + ], + "related": [ + "memory:load-skill-memory" + ] + } +} \ No newline at end of file diff --git a/.claude/skills/ccw-help/index/essential-commands.json b/.claude/skills/ccw-help/index/essential-commands.json new file mode 100644 index 00000000..9a1bc0d6 --- /dev/null +++ b/.claude/skills/ccw-help/index/essential-commands.json @@ -0,0 +1,90 @@ +[ + { + "name": "lite-plan", + "command": "/workflow:lite-plan", + "description": "Lightweight interactive planning workflow with in-memory planning, code exploration, and execution execute to lite-execute after user confirmation", + "arguments": "[-y|--yes] [-e|--explore] \\\"task description\\\"|file.md", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/lite-plan.md" + }, + { + "name": "lite-fix", + "command": "/workflow:lite-fix", + "description": "Lightweight bug diagnosis and fix workflow with intelligent severity assessment and optional hotfix mode for production incidents", + "arguments": "[-y|--yes] [--hotfix] \\\"bug description or issue reference\\", + "category": "workflow", + "subcategory": null, + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/lite-fix.md" + }, + { + "name": "plan", + "command": "/workflow:plan", + "description": "5-phase planning workflow with action-planning-agent task generation, outputs IMPL_PLAN.md and task JSONs", + "arguments": "[-y|--yes] \\\"text description\\\"|file.md", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/plan.md" + }, + { + "name": "execute", + "command": "/workflow:execute", + "description": "Coordinate agent execution for workflow tasks with automatic session discovery, parallel task processing, and status tracking", + "arguments": "[-y|--yes] [--resume-session=\\\"session-id\\\"]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "implementation", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/execute.md" + }, + { + "name": "start", + "command": "/workflow:session:start", + "description": "Discover existing sessions or start new workflow session with intelligent session management and conflict detection", + "arguments": "[--type <workflow|review|tdd|test|docs>] [--auto|--new] [optional: task description for new session]", + "category": "workflow", + "subcategory": "session", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/session/start.md" + }, + { + "name": "review-session-cycle", + "command": "/workflow:review-session-cycle", + "description": "Session-based comprehensive multi-dimensional code review. Analyzes git changes from workflow session across 7 dimensions with hybrid parallel-iterative execution, aggregates findings, and performs focused deep-dives on critical issues until quality gates met.", + "arguments": "[session-id] [--dimensions=security,architecture,...] [--max-iterations=N]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "session-management", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/review-session-cycle.md" + }, + { + "name": "artifacts", + "command": "/workflow:brainstorm:artifacts", + "description": "Interactive clarification generating confirmed guidance specification through role-based analysis and synthesis", + "arguments": "[-y|--yes] topic or challenge description [--count N]", + "category": "workflow", + "subcategory": "brainstorm", + "usage_scenario": "general", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/brainstorm/artifacts.md" + }, + { + "name": "plan-verify", + "command": "/workflow:plan-verify", + "description": "Perform READ-ONLY verification analysis between IMPL_PLAN.md, task JSONs, and brainstorming artifacts. Generates structured report with quality gate recommendation. Does NOT modify any files.", + "arguments": "[optional: --session session-id]", + "category": "workflow", + "subcategory": null, + "usage_scenario": "planning", + "difficulty": "Intermediate", + "source": "../../../commands/workflow/plan-verify.md" + } +] \ No newline at end of file diff --git a/ccw/src/core/routes/help-routes.ts b/ccw/src/core/routes/help-routes.ts index 130c865f..c83a357a 100644 --- a/ccw/src/core/routes/help-routes.ts +++ b/ccw/src/core/routes/help-routes.ts @@ -388,7 +388,7 @@ export async function handleHelpRoutes(ctx: RouteContext): Promise<boolean> { // We need to resolve this against that actual location, not the project root const baseDir = initialPath || join(homedir(), '.claude'); - const commandJsonDir = join(baseDir, '.claude', 'skills', 'ccw-help'); + const commandJsonDir = join(baseDir, 'skills', 'ccw-help'); // Resolve the source path against where command.json actually is const resolvedPath = resolve(commandJsonDir, sourceParam); diff --git a/ccw/src/templates/dashboard-js/views/help.js b/ccw/src/templates/dashboard-js/views/help.js index 2cd75a66..aae323ba 100644 --- a/ccw/src/templates/dashboard-js/views/help.js +++ b/ccw/src/templates/dashboard-js/views/help.js @@ -262,6 +262,8 @@ function renderCommandsTab(category) { // Initialize accordion handlers initializeAccordions(); + // Initialize command card click handlers + initializeCommandCardHandlers(); } function renderCommandCard(cmd) { @@ -271,8 +273,13 @@ function renderCommandCard(cmd) { 'Advanced': 'bg-error-light text-error' }[cmd.difficulty] || 'bg-muted text-muted-foreground'; + // Create safe JSON string for command data + var cmdJson = escapeHtml(JSON.stringify(cmd)); + return ` - <div class="bg-background border border-border rounded-lg p-4 hover:border-primary transition-colors"> + <div class="command-card cursor-pointer bg-background border border-border rounded-lg p-4 hover:border-primary transition-all hover:shadow-md" + data-command='${cmdJson}' + title="Click to view details"> <div class="flex items-start justify-between mb-2"> <div class="flex-1"> <div class="flex items-center gap-2 mb-1"> @@ -281,6 +288,7 @@ function renderCommandCard(cmd) { </div> <p class="text-sm text-muted-foreground">${escapeHtml(cmd.description)}</p> </div> + <i data-lucide="arrow-right" class="w-4 h-4 text-muted-foreground opacity-0 group-hover:opacity-100 transition-opacity ml-2"></i> </div> ${cmd.arguments ? ` <div class="mt-2 text-xs"> @@ -854,3 +862,407 @@ function renderCodexLensQuickStart() { container.innerHTML = html; if (typeof lucide !== 'undefined') lucide.createIcons(); } + +// ========== Command Detail Modal ========== +function showCommandDetailModal(cmd) { + var modal = document.createElement('div'); + modal.className = 'fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 p-4'; + modal.id = 'commandDetailModal'; + + var difficultyColor = { + 'Beginner': 'bg-success/10 text-success', + 'Intermediate': 'bg-warning/10 text-warning', + 'Advanced': 'bg-error/10 text-error' + }[cmd.difficulty] || 'bg-muted/10 text-muted-foreground'; + + var sourceLink = cmd.source ? cmd.source.replace(/\.\.\/..\/..\//g, '') : ''; + + var html = ` + <div class="bg-card border border-border rounded-lg max-w-4xl w-full max-h-[90vh] overflow-hidden flex flex-col"> + <!-- Header --> + <div class="sticky top-0 bg-card border-b border-border px-6 py-4 flex items-start justify-between"> + <div class="flex-1"> + <div class="flex items-center gap-2 mb-2"> + <code class="text-lg font-mono text-primary font-bold">${escapeHtml(cmd.command)}</code> + <span class="text-xs px-3 py-1 rounded-full ${difficultyColor} font-medium">${escapeHtml(cmd.difficulty || 'Intermediate')}</span> + </div> + <p class="text-sm text-muted-foreground">${escapeHtml(cmd.category || 'general')}${cmd.subcategory ? ' / ' + escapeHtml(cmd.subcategory) : ''}</p> + </div> + <button class="close-modal text-muted-foreground hover:text-foreground transition-colors" title="Close"> + <i data-lucide="x" class="w-6 h-6"></i> + </button> + </div> + + <!-- Content - Tabs --> + <div class="border-b border-border flex"> + <button class="detail-tab active px-4 py-3 text-sm font-medium transition-colors border-b-2 border-primary" data-tab="overview"> + Overview + </button> + ${cmd.source ? ` + <button class="detail-tab px-4 py-3 text-sm font-medium transition-colors border-b-2 border-transparent text-muted-foreground hover:text-foreground" data-tab="document"> + <i data-lucide="file-text" class="w-4 h-4 inline-block mr-1"></i> + Full Document + </button> + ` : ''} + </div> + + <!-- Tab Content --> + <div class="flex-1 overflow-y-auto"> + <!-- Overview Tab --> + <div id="overview-tab" class="detail-tab-content p-6 space-y-6"> + <!-- Description --> + <div> + <h3 class="text-sm font-semibold text-foreground mb-2">Description</h3> + <p class="text-sm text-muted-foreground leading-relaxed">${escapeHtml(cmd.description || 'No description available')}</p> + </div> + + <!-- Usage Scenario --> + ${cmd.usage_scenario ? ` + <div> + <h3 class="text-sm font-semibold text-foreground mb-2">Use Case</h3> + <p class="text-sm text-muted-foreground">${escapeHtml(cmd.usage_scenario)}</p> + </div> + ` : ''} + + <!-- Arguments --> + ${cmd.arguments ? ` + <div> + <h3 class="text-sm font-semibold text-foreground mb-2">Arguments</h3> + <div class="bg-background rounded-lg p-3 border border-border"> + <code class="text-xs font-mono text-foreground">${escapeHtml(cmd.arguments)}</code> + </div> + </div> + ` : ''} + + <!-- Flow Information --> + ${cmd.flow ? ` + <div> + <h3 class="text-sm font-semibold text-foreground mb-3">Workflow</h3> + <div class="space-y-2"> + ${cmd.flow.prerequisites ? ` + <div class="text-xs"> + <span class="text-muted-foreground">Prerequisites:</span> + <div class="mt-1 space-y-1"> + ${cmd.flow.prerequisites.map(p => ` + <div class="inline-block px-2 py-1 bg-primary/10 text-primary rounded text-xs mr-2"> + ${escapeHtml(p)} + </div> + `).join('')} + </div> + </div> + ` : ''} + + ${cmd.flow.next_steps ? ` + <div class="text-xs"> + <span class="text-muted-foreground">Next Steps:</span> + <div class="mt-1 space-y-1"> + ${cmd.flow.next_steps.map(n => ` + <div class="inline-block px-2 py-1 bg-success/10 text-success rounded text-xs mr-2"> + ${escapeHtml(n)} + </div> + `).join('')} + </div> + </div> + ` : ''} + + ${cmd.flow.alternatives ? ` + <div class="text-xs"> + <span class="text-muted-foreground">Alternatives:</span> + <div class="mt-1 space-y-1"> + ${cmd.flow.alternatives.map(a => ` + <div class="inline-block px-2 py-1 bg-warning/10 text-warning rounded text-xs mr-2"> + ${escapeHtml(a)} + </div> + `).join('')} + </div> + </div> + ` : ''} + </div> + </div> + ` : ''} + + <!-- Source --> + ${sourceLink ? ` + <div> + <h3 class="text-sm font-semibold text-foreground mb-2">Source File</h3> + <div class="text-xs text-muted-foreground font-mono break-all">${escapeHtml(sourceLink)}</div> + </div> + ` : ''} + </div> + + <!-- Document Tab --> + ${cmd.source ? ` + <div id="document-tab" class="detail-tab-content hidden p-6"> + <div class="bg-background border border-border rounded-lg p-4"> + <div id="document-loader" class="flex items-center justify-center py-8"> + <i data-lucide="loader-2" class="w-5 h-5 animate-spin text-primary mr-2"></i> + <span class="text-sm text-muted-foreground">Loading document...</span> + </div> + <div id="document-content" class="hidden prose prose-invert max-w-none text-sm"> + <!-- Markdown content will be loaded here --> + </div> + <div id="document-error" class="hidden text-sm text-error"> + Failed to load document + </div> + </div> + </div> + ` : ''} + </div> + + <!-- Footer --> + <div class="border-t border-border px-6 py-3 flex gap-2 justify-end bg-background rounded-b-lg"> + <button class="close-modal px-4 py-2 text-sm font-medium text-foreground bg-muted hover:bg-muted/80 rounded-lg transition-colors"> + Close + </button> + </div> + </div> + `; + + modal.innerHTML = html; + document.body.appendChild(modal); + + // Initialize tab switching + var tabButtons = modal.querySelectorAll('.detail-tab'); + tabButtons.forEach(function(btn) { + btn.addEventListener('click', function() { + var tabName = this.getAttribute('data-tab'); + + // Update active tab button + tabButtons.forEach(function(b) { + b.classList.remove('active', 'border-primary', 'text-foreground'); + b.classList.add('border-transparent', 'text-muted-foreground'); + }); + this.classList.add('active', 'border-primary', 'text-foreground'); + this.classList.remove('border-transparent', 'text-muted-foreground'); + + // Show/hide tab content + var tabContents = modal.querySelectorAll('.detail-tab-content'); + tabContents.forEach(function(content) { + content.classList.add('hidden'); + }); + var activeTab = modal.querySelector('#' + tabName + '-tab'); + if (activeTab) { + activeTab.classList.remove('hidden'); + } + + // Load document content if needed + if (tabName === 'document' && cmd.source) { + loadCommandDocument(modal, cmd.source); + } + }); + }); + + // Close handlers + var closeButtons = modal.querySelectorAll('.close-modal'); + closeButtons.forEach(function(btn) { + btn.addEventListener('click', function() { + modal.remove(); + }); + }); + + // Close on background click + modal.addEventListener('click', function(e) { + if (e.target === modal) { + modal.remove(); + } + }); + + // Close on Escape key + var closeOnEscape = function(e) { + if (e.key === 'Escape') { + modal.remove(); + document.removeEventListener('keydown', closeOnEscape); + } + }; + document.addEventListener('keydown', closeOnEscape); + + if (typeof lucide !== 'undefined') lucide.createIcons(); +} + +// ========== Load Command Document ========== +function loadCommandDocument(modal, sourcePath) { + var contentDiv = modal.querySelector('#document-content'); + var loaderDiv = modal.querySelector('#document-loader'); + var errorDiv = modal.querySelector('#document-error'); + + // Check if already loaded + if (contentDiv && !contentDiv.classList.contains('hidden')) { + return; + } + + // Start loading + if (loaderDiv) loaderDiv.classList.remove('hidden'); + if (errorDiv) errorDiv.classList.add('hidden'); + if (contentDiv) contentDiv.classList.add('hidden'); + + // Fetch document content + fetch('/api/help/command-content?source=' + encodeURIComponent(sourcePath)) + .then(function(response) { + if (!response.ok) { + throw new Error('Failed to load document'); + } + return response.text(); + }) + .then(function(markdown) { + // Parse markdown to HTML + var html = parseMarkdown(markdown); + + if (contentDiv) { + contentDiv.innerHTML = html; + contentDiv.classList.remove('hidden'); + } + if (loaderDiv) loaderDiv.classList.add('hidden'); + + if (typeof lucide !== 'undefined') lucide.createIcons(); + }) + .catch(function(error) { + console.error('Failed to load document:', error); + if (errorDiv) { + errorDiv.classList.remove('hidden'); + } + if (loaderDiv) loaderDiv.classList.add('hidden'); + }); +} + +// ========== Markdown Parser (Simple) ========== +function parseMarkdown(markdown) { + // Remove frontmatter + var lines = markdown.split('\n'); + var startIdx = 0; + if (lines[0] === '---') { + for (var i = 1; i < lines.length; i++) { + if (lines[i] === '---') { + startIdx = i + 1; + break; + } + } + } + + var content = lines.slice(startIdx).join('\n').trim(); + + var html = ''; + var currentList = null; + var inCodeBlock = false; + var codeBlockContent = ''; + var codeBlockLang = ''; + + lines = content.split('\n'); + + for (var i = 0; i < lines.length; i++) { + var line = lines[i]; + + // Code blocks + if (line.startsWith('```')) { + if (!inCodeBlock) { + inCodeBlock = true; + codeBlockLang = line.substring(3).trim(); + codeBlockContent = ''; + } else { + inCodeBlock = false; + var langClass = codeBlockLang ? ' language-' + escapeHtml(codeBlockLang) : ''; + html += '<pre class="bg-background border border-border rounded-lg p-4 overflow-x-auto my-3"><code class="text-xs font-mono text-foreground' + langClass + '">' + + escapeHtml(codeBlockContent).replace(/\n/g, '<br>') + '</code></pre>'; + } + continue; + } + + if (inCodeBlock) { + codeBlockContent += line + '\n'; + continue; + } + + // Headings + if (line.startsWith('# ')) { + html += '<h1 class="text-2xl font-bold text-foreground mt-6 mb-3">' + escapeHtml(line.substring(2)) + '</h1>'; + continue; + } + if (line.startsWith('## ')) { + html += '<h2 class="text-xl font-bold text-foreground mt-5 mb-2">' + escapeHtml(line.substring(3)) + '</h2>'; + continue; + } + if (line.startsWith('### ')) { + html += '<h3 class="text-lg font-semibold text-foreground mt-4 mb-2">' + escapeHtml(line.substring(4)) + '</h3>'; + continue; + } + + // Lists + if (line.match(/^[\s]*[-*+]\s/)) { + var listContent = line.replace(/^[\s]*[-*+]\s/, ''); + if (currentList !== 'ul') { + if (currentList === 'ol') html += '</ol>'; + html += '<ul class="list-disc list-inside text-sm text-muted-foreground space-y-1 my-2">'; + currentList = 'ul'; + } + html += '<li>' + escapeHtml(listContent) + '</li>'; + continue; + } + + if (line.match(/^[\s]*\d+\.\s/)) { + var listContent = line.replace(/^[\s]*\d+\.\s/, ''); + if (currentList !== 'ol') { + if (currentList === 'ul') html += '</ul>'; + html += '<ol class="list-decimal list-inside text-sm text-muted-foreground space-y-1 my-2">'; + currentList = 'ol'; + } + html += '<li>' + escapeHtml(listContent) + '</li>'; + continue; + } + + // Close list if we encounter non-list content + if (line.trim() && (currentList === 'ul' || currentList === 'ol')) { + html += currentList === 'ul' ? '</ul>' : '</ol>'; + currentList = null; + } + + // Paragraphs + if (line.trim()) { + // Convert inline formatting + var formatted = line + .replace(/\*\*([^*]+)\*\*/g, '<strong class="font-semibold text-foreground">$1</strong>') + .replace(/\*([^*]+)\*/g, '<em class="italic">$1</em>') + .replace(/`([^`]+)`/g, '<code class="bg-background px-1 rounded text-xs font-mono text-primary">$1</code>') + .replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2" class="text-primary hover:underline">$1</a>'); + + html += '<p class="text-sm text-muted-foreground leading-relaxed my-2">' + formatted + '</p>'; + } + } + + // Close any open lists + if (currentList === 'ul') html += '</ul>'; + if (currentList === 'ol') html += '</ol>'; + + return html; +} + +// ========== Command Card Click Handlers ========== +function initializeCommandCardHandlers() { + var cards = document.querySelectorAll('.command-card'); + cards.forEach(function(card) { + card.addEventListener('click', function(e) { + e.preventDefault(); + var cmdJson = this.getAttribute('data-command'); + if (cmdJson) { + try { + var cmd = JSON.parse(unescapeHtml(cmdJson)); + showCommandDetailModal(cmd); + } catch (err) { + console.error('Failed to parse command data:', err); + } + } + }); + }); +} + +// Helper function to unescape HTML +function unescapeHtml(html) { + var map = { + '&': '&', + '<': '<', + '>': '>', + '"': '"', + ''': "'" + }; + return html.replace(/&(?:amp|lt|gt|quot|#039);/g, function(match) { + return map[match]; + }); +} diff --git a/validate-help.py b/validate-help.py new file mode 100644 index 00000000..c1e477b2 --- /dev/null +++ b/validate-help.py @@ -0,0 +1,60 @@ +#!/usr/bin/env python3 +import os +import json +import sys + +# Read command.json +command_json_path = os.path.expandvars('D:\\Claude_dms3\\.claude\\skills\\ccw-help\\command.json') + +try: + with open(command_json_path, 'r', encoding='utf-8') as f: + data = json.load(f) +except Exception as e: + print(f"Error reading command.json: {e}") + sys.exit(1) + +base_dir = os.path.expandvars('D:\\Claude_dms3\\.claude\\skills\\ccw-help') +commands_base = os.path.expandvars('D:\\Claude_dms3\\.claude\\commands') + +# Check commands +missing = [] +existing = [] + +print("Checking command source files...") +print("=" * 70) + +for cmd in data.get('commands', []): + if cmd.get('source'): + # Resolve path from ccw-help directory + full_path = os.path.normpath(os.path.join(base_dir, cmd['source'])) + exists = os.path.isfile(full_path) + + if exists: + existing.append((cmd['command'], full_path)) + else: + missing.append((cmd['command'], cmd['source'], full_path)) + +# Print missing files +if missing: + print(f"\n❌ MISSING SOURCE FILES ({len(missing)}):") + print("-" * 70) + for cmd, source, resolved in missing[:20]: # Show first 20 + print(f"{cmd}") + print(f" Source: {source}") + print(f" Expected: {resolved}") +else: + print(f"\n✅ All source files exist!") + +print(f"\n" + "=" * 70) +print(f"SUMMARY:") +print(f" Total commands: {len(data.get('commands', []))}") +print(f" Source files exist: {len(existing)}") +print(f" Source files missing: {len(missing)}") +print("=" * 70) + +# List commands without source +no_source = [cmd['command'] for cmd in data.get('commands', []) if not cmd.get('source')] +if no_source: + print(f"\n⚠️ Commands without 'source' field ({len(no_source)}):") + for cmd_name in no_source[:10]: + print(f" - {cmd_name}")