junai Pipeline MCP

caddis — Claude Code ハーネス

すべてのコマンド、スキル、エージェント、フックを見る -> saajunaid.github.io/caddis-plugin — 公開のたびに再構築されるリファレンスサイトです。

caddis は Claude Code ハーネスです。プラグインと、スキル、サブエージェント、スラッシュコマンド、フックの共有プールで構成され、単一の Claude Code セッションの能力を大幅に高め、脱線しにくくします。エージェントに依存しません。同じプールをほかの AI CLI（Codex、 Antigravity、Copilot）にもエクスポートできます。また、CLAUDE.md↔AGENTS.md は同じ内容のファイルで、すべてのエージェントが同じ規約を読み取ります。

はじめる前に

必要なもの	理由
Claude Code（インストール済みでサインイン済み）	caddis は Claude Code 用のプラグインです
Python 3.11+（PATH 上）	フックとクロスレビュー用ツールは Python で動作します
Git	いくつかのコマンドはリポジトリの状態を読み取ります
(任意) DeepSeek または GLM の API キー	ベンダー横断レビューと OSS レーンでのみ使用します

プラットフォームについて正直にお伝えします。 caddis は PowerShell を使う Windows 環境で開発され、日常的に使用されています。 フックは純粋な Python で、クロスプラットフォームに対応しています。スキル、コマンド、エージェントはどこでも動作するプレーンな Markdown です。ただし、一部のランチャーには .ps1 版と .sh 版があり、デプロイスキルは Windows 専用で、公開用の仕組み（sync.ps1）は PowerShell 専用です。macOS や Linux で問題が起きるわけではありませんが、利用実績が少ないため、粗削りな部分があるかもしれません。問題があれば、ぜひ報告してください。

最初の5分

claude plugin marketplace add saajunaid/caddis-plugin
claude plugin install caddis@caddis

次に、Claude Code のセッションで、実際に読み込まれたことを確認します。

/caddis:version

バージョンが表示されれば、インストールは完了です。そこから、caddis の用途を知るための最短ルートを紹介します。

試してみること	動作
/caddis:feature-plan add CSV export	.caddis/plans/ に、フェーズ分けされた TDD 構成の計画を書き込みます。これは、ハーネスの残りの部分が参照する永続的な軸となります
/caddis:implement <plan>	計画をフェーズごとに実行して、それぞれをコミットし、実際の区切りに達したときだけ停止します
/caddis:cross-review	別のベンダーのモデルに差分をレビューさせます。同じベンダーのレビュアーでは盲点を共有してしまうためです
/caddis:handoff	引き継ぎ用ドキュメントを書き込み、次のセッションを再調査なしで始められるようにします

それ以外はすべて任意です。feature-plan → implement → cross-review だけを使う場合でも、価値の大部分を活用できます。

このリポジトリは、公開済みマーケットプレイスのミラーです。caddis と caddis-extras の Claude Code プラグイン、bundles/ 以下の各ハーネス向けポータブルバンドル、そして共有プールを提供しています。caddis のオーサリング用リポジトリのエクスポーターによって生成・プッシュされています。こちらへのイシューは歓迎しますが、コードの変更は上流リポジトリに反映され、同期されます。

---

インストール（Claude Code）

# 1. Register this repo as a plugin marketplace (once)
claude plugin marketplace add saajunaid/caddis-plugin

# 2. Install the core plugin (always-on, lean context)
claude plugin install caddis@caddis

# 3. (optional) Add the long-tail skill library — cloud/data/media/etc. Disabled by default,
#    so it costs zero always-on context until you enable it.
claude plugin install caddis-extras@caddis

次に、任意のリポジトリで以下を実行します。

/caddis:setup-project-ai     # deploy the harness into the project

通常の作業の流れは次のとおりです。

/feature-plan      # (or /prd first) → writes .caddis/plans/<slug>.md, the durable spine
/implement         # executes the plan phase-by-phase, TDD, commit per phase
/ship              # express lane: commit → push → CI (hotfixes); feature work: /ship-pr then /ship-merge
/handoff           # ALWAYS end a session with this — writes the resume doc

最も大切な習慣は、毎回のセッションの終わりに /handoff を実行することです。 .caddis/relay.md に内容が書き込まれ、次回のセッション開始時に自動で再注入されます。何も覚えていない状態から始めるのではなく、再調査なしで作業を再開できます。

すべてのコマンド、スキル、フックのリファレンスと考え方については、USERGUIDE.md をご覧ください。

---

提供される機能

• スラッシュコマンド — /feature-plan、/prd、/implement、/tdd、/ship · /ship-pr · /ship-merge、/handoff、/kb、/digress · /resume、/cross-review、/usage-review、 /mermaid-db · /excalidraw-db、/setup-project-ai、/migrate-dir。
• サブエージェント — コンテキストを絞った専用ヘルパー：anchor（証拠を優先した検証）、 code-reviewer、preflight（計画とコードベースの整合性検証）、tester、debug、codebase-audit、 security-analyst、data-engineer、sql-expert、knowledge-transfer。
• 4 層のメモリモデル — セッションリレー（relay.md）、自動 Dream Memory （memory.jsonl）、リポジトリごとのナレッジベース（.caddis/kb/ + DOC-MAP.md）、リポジトリ間メモリ。
• フックと安全性 — シークレットや破壊的な書き込みを防ぐ PreToolUse ガード、編集時の自動 lint、リレーとメモリを支える SessionStart/Stop フック。
• 段階別のスキル — 開発の中核スキルセットは caddis に含まれ、その他の分野（クラウド、データ、メディア、 生産性）のスキルは、デフォルトでは無効の caddis-extras にあります。

---

Claude Code 以外（Codex、Antigravity など）へのインストール

ナレッジレイヤー（スキル + AGENTS.md の規約）は、どのハーネスでも機能します。ハーネスごとのバンドルは bundles/ に公開されており、caddis-init でインストールできます：

# from a checkout of this repo (the installer ships in plugin/scripts/)
python plugin/scripts/claudster_init.py --target codex        --dest /path/to/project
python plugin/scripts/claudster_init.py --target antigravity  --dest /path/to/project

安全性を考慮した設計です。sha256 マニフェストでインストーラーが書き込んだ内容を追跡します。再実行時は未変更のファイルだけが更新され、ローカルで編集したファイルは上書きされず、競合として報告されます。

---

リポジトリの構成

パス	内容
.claude-plugin/marketplace.json	マーケットプレイスのマニフェスト（caddis + caddis-extras）
plugin/	caddis の Claude Code 向けコアプラグイン（エージェント、コマンド、フック、コアスキル）
plugin-extras/	caddis-extras のスキルライブラリ（デフォルトでは無効）
bundles/	caddis-init 用のハーネスごとの移植可能なエクスポート（codex、antigravity）
.github/	スキル、エージェント、プロンプト、指示、ツールの共通プール
sync.ps1、export_runtime_resources.py、validate_pool.py	ビルドと同期の仕組み

---

名前について

caddis は以前 claudster として公開されていました（その前は、このリポジトリで junai Copilot パイプラインを管理していました。詳しくは CHANGELOG.md の 1.2 より前の項目を参照してください）。古い名前でセットアップされたリポジトリには .claudster/ アーティファクトディレクトリがあります。すべての処理は .caddis/ と .claudster/ の両方を読み込み、 リポジトリがすでに使用している場所に書き込むため、問題は発生しません。リポジトリを変換する場合は /caddis:migrate-dir を実行してください。ユーザースコープの ~/.claudster/（キー、インストール記録）は恒久的に使用されます。

---

ライセンス

MIT。公開されているプラグインバンドル（caddis / caddis-extras）にも、マニフェストで同じライセンスが適用されています。