Claude-Code-Workflow/.claude/skills/team-lifecycle-v2/specs/team-config.json

{
  "team_name": "team-lifecycle-v2",
  "team_display_name": "Team Lifecycle v2",
  "description": "Optimized team-worker agent architecture: discuss reduced 6→3, progressive refinement preserved",
  "version": "6.0.0",
  "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"]
    },
    "analyst": {
      "task_prefix": "RESEARCH",
      "role_spec": "role-specs/analyst.md",
      "responsibility": "Seed analysis, codebase exploration, context gathering + discuss",
      "inline_discuss": "DISCUSS-001",
      "inner_loop": false,
      "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"]
    },
    "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"]
    },
    "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"]
    },
    "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"]
    },
    "reviewer": {
      "task_prefix": "REVIEW",
      "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"]
    },
    "architect": {
      "task_prefix": "ARCH",
      "role_spec": "role-specs/architect.md",
      "responsibility": "Architecture assessment, tech feasibility. Consulting role",
      "role_type": "consulting",
      "inner_loop": false,
      "message_types": ["arch_ready", "arch_concern", "error"]
    },
    "fe-developer": {
      "task_prefix": "DEV-FE",
      "role_spec": "role-specs/fe-developer.md",
      "responsibility": "Frontend implementation",
      "role_type": "frontend-pipeline",
      "inner_loop": false,
      "message_types": ["dev_fe_complete", "dev_fe_progress", "error"]
    },
    "fe-qa": {
      "task_prefix": "QA-FE",
      "role_spec": "role-specs/fe-qa.md",
      "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"]
    }
  },

  "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",
      "pattern": "revise <TASK-ID> [feedback]",
      "cascade": true
    },
    "feedback": {
      "handler": "handleFeedback",
      "pattern": "feedback <text>",
      "cascade": true
    },
    "recheck": {
      "handler": "handleRecheck",
      "pattern": "recheck",
      "cascade": false
    },
    "improve": {
      "handler": "handleImprove",
      "pattern": "improve [dimension]",
      "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"],
      "beats": 6
    },
    "impl-only": {
      "description": "Implementation pipeline: plan -> implement -> test + review",
      "task_chain": ["PLAN-001", "IMPL-001", "TEST-001", "REVIEW-001"],
      "beats": 3
    },
    "full-lifecycle": {
      "description": "Full lifecycle: spec + impl (PLAN blockedBy QUALITY)",
      "task_chain": "spec-only + impl-only (PLAN-001 blockedBy QUALITY-001)",
      "beats": 9
    },
    "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" }
    },
    "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"]
    },
    "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"],
    "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/",
    "discussions": "discussions/",
    "plan": "plan/",
    "explorations": "explorations/",
    "messages": ".msg/"
  }
}