piv-implement

実行：計画に基づく実装

実行する計画

計画ファイルを読み込みます：$ARGUMENTS

作業を始める前に — フィーチャーブランチで作業する

チケットごとに専用のブランチで開発し、1つのPRにまとめます。理想的には、計画を立てる前にブランチを作成しておき、すでにそのブランチにいる状態です。こうすれば、作成した計画のコミットもブランチに含まれてPRに反映されます。ベースブランチ上で計画をコミットしても、このブランチのPRには含まれません。 まだベースブランチにいる場合は、この手順でブランチを作成します。ベースブランチを検出します（mainをハードコードしないでください）：git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@' （検出できない場合はmain）。

• ベースブランチにいて、作業ツリーがクリーンな場合 → ブランチを1つ作成します：git checkout -b feature/<plan-slug>。
• すでにフィーチャーブランチまたはワークツリーにいる場合 → そのまま使用します。
• ベースブランチにいて、未コミットの変更がある場合 → 中止します。先にコミットするか、変更をスタッシュしてください。

（チケットごとにブランチを1つ作成することで、後から並行してワークツリーを使う場合も整理しやすくなります。）

実行手順

1. 読んで理解する

• 計画全体を注意深く読む
• すべてのタスクとその依存関係を理解する
• 実行する検証コマンドを確認する
• テスト戦略を確認する

2. タスクを順番に実行する

「Step by Step Tasks」の各タスクについて：

a. タスクに取り掛かる

• 対象ファイルと必要な操作を特定する
• 変更する場合は、関連する既存ファイルを読む

b. タスクを実装する

• 詳細な仕様に厳密に従う
• 既存コードのパターンとの一貫性を保つ
• 適切な型ヒントとドキュメントを含める
• 必要に応じて構造化ログを追加する

c. 作業しながら検証する

• ファイルを変更するたびに、構文を確認する
• インポートが正しいことを確認する
• 型が適切に定義されていることを確認する
• 次のタスクに進む前に、タスク固有のVALIDATEコマンドを実行してください。 計画内のすべてのタスクにコマンドが記載されています。 チェックに合格するまではタスク完了ではありません。失敗した場合は、問題を先送りにせず、その場で修正してください。 手順4では全体のテストスイートも実行します。このタスクごとのチェックを通過しておくことで、手順4に問題が積み上がるのを防げます。

3. テスト戦略を実装する

実装タスクが完了したら：

• 計画で指定されたすべてのテストファイルを作成する
• 記載されているすべてのテストケースを実装する
• 指定されたテスト手法に従う
• エッジケースをテストでカバーする

4. 検証コマンドを実行する

計画に記載されたすべての検証コマンドを、順番に実行します：

# Run each command exactly as specified in plan

コマンドが失敗した場合：

• 問題を修正する
• コマンドを再実行する
• 合格してから次に進む

5. 最終確認

完了する前に、次の項目を確認します。

• ✅ 計画内のすべてのタスクが完了している
• ✅ すべてのテストを作成し、合格している
• ✅ すべての検証コマンドに合格している
• ✅ コードがプロジェクトの規約に従っている
• ✅ 必要に応じてドキュメントを追加・更新している

出力 — 実装レポートを作成する

.claude/reports/<plan-slug>-report.mdに短いレポートを作成し、要約を出力してください。このレポートはPR本文とpiv-review-prのゲートで参照されます。特に計画からの逸脱を記載してください（文書化された逸脱は、レビュー担当者が指摘すべきでない意図的な判断です）。

# Implementation Report — <feature>

**Plan**: <path>   **Branch**: <feature/...>   **Status**: COMPLETE | PARTIAL

## Summary
{What was built, 2-4 sentences.}

## Tasks completed
- [task] → `path/to/file` (CREATE/UPDATE)

## Tests added
{Test files + cases + results.}

## Validation results
{Type-check / lint / tests / build — pass/fail with counts.}

## Deviations from the plan
{What changed vs the plan and WHY — or "none". This is the reviewer's signal of intent.}

## Issues encountered
{Anything notable, or "none".}

次の手順に進む準備

• すべての変更が完了し、検証に合格していることを確認します。
• 次に、作業をpiv-commitし、その後piv-create-prでPRを作成します（レポートがPR本文に反映されます）。続いてpiv-review-prを実行します。

注意事項

• 計画で扱われていない問題が発生した場合は、記録してください
• 計画から逸脱する必要がある場合は、その理由を説明してください
• テストが失敗した場合は、合格するまで実装を修正してください
• 検証手順を省略しないでください