sd0x-dev-flow

言語: English | 繁體中文 | 简体中文 | 日本語 | 한국어 | Español

Claude Code のための harness レイヤー。

AI がスキップできない品質ゲート。 Claude Code のための AI Agent Harness Engineering の reference implementation — Hook 強制のデュアルレビュー、context compaction を乗り越える state machine ゲート、そして本当に必要な箇所での fail-closed な安全性。

96 bundled · 96 public skills · 15 agents — Claude の context window のわずか ~4%

この harness は何をするのか

Harness engineering とは、モデル自体を学習させるのではなく、LLM の周辺にあるすべて（tool loop、context management、hooks、state machine、safety layer）を工学的に構築する分野です。Mitchell Hashimoto が 2026 年 2 月にこの用語を提唱し、Anthropic engineering と Martin Fowler が論考を発表、arXiv 2603.05344 が形式化しています。

sd0x-dev-flow は reference implementation です。以下の各行は、harness の典型的なサブ問題を実際に読める具体的なコードに対応づけています:

多くの harness プロジェクトはこれらのうち 2〜4 個しかカバーしません。sd0x-dev-flow は 10 個すべてをカバーしており、単なるツールではなく学習対象として読めるコードになっています。

なぜ sd0x-dev-flow？

クイックスタート

# プラグインをインストール
/plugin marketplace add sd0xdev/sd0x-dev-flow
/plugin install sd0x-dev-flow@sd0xdev-marketplace

# プロジェクトを設定
/project-setup

1つのコマンドでフレームワーク、パッケージマネージャー、データベース、エントリポイント、スクリプトを自動検出します。ルールとフックのサブセットをインストールします。完全なプラグインには14ルール + 9フックが含まれます。

--lite で CLAUDE.md のみ設定（ルール/フックをスキップ）。

仕組み

flowchart LR
    P["🎯 Plan"] --> B["🔨 Build"]
    B --> G["🛡️ Gate"]
    G --> S["🚀 Ship"]

    P -.- P1["/codex-brainstorm<br/>/feasibility-study<br/>/tech-spec"]
    B -.- B1["/feature-dev<br/>/bug-fix<br/>/codex-implement"]
    G -.- G1["/codex-review-fast<br/>/precommit<br/>/codex-test-review"]
    S -.- S1["/smart-commit<br/>/push-ci<br/>/create-pr<br/>/pr-review"]

Auto-Loop エンジンが品質ゲートを自動的に実行します。コード編集後、レビューコマンドがデュアルレビュー（Codex MCP + セカンダリレビューアーを並列実行）をディスパッチします。Findings は重複排除・重要度正規化後、単一ゲートに集約されます。strict モードでは、Hooks が fail-closed を強制：集約ゲートが未完了なら stop-guard がブロックします。詳細は docs/hooks.md を参照。

sequenceDiagram
    participant D as Developer
    participant C as Claude
    participant X as Codex MCP
    participant T as Secondary Reviewer
    participant H as Hooks

    D->>C: Edit code
    H->>H: Track file change
    C->>H: emit-review-gate PENDING
    par Dual Review
        C->>X: Codex review (sandbox)
    and
        C->>T: Task(code-reviewer)
    end
    X-->>C: Findings (primary)
    T-->>C: Findings (secondary)
    C->>C: Aggregate + dedup + gate
    C->>H: emit-review-gate READY/BLOCKED

    alt Issues found
        C->>C: Fix all issues
        C->>X: --continue threadId
        X-->>C: Re-verify
    end

    C->>C: /precommit (auto)
    C-->>D: ✅ All gates passed

    Note over H: Strict mode: incomplete gate → blocked

機能スポットライト：デュアルレビューアーキテクチャ

v2.0 では2つの独立したレビューアーを並列でディスパッチします — 単一障害点ゼロ：

Findings は重要度正規化（P0-Nit）、重複排除（ファイル + issue キー、±5 行許容）、ソース帰属（codex | toolkit | both）されます。

ゲート：✅ Ready または ⛔ Blocked — strict モードでは、未完了ゲート = ブロック。

比較表

使用に適したケース

インストール

Codex CLI / その他の AI エージェント

# Agent Skills 標準で個別スキルをインストール
npx skills add sd0xdev/sd0x-dev-flow

# AGENTS.md を生成 + フックをインストール（Claude Code 内で実行）
/codex-setup init

必要環境: Claude Code 2.1+ | Codex MCP（オプション — /codex-* スキルに必要；未インストール時はシングルレビューモードにフォールバック）

ワークフロートラック

flowchart TD
    subgraph feat ["🔨 Feature Development"]
        F1["/feature-dev"] --> F2["Code + Tests"]
        F2 --> F3["/verify"]
        F3 --> F4["/codex-review-fast"]
        F4 --> F5["/precommit"]
        F5 --> F6["/update-docs"]
    end

    subgraph fix ["🐛 Bug Fix"]
        B1["/issue-analyze"] --> B2["/bug-fix"]
        B2 --> B3["Fix + Regression test"]
        B3 --> B4["/verify"]
        B4 --> B5["/codex-review-fast"]
        B5 --> B6["/precommit"]
    end

    subgraph docs ["📝 Docs Only"]
        D1["Edit .md"] --> D2["/codex-review-doc"]
        D2 --> D3["Done"]
    end

    subgraph plan ["🎯 Planning"]
        P1["/codex-brainstorm"] --> P2["/feasibility-study"]
        P2 --> P3["/tech-spec"]
        P3 --> P4["/codex-architect"]
        P4 --> P5["Implementation ready"]
    end

    subgraph ops ["⚙️ Operations"]
        O1["/project-setup"] --> O2["/repo-intake"]
        O2 --> O3["Develop"]
        O3 --> O4["/project-audit"]
        O3 --> O7["/best-practices"]
        O3 --> O5["/risk-assess"]
        O4 --> O6["/next-step --go"]
        O5 --> O6
        O7 --> O6
    end

クックブック

どのスキルをどの順番で組み合わせるかを示す、実践的なシナリオ集です。

全 10 シナリオを見る →

同梱内容

極小の Context 使用量

Claude の 200k context window のわずか ~4% — 96% はコードに使えます。

スキルはオンデマンドで読み込まれます。未使用のスキルはトークンを消費しません。

スキルリファレンス

ルール & フック

14 ルール（常時読み込みの規約）+ 9 フック（自動ガードレール）。

カスタマイズ：auto-loop-project.md を編集してプロジェクトの auto-loop 動作をオーバーライドできます。プラグイン更新と競合しません — Rule Override Pattern 参照。

ルール、フック、環境変数の完全なリファレンスは docs/rules.md と docs/hooks.md をご覧ください。

カスタマイズ

/project-setup ですべてのプレースホルダーを自動検出・設定するか、.claude/CLAUDE.md を直接編集してください：

ショーケース：マルチエージェントリサーチ

/deep-research を実行すると、2-3 の並列リサーチエージェントが Web ソース、コードベース、コミュニティ知識を横断して調査します — claim registry による統合と条件付き敵対的ディベートを備えています。

詳細ドキュメント

アーキテクチャ

Command (entry) → Skill (capability) → Agent (environment)

• コマンド：ユーザーが /... で起動
• スキル：オンデマンドで読み込まれるナレッジベース
• エージェント：専用ツールを持つ隔離されたサブエージェント
• フック：自動ガードレール（フォーマット、レビュー状態、ストップガード）
• ルール：常時有効な規約（自動読み込み）

高度なアーキテクチャの詳細（agentic control stack、制御ループ理論、サンドボックスルール）については docs/architecture.md を参照してください。

コントリビュート

PR を歓迎します。お願い事項：

1. 既存の命名規約に従う（kebab-case）
2. スキルに When to Use / When NOT to Use を含める
3. 危険な操作には disable-model-invocation: true を付与
4. 提出前に Claude Code でテスト

ライセンス

MIT

Star History