Agent skill

team-implement

Parallel implementation using Agent Teams. Spawns teammates per module/layer, each owning separate files to avoid conflicts. Uses shared task list with dependencies for autonomous coordination. Run after /startproject plan approval.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/team-implement

Metadata

Additional technical details for this skill

short description
Parallel implementation with Agent Teams

SKILL.md

Team Implement

Agent Teams による並列実装。/startproject で承認された計画に基づいて実行する。

Prerequisites

  • /startproject が完了し、計画がユーザーに承認されていること
  • .claude/docs/DESIGN.md にアーキテクチャが記録されていること
  • タスクリストが作成されていること

Workflow

Step 1: Analyze Plan & Design Team
  計画からタスク依存関係を分析し、チーム構成を決定
    ↓
Step 2: Spawn Agent Team
  モジュール/レイヤー単位でTeammateを起動
    ↓
Step 3: Monitor & Coordinate
  Lead がモニタリング、統合、品質管理
    ↓
Step 4: Integration & Verification
  全タスク完了後、統合テスト実行

Step 1: Analyze Plan & Design Team

タスクリストから並列化可能なワークストリームを特定する。

Team Design Principles

  1. ファイル所有権の分離: 各Teammateが異なるファイルセットを所有
  2. 依存関係の尊重: 依存タスクは同一Teammateか、依存順で実行
  3. 適切な粒度: Teammate あたり 5-6 タスクが目安

Common Team Patterns

Pattern A: Module-Based (推奨)

Teammate 1: Module A (models, core logic)
Teammate 2: Module B (API, endpoints)
Teammate 3: Tests (unit + integration)

Pattern B: Layer-Based

Teammate 1: Data layer (models, DB)
Teammate 2: Business logic (services)
Teammate 3: Interface layer (API/CLI)

Pattern C: Feature-Based

Teammate 1: Feature X (all layers)
Teammate 2: Feature Y (all layers)
Teammate 3: Shared infrastructure

Anti-patterns

  • 2つの Teammate が同じファイルを編集 → 上書きリスク
  • Teammate あたりのタスクが多すぎる → 長時間放置リスク
  • 依存関係が複雑すぎる → 調整コストが利益を上回る

Step 2: Spawn Agent Team

計画に基づいてチームを起動する。

Create an agent team for implementing: {feature}

Each teammate receives:
- Project Brief from CLAUDE.md
- Architecture from .claude/docs/DESIGN.md
- Library constraints from .claude/docs/libraries/
- Their specific task assignments

Spawn teammates:

1. **Implementer-{module}** for each module/workstream
   Prompt: "You are implementing {module} for project: {feature}.

   Read these files for context:
   - CLAUDE.md (project context)
   - .claude/docs/DESIGN.md (architecture)
   - .claude/docs/libraries/ (library constraints)

   Your assigned tasks:
   {task list for this teammate}

   Your file ownership:
   {list of files this teammate owns}

   Rules:
   - ONLY edit files in your ownership set
   - Follow existing codebase patterns
   - Write type hints on all functions
   - Run ruff check after each file change
   - Communicate with other teammates if you need interface changes

   When done with each task, mark it completed in the task list.

   IMPORTANT — Work Log:
   When ALL your assigned tasks are complete, write a work log file to:
     .claude/logs/agent-teams/{team-name}/{your-teammate-name}.md

   Use this format:
   # Work Log: {your-teammate-name}
   ## Summary
   (1-2 sentence summary of what you accomplished)
   ## Tasks Completed
   - [x] {task}: {brief description of what was done}
   ## Files Modified
   - `{file path}`: {what was changed and why}
   ## Key Decisions
   - {decision made during implementation and rationale}
   ## Communication with Teammates
   - → {recipient}: {summary of message sent}
   - ← {sender}: {summary of message received}
   ## Issues Encountered
   - {issue}: {how it was resolved}
   (If none, write 'None')
   "

2. **Tester** (optional but recommended)
   Prompt: "You are the Tester for project: {feature}.

   Read:
   - CLAUDE.md, .claude/docs/DESIGN.md
   - Existing test patterns in tests/

   Your tasks:
   - Write tests for each module as implementers complete them
   - Follow TDD where possible (write test stubs first)
   - Run uv run pytest after each test file
   - Report failing tests to the relevant implementer

   Test coverage target: 80%+

   IMPORTANT — Work Log:
   When ALL your assigned tasks are complete, write a work log file to:
     .claude/logs/agent-teams/{team-name}/{your-teammate-name}.md

   Use this format:
   # Work Log: {your-teammate-name}
   ## Summary
   (1-2 sentence summary of what you accomplished)
   ## Tasks Completed
   - [x] {task}: {brief description of what was done}
   ## Files Modified
   - `{file path}`: {what was changed and why}
   ## Key Decisions
   - {decision made during implementation and rationale}
   ## Communication with Teammates
   - → {recipient}: {summary of message sent}
   - ← {sender}: {summary of message received}
   ## Issues Encountered
   - {issue}: {how it was resolved}
   (If none, write 'None')
   "

Use delegate mode (Shift+Tab) to prevent Lead from implementing directly.
Wait for all teammates to complete their tasks.

Step 3: Monitor & Coordinate

Lead は実装せず、モニタリングと統合に専念する。

Monitoring Checklist

  • タスクリストの進捗を確認(Ctrl+T)
  • 各 Teammate の出力を確認(Shift+Up/Down)
  • ファイル競合がないか確認
  • 行き詰まっている Teammate がいないか確認

Intervention Triggers

状況 対応
Teammate が長時間タスクを進めない メッセージで確認、必要なら再指示
ファイル競合が発生 所有権を再配分
テストが失敗し続ける 関連する Implementer にメッセージ
想定外の技術的問題 Codex に相談(サブエージェント経由)

Quality Gates (via Hooks)

TeammateIdle hook と TaskCompleted hook が自動で品質チェック:

  • lint チェック(ruff)
  • テスト実行(pytest)
  • 型チェック(ty)

Step 4: Integration & Verification

全タスク完了後、統合検証を行う。

bash
# All quality checks
uv run ruff check .
uv run ruff format --check .
uv run ty check src/
uv run pytest -v

# Or via poe
poe all

Integration Report

markdown
## 実装完了: {feature}

### 完了タスク
- [x] {task 1}
- [x] {task 2}
...

### 品質チェック
- ruff: ✓ / ✗
- ty: ✓ / ✗
- pytest: ✓ ({N} tests passed)
- coverage: {N}%

### 次のステップ
`/team-review` で並列レビューを実行してください

Cleanup

Clean up the team

Tips

  • Delegate mode: Shift+Tab で Lead が実装を避ける
  • タスク粒度: Teammate あたり 5-6 タスクが最適
  • ファイル競合回避: モジュール単位の所有権分離が最重要
  • Tester 分離: Implementer とは別に Tester を立てるとTDD的に回る
  • コスト意識: 各 Teammate は独立した Claude インスタンス(トークン消費大)

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results