shinpr/claude-code-workflows：Claude Code 向けの反復可能な開発ワークフローを提供するプラグインマーケット

プラグインマーケットと、その対象とする問題

shinpr/claude-code-workflows は Claude Code 向けのプラグインマーケットです。README は、設計上の決定を実装、テスト、レビューを通して追跡可能にする、反復可能なソフトウェア開発ワークフローを提供することを目的としています。動機となっている問題は、Claude Code が個々のコーディングタスクはうまく処理できる一方で、長いセッションの間に変更が静かに範囲を広げたり、設計と実装の間で重要な決定が失われたりすることです。リポジトリのメタデータはこのプロジェクトを production-ready と表現していますが、その語はメタデータ自体に由来し、README は production-ready の意味を定義していないため、文書から特定の成熟度を推測することはできません。

新しいコンテキストで実行されるフェーズと、明示的な引き継ぎ

ワークフローは各フェーズを新しいエージェントコンテキストで実行し、明確な成果物を通じて引き継ぎます。README は、既存のコードベースを検査し、最小限で十分な変更を設計し、承認のために一時停止し、タスクを一度に1つ実装し、最後に完成した作業が合意されたスコープと要件に一致するかを確認する、という流れを説明しています。これらのフェーズを支える専門エージェントとして、requirement-analyzer は変更規模と影響レイヤーを判断し、codebase-analyzer は設計前にコードを検査し、work-planner は設計上の決定を実行可能な計画に変換し、task-decomposer は計画をコミット可能なタスクに分割し、code-reviewer と security-reviewer が最終検証を行います。README は、最終レビューが実装時の会話ではなく元の文書を読むことを明示しています。

テンプレート、文書、成果物の追跡

引き継ぎを具体的にするため、リポジトリには Work Plan テンプレートと Task テンプレートが含まれています。Work Plan の表は、Design Doc の各技術要件にカバーするタスクがあるか、明示的なギャップがあることを要求し、Task テンプレートは拘束力のある決定と観測可能な契約値を、項目ごとの yes/no 準拠チェックとともに運びます。規模が大きい変更では、コードベース分析、Design Doc、そしてスコープが必要とする場合には PRD、UI Spec、ADR、受け入れテスト、作業計画が追加されます。README は、ワークフローがデフォルトで完全な文書セットを作成するわけではないと述べています。また、成果物ごとにディレクトリが割り当てられており、PRD、ADR、UI Spec、Design Doc はコミットすることを想定し、docs/plans/ は一時的な作業状態として扱い、.gitignore に追加することを推奨しています。

個人利用とチーム利用のセットアップ

クイックスタートには、プラグインマーケットをサポートする Claude Code リリースが必要です。個人利用では、claude を起動し、/plugin marketplace add shinpr/claude-code-workflows でマーケットを追加し、dev-workflows、dev-workflows-frontend、dev-workflows-fullstack のいずれかのワークフロープラグインをインストールし、/recipe-implement や /recipe-front-design などのレシピを実行します。チーム利用では、project スコープでマーケットを追加しプラグインをインストールし、生成された .claude/settings.json をコミットして、貢献者に同じプラグインの使用を促します。README は、ワークフロープラグインを1つだけインストールすることを推奨しています。dev-workflows-fullstack にはバックエンドとフロントエンドのワークフローが既に含まれており、以前 dev-workflows のフルスタックレシピを使っていた場合は dev-workflows-fullstack への移行を求めています。

文書化されたエンドツーエンドの実行例

README は、ワークフローの実際の動作例として、mcp-local-rag のインクリメンタル同期機能を挙げています。これは、ファイルシステムスキャン、ストレージ、CLI と MCP の両サーフェスにまたがる42ファイルの変更でした。独立したセキュリティレビューは実装を2回差し戻し、検証前のファイル読み取りと、シンボリックリンクされた親ディレクトリを通じたパス包含のエスケープを検出しました。実行は既存の Work Plan から始まり、/recipe-build が計画された ADR と Design Doc の欠落を検出すると、意図された承認境界で停止しました。ユーザーが Work Plan を技術的な情報源として承認し、レシピはそれを13の計画タスクに分割しました。計画されたファイルセットの外にテストファイルを追加するには2回目のユーザー決定が必要で、PR にはウォッチモードと永続ジョブを除外した理由も記録されています。

ワークフロープラグイン、dev-skills、オプションのアドオン

マーケットは、完全なワークフロープラグインと dev-skills を区別しています。ワークフロープラグインには、エンドツーエンド開発のための専門エージェントとレシピコマンドが含まれます。dev-skills は、エージェントも所定のワークフローも含まない、コーディング、テスト、設計、文書化のガイダンスのみを提供し、カスタムプロンプトや CI で Claude をすでにオーケストレーションしているチームを対象としています。README は、dev-skills をワークフロープラグインと一緒にインストールしないよう警告しています。両者が同じスキルを共有し、重複した説明が原因で、Claude Code がコンテキスト制限に達した後にスキルを無視する可能性があるためです。マーケットにはオプションのアドオンもリストされています。claude-code-discover は機能アイデアを証拠に基づく PRD に変え、metronome は近道行動を検出し、linear-prism は要件を検証して構造化された Linear タスクに変換し、pr-review はリポジトリ固有の基準に基づいて GitHub PR をレビューします。

ライセンスと、ソースが語らないこと

リポジトリは MIT ライセンスで提供され、著作権は Shinsuke Kagawa に帰属します。ライセンスは、ソフトウェアのコピーを、使用、複製、変更、結合、公開、配布、サブライセンス、販売する権利を許可し、すべてのコピーまたは実質的な部分に著作権表示と許可表示を含めることを条件とします。ソフトウェアは現状のまま提供され、商品性、特定目的への適合性、非侵害を含むいかなる種類の保証もありません。ライセンス文書は、サポート、セキュリティ、可用性、保守の約束については何も述べていません。README も、プラグインマーケットをサポートする Claude Code リリースが必要であること以外に、リリースバージョン番号、日付、互換性の保証を明記していません。これらの具体的な点についての仮定は、他の場所で検証する必要があります。

編集部の結論

README は docs/plans/ を、実行後にクリーンアップされる一時的な作業状態として説明し、PRD、ADR、UI Spec、Design Doc はそれぞれ専用ディレクトリにコミットすることを想定しています。リポジトリは @shinpr が保守し、MIT ライセンスで提供されていますが、サポート窓口、保証、セキュリティコミットメント、リリースバージョンや日付については文書化されていません。

公式情報源

1. Official README
2. Project repository
3. Release notes