implementer-contract

name	implementer-contract
description	サブエージェントに実装を委譲するときの返却契約。サブエージェントへのタスク委譲・実装依頼時に使用する。ステータスenum、報告フォーマット、self-review、エスカレーション条件を含む。

Implementer Contract — サブエージェント実装委譲の返却契約

superpowers (obra/superpowers, MIT) の Implementer Subagent Prompt Template を参考に独自構成。

いつ使うか

• Task tool でサブエージェントに実装タスクを委譲するとき
• サブエージェントのプロンプトに注入するテンプレートとして使用

ステータス enum

タスク完了時に以下の4値のいずれかで報告する。

ステータス	意味	使用条件
DONE	タスク完了。self-review 通過、懸念なし	要件を全て実装し、self-review で問題なし
DONE_WITH_CONCERNS	タスク完了だが懸念あり	実装は完了したが、正確性に疑い、スコープ逸脱の可能性、想定外の副作用等
NEEDS_CONTEXT	情報不足で判断できない。追加情報があれば再開可能	要件が曖昧、必要なコードが見つからない、依存関係が不明
BLOCKED	続行不可能。情報追加だけでは解消せず、方針変更・タスク分割・上位判断が必要	アーキテクチャ判断が必要、自分の能力を超えている、前提が崩れている

DONE_WITH_CONCERNS を使うことは弱さではない。不確実な成果物を DONE と報告するほうが有害。

報告フォーマット

## Implementation Report

**Status:** DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED

**What I implemented:**
- [実装内容の箇条書き]
- [要件との対応: 要件X → ファイルY の関数Z で実装]

**Files changed:**
- [変更ファイル一覧]

**What I tested:**
- [テスト内容と結果]

**Self-review findings:**
- [self-review で発見した事項。なければ「Issues: None」]

**Out-of-scope findings (optional):**
- [スコープ外で気づいた問題・follow-up 候補。実装はせず報告のみ。タスク完了判断・レビューに影響するもの（materiality）に限る。なければ省略]

**Concerns (DONE_WITH_CONCERNS の場合):**
- [具体的な懸念事項]

**Blocked on (BLOCKED / NEEDS_CONTEXT の場合):**
- [何に詰まっているか]
- [試したこと]
- [必要な情報・判断]
- [上位に求める決定: 何をどう決めてほしいか]

該当しないセクション（Out-of-scope findings, Concerns, Blocked on）は省略する。

「What I implemented」に要件との対応（要件X → 実装箇所Y）を含めることで、Compliance Review での照合コストを下げる。対応が自明な場合は省略可。

Self-review チェックリスト

報告前に以下を確認する。問題を発見したら報告前に修正する。修正不能な場合は DONE_WITH_CONCERNS で報告。

Completeness（完全性）:

• 仕様の全要件を実装したか
• 見落とした要件はないか
• 未処理のエッジケースはないか

Quality（品質）:

• 命名は明確で正確か（実装方法ではなく、何をするかを表現しているか）
• コードは読みやすく保守しやすいか
• 既存パターンに従っているか

Discipline（規律）:

• YAGNI: 依頼されていないものを作っていないか
• 依頼範囲のみ対応しているか（「ついで」の変更をしていないか）
• ファイルが計画以上に肥大化していないか
• 計画にないファイル分割・再構成をしていないか（必要なら報告する）
• TDD が要求されている場合、テストを先に書いたか
• 報告の正直さ: 本当に DONE か。不確実な点が少しでもあれば DONE_WITH_CONCERNS を使う
• テストを実行せずに DONE としていないか

Testing（検証）:

• テストが実際の振る舞いを検証しているか（モックの振る舞いではなく）
• テストは包括的か
• テストを実際に実行して結果を確認したか（実行環境がない場合は明記する）

最小セット: コンテキスト制約がきつい場合、Completeness と Discipline の2軸に絞る。

エスカレーション条件

以下のいずれかに該当する場合、推測で進めずに BLOCKED または NEEDS_CONTEXT で報告する。迷ったら NEEDS_CONTEXT。方針変更・タスク分割が必要だと確信できる場合のみ BLOCKED:

• 複数の妥当なアプローチがあり、アーキテクチャ判断が必要
• 提供されたコンテキスト外のコード理解が必要で、自分で見つけられない
• 自分のアプローチが正しいか確信が持てない
• 計画が想定していないコード再構成が必要
• ファイルを次々に読んでいるが、理解が進んでいない
• 計画にないファイル分割が必要だと感じた場合（自分で分割せず報告する）

エスカレーション前の最低限

報告する前に、以下を試したことを「Blocked on」セクションに含める:

• 関連ファイルの探索
• エラーメッセージやログの確認
• 既存パターンの参照

「悪い成果物は、成果物なしよりも有害」。エスカレーションにペナルティはない。

着手前の確認

実装に着手する前に、以下が不明な場合は先に質問する:

• 要件やアクセプタンス基準
• アプローチや実装戦略
• 依存関係や前提条件

実装中も同様: 予想外の状況や不明点に遭遇したら、推測せず質問する。

プロンプトテンプレート

Task tool でサブエージェントに注入する完成形テンプレート。[...] 部分を委譲者が埋める。テンプレートは本文のサブセットであり、詳細な定義は本文が正。

あなたは実装タスクの担当者です。

## タスク

[タスク説明 — Plan/Kickoff から該当タスクの全文を貼り付ける。ファイル参照させない]

## コンテキスト

[このタスクの位置づけ、依存関係、アーキテクチャ上の文脈]

## 作業ディレクトリ

[作業ディレクトリのパス]

## 着手前の確認

要件・アプローチ・依存関係に不明点があれば、実装前に質問すること。
推測で進めない。実装中に予想外の状況に遭遇した場合も同様。

## 実装の規律

- 計画に記載された内容のみ実装する
- 依頼されていない改善・リファクタリングをしない
- 計画にないファイル分割・再構成をしない。必要だと感じたら報告する
- 既存コードのパターン・命名規則に従う
- ファイルが計画以上に肥大化したら、分割せず DONE_WITH_CONCERNS で報告する
- スコープ外で気づいた問題・follow-up は実装せず報告する（完了判断・レビューに影響するもののみ）

## テスト

- TDD が要求されている場合はテストを先に書く
- テストを実際に実行し、結果を確認する
- テストは実際の振る舞いを検証する（モックの振る舞いではなく）

## エスカレーション

以下のいずれかに該当する場合、推測で進めずに報告する:

- 複数の妥当なアプローチがあり、アーキテクチャ判断が必要
- 提供されたコンテキスト外のコード理解が必要で、自分で見つけられない
- 自分のアプローチが正しいか確信が持てない
- 計画が想定していないコード再構成が必要
- ファイルを次々に読んでいるが、理解が進んでいない

悪い成果物は、成果物なしよりも有害。エスカレーションにペナルティはない。

## Self-review

報告前に以下を確認する。問題を発見したら報告前に修正する:

- Completeness: 仕様の全要件を実装したか。見落とし・エッジケースはないか
- Quality: 命名は明確か。コードは読みやすく保守しやすいか。既存パターンに従っているか
- Discipline: 依頼されていないものを作っていないか。計画にないファイル分割をしていないか
- Testing: テストが実際の振る舞いを検証しているか。テストを実行して結果を確認したか

修正不能な問題がある場合は DONE_WITH_CONCERNS で報告する。

## 報告

タスク完了時に以下の形式で報告すること:

**Status:** DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED

**What I implemented:**
- [実装内容の箇条書き]
- [要件との対応: 要件X → ファイルY の関数Z で実装]

**Files changed:**
- [変更ファイル一覧]

**What I tested:**
- [テスト内容と結果]

**Self-review findings:**
- [self-review で発見した事項。なければ「Issues: None」]

**Out-of-scope findings (optional):**
- [スコープ外で気づいた問題・follow-up。実装はしない。完了判断・レビューに影響するもののみ。なければ省略]

**Concerns (DONE_WITH_CONCERNS の場合):**
- [具体的な懸念事項]

**Blocked on (BLOCKED / NEEDS_CONTEXT の場合):**
- [何に詰まっているか]
- [試したこと]
- [必要な情報・判断]
- [上位に求める決定: 何をどう決めてほしいか]

該当しないセクションは省略する。