sangrokjung/claude-forge

oh-my-zsh for Claude Code — 16 agents, 35 commands, 32 skills, 21 safety hooks in one install. v4.0 adds an adversarial review loop: a second agent that never sees the first one's reasoning. MIT.

Claude Forge – Claude Code のためのプラグインパック

何であるか – Claude Forge は、基本的な Claude Code ターミナルベースのコーディングアシスタントを、本格的な開発ワークステーションに変える、事前に構成されたエージェント、コマンド、スキル、フック、ルール、ツール連携のコレクションです。oh‑my‑zsh をシェルに例えるなら、コアのアシスタントは同じままですが、このパックは数十の専門的な「同僚」、セーフティネットチェック、1行で実行できるショートカットを追加します。

なぜ重要か – Claude Code はコードを生成できますが、それだけではテストの実行、セキュリティレビュー、ドキュメントの同期などを自分で覚えておく必要があります。Claude Forge はこれらのベストプラクティスを自動的に統合し、リスクの高い操作(例:シークレットの漏洩、安全でないコマンドの実行)をブロックする6層のフックシステムを追加し、変更ごとに2番目の独立したエージェントがレビューを行う検証ループを提供します。


主な構成要素(README に記載)

構成要素 数 役割(平易な言葉)
エージェント 16 専門的なAI「同僚」(プランナー、アーキテクト、セキュリティレビュー担当、テスト最優先ガイド、データベースレビュー担当など)で、適切なタスクに自動的に呼び出されます。
コマンド 35 シェル内で入力するスラッシュ形式のショートカット(/plan, /tdd, /code‑review, /e2e, …)で、1キーストロークで全体のワークフローを開始できます。
スキル 33 さらにプロンプトを必要とせずに Claude が従う事前に書かれたプレイブック(例:loop‑forge, review‑loop, harness‑diet)。
フック 22(+9つのオプション例) 各 Claude 操作の前後で静かに実行されるセーフティチェック。シークレットの漏洩、危険なDBコマンド、APIエラー後の自動再開、セッション時間の報告などをブロックします。
ルール 14 セッション開始時に読み込まれるテキストファイルで、コーディングスタイル、セキュリティポリシー、Gitワークフロー、検証が必要なタイミングなどを定義します。
MCP 接続 4 外部ツールとのブリッジ – Playwright ブラウザ自動化、リアルタイムドキュメント検索、Jina ページリーダー、Chrome DevTools 統合。

インストール方法

方法 取得できるもの
オプション A – Claude Code プラグイン 35 のコマンドと大部分のスキルをインストール。エージェント、フック、ルール、外部ツール接続はインストールされません。
オプション B – フルインストール(推奨) 1行の `curl …

両方の方法は後から /plugin update claude-forge(オプション A)または ./install.sh --upgrade(オプション B)で更新可能です。


使い方

  1. ターミナルで Claude Code セッションを開始。
  2. スラッシュコマンドを入力、例:/plan → 生成された実装計画の確認を促される。
  3. /tdd を実行 → テストを先に書く、その後コードを書く。tdd‑guide エージェントが RED‑GREEN‑REFactor ループを保証する。
  4. 変更を終えたら /code‑review を呼び出す → code‑reviewer と security‑reviewer エージェントが実行され、22のフックが安全でない操作を静かにブロックする。
  5. /handoff‑verify または /verify‑loop で終了 → 新しいコンテキストの adversarial‑reviewer が変更をチェックし、APPROVE または REQUEST_CHANGES を返す。その後、/commit‑push‑pr で自動的にコミット・プッシュ・PRが作成可能。

上記すべては、複数のエージェントを並列で実行し、最も適切な専門家に作業をルーティングできる、組み込みの team‑orchestrator エージェントによって調整されます。


アーキテクチャのスナップショット(README に記載)

  • コア – スラッシュコマンドとスキルを解釈する Claude Code ランタイム。
  • エージェント層 – 16の専用LLMエージェント。deep‑analysis(高容量モデル)と fast‑execution(軽量モデル)のグループに分かれています。
  • フックシステム – 22のイベント駆動型セーフティチェック。21のライフサイクルタイミング(コマンド実行前後、エラー時、セッション開始/終了時など)で発火します。
  • ルールエンジン – セッション開始時に読み込まれる静的Markdownファイル(CLAUDE.md + ルールファイル)で、モデルの振る舞いを制御します。
  • MCP(マルチチャネルプラグイン)接続 – Playwright、Jina‑reader、Chrome DevTools などを通じて外部サービスにアクセスし、サブエージェントとして公開します。
  • 検証ループ – メーカー≠チェッカーのパターン。adversarial‑reviewer(メーカーの推論を一切見ない)が明示的に APPROVE を出さないと、変更は完了と見なされません。

どんな人に役立つか?

  • すでに Claude Code を使っているが、手作業でセーフティネットを構築したくない開発者。
  • 再現性があり、監査可能なAI生成コードが必要なチーム(セキュリティ、コンプライアンス、SOC2/ISO27001、GDPR、HIPAA 環境)。
  • プランニングからPRまで「ワンクリック」で完了したいシングルエンジニア。

クイックスタートチェックリスト

  1. Claude Code を開く。
  2. 2つのプラグインコマンドを実行(オプション A)または install.sh スクリプトを実行(オプション B)。
  3. デモコマンドを試す:/plan → 確認 → /tdd → 生成されたテストとコードを観察。
  4. 満足したら、/commit‑push‑pr を実行して自動的にPRを作成。
  5. ./install.sh --upgrade または /plugin update claude‑forge でパックを最新状態に保つ。

ライセンスとコミュニティ

  • MIT ライセンス – 個人・商用利用ともに無料。
  • リポジトリは活発なメンテナンス(最新 v4.3.0 2026年9月リリース)と、増加する貢献者ベース(スター、フォーク、最近のコミット)を示しています。
  • ドキュメントには13言語のセットアップガイドと、詳細な 検証ループ 解説が含まれます。

結論:Claude Forge は、Claude Code AIコーディングアシスタントの包括的で即時利用可能な拡張パッケージであり、専門エージェント、セーフティフック、事前準備済みコマンド、ツール連携を提供し、Claude を単なるコード生成器ではなく、完全に整備された開発チームメイトとして扱えるようにします。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト