shinpr/claude-code-workflows

Development workflows for Claude Code that keep broad exploration focused on the outcome you approved.

Claude Code Development Workflows

何であるか – Claude Code AIアシスタントを構造化された開発プロセスエンジンに変換する、Claude Codeプラグインのコレクション。プラグインは「レシピ」（例：/recipe‑implement、/recipe‑design、/recipe‑review）を定義し、モデルを以下に導きます：

範囲の合意 – ユーザーとClaudeが望ましい成果と除外事項について合意する。
設計と計画 – Claudeが設計ドキュメント、UI仕様、ADR、およびコード作成前にレビューされる作業計画を生成する。
タスクレベルの実装 – 作業計画の各項目が実行され、リポジトリ固有の品質ルールに基づいて検証され、自動的にコミットされる。
独立したレビュー – 2段階目のセキュリティ/レビューAIエージェントが、ワークフロー終了前に機能的・信頼性・セキュリティ上のリグレッションがないかをチェックする。

このシステムは意図的に3つのプラグインファミリーに分かれています：

プラグイン	対象	通常のエントリポイント
`dev‑workflows`	バックエンドまたは汎用コードベース	`/recipe‑implement`、`/recipe‑design`、…
`dev‑workflows‑frontend`	React/TypeScriptフロントエンド	`/recipe‑front‑design`、`/recipe‑front‑build`、…
`dev‑workflows‑fullstack`	バックエンドとフロントエンドの両方を持つプロジェクト	`/recipe‑fullstack‑implement`、…

なぜ使うべきか

デザインの議論と実際のコード生成の間に正式な引き渡しが必要な場合。Claudeが合意した製品目標から逸脱しないようにするため。
チームが繰り返し可能なセーフティゲート（設計レビュー、作業計画承認、独立したセキュリティレビュー）を自動的にプラグインで強制したい場合。
すでにClaude Codeを使っているが、複数のリポジトリで同じAI駆動のワークフローを維持したい場合。

クイックスタート（READMEから）

# 1. Claude Codeを起動
claude

# 2. プラグインをホストするマーケットプレイスを追加
/plugin marketplace add shinpr/claude-code-workflows

# 3. プロジェクトタイプに合ったプラグインをインストール
#   – バックエンド / 汎用
/plugin install dev-workflows@claude-code-workflows
/recipe-implement "Public APIにレート制限を追加"

#   – Reactフロントエンド
/plugin install dev-workflows-frontend@claude-code-workflows
/recipe-front-design "アカウント復旧画面を追加"

#   – フルスタック
/plugin install dev-workflows-fullstack@claude-code-workflows
/recipe-fullstack-implement "JWT + ログインフォームによるユーザー認証を追加"

1つのリポジトリには1つのワークフロープラグインのみをインストールすること。フルスタックプラグインはすでにバックエンドとフロントエンドのレシピをバンドルしている。

ワークフローの動作（概要フロー）

リクエスト → 成果と除外事項の合意 →
   ┌─► 単純なパス？ ──► 直接タスクサイクル → 完了
   │
   └─► 複雑？ → 検査 → 設計 → レビュー → スコープ承認 →
        タスクごと：実装 → 検証 → 品質チェック → コミット →
        独立したセキュリティレビュー → （修正ループ） → 完了

どちらのパスを取るかは製品決定の複雑さによる。ファイル数ではない。

プラグインが導入するコアコンセプト

作業計画 – 設計ドキュメント、ADR、UI仕様などから得た承認済み要件を1つ以上の具体的なタスクにマッピングするテーブル。未記載のギャップは警告される。
タスクテンプレート – 各生成されたタスクには正確な受入基準と、コミット前に実行されるYes/Noコンプライアンスチェックが付随する。
品質プロファイル – docs/project‑context/quality.yaml に保存されたリポジトリ固有のLint、テスト、セキュリティルール。プラグインは検証ステップでこのプロファイルを読み込む。
専門エージェント – requirement‑analyzer、code‑verifier、security‑reviewer などのAIエージェントのセットをオーケストレーションし、設計、実装、レビューの関心事項を分離する。

例の実行（READMEから要約）

ユーザーが /recipe‑implement "Public APIにレート制限を追加" を実行。
Claudeがリポジトリを分析し、設計ドキュメントを提案。ユーザーが承認。
作業計画が生成され、4つのタスクに分割（ミドルウェア追加、設定更新、テスト作成、ドキュメント更新）。
各タスクで タスクエクセキューター エージェントがコードを書く、コード検証エージェント がリポジトリの品質プロファイルを実行、変更がコミットされる。
すべてのタスクが完了後、セキュリティレビュー エージェントが独立したチェックを実行。問題なし。ワークフロー終了。

必要ない場合

変更が素早いプロトタイプであり、成果と安全な実装の境界がすでに明確な場合、追加のワークフローのオーバーヘッドなしにClaude Codeを直接使用できる。

ライセンスと貢献

ライセンス: MIT（READMEのバッジを参照）。
貢献: PRを歓迎。リポジトリには PRs welcome バッジが含まれている。

まとめ

shinpr/claude-code-workflows は、自らのコードにインポートするライブラリではない。Claude Codeを使用する任意のプロジェクトに、厳格でAI駆動の開発パイプラインを追加するClaude Codeプラグインセットである。設計レビュー、作業計画承認、タスクレベルの検証、独立したセキュリティレビューをコード化することで、チームがClaude生成コードが合意された製品目標とリポジトリの品質基準に一致していることを保証する。