mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-03-01 15:03:57 +08:00

Files

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

3.0 KiB

Raw Blame History

role, prefix, inner_loop, discuss_rounds, subagents, message_types

role

prefix

inner_loop

discuss_rounds

subagents

message_types

planner

PLAN

true

explore

success	revision	error
plan_ready	plan_revision	error

Planner — Phase 2-4

Phase 1.5: Load Spec Context (Full-Lifecycle)

If <session-folder>/spec/ exists → load requirements/_index.md, architecture/_index.md, epics/_index.md, spec-config.json. Otherwise → impl-only mode.

Check shared explorations: Read <session-folder>/explorations/cache-index.json to see if analyst already cached useful explorations. Reuse rather than re-explore.

Phase 2: Multi-Angle Exploration

Objective: Explore codebase to inform planning.

Complexity routing:

Complexity	Criteria	Strategy
Low	< 200 chars, no refactor/architecture keywords	ACE semantic search only
Medium	200-500 chars or moderate scope	2-3 angle explore subagent
High	> 500 chars, refactor/architecture, multi-module	3-5 angle explore subagent

For each angle, call explore subagent (cache-aware — check cache-index.json before each call):

Task({
  subagent_type: "cli-explore-agent",
  run_in_background: false,
  description: "Explore <angle>",
  prompt: "Explore codebase for: <task>\nFocus angle: <angle>\nKeywords: <keywords>\nSession folder: <session-folder>\n..."
})

Phase 3: Plan Generation

Objective: Generate structured implementation plan.

Complexity	Strategy
Low	Direct planning → single TASK-001 with plan.json
Medium/High	cli-lite-planning-agent with exploration results

Agent call (Medium/High):

Task({
  subagent_type: "cli-lite-planning-agent",
  run_in_background: false,
  description: "Generate implementation plan",
  prompt: "Generate plan.
Output: <plan-dir>/plan.json + <plan-dir>/.task/TASK-*.json
Schema: cat ~/.ccw/workflows/cli-templates/schemas/plan-overview-base-schema.json
Task: <task-description>
Explorations: <explorations-manifest>
Complexity: <complexity>
Requirements: 2-7 tasks with id, title, files[].change, convergence.criteria, depends_on"
})

Spec context (full-lifecycle): Reference REQ-* IDs, follow ADR decisions, reuse Epic/Story decomposition.

Phase 4: Submit for Approval

Read plan.json and TASK-*.json
Report to coordinator: complexity, task count, task list, approach, plan location
Wait for response: approved → complete; revision → update and resubmit

Session files:

<session-folder>/explorations/          (shared cache)
+-- cache-index.json
+-- explore-<angle>.json

<session-folder>/plan/
+-- explorations-manifest.json
+-- plan.json
+-- .task/TASK-*.json

Error Handling

Scenario	Resolution
Exploration agent failure	Plan from description only
Planning agent failure	Fallback to direct planning
Plan rejected 3+ times	Notify coordinator, suggest alternative
Schema not found	Use basic structure
Cache index corrupt	Clear cache, re-explore all angles

3.0 KiB Raw Blame History