Refactor documentation for code commands and workflows

- Updated command syntax formatting to use code blocks for clarity in `prep.md`, `review.md`, and `spec.md`.
- Enhanced architectural diagrams in `ch01-what-is-claude-dms3.md` and core concepts in `ch03-core-concepts.md` using mermaid syntax for better visualization.
- Improved workflow diagrams in `ch04-workflow-basics.md` and `4-level.md` to provide clearer representations of processes.
- Added troubleshooting section in `installation.md` to address common installation issues and provide quick start examples.
- Revised skill documentation in `claude-meta.md` and `claude-workflow.md` to standardize command triggers and output structures.
- Updated best practices and workflow index documentation to enhance readability and understanding of workflow levels and practices.

Author: catlog22

.claude/commands/cli/cli-init.md

@@ -33,15 +33,15 @@ Creates tool-specific configuration directories:
 - `.gemini/settings.json`:
 ```json
 {
-  "contextfilename": ["CLAUDE.md","GEMINI.md"]
+  "contextfilename": "CLAUDE.md"
 }
 ```
 
 **For Qwen** (`.qwen/`):
 - `.qwen/settings.json`:
 ```json
 {
-  "contextfilename": ["CLAUDE.md","QWEN.md"]
+  "contextfilename": "CLAUDE.md"
 }
 ```
 

docs/COMMAND_SPEC.md

@@ -1,8 +1,8 @@
 
 # Claude Code Workflow (CCW) - Command Specification
 
-**Version**: 6.2.0
-**Updated**: 2025-12-20
+**Version**: 7.0.6
+**Updated**: 2026-02-28
 
 ## 1. Introduction
 

docs/commands/claude/cli.md

@@ -26,7 +26,7 @@
 **Function**: Generate `.gemini/` and `.qwen/` configuration directories based on workspace tech detection, including settings.json and ignore files.
 
 **Syntax**:
-```
+```bash
 /cli:cli-init [--tool gemini|qwen|all] [--output path] [--preview]
 ```
 
@@ -36,7 +36,7 @@
 - `--preview`: Preview mode (don't actually create)
 
 **Generated File Structure**:
-```
+```plaintext
 .gemini/
 ├── settings.json      # Gemini configuration
 └── ignore            # Ignore patterns
@@ -75,7 +75,7 @@
 **Function**: Interactive code review using Codex CLI via ccw endpoint, supporting configurable review targets, models, and custom instructions.
 
 **Syntax**:
-```
+```bash
 /cli:codex-review [--uncommitted|--base <branch>|--commit <sha>] [--model <model>] [--title <title>] [prompt]
 ```
 

docs/commands/claude/core-orchestration.md

@@ -18,7 +18,7 @@
 **Function**: Main workflow orchestrator - intent analysis -> workflow selection -> command chain execution
 
 **Syntax**:
-```
+```bash
 /ccw "task description"
 ```
 
@@ -80,7 +80,7 @@ graph TD
 **Function**: Command orchestration tool - analyze tasks, recommend command chains, sequential execution, state persistence
 
 **Syntax**:
-```
+```bash
 /ccw-coordinator "task description"
 ```
 

docs/commands/claude/index.md

@@ -11,7 +11,7 @@
 | **Core Orchestration** | 2 | Main workflow orchestrators (ccw, ccw-coordinator) |
 | **Workflow** | 20+ | Planning, execution, review, TDD, testing workflows |
 | **Session Management** | 6 | Session creation, listing, resuming, completion |
-| **Issue Workflow** | 7 | Issue discovery, planning, queue, execution |
+| **Issue Workflow** | 8 | Issue discovery, planning, queue, execution |
 | **Memory** | 8 | Memory capture, update, document generation |
 | **CLI Tools** | 2 | CLI initialization, Codex review |
 | **UI Design** | 10 | UI design prototype generation, style extraction |
@@ -52,6 +52,7 @@
 | [`/workflow:session:start`](./session.md#start) | Discover existing sessions or start new workflow session | Intermediate |
 | [`/workflow:session:list`](./session.md#list) | List all workflow sessions | Beginner |
 | [`/workflow:session:resume`](./session.md#resume) | Resume most recently paused workflow session | Intermediate |
+| [`/workflow:session:sync`](./session.md#sync) | Quick-sync session work to specs and project-tech | Intermediate |
 | [`/workflow:session:complete`](./session.md#complete) | Mark active workflow session as completed | Intermediate |
 | [`/workflow:session:solidify`](./session.md#solidify) | Crystallize session learnings into project guidelines | Intermediate |
 
@@ -62,6 +63,7 @@
 | [`/issue:new`](./issue.md#new) | Create structured issue from GitHub URL or text description | Intermediate |
 | [`/issue:discover`](./issue.md#discover) | Discover potential issues from multiple perspectives | Intermediate |
 | [`/issue:discover-by-prompt`](./issue.md#discover-by-prompt) | Discover issues via user prompt | Intermediate |
+| [`/issue:from-brainstorm`](./issue.md#from-brainstorm) | Convert brainstorm session ideas into issue with executable solution | Intermediate |
 | [`/issue:plan`](./issue.md#plan) | Batch plan issue solutions | Intermediate |
 | [`/issue:queue`](./issue.md#queue) | Form execution queue | Intermediate |
 | [`/issue:execute`](./issue.md#execute) | Execute queue | Intermediate |
@@ -73,7 +75,7 @@
 |---------|----------|------------|
 | [`/memory:compact`](./memory.md#compact) | Compress current session memory to structured text | Intermediate |
 | [`/memory:tips`](./memory.md#tips) | Quick note-taking | Beginner |
-| [`/memory:load`](./memory.md#load) | Load task context via CLI project analysis | Intermediate |
+| [`/memory:prepare`](./memory.md#prepare) | Load task context via CLI project analysis | Intermediate |
 | [`/memory:update-full`](./memory.md#update-full) | Update all CLAUDE.md files | Intermediate |
 | [`/memory:update-related`](./memory.md#update-related) | Update CLAUDE.md for git-changed modules | Intermediate |
 | [`/memory:docs-full-cli`](./memory.md#docs-full-cli) | Generate full project documentation using CLI | Intermediate |

docs/commands/claude/issue.md

@@ -32,7 +32,7 @@
 **Function**: Create structured issue from GitHub URL or text description, supporting requirement clarity detection.
 
 **Syntax**:
-```
+```bash
 /issue:new [-y|--yes] <github-url | text description> [--priority 1-5]
 ```
 
@@ -92,7 +92,7 @@ interface Issue {
 **Function**: Discover potential issues from multiple perspectives (Bug, UX, Test, Quality, Security, Performance, Maintainability, Best Practices).
 
 **Syntax**:
-```
+```bash
 /issue:discover [-y|--yes] <path pattern> [--perspectives=bug,ux,...] [--external]
 ```
 
@@ -125,7 +125,7 @@ interface Issue {
 **Function**: Discover issues via user prompt, using Gemini-planned iterative multi-agent exploration, supporting cross-module comparison.
 
 **Syntax**:
-```
+```bash
 /issue:discover-by-prompt [-y|--yes] <prompt> [--scope=src/**] [--depth=standard|deep] [--max-iterations=5]
 ```
 
@@ -151,7 +151,7 @@ interface Issue {
 **Function**: Batch plan issue solutions, using issue-plan-agent (explore + plan closed loop).
 
 **Syntax**:
-```
+```bash
 /issue:plan [-y|--yes] --all-pending <issue-id>[,<issue-id>,...] [--batch-size 3]
 ```
 
@@ -176,7 +176,7 @@ interface Issue {
 **Function**: Form execution queue from bound solutions, using issue-queue-agent (solution level).
 
 **Syntax**:
-```
+```bash
 /issue:queue [-y|--yes] [--queues <n>] [--issue <id>]
 ```
 
@@ -201,7 +201,7 @@ interface Issue {
 **Function**: Execute queue, using DAG parallel orchestration (one commit per solution).
 
 **Syntax**:
-```
+```bash
 /issue:execute [-y|--yes] --queue <queue-id> [--worktree [<existing-path>]]
 ```
 
@@ -223,7 +223,7 @@ interface Issue {
 **Function**: Convert planning artifact (lite-plan, workflow session, markdown) to issue solution.
 
 **Syntax**:
-```
+```bash
 /issue:convert-to-plan [-y|--yes] [--issue <id>] [--supplement] <source>
 ```
 
@@ -253,7 +253,7 @@ interface Issue {
 **Function**: Convert brainstorm session ideas to issues and generate executable solutions.
 
 **Syntax**:
-```
+```bash
 /issue:from-brainstorm SESSION="session-id" [--idea=<index>] [--auto] [-y|--yes]
 ```
 

docs/commands/claude/memory.md

@@ -19,7 +19,7 @@
 |---------|----------|--------|
 | [`compact`](#compact) | Compress current session memory to structured text | `/memory:compact [optional: session description]` |
 | [`tips`](#tips) | Quick note-taking | `/memory:tips <note content> [--tag tags] [--context context]` |
-| [`load`](#load) | Load task context via CLI project analysis | `/memory:load [--tool gemini\|qwen] "task context description"` |
+| [`prepare`](#prepare) | Load task context via CLI project analysis | `/memory:prepare [--tool gemini\|qwen] "task context description"` |
 | [`update-full`](#update-full) | Update all CLAUDE.md files | `/memory:update-full [--tool gemini\|qwen\|codex] [--path directory]` |
 | [`update-related`](#update-related) | Update CLAUDE.md for git-changed modules | `/memory:update-related [--tool gemini\|qwen\|codex]` |
 | [`docs-full-cli`](#docs-full-cli) | Generate full project documentation using CLI | `/memory:docs-full-cli [path] [--tool tool]` |
@@ -33,7 +33,7 @@
 **Function**: Compress current session memory to structured text, extracting objectives, plans, files, decisions, constraints, and state, saving via MCP core_memory tool.
 
 **Syntax**:
-```
+```bash
 /memory:compact [optional: session description]
 ```
 
@@ -59,7 +59,7 @@
 **Function**: Quick note-taking command, capturing thoughts, snippets, reminders, and insights for future reference.
 
 **Syntax**:
-```
+```bash
 /memory:tips <note content> [--tag <tag1,tag2>] [--context <context>]
 ```
 
@@ -79,13 +79,13 @@
 /memory:tips "use Redis to cache user sessions" --context "login optimization"
 ```
 
-### load
+### prepare
 
 **Function**: Delegate to universal-executor agent, analyzing project via Gemini/Qwen CLI and returning JSON core content package for task context.
 
 **Syntax**:
-```
-/memory:load [--tool gemini|qwen] "task context description"
+```bash
+/memory:prepare [--tool gemini|qwen] "task context description"
 ```
 
 **Options**:
@@ -96,18 +96,18 @@
 **Examples**:
 ```bash
 # Use default tool
-/memory:load "user authentication module"
+/memory:prepare "user authentication module"
 
 # Specify tool
-/memory:load --tool gemini "payment system architecture"
+/memory:prepare --tool gemini "payment system architecture"
 ```
 
 ### update-full
 
 **Function**: Update all CLAUDE.md files, using layer-based execution (Layer 3->1), batch agent processing (4 modules/agent), and gemini->qwen->codex fallback.
 
 **Syntax**:
-```
+```bash
 /memory:update-full [--tool gemini|qwen|codex] [--path <directory>]
 ```
 
@@ -137,7 +137,7 @@
 **Function**: Update CLAUDE.md files for git-changed modules, using batch agent execution (4 modules/agent) and gemini->qwen->codex fallback.
 
 **Syntax**:
-```
+```bash
 /memory:update-related [--tool gemini|qwen|codex]
 ```
 
@@ -158,7 +158,7 @@
 **Function**: Generate full project documentation using CLI (Layer 3->1), batch agent processing (4 modules/agent), gemini->qwen->codex fallback, direct parallel for <20 modules.
 
 **Syntax**:
-```
+```bash
 /memory:docs-full-cli [path] [--tool <gemini|qwen|codex>]
 ```
 
@@ -179,7 +179,7 @@
 **Function**: Generate documentation for git-changed modules using CLI, batch agent processing (4 modules/agent), gemini->qwen->codex fallback, direct execution for <15 modules.
 
 **Syntax**:
-```
+```bash
 /memory:docs-related-cli [--tool <gemini|qwen|codex>]
 ```
 
@@ -197,7 +197,7 @@
 **Function**: Generate SKILL memory package from style reference, facilitating loading and consistent design system usage.
 
 **Syntax**:
-```
+```bash
 /memory:style-skill-memory [package-name] [--regenerate]
 ```