implementation

実装・テスト (Implementation)

Overview

サブタスク (=PR単位) の実装を行う。TDDベースで進め、意味のある単位でコミットする。

Announce at start: 「サブタスク #N の実装を開始します: [サブタスク名]」

REQUIRED SUB-SKILL: aidlc:pr-strategy — コミット・PRルールに従うこと

The Process

Step 1: ブランチ作成

git checkout -b feature/<feature-name>/<subtask-name>

命名規則: feature/<機能名>/<サブタスク名>

Step 2: 実装 (TDDサイクル)

各機能単位で以下のサイクルを回す:

1. Red: 失敗するテストを書く
2. Green: テストを通す最小限のコードを書く
3. Refactor: コードを整理する
4. Commit: 意味のある単位でコミット

詳細なTDDガイダンスが必要な場合: ecc:tdd-workflow スキルを参照。 テストパターン（Unit/Integration/E2E）、カバレッジ目標（80%+）、 モックパターン、アンチパターン等の具体例が含まれます。

TDDの必須ルール

• テストファースト: 実装コードの前に必ずテストを書く
• カバレッジ目標: 80%以上を目指す（unit + integration + E2E）
• エッジケース: null, undefined, 空文字, 境界値, 大量データを必ずテスト
• テスト独立性: テスト間の依存を排除し、各テストが独立して実行可能であること
• セマンティックセレクタ: E2Eテストでは data-testid やロールベースのセレクタを使用

Step 3: コミットルール

通常のコミット

意味のある変更ごとにコミットする:

git add <specific-files>
git commit -m "feat: add order status validation

Co-Authored-By: Claude <[email protected]>"

スクリプト生成ファイルのコミット

スクリプトによって生成・更新されるファイルは必ず別コミットにし、 `[scripts]` プレフィックスと実行したスクリプトをコミットメッセージに記載する。

# 1. スクリプトを実行
bin/rails generate migration AddStatusToOrders status:integer

# 2. 生成ファイルのみをコミット
git add db/migrate/YYYYMMDD_add_status_to_orders.rb
git commit -m "[scripts] rails generate migration AddStatusToOrders status:integer

Generated by: bin/rails generate migration AddStatusToOrders status:integer

Co-Authored-By: Claude <[email protected]>"

# 3. 手動で編集した内容は別コミット
git add db/migrate/YYYYMMDD_add_status_to_orders.rb
git commit -m "feat: add status column with default value and index

Co-Authored-By: Claude <[email protected]>"

Step 4: PRサイズ監視

実装中に変更行数を定期的に確認:

git diff --stat HEAD~N  # またはブランチ分岐元との比較

±150行を超えそうな場合:

1. ユーザーに報告する
2. さらなる分割を提案する
3. または理由を説明して続行の承認を得る

Step 5: 実装完了確認

サブタスクの実装が完了したら:

1. 全テストが通ることを確認
2. 変更内容のサマリを作成
3. PR作成フェーズへ遷移

「サブタスク #N の実装が完了しました。

• 変更ファイル数: X
• 追加/削除行数: +Y/-Z
• テスト結果: ALL PASS

PR作成に進みます。」

REQUIRED NEXT SKILL: aidlc:pr-creation

エラー・ブロッカー対応

テストが失敗した場合:

• 原因を調査し修正する
• 修正が困難な場合はユーザーに相談する

サイズ超過の場合:

• ユーザーに分割案を提示する
• 承認を得てから対応する

依存タスクの未完了:

• 依存タスクが未完了の場合はスキップし、次の独立タスクに移る
• ユーザーに報告する