catlog22/Claude-Code-Workflow
1
0
Fork 0
mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-03-05 16:13:08 +08:00
Code Issues Packages Projects Releases Wiki Activity

refactor: remove subagent references and update CLI tool usage across documentation

Browse Source
This commit is contained in:
catlog22
2026-03-05 11:15:13 +08:00
parent 99a45e3136
commit 1fb49c0e39
21 changed files with 199 additions and 118 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
.claude/skills/team-lifecycle-v2/SKILL.md
View File

@@ -34,8 +34,8 @@ Optimized lifecycle: specification → implementation → testing → review. Bu
| fe-qa |
+--------+
Subagent (callable by analyst, writer, reviewer):
[discuss-subagent] - multi-perspective critique (3 rounds)
⚠️ ARCHITECTURAL CONSTRAINT: Workers CANNOT spawn subagents.
Workers use CLI tools for complex analysis (see "CLI Tool Usage in Workers" section).
```
## Role Router

1
.claude/skills/team-lifecycle-v2/role-specs/executor.md
View File

@@ -3,7 +3,6 @@ role: executor
prefix: IMPL
inner_loop: true
discuss_rounds: []
subagents: []
message_types:
success: impl_complete
progress: impl_progress

1
.claude/skills/team-lifecycle-v2/role-specs/fe-developer.md
View File

@@ -3,7 +3,6 @@ role: fe-developer
prefix: DEV-FE
inner_loop: false
discuss_rounds: []
subagents: []
message_types:
success: dev_fe_complete
progress: dev_fe_progress

1
.claude/skills/team-lifecycle-v2/role-specs/fe-qa.md
View File

@@ -3,7 +3,6 @@ role: fe-qa
prefix: QA-FE
inner_loop: false
discuss_rounds: []
subagents: []
message_types:
success: qa_fe_passed
result: qa_fe_result

1
.claude/skills/team-lifecycle-v2/role-specs/planner.md
View File

@@ -3,7 +3,6 @@ role: planner
prefix: PLAN
inner_loop: true
discuss_rounds: []
subagents: []
message_types:
success: plan_ready
revision: plan_revision

1
.claude/skills/team-lifecycle-v2/role-specs/tester.md
View File

@@ -3,7 +3,6 @@ role: tester
prefix: TEST
inner_loop: false
discuss_rounds: []
subagents: []
message_types:
success: test_result
fix: fix_required

143
.claude/skills/team-lifecycle-v2/specs/team-config.json
View File

@@ -6,12 +6,18 @@
"architecture": "team-worker agent + role-specs",
"role_structure": "role-specs/{name}.md (Phase 2-4 only)",
"worker_agent": "team-worker",
"roles": {
"coordinator": {
"task_prefix": null,
"responsibility": "Pipeline orchestration, requirement clarification, task chain creation",
"message_types": ["plan_approved", "plan_revision", "task_unblocked", "fix_required", "error", "shutdown"]
"message_types": [
"plan_approved",
"plan_revision",
"task_unblocked",
"fix_required",
"error",
"shutdown"
]
},
"analyst": {
"task_prefix": "RESEARCH",
@@ -19,45 +25,76 @@
"responsibility": "Seed analysis, codebase exploration, context gathering + discuss",
"inline_discuss": "DISCUSS-001",
"inner_loop": false,
"message_types": ["research_ready", "research_progress", "error"]
"message_types": [
"research_ready",
"research_progress",
"error"
]
},
"writer": {
"task_prefix": "DRAFT",
"role_spec": "role-specs/writer.md",
"responsibility": "Product Brief / PRD / Architecture / Epics generation. Discuss at PRD only, self-validate others",
"inner_loop": true,
"inline_discuss": ["DISCUSS-002"],
"message_types": ["draft_ready", "draft_revision", "error"]
"inline_discuss": [
"DISCUSS-002"
],
"message_types": [
"draft_ready",
"draft_revision",
"error"
]
},
"planner": {
"task_prefix": "PLAN",
"role_spec": "role-specs/planner.md",
"responsibility": "Multi-angle exploration and structured implementation planning",
"inner_loop": true,
"message_types": ["plan_ready", "plan_revision", "error"]
"message_types": [
"plan_ready",
"plan_revision",
"error"
]
},
"executor": {
"task_prefix": "IMPL",
"role_spec": "role-specs/executor.md",
"responsibility": "Code implementation following approved plans",
"inner_loop": true,
"message_types": ["impl_complete", "impl_progress", "error"]
"message_types": [
"impl_complete",
"impl_progress",
"error"
]
},
"tester": {
"task_prefix": "TEST",
"role_spec": "role-specs/tester.md",
"responsibility": "Adaptive test-fix cycles, progressive testing",
"inner_loop": false,
"message_types": ["test_result", "fix_required", "error"]
"message_types": [
"test_result",
"fix_required",
"error"
]
},
"reviewer": {
"task_prefix": "REVIEW",
"additional_prefixes": ["QUALITY", "IMPROVE"],
"additional_prefixes": [
"QUALITY",
"IMPROVE"
],
"role_spec": "role-specs/reviewer.md",
"responsibility": "Code review (REVIEW-*) + Spec quality (QUALITY-*) + Improvement (IMPROVE-*) + final discuss",
"inline_discuss": "DISCUSS-003",
"inner_loop": false,
"message_types": ["review_result", "quality_result", "quality_recheck", "fix_required", "error"]
"message_types": [
"review_result",
"quality_result",
"quality_recheck",
"fix_required",
"error"
]
},
"architect": {
"task_prefix": "ARCH",
@@ -65,7 +102,11 @@
"responsibility": "Architecture assessment, tech feasibility. Consulting role",
"role_type": "consulting",
"inner_loop": false,
"message_types": ["arch_ready", "arch_concern", "error"]
"message_types": [
"arch_ready",
"arch_concern",
"error"
]
},
"fe-developer": {
"task_prefix": "DEV-FE",
@@ -73,7 +114,11 @@
"responsibility": "Frontend implementation",
"role_type": "frontend-pipeline",
"inner_loop": false,
"message_types": ["dev_fe_complete", "dev_fe_progress", "error"]
"message_types": [
"dev_fe_complete",
"dev_fe_progress",
"error"
]
},
"fe-qa": {
"task_prefix": "QA-FE",
@@ -81,19 +126,14 @@
"responsibility": "5-dimension frontend review, GC loop",
"role_type": "frontend-pipeline",
"inner_loop": false,
"message_types": ["qa_fe_passed", "qa_fe_result", "fix_required", "error"]
"message_types": [
"qa_fe_passed",
"qa_fe_result",
"fix_required",
"error"
]
}
},
"subagents": {
"discuss": {
"spec": "subagents/discuss-subagent.md",
"type": "cli-discuss-agent",
"callable_by": ["analyst", "writer", "reviewer"],
"purpose": "Multi-perspective critique (3 rounds: direction, requirements, final gate)"
}
},
"checkpoint_commands": {
"revise": {
"handler": "handleRevise",
@@ -116,17 +156,32 @@
"cascade": false
}
},
"pipelines": {
"spec-only": {
"description": "Spec pipeline: research(+D1) -> brief -> prd(+D2) -> arch -> epics -> quality(+D3)",
"task_chain": ["RESEARCH-001", "DRAFT-001", "DRAFT-002", "DRAFT-003", "DRAFT-004", "QUALITY-001"],
"discuss_points": ["RESEARCH-001", "DRAFT-002", "QUALITY-001"],
"task_chain": [
"RESEARCH-001",
"DRAFT-001",
"DRAFT-002",
"DRAFT-003",
"DRAFT-004",
"QUALITY-001"
],
"discuss_points": [
"RESEARCH-001",
"DRAFT-002",
"QUALITY-001"
],
"beats": 6
},
"impl-only": {
"description": "Implementation pipeline: plan -> implement -> test + review",
"task_chain": ["PLAN-001", "IMPL-001", "TEST-001", "REVIEW-001"],
"task_chain": [
"PLAN-001",
"IMPL-001",
"TEST-001",
"REVIEW-001"
],
"beats": 3
},
"full-lifecycle": {
@@ -136,28 +191,50 @@
},
"fe-only": {
"description": "Frontend-only: plan -> dev -> qa",
"task_chain": ["PLAN-001", "DEV-FE-001", "QA-FE-001"],
"gc_loop": { "max_rounds": 2, "convergence": "score >= 8 && critical === 0" }
"task_chain": [
"PLAN-001",
"DEV-FE-001",
"QA-FE-001"
],
"gc_loop": {
"max_rounds": 2,
"convergence": "score >= 8 && critical === 0"
}
},
"fullstack": {
"description": "Fullstack: plan -> backend + frontend parallel -> test + qa -> review",
"task_chain": ["PLAN-001", "IMPL-001||DEV-FE-001", "TEST-001||QA-FE-001", "REVIEW-001"]
"task_chain": [
"PLAN-001",
"IMPL-001||DEV-FE-001",
"TEST-001||QA-FE-001",
"REVIEW-001"
]
},
"full-lifecycle-fe": {
"description": "Full lifecycle with frontend",
"task_chain": "spec-only + fullstack (PLAN-001 blockedBy QUALITY-001)"
}
},
"frontend_detection": {
"keywords": ["component", "page", "UI", "frontend", "CSS", "HTML", "React", "Vue", "Tailwind", "Svelte", "Next.js"],
"keywords": [
"component",
"page",
"UI",
"frontend",
"CSS",
"HTML",
"React",
"Vue",
"Tailwind",
"Svelte",
"Next.js"
],
"routing_rules": {
"frontend_only": "All tasks match frontend keywords",
"fullstack": "Mix of frontend and backend tasks",
"backend_only": "No frontend keywords (default impl-only)"
}
},
"session_dirs": {
"base": ".workflow/.team/TLS-{slug}-{YYYY-MM-DD}/",
"spec": "spec/",

21
.claude/skills/team-lifecycle-v3/SKILL.md
View File

@@ -78,12 +78,25 @@ Workers use CLI tools for complex analysis:
### Coordinator-Only Utility Members
**⚠️ COORDINATOR ONLY**: Utility members can only be spawned by Coordinator.
Workers CANNOT call Agent() to spawn utility members.
Coordinator can spawn utility members for team-level orchestration:
| Utility Member | Purpose | When |
|----------------|---------|------|
| explorer | Parallel multi-angle exploration | High complexity analysis |
| discussant | Aggregate multi-CLI critique | Critical decision points |
| Utility Member | Purpose | When | Callable By |
|----------------|---------|------|-------------|
| explorer | Parallel multi-angle exploration | High complexity analysis | **Coordinator only** |
| discussant | Aggregate multi-CLI critique | Critical decision points | **Coordinator only** |
### Worker Alternatives
Workers needing similar capabilities must use CLI tools:
| Capability | CLI Command | Example |
|------------|-------------|---------|
| Codebase exploration | `ccw cli --tool gemini --mode analysis` | Explore architecture patterns |
| Multi-perspective critique | Parallel CLI calls | Security + performance + quality reviews |
| Document generation | `ccw cli --tool gemini --mode write` | Generate PRD from research |
### Dynamic Role Injection