|
2 | 2 |
|
3 | 3 | <div align="center">
|
4 | 4 |
|
5 |
| -[](https://github.com/catlog22/Claude-Code-Workflow/releases) |
| 5 | +[](https://github.com/catlog22/Claude-Code-Workflow/releases) |
6 | 6 | [](LICENSE)
|
7 | 7 | []()
|
8 | 8 | [](https://github.com/modelcontextprotocol)
|
|
15 | 15 |
|
16 | 16 | **Claude Code Workflow (CCW)** is a next-generation multi-agent automation framework that orchestrates complex software development tasks through intelligent workflow management and autonomous execution.
|
17 | 17 |
|
18 |
| -> **🎉 Latest: v3.2.0** - Simplified agent architecture with "Tests Are the Review" philosophy. See [CHANGELOG.md](CHANGELOG.md) for details. |
| 18 | +> **🎉 Latest: v3.2.2** - Independent test-gen workflow with cross-session context. See [CHANGELOG.md](CHANGELOG.md) for details. |
19 | 19 | >
|
20 |
| -> **What's New in v3.2.0**: |
21 |
| -> - 🔄 Simplified from 3 agents to 2 core agents (`@code-developer`, `@test-fix-agent`) |
22 |
| -> - ✅ "Tests Are the Review" - Passing tests = approved code |
23 |
| -> - 🧪 Enhanced test-fix workflow with automatic execution and fixing |
24 |
| -> - 📦 Interactive installation with version selection menu |
| 20 | +> **What's New in v3.2.2**: |
| 21 | +> - 🔄 Independent test session architecture (WFS-test-[source]) |
| 22 | +> - 🤖 Automatic cross-session context gathering via metadata |
| 23 | +> - 🧪 Integrated concept-enhanced analysis (Gemini + Codex parallel execution) |
| 24 | +> - 📦 Reuses IMPL-*.json format with meta.type="test-fix" (zero breaking changes) |
| 25 | +> - ⚡ 4-phase workflow: session → context → analysis → task generation |
25 | 26 |
|
26 | 27 | ---
|
27 | 28 |
|
@@ -94,17 +95,51 @@ Select version to install (1-3, default: 1):
|
94 | 95 |
|
95 | 96 | > 💡 **Pro Tip**: The installer automatically detects and displays the latest version numbers and release dates from GitHub. Just press Enter to select the recommended stable release.
|
96 | 97 |
|
| 98 | +### **📦 Local Installation (Install-Claude.ps1)** |
| 99 | + |
| 100 | +For local installation without network access, use the bundled PowerShell installer: |
| 101 | + |
| 102 | +**Installation Modes:** |
| 103 | +```powershell |
| 104 | +# Interactive mode with prompts (recommended) |
| 105 | +.\Install-Claude.ps1 |
| 106 | +
|
| 107 | +# Quick install with automatic backup |
| 108 | +.\Install-Claude.ps1 -Force -BackupAll |
| 109 | +
|
| 110 | +# Non-interactive install |
| 111 | +.\Install-Claude.ps1 -NonInteractive -Force |
| 112 | +``` |
| 113 | + |
| 114 | +**Installation Options:** |
| 115 | + |
| 116 | +| Mode | Description | Installs To | |
| 117 | +|------|-------------|-------------| |
| 118 | +| **Global** | System-wide installation (default) | `~/.claude/`, `~/.codex/`, `~/.gemini/` | |
| 119 | +| **Path** | Custom directory + global hybrid | Local: `agents/`, `commands/`<br>Global: `workflows/`, `scripts/` | |
| 120 | + |
| 121 | +**Backup Behavior:** |
| 122 | +- **Default**: Automatic backup enabled (`-BackupAll`) |
| 123 | +- **Disable**: Use `-NoBackup` flag (⚠️ overwrites without backup) |
| 124 | +- **Backup location**: `claude-backup-{timestamp}/` in installation directory |
| 125 | + |
| 126 | +**⚠️ Important Warnings:** |
| 127 | +- `-Force -BackupAll`: Silent file overwrite (with backup) |
| 128 | +- `-NoBackup -Force`: Permanent file overwrite (no recovery) |
| 129 | +- Global mode modifies user profile directories |
| 130 | + |
97 | 131 | ### **✅ Verify Installation**
|
98 | 132 | After installation, run the following command to ensure CCW is working:
|
99 | 133 | ```bash
|
100 | 134 | /workflow:session:list
|
101 | 135 | ```
|
102 | 136 |
|
103 |
| -> **📝 Important Notes:** |
| 137 | +> **📝 Installation Notes:** |
104 | 138 | > - The installer will automatically install/update `.codex/` and `.gemini/` directories
|
105 | 139 | > - **Global mode**: Installs to `~/.codex` and `~/.gemini`
|
106 | 140 | > - **Path mode**: Installs to your specified directory (e.g., `project/.codex`, `project/.gemini`)
|
107 |
| -> - Existing files will be backed up automatically before installation |
| 141 | +> - **Backup**: Existing files are backed up by default to `claude-backup-{timestamp}/` |
| 142 | +> - **Safety**: Use interactive mode for first-time installation to review changes |
108 | 143 |
|
109 | 144 | ---
|
110 | 145 |
|
@@ -142,9 +177,9 @@ After installation, run the following command to ensure CCW is working:
|
142 | 177 |
|
143 | 178 | **Phase 4: Testing & Quality Assurance**
|
144 | 179 | ```bash
|
145 |
| -# Generate comprehensive test suite (standard workflow) |
146 |
| -/workflow:test-gen |
147 |
| -/workflow:execute |
| 180 | +# Generate independent test-fix workflow (v3.2.2+) |
| 181 | +/workflow:test-gen WFS-auth # Creates WFS-test-auth session |
| 182 | +/workflow:execute # Runs test validation |
148 | 183 |
|
149 | 184 | # OR verify TDD compliance (TDD workflow)
|
150 | 185 | /workflow:tdd-verify
|
@@ -217,7 +252,7 @@ After installation, run the following command to ensure CCW is working:
|
217 | 252 | | `/workflow:tdd-plan` | Create a Test-Driven Development workflow with Red-Green-Refactor cycles. |
|
218 | 253 | | `/workflow:execute` | Execute the current workflow plan autonomously. |
|
219 | 254 | | `/workflow:status` | Display the current status of the workflow. |
|
220 |
| -| `/workflow:test-gen` | Automatically generate a test plan from the implementation. | |
| 255 | +| `/workflow:test-gen` | Create independent test-fix workflow for validating completed implementation. | |
221 | 256 | | `/workflow:tdd-verify` | Verify TDD compliance and generate quality report. |
|
222 | 257 | | `/workflow:review` | **Optional** manual review (only use when explicitly needed - passing tests = approved code). |
|
223 | 258 |
|
@@ -275,7 +310,7 @@ Configure Gemini CLI for optimal integration:
|
275 | 310 | ```json
|
276 | 311 | // ~/.gemini/settings.json
|
277 | 312 | {
|
278 |
| - "contextFileName": "CLAUDE.md" |
| 313 | + "contextFileName": ["CLAUDE.md", "GEMINI.md"] |
279 | 314 | }
|
280 | 315 | ```
|
281 | 316 |
|
|
0 commit comments