Claude Codeの設計が本題からそれる?成果を先に決める「claude-code-workflows」
- 公開
- 正式公開 2025-10-10
- 作り手
- shinpr(個人)
- 対応
- Claude Code プラグイン
- 言語
- English・简体中文・日本語・Español・한국어・Português (Brasil)
- 価格
- 無料(MIT ライセンス)
- 評価
- GitHub のスター 695(2026-10-14)
どんなアプリか
Claude Code に入れて使う開発ワークフローのプラグインです。作り手は README で、Claude Code はコードベースを深く探れる一方、規模のある作業では結論にまとまらないことのほうが難しいと書いています。例として、アカウント復旧の流れを設計している途中でトークン処理の本物の不整合を見つけて設計の大半をそこに使い、頼んだ復旧の動きがあいまいなまま残る場面を挙げています。
claude-code-workflows keeps that exploration pointed at an agreed result. It agrees on the outcome and exclusions before design, checks designs against the repository, verifies each task before commit, and, on larger changes, independently reviews the finished implementation to make sure it delivers the agreed result, does not include unnecessary changes, and has no serious functional, reliability, or security problems.
shinpr さん、GitHub の README
入口は /recipe- で始まるコマンドです。バックエンドや一般的な変更を通しで進める /recipe-implement、実装の前に設計を作る /recipe-design、React / TypeScript のフロントエンド向けの /recipe-front-design などがあり、修正方針を決める前の調査をする /recipe-diagnose はコードを変更しません。
どの道を通るかはファイルの数ではなく、変更にからむ製品や設計の判断の数で決まります。実装の範囲が承認されたあとは、決まりきった実装の判断で利用者に尋ねることはなく、尋ねるのは合意した成果や対象外を変える必要があるときと、取り消せない外部の操作に承認が要るときだと説明されています。
README には作り手自身の mcp-local-rag での実例が載っています。ファイルシステムの走査、保存、CLI と MCP の両方にまたがる変更で、独立したセキュリティレビューが実装を差し戻し、検証前のファイル読み込みと、シンボリックリンクの親ディレクトリを通じたパスの抜け道を見つけたとしています。
料金とデータの置き場所
MIT ライセンスで公開されていて、無料で使え、改変や再配布もできます。
作業計画やタスクのファイルはリポジトリの docs/plans/ に置かれる一時的な作業状態として扱われ、実行が成功すると使い終わったものは片づけられます。PRD・ADR・UI Spec・Design Doc はそれぞれのディレクトリに置き、コミットする前提です。
同じ分野のアプリ
| 名前 | 型 | 仕掛け | 対応 | 料金 |
|---|---|---|---|---|
| claude-code-workflows | 開発ワークフロー | 成果と対象外を設計前に合意し、大きな変更は独立レビューまで回す | Claude Code プラグイン | 無料(OSS, MIT) |
| Claude Code Cookbook | コマンド集 | コマンド・ロール・自動化スクリプトで定型作業を任せる | Claude Code プラグイン | 無料(OSS、ライセンス要確認) |
| CC-Flow | ワークフロー定義 | サブエージェントを順に呼び出すワークフローを定義・実行 | Claude Code 用ツール | 無料(OSS) |
| CC Workflow Studio | ワークフロー作図 | ノードをつないだワークフローを Markdown に書き出す | VS Code 拡張(Open VSX ほか) | 無料(OSS) |
| cc-company | 仮想会社 | 「秘書」が窓口になり「部署」フォルダを提案して増やす | Claude Code(プラグインマーケットプレイス) | 無料(OSS, MIT) |
入れる前に
プラグインのマーケットプレイスに対応した Claude Code が必要です。ワークフローのプラグインはひとつを選んで入れるよう案内されていて、dev-workflows-fullstack にはバックエンドとフロントエンドの両方のワークフローが入っています。
手順の進め方はすでに自前のプロンプトや CI で持っていて、ベストプラクティスのガイドがほしい場合は dev-skills がありますが、ワークフローのプラグインと一緒に入れないよう注意書きがあります。同じスキルを共有しているため、説明が重複して Claude Code がスキルを無視することがあるためです。
ワークフローはエージェントの呼び出しと成果物を増やすので、作り手は、その手間に見合う変更で使うよう勧めています。結果も安全な実装の範囲もはっきりしている変更なら Claude Code を直接使い、全部の確認が要らない変更には確認を減らした lite mode があります。
docs/plans/ はプロジェクトの .gitignore に加えるよう、よくある質問で案内されています。OpenAI Codex CLI 向けには、同じ考え方の codex-workflows があります。