# 開発ワークフロー

> このファイルは [common/git-workflow.md](./git-workflow.md) を拡張し、Git操作の前に行われるフル機能開発プロセスを説明します。

機能実装ワークフローは、開発パイプラインを説明します：調査、計画、TDD、コードレビュー、そしてGitへのコミット。

## 機能実装ワークフロー

0. **調査と再利用** _（新規実装の前に必須）_
   - **まずGitHubコード検索：** 何か新しいものを書く前に、`gh search repos` と `gh search code` を実行して既存の実装、テンプレート、パターンを見つける。
   - **次にライブラリドキュメント：** Context7またはベンダーの公式ドキュメントを使用して、API動作、パッケージ使用方法、バージョン固有の詳細を実装前に確認する。
   - **最初の2つが不十分な場合のみExa：** GitHub検索と公式ドキュメントの後、より広範なウェブ調査や発見のためにExaを使用する。
   - **パッケージレジストリを確認：** ユーティリティコードを書く前にnpm、PyPI、crates.ioなどのレジストリを検索する。手作りのソリューションよりも実績のあるライブラリを優先。
   - **適応可能な実装を検索：** 問題の80%以上を解決し、フォーク、移植、またはラップできるオープンソースプロジェクトを探す。
   - 要件を満たす場合、完全な新規コードよりも実績のあるアプローチの採用や移植を優先する。

1. **まず計画**
   - **planner**エージェントを使用して実装計画を作成
   - コーディング前に計画ドキュメントを生成：PRD、アーキテクチャ、system_design、tech_doc、task_list
   - 依存関係とリスクを特定
   - フェーズに分割

2. **TDDアプローチ**
   - **tdd-guide**エージェントを使用
   - まずテストを書く（RED）
   - テストを通すように実装（GREEN）
   - リファクタリング（IMPROVE）
   - 80%以上のカバレッジを検証

3. **コードレビュー**
   - コード作成直後に**code-reviewer**エージェントを使用
   - CRITICALとHIGHの問題に対処
   - 可能な場合はMEDIUMの問題も修正

4. **コミットとプッシュ**
   - 詳細なコミットメッセージ
   - Conventional Commitsフォーマットに従う
   - コミットメッセージのフォーマットとPRプロセスについては[git-workflow.md](./git-workflow.md)を参照

5. **レビュー前チェック**
   - すべての自動チェック（CI/CD）が通過していることを確認
   - マージコンフリクトを解決
   - ブランチがターゲットブランチと最新状態であることを確認
   - これらのチェックが通過した後にのみレビューを依頼
