Claude Code Plugin  ·  v1.2.0  ·  revfactory/harness

Harness

Team-Architecture Factory

ドメイン記述を入力すると、Harness が 6 種のチームアーキテクチャパターンから 1 つを選び、 .claude/agents/ と .claude/skills/ を生成する。初回生成だけでなく、 既存ハーネスの監査・拡張・同期・部分再実行まで扱う。

L3 Meta-Factory 6 Team Patterns 3 Execution Modes Apache 2.0
GitHub: revfactory/harness harness-100 — 100 チームハーネス集 Quickstart
チームパターン
6
Pipeline / Fan-out / Expert Pool / Producer-Reviewer / Supervisor / Hierarchical Delegation
実行モード
3
Agent Teams を基本に、サブエージェントとハイブリッドを切り替える
対応範囲
0→7
現況監査から進化・運用保守までをライフサイクルとして扱う
02

位置づけとライフサイクル

L3 Meta-Factory の中での位置

Harness は Claude Code エコシステムの L3 Meta-Factory 層で、 ランタイムそのものではなく チームアーキテクチャ を生成する側に立つ。 Archon とは同じ L3 でも役割が違い、Harness は 誰がどう協調するか を設計する。

層 / サブ層 役割 隣接プロジェクト
L3 / Team-Architecture Factory ドメイン記述からエージェントチーム + スキルを生成 Harness
L3 / Runtime-Configuration Factory 決定的で再現可能なランタイム構成を生成 coleam00/Archon
L3 / Codex Runtime Port 同じ発想を Codex ランタイムへ移植 SaehwanPark/meta-harness
L2 / Cross-Harness Workflow 複数ハーネス横断でスキル・ルール・フックを標準化 affaan-m/ECC
%%{init: {"theme": "base", "themeVariables": {"primaryColor": "#f0faff", "primaryBorderColor": "#0891b2", "primaryTextColor": "#193a5c", "lineColor": "#0891b2", "fontSize": "14px"}, "flowchart": {"curve": "monotoneX"}}}%% flowchart TD P0["Phase 0\n現況監査"] --> P1["Phase 1\nドメイン分析"] P1 --> P2["Phase 2\nチームアーキテクチャ設計"] P2 --> MODE{"実行モード選択"} MODE -->|"エージェント2名以上\n通信が必要"| AT["Agent Teams\n（デフォルト）"] MODE -->|"単発・通信不要"| SA["サブエージェント\n（軽量モード）"] MODE -->|"Phase ごとに\n切り替える"| HY["ハイブリッド\n（混在モード）"] AT --> P3 SA --> P3 HY --> P3 P3["Phase 3\nエージェント定義生成\n.claude/agents/"] --> P4["Phase 4\nスキル生成\n.claude/skills/"] P4 --> P5["Phase 5\n統合 & オーケストレーション"] P5 --> P6["Phase 6\n検証 & テスト"] P6 --> P7["Phase 7\n進化 / 運用保守"] classDef phase fill:#e0f2fe,stroke:#0891b2,color:#0c4a6e classDef mode fill:#fef9c3,stroke:#d97706,color:#78350f classDef exec fill:#d1fae5,stroke:#059669,color:#064e3b class P0,P1,P2,P3,P4,P5,P6,P7 phase class MODE mode class AT,SA,HY exec
Phase 00

現況監査

既存の .claude/agents/ / .claude/skills/ / CLAUDE.md を読み、初回生成・拡張・運用保守のどれかを判定する。

Phase 01

ドメイン分析

ユーザー要求からドメイン・技術スタック・主要タスクを識別。既存エージェント/スキルの重複を確認。

Phase 02

チームアーキテクチャ設計

Agent Teams / サブエージェント / ハイブリッドから選択し、6 種のアーキテクチャパターンと接続する。

Phase 03

エージェント定義生成

.claude/agents/{name}.md に役割・原則・チーム通信プロトコルを生成。全エージェント model: "opus"。

Phase 04

スキル生成

.claude/skills/{name}/SKILL.md を Progressive Disclosure パターンで生成。JiT 参照構成。

Phase 05

統合 & オーケストレーション

メッセージ・タスク・ファイル・戻り値の受け渡し規約を定義し、必要なら Phase ごとにチームを再構成する。

Phase 06

検証 & テスト

トリガー検証・ドライランテスト・With-skill vs Without-skill 比較テストで品質を担保。

Phase 07

進化 & 運用保守

フィードバックを変更履歴へ反映し、既存ハーネスの監査・同期・部分再実行・ドリフト修正を続ける。

Harness Evolution Mechanism: 生成直後のハーネスと、実運用を経たリリース版ハーネスとの差分をファクトリーへ戻し、 次回の同系統ドメイン生成をよりリリース状態に近いドラフトから始める、という考え方が README に追加されている。
03

6 アーキテクチャパターン

PIPE
パイプライン
エージェントが順序どおりに連鎖。前段の出力が次段の入力になる直列依存構造。
適用: ETL, 翻訳→校正→整形, コード生成→レビュー→テスト
FAN
ファンアウト / ファンイン
リーダーが複数エージェントへ同時に仕事を分配し、結果をまとめて集約する並列構造。
適用: マルチソースリサーチ, 並列コードレビュー, 多言語対応
POOL
エキスパートプール
タスク種別ごとに専門エージェントを選択的に呼び出す。汎用エージェントのオーバーヘッドを排除。
適用: 多言語 QA, 分野特化分析, 動的ルーティング
P-R
プロデューサー / レビューア
生成エージェントと独立した検証エージェントをペアにする。出力の偏りや見落としを相互補完。
適用: コード生成+セキュリティ審査, 文章+事実確認
SUP
スーパーバイザー
中央エージェントが状態管理し、進捗に応じてタスクを動的分配。実行順を実行時に調整できる。
適用: 複雑なプロジェクト管理, 適応型ワークフロー
HIER
階層的委任
上位エージェントが下位へ再帰的に委任する木構造。大規模タスクの分解と責任の局所化。
適用: 大規模コードベース変更, 多段リサーチ
04

スキル設計

Harness が生成するスキルは Progressive Disclosure を前提にする。 さらに現在の設計では、CLAUDE.md にハーネスの全情報を複写せず、 トリガーポインタ + 変更履歴 だけを残す。

  • SKILL.md メインエントリ。トリガー条件・高レベル手順・参照先のみを記述
  • references/ 詳細仕様を分割格納。必要なフェーズでのみ読み込む
  • agents/ 各エージェント定義ファイル。役割・原則・通信プロトコルを明記
  • CLAUDE.md 新規セッション用のポインタと変更履歴だけを登録し、詳細はオーケストレーターへ集約する
  • _workspace/ ハイブリッド実行や後続修正で再利用する中間成果物を残す
  • model: opus 全エージェントは opus を前提に設計し、難度の高いタスクでの推論品質を優先する 
your-project/
├── CLAUDE.md              # ポインタ + 変更履歴
├── _workspace/            # 中間成果物 / 部分再実行
└── .claude/
    ├── agents/
    │   ├── analyst.md     # 役割・原則・通信プロトコル
    │   ├── builder.md
    │   └── qa.md
    └── skills/
        ├── analyze/
        │   └── SKILL.md
        └── build/
            ├── SKILL.md
            └── references/
                ├── patterns.md     # JiT 読み込み
                └── templates.md
QA エージェント統合: QA はモジュール完成直後に都度実行する。さらに description には 「再実行」「更新」「同期」などの後続キーワードを含め、運用フェーズでも再びトリガーできるようにする。

参照ドキュメント（スキル内 references/）

ファイル 内容
agent-design-patterns.md 6 種パターンの詳細・実行モード選択意思決定ツリー・エージェント分離基準
orchestrator-template.md チーム / サブエージェント オーケストレーターテンプレート
team-examples.md 実践チーム構成例 5 種（リサーチ / フルスタック / ウェブトゥーン 等）
skill-writing-guide.md スキル作成ガイド・YAML frontmatter・Progressive Disclosure 実装例
skill-testing-guide.md テスト・評価方法論・With/Without-skill 比較フレームワーク
qa-agent-guide.md QA エージェント統合ガイド・incremental QA の実装パターン
05

実行モード

デフォルト

Agent Teams

リーダーが TeamCreate でチームを構成。メンバーが SendMessage で相互通信し、共有タスクリストで自律協調する。

  • メンバー間の直接対話・交差検証が可能
  • TaskCreate / TaskUpdate で自律タスク管理
  • セッション内でチームの再構成も可能
  • 課題難度が高いほど品質向上効果が増大
軽量モード

サブエージェント

Agent ツールで直接サブエージェントを生成。結果をメインコンテキストへ要約返却する。

  • シンプル・高速・低コスト
  • エージェント間の通信なし
  • メインが全調整を担う
  • 単発タスク・通信不要な構成向け
混在モード

ハイブリッド

Phase ごとに Team と Subagent を切り替える。並列収集は軽く、合意形成や相互レビューだけ Team に寄せられる。

  • Phase 単位で実行モードを明示できる
  • 収集・統合・検証で異なるコスト特性を使い分ける
  • _workspace/ を中継地点にして再構成しやすい
  • 既存ハーネス更新や部分再実行と相性がいい
選択指針: まず Agent Teams を検討し、通信が構造的に不要なときだけサブエージェントを使う。収集と統合で性質が違うなら、Phase ごとに切り替えるハイブリッドを選ぶ。
比較軸 Agent Teams サブエージェント ハイブリッド
エージェント間通信 SendMessage で直接通信 なし（メイン経由のみ） Phase 内だけ必要な側に持たせる
データ受け渡し メッセージ / タスク / ファイル 戻り値 / ファイル Phase ごとに切り替え
トークンコスト 高め 低め 中間。重い区間だけ Team に寄せる
得意な仕事 合意形成・相互レビュー・長い協調 単発解析・軽量並列・結果収集 既存ハーネス更新・部分再実行・段階的検証
制約 セッション内 1 チームのみ活性 Agent 呼び出しの調整をメインが背負う 切り替え境界のファイル規約が必要
06

インストール

Quickstart 前提: Claude Code v2.x 以上、現在のシェルで CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 を有効化する。Harness は TeamCreate / SendMessage / TaskCreate を使うため、 このフラグが無いとチーム実行へ進めない。
推奨 — Quickstart 5 分

Marketplace + Experimental flag

現行 Quickstart は claude plugin コマンドを使う。追加・インストール・flag 有効化までを同じシェルで続けて実行する。

claude plugin marketplace add revfactory/harness
claude plugin install harness@harness
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
確認 — 失敗時に見る項目

Version / enable / active plugin

何も生成されない時は、バージョン不足か、プラグインが現在のプロジェクトで有効になっていないことが多い。

claude --version
claude plugin list
claude plugin enable harness@harness
直接配置する場合: marketplace を使わない時はリポジトリを clone し、 skills/harness を ~/.claude/skills/harness へコピーする。 ただし現行 onboarding の主経路は marketplace + claude plugin コマンド。

インストール後、Claude Code で以下のトリガーフレーズで起動：

Build a harness for this project
Design an agent team for this domain
Set up a harness
ハーネスを構築して
このドメインのハーネスを設計して

プラグイン構成

harness/
├── .claude-plugin/
│   └── plugin.json                # プラグインマニフェスト
├── docs/
│   ├── quickstart.md              # 5分導入ガイド
│   └── experimental-dependency.md # flag依存の説明
├── skills/
│   └── harness/
│       ├── SKILL.md               # 監査 + 6フェーズ本体 + 進化を束ねるメインスキル
│       └── references/
│           ├── agent-design-patterns.md
│           ├── orchestrator-template.md
│           ├── team-examples.md
│           ├── skill-writing-guide.md
│           ├── skill-testing-guide.md
│           └── qa-agent-guide.md
└── README.md
07

ユースケース — プロンプト例

Harness は初回生成だけでなく、既存ハーネスの点検・同期・部分再実行にも使える。以下は Claude Code に渡すときの書き方の例。

ディープリサーチ

多角的調査チーム

Build a harness for deep research. I need an agent team that can investigate any topic from multiple angles — web search, academic sources, community sentiment — then cross-validate findings and produce a comprehensive report.
ウェブサイト制作

フルスタック開発チーム

Build a harness for full-stack website development. The team should handle design, frontend (React/Next.js), backend (API), and QA testing in a coordinated pipeline from wireframe to deployment.
コードレビュー

並列レビューチーム

Build a harness for comprehensive code review. I want parallel agents checking architecture, security vulnerabilities, performance bottlenecks, and code style — then merging all findings into a single report.
技術ドキュメント

API ドキュメント生成

Build a harness that generates API documentation from this codebase. Agents should analyze endpoints, write descriptions, generate usage examples, and review for completeness.
YouTube コンテンツ

コンテンツ企画チーム

Build a harness for YouTube content creation. The team should research trending topics, write scripts, optimize titles/tags for SEO, and plan thumbnail concepts — all coordinated by a supervisor agent.
データパイプライン

パイプライン設計チーム

Build a harness for designing data pipelines. I need agents for schema design, ETL logic, data validation rules, and monitoring setup that delegate sub-tasks hierarchically.
マーケティング

キャンペーン作成チーム

Build a harness for marketing campaign creation. The team should research the target market, write ad copy, design visual concepts, and set up A/B test plans with iterative quality review.
ウェブトゥーン制作

エピソード制作チーム

Build a harness for webtoon episode production. I need agents for story writing, character design prompts, panel layout planning, and dialogue editing. They should review each other's work for style consistency.
運用保守

既存ハーネス監査

ハーネスを点検して。今ある .claude/agents / .claude/skills / CLAUDE.md を監査して、ドリフトと不足しているポインタを洗い出して。
更新

部分再実行と同期

既存ハーネスを拡張して。レビュー用 QA エージェントを追加し、オーケストレーターと CLAUDE.md の変更履歴も同期して。
08

実験結果と開示

A/B テスト — 15 ソフトウェアエンジニアリング課題

Harness あり vs なし 統制実験

構造化された事前設定が LLM コードエージェントの出力品質に与える影響を測定した統制実験。
論文: Hwang, M. (2026). Harness: Structured Pre-Configuration for Enhancing LLM Code Agent Output Quality.
n=15 / author-measured A/B / third-party replications pending を前提に読む。

+60%
品質スコア向上
100%
勝率（15/15）
−32%
出力分散削減
A/B テスト データセット Harness リポジトリ
数字の扱い: source 側 README は、 +60% avg quality (49.5 → 79.3), 15/15 win-rate, −32% variance を n=15, author-measured A/B, third-party replications pending とセットで使うよう求めている。 導入判断では自社の短期パイロットで再計測する前提が安全。

課題難度別スコア改善（Harness なし → あり）

Basic
+23.8
Advanced
+29.6
Expert
+36.2

課題の難易度が高いほど改善効果が増大する傾向が確認された。

Harness 100

10 ドメイン・100 のプロダクションレディなエージェントチームハーネスを収録し、 英語と韓国語を合わせて 200 パッケージを提供する。 コンテンツ制作、ソフトウェア開発、データ/AI、ビジネス戦略、教育、法律、ヘルスケアなどを含み、 本プラグインで生成された 1,808 の Markdown 資産が並ぶ。

revfactory/harness-100