Claude Code Plugin · v1.0.1 · revfactory/harness

Harness

Agent Team & Skill Architect — メタスキル

ドメイン特化のエージェントチームを自動設計し、専門エージェントを定義し、各エージェントが使うスキルを生成するメタスキル。 「ハーネス構築して」 の一言で 6 フェーズが自動実行される。

6 Architecture Patterns Progressive Disclosure Agent Teams · Default Apache 2.0

GitHub: revfactory/harness harness-100 — 100 チームハーネス集 Agent Teams ドキュメント

品質スコア向上

+60%

49.5 → 79.3（15 タスク平均）

勝率

15/15

Harness あり vs なし — 全勝

出力ばらつき削減

−32%

課題難度が高いほど効果大

6-Phase ワークフロー

%%{init: {"theme": "base", "themeVariables": {"primaryColor": "#f0faff", "primaryBorderColor": "#0891b2", "primaryTextColor": "#193a5c", "lineColor": "#0891b2", "fontSize": "14px"}, "flowchart": {"curve": "monotoneX"}}}%% flowchart TD P1["Phase 1\nドメイン分析"] --> P2["Phase 2\nチームアーキテクチャ設計"] P2 --> P3["Phase 3\nエージェント定義生成\n.claude/agents/"] P3 --> P4["Phase 4\nスキル生成\n.claude/skills/"] P4 --> P5["Phase 5\n統合 & オーケストレーション"] P5 --> P6["Phase 6\n検証 & テスト"] P2 --> MODE{"実行モード選択"} MODE -->|"エージェント2名以上\n通信が必要"| AT["Agent Teams\n（デフォルト）"] MODE -->|"単発・通信不要"| SA["サブエージェント\n（軽量モード）"] AT --> P3 SA --> P3 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 P1,P2,P3,P4,P5,P6 phase class MODE mode class AT,SA exec

Phase 01

ドメイン分析

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

Phase 02

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

Agent Teams vs サブエージェントを選択。6 種のアーキテクチャパターンから最適構成を決定。

Phase 03

エージェント定義生成

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

Phase 04

スキル生成

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

Phase 05

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

エージェント間データ受け渡し、エラーハンドリング、チーム連携プロトコルを設定。

Phase 06

検証 & テスト

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

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

PIPE

パイプライン

エージェントが順序どおりに連鎖。前段の出力が次段の入力になる直列依存構造。

適用: ETL, 翻訳→校正→整形, コード生成→レビュー→テスト

FAN

ファンアウト / ファンイン

リーダーが複数エージェントへ同時に仕事を分配し、結果をまとめて集約する並列構造。

適用: マルチソースリサーチ, 並列コードレビュー, 多言語対応

POOL

エキスパートプール

タスク種別ごとに専門エージェントを選択的に呼び出す。汎用エージェントのオーバーヘッドを排除。

適用: 多言語 QA, 分野特化分析, 動的ルーティング

P-R

プロデューサー / レビューア

生成エージェントと独立した検証エージェントをペアにする。出力の偏りや見落としを相互補完。

適用: コード生成+セキュリティ審査, 文章+事実確認

SUP

スーパーバイザー

中央エージェントが状態管理し、進捗に応じてタスクを動的分配。実行順を実行時に調整できる。

適用: 複雑なプロジェクト管理, 適応型ワークフロー

HIER

階層的委任

上位エージェントが下位へ再帰的に委任する木構造。大規模タスクの分解と責任の局所化。

適用: 大規模コードベース変更, 多段リサーチ

スキル設計

Harness が生成するスキルは Progressive Disclosure パターンを採用。必要な情報だけを JiT（Just-in-Time）でロードし、コンテキスト消費を最小化する。

SKILL.md メインエントリ。トリガー条件・高レベル手順・参照先のみを記述
references/ 詳細仕様を分割格納。必要なフェーズでのみ読み込む
agents/ 各エージェント定義ファイル。役割・原則・通信プロトコルを明記
model: opus 全エージェントは opus 必須。品質は推論能力に直結する

your-project/
├── .claude/
│   ├── agents/
│   │   ├── analyst.md    # 役割・原則・通信プロトコル
│   │   ├── builder.md
│   │   └── qa.md
│   └── skills/
│       ├── analyze/
│       │   └── SKILL.md
│       └── build/
│           ├── SKILL.md
│           └── references/
│               ├── patterns.md    # JiT 読み込み
│               └── templates.md  # JiT 読み込み

QA エージェント統合: QA はモジュール完成直後に都度実行（incremental QA）。全体完成後 1 回ではなく、段階的に品質を積み上げる。

参照ドキュメント（スキル内 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 の実装パターン

実行モード

デフォルト

Agent Teams

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

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

軽量モード

サブエージェント

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

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

選択指針: エージェントが 2 名以上で通信が必要なら Agent Teams を選択。1 名または通信不要（結果を渡すだけ）ならサブエージェントも選択肢に入る。Agent Teams が基本。

比較軸	Agent Teams	サブエージェント
エージェント間通信	SendMessage で直接通信	なし（メイン経由のみ）
並列協調	自律的な共有タスク管理	並列実行は可能だが調整は手動
トークンコスト	高め	低め
制約	セッション内 1 チームのみ活性	Agent ツール呼び出し数の上限
使用ツール	TeamCreate, SendMessage, TaskCreate	Agent(prompt, subagent_type)

インストール

前提条件: Agent Teams 機能を有効化するために環境変数を設定してください。
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 — 詳細は Agent Teams ドキュメントを参照。

推奨 — マーケットプレイス経由

Plugin Marketplace

Claude Code のプラグインマーケットプレイスを通じてワンコマンドでインストール。

# マーケットプレイスを追加
/plugin marketplace add revfactory/harness

# プラグインをインストール
/plugin install harness@harness

代替 — 直接インストール

グローバルスキルとして配置

リポジトリをクローンして skills/harness を直接 ~/.claude/skills/ にコピー。

# リポジトリをクローン
git clone https://github.com/revfactory/harness.git

# スキルディレクトリをコピー
cp -r harness/skills/harness \
  ~/.claude/skills/harness

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

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

プラグイン構成

harness/
├── .claude-plugin/
│   └── plugin.json                # プラグインマニフェスト
├── 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

ユースケース — そのまま使えるプロンプト

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.

研究結果

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

Harness あり vs なし統制実験

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

+60%

品質スコア向上

100%

勝率（15/15）

−32%

出力分散削減

A/B テストデータセット Harness リポジトリ

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

Basic

+23.8

Advanced

+29.6

Expert

+36.2

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

Harness 100

10 ドメイン・100 のプロダクションレディなエージェントチームハーネス（英韓 200 パッケージ）。コンテンツ制作、ソフトウェア開発、データ/AI、ビジネス戦略、教育、法律、ヘルスケアなど 1,808 の Markdown ファイル。本プラグインで生成されたハーネスのライブラリ。

revfactory/harness-100