shinpr/claude-code-workflows

何が解決されるか

Claude Code Workflows は、生成されたコードが設計書とテストに厳密に一致するように、構造化されたエージェント駆動型開発ライフサイクルを提供します。これにより、AI が生成したコードが元の要件からずれたり、自身のテストにパスしないという一般的な問題を防ぎます。開発プロセスの各段階に専門エージェントを導入することで実現します。

どのように機能するか

このプロジェクトは、「レシピ」（エントリーポイント）のシリーズを実装し、ユーザーのリクエストを専門エージェントのパイプラインにルーティングします。タスクの複雑度（小、中、大）によってワークフローが変わります：

• 分析と計画：requirement-analyzer が作業の規模を判断します。大きなタスクの場合、製品要件ドキュメント（PRD）の作成、コードベースの分析、技術設計ドキュメントの作成をトリガーします。

• 実行：バックエンドまたはフロントエンドの専門エグゼキューターが、テスト駆動開発（TDD）を使用して機能を実装し、コードが型チェックとリンティングされるようにします。

• 検証：code-reviewer と code-verifier が設計書に基づいて実装をチェックし、要件が見落とされていないことを確認します。

• 診断：investigator、verifier、solver の専用ループを使用してバグの根本原因を分析し、トレードオフ分析に基づく解決策を提案します。

• 逆エンジニアリング：システムは既存のコードをスキャンして PRD と設計ドキュメントを生成し、レガシーコードベースを AI フレンドリーにします。

対象者

Claude Code を使用し、単なるチャットベースのコード生成よりも決定的でプロフェッショナルなソフトウェアエンジニアリングプロセスを望む開発者。特にバックエンド API、React/TypeScript フロントエンド、またはフルスタックアプリケーションに取り組んでいる方に適しています。

ハイライト

• レイヤー認識ワークフロー：バックエンド、フロントエンド、フルスタック開発用の別々のプラグイン。それぞれに専門エージェントが存在（例：React 用の ui-spec-designer）。
• マルチエージェストレーション：Analyzer $ ightarrow$ Designer $ ightarrow$ Planner $ ightarrow$ Executor $ ightarrow$ Reviewer のエージェントチェーンを使用し、クリーンなコンテキストウィンドウを維持します。
• UI 仕様：フロントエンド作業のための専用ステップ。プロトタイプで見落としがちなエッジケース（ロード、エラー、空状態）をキャプチャします。
• 自動ドキュメント生成：既存コードを構造化された PRD と設計ドキュメントに逆エンジニアリングする機能。
• TDD 統合：テストファースト実装と品質修正のための組み込み原則。