Files
Claude-Code-Workflow/.claude/skills/team-lifecycle-v5/role-specs/executor.md
catlog22 8566e3af44 fix(team): use session-id instead of team-name in team_msg across all skills
Root cause: team_msg --team parameter maps directly to filesystem path
.workflow/.team/{value}/.msg/, so using team-name creates wrong directory.

Changes:
- All team skills (14 skills, 80+ files): Changed team=<team-name> to
  team=<session-id> with clear documentation
- Added NOTE in every file: "team must be session ID (e.g., TLS-xxx-date),
  NOT team name. Extract from Session: field in task description."
- CLI fallback examples updated: --team brainstorm -> --team <session-id>

Skills fixed:
- team-brainstorm, team-coordinate, team-frontend, team-issue
- team-iterdev, team-lifecycle-v3, team-planex, team-quality-assurance
- team-review, team-roadmap-dev, team-tech-debt, team-testing
- team-uidesign, team-ultra-analyze

Also includes new team-executor skill for lightweight session execution.
2026-02-27 18:48:39 +08:00

2.1 KiB

role, prefix, inner_loop, discuss_rounds, subagents, message_types
role prefix inner_loop discuss_rounds subagents message_types
executor IMPL true
success progress error
impl_complete impl_progress error

Executor — Phase 2-4

Phase 2: Task & Plan Loading

Objective: Load plan and determine execution strategy.

  1. Load plan.json and .task/TASK-*.json from <session-folder>/plan/

Backend selection (priority order):

Priority Source Method
1 Task metadata task.metadata.executor field
2 Plan default "Execution Backend:" in plan
3 Auto-select Simple (< 200 chars, no refactor) → agent; Complex → codex

Code review selection:

Priority Source Method
1 Task metadata task.metadata.code_review field
2 Plan default "Code Review:" in plan
3 Auto-select Critical keywords (auth, security, payment) → enabled

Phase 3: Code Implementation

Objective: Execute implementation across batches.

Batching: Topological sort by IMPL task dependencies → sequential batches.

Backend Invocation Use Case
agent Task({ subagent_type: "code-developer", run_in_background: false }) Simple, direct edits
codex ccw cli --tool codex --mode write (background) Complex, architecture
gemini ccw cli --tool gemini --mode write (background) Analysis-heavy

Phase 4: Self-Validation

Step Method Pass Criteria
Syntax check tsc --noEmit (30s) Exit code 0
Acceptance criteria Match criteria keywords vs implementation All addressed
Test detection Find .test.ts/.spec.ts for modified files Tests identified
Code review (optional) gemini analysis or codex review No blocking issues

Report: task ID, status, files modified, validation results, backend used.

Error Handling

Scenario Resolution
Syntax errors Retry with error context (max 3)
Missing dependencies Request from coordinator
Backend unavailable Fallback to agent
Circular dependencies Abort, report graph