mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-13 02:41:50 +08:00
2fb1d1243c
Changed loadClaudeCliTools() to only load tools explicitly defined in user config. Previously, DEFAULT_TOOLS_CONFIG.tools was spread before user tools, causing all default tools to be loaded even if not present in user config. User config now has complete control over which tools are loaded.
182 lines
4.0 KiB
Markdown
182 lines
4.0 KiB
Markdown
# State Schema (CCW Loop-B)
|
|
|
|
## Master State Structure
|
|
|
|
```json
|
|
{
|
|
"loop_id": "loop-b-20260122-abc123",
|
|
"title": "Implement user authentication",
|
|
"description": "Full task description here",
|
|
"mode": "interactive | auto | parallel",
|
|
"status": "running | paused | completed | failed",
|
|
"current_iteration": 3,
|
|
"max_iterations": 10,
|
|
"created_at": "2026-01-22T10:00:00.000Z",
|
|
"updated_at": "2026-01-22T10:30:00.000Z",
|
|
|
|
"skill_state": {
|
|
"phase": "develop | debug | validate | complete",
|
|
"action_index": 2,
|
|
"workers_completed": ["init", "develop"],
|
|
"parallel_results": null,
|
|
"pending_tasks": [],
|
|
"completed_tasks": [],
|
|
"findings": []
|
|
}
|
|
}
|
|
```
|
|
|
|
## Field Descriptions
|
|
|
|
### Core Fields (API Compatible)
|
|
|
|
| Field | Type | Description |
|
|
|-------|------|-------------|
|
|
| `loop_id` | string | Unique identifier |
|
|
| `title` | string | Short title (max 100 chars) |
|
|
| `description` | string | Full task description |
|
|
| `mode` | enum | Execution mode |
|
|
| `status` | enum | Current status |
|
|
| `current_iteration` | number | Iteration counter |
|
|
| `max_iterations` | number | Safety limit |
|
|
| `created_at` | ISO string | Creation timestamp |
|
|
| `updated_at` | ISO string | Last update timestamp |
|
|
|
|
### Skill State Fields
|
|
|
|
| Field | Type | Description |
|
|
|-------|------|-------------|
|
|
| `phase` | enum | Current execution phase |
|
|
| `action_index` | number | Position in action sequence (auto mode) |
|
|
| `workers_completed` | array | List of completed worker actions |
|
|
| `parallel_results` | object | Merged results from parallel mode |
|
|
| `pending_tasks` | array | Tasks waiting to be executed |
|
|
| `completed_tasks` | array | Tasks already done |
|
|
| `findings` | array | Discoveries during execution |
|
|
|
|
## Worker Output Structure
|
|
|
|
Each worker writes to `.workflow/.loop/{loopId}.workers/{action}.output.json`:
|
|
|
|
```json
|
|
{
|
|
"action": "develop",
|
|
"status": "success",
|
|
"summary": "Implemented 3 functions",
|
|
"files_changed": ["src/auth.ts", "src/utils.ts"],
|
|
"next_suggestion": "validate",
|
|
"loop_back_to": null,
|
|
"timestamp": "2026-01-22T10:15:00.000Z",
|
|
"detailed_output": {
|
|
"tasks_completed": [
|
|
{ "id": "T1", "description": "Create auth module" }
|
|
],
|
|
"metrics": {
|
|
"lines_added": 150,
|
|
"lines_removed": 20
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Progress File Structure
|
|
|
|
Human-readable progress in `.workflow/.loop/{loopId}.progress/{action}.md`:
|
|
|
|
```markdown
|
|
# Develop Progress
|
|
|
|
## Session: loop-b-20260122-abc123
|
|
|
|
### Iteration 1 (2026-01-22 10:15)
|
|
|
|
**Task**: Implement auth module
|
|
|
|
**Changes**:
|
|
- Created `src/auth.ts` with login/logout functions
|
|
- Added JWT token handling in `src/utils.ts`
|
|
|
|
**Status**: Success
|
|
|
|
---
|
|
|
|
### Iteration 2 (2026-01-22 10:30)
|
|
|
|
...
|
|
```
|
|
|
|
## Status Transitions
|
|
|
|
```
|
|
+--------+
|
|
| init |
|
|
+--------+
|
|
|
|
|
v
|
|
+------> +---------+
|
|
| | develop |
|
|
| +---------+
|
|
| |
|
|
| +--------+--------+
|
|
| | |
|
|
| v v
|
|
| +-------+ +---------+
|
|
| | debug |<------| validate|
|
|
| +-------+ +---------+
|
|
| | |
|
|
| +--------+--------+
|
|
| |
|
|
| v
|
|
| [needs fix?]
|
|
| yes | | no
|
|
| v v
|
|
+------------+ +----------+
|
|
| complete |
|
|
+----------+
|
|
```
|
|
|
|
## Parallel Results Schema
|
|
|
|
When `mode === 'parallel'`:
|
|
|
|
```json
|
|
{
|
|
"parallel_results": {
|
|
"develop": {
|
|
"status": "success",
|
|
"summary": "...",
|
|
"suggestions": []
|
|
},
|
|
"debug": {
|
|
"status": "success",
|
|
"issues_found": [],
|
|
"suggestions": []
|
|
},
|
|
"validate": {
|
|
"status": "success",
|
|
"test_results": {},
|
|
"coverage": {}
|
|
},
|
|
"merged_at": "2026-01-22T10:45:00.000Z"
|
|
}
|
|
}
|
|
```
|
|
|
|
## Directory Structure
|
|
|
|
```
|
|
.workflow/.loop/
|
|
+-- loop-b-20260122-abc123.json # Master state
|
|
+-- loop-b-20260122-abc123.workers/
|
|
| +-- init.output.json
|
|
| +-- develop.output.json
|
|
| +-- debug.output.json
|
|
| +-- validate.output.json
|
|
| +-- complete.output.json
|
|
+-- loop-b-20260122-abc123.progress/
|
|
+-- develop.md
|
|
+-- debug.md
|
|
+-- validate.md
|
|
+-- summary.md
|
|
```
|