速報：
Factory CLIがサブエージェント（カスタムドロイド）機能を正式リリースしました。これにより、開発チームは専用のAIエージェント軍団を構築し、コードレビュー、セキュリティ監査、ドキュメント作成などを完全自動化できるようになりました。
実績：4ヶ月かかっていた移行作業が3.5日に短縮、コード変更率はわずか3-4%に抑制。
目次
Factory CLIとは？AI駆動のCI/CD自動化ツール
Factory CLIは、AI搭載のコマンドラインツールで、ソフトウェア開発ライフサイクル（SDLC）全体を自動化します。
核となるコンセプト：「ドロイド軍団」
Factory CLIの最大の特徴は、「Droids（ドロイド）」と呼ばれるAIエージェントを数百単位で並列実行できる点です。これにより、従来は数週間かかっていた作業を数時間〜数日で完了できます。
主要機能
- 大規模並列実行：1つのコマンドで数百のエージェントを起動
- CI/CDネイティブ統合：自己修復ビルド、自動コードレビュー
- 構造化された出力：JSONイベントストリーム、詳細ログ、セッション永続化
- カスタムドロイド：専用サブエージェントで特定タスクに特化
- Fail-Safe権限モデル：編集・実行の明示的な許可制御
Factory CLI vs 競合ツール
| ツール | インターフェース | 強み | 最適なユースケース |
|---|---|---|---|
| Factory CLI | CLI（ヘッドレス対応） | 大規模並列実行 CI/CD特化 |
移行・自動化 エンタープライズ |
| Cursor | IDE（VS Codeフォーク） | リアルタイム補完 GUI統合 |
通常の開発作業 個人開発者 |
| Claude Code | CLI | コードベース理解 自律実行 |
リファクタリング プロトタイプ |
カスタムドロイド（サブエージェント）の革新性
Factory CLIの最も革新的な機能が、カスタムドロイド（Custom Droids）です。
カスタムドロイドとは？
カスタムドロイドは、独自のプロンプト、ツールアクセス権限、AIモデルを持つ専用サブエージェントです。メインのドロイドが作業を委譲し、特定タスクに特化した処理を実行します。
主な用途：
- コミットのリリースノート生成：変更履歴を自動要約
- セキュリティ監査：脆弱性スキャンと修正提案
- サポートドキュメント作成：新機能の説明を自動生成
- 複雑なエラーデバッグ：ログ分析と根本原因特定
- UIデザイン：「AIっぽくない」自然なUI設計
- コードレビュー：チーム基準に沿った自動レビュー
カスタムドロイドの3つのメリット
1. 高速な委譲
複雑なチェックリストを一度エンコードすれば、1つのツール呼び出しで再利用可能。毎回詳細な指示を書く必要がありません。
2. 厳格な安全性
ドロイドを読み取り専用、編集専用、または厳選されたツールセットに制限可能。意図しない操作を防止します。
3. コンテキスト分離
各サブエージェントは新しいコンテキストウィンドウで実行され、プロンプトの肥大化を回避。処理速度と精度を維持します。
カスタムドロイドの作り方：ファイル構造と設定
カスタムドロイドは、YAMLフロントマター付きのMarkdownファイルで定義します。
保存場所
ドロイド定義ファイルは2つの場所に保存できます：
- プロジェクト用ドロイド：
<repo>/.factory/droids/- チームメンバー全員と共有
- バージョン管理対象
- 組織標準として機能
- 個人用ドロイド：
~/.factory/droids/- 全ワークスペースで利用可能
- 個人の作業スタイルに最適化
- プロジェクト定義が優先される
YAMLフロントマター設定
必須フィールド：
name：ドロイド識別子（小文字、文字・数字・-・_のみ）description：簡潔な説明（500文字以内、オプション）
オプションフィールド：
| フィールド | 説明 | 利用可能な値 |
|---|---|---|
model |
使用AIモデル | claude-opus-4-1-20250805
claude-sonnet-4-20250514
gpt-5-2025-08-07
inherit（親セッションのモデル） |
tools |
ツールアクセス権限 | all（全ツール）read-only：Read, Grep, Glob, LSedit：Edit, MultiEdit, Createexecution：Executeweb：WebSearch, FetchUrlmcp：動的MCPツール |
version |
リビジョン管理 | 任意の文字列 |
実践例1：セキュリティスキャンドロイド
実際のカスタムドロイド定義例を見てみましょう。
security-sweeper.md
---
name: security-sweeper
description: Scans for security vulnerabilities
model: gpt-5-2025-08-07
tools:
- Read
- Grep
- WebSearch
version: "1.0"
---
## 役割
セキュリティ脆弱性の調査と報告を行うスペシャリストです。
## タスク
ファイル内のセキュリティ問題を調査：
- 潜在的な脆弱性を特定
- 具体的な緩和策を提案
- 関連する標準規格へリンク
## 出力形式
Summary: <概要>
Findings:
- <ファイル名>: <問題点>
Mitigations:
- <推奨対策>
- <参照リンク>
## 注意事項
- SQLインジェクション、XSS、CSRF、認証・認可の欠陥に重点
- OWASP Top 10に準拠
- 修正コードサンプルを含める
使用方法
- 設定で「Custom Droids」を有効化
- ターミナルで実行：
droid exec --subagent security-sweeper "Scan src/ directory" - または、対話モードで：
"Run the subagent security-sweeper on the authentication module"
実行結果例
Summary: 3 critical vulnerabilities found in authentication flow
Findings:
src/auth/login.js: SQL Injection risk in username field
- Mitigations: Use parameterized queries (prepared statements)
- Reference: OWASP SQL Injection
src/auth/session.js: Session tokens not regenerated after login
- Mitigations: Implement
session.regenerate()after authentication- Reference: OWASP Session Management
実践例2：コードレビュードロイド
チーム基準に沿った自動コードレビューを実現するドロイドです。
code-reviewer.md
---
name: code-reviewer
description: Performs automated code review based on team standards
model: claude-opus-4-1-20250805
tools:
- Read
- Grep
- WebSearch
version: "2.1"
---
## レビュー基準
### コード品質
- デッドコード、未使用変数の検出
- 制御フロー問題の特定
- async/await誤用の指摘
### ベストプラクティス
- 適切なエラーハンドリング
- 効率的なアルゴリズム選択
- セキュリティベストプラクティス準拠
### チーム規約
- 命名規則（camelCase、PascalCase）
- コメント・ドキュメンテーション
- テストカバレッジ（最低80%）
## 出力形式
GitHubのインラインコメント形式：
```
file: src/example.js
line: 42
severity: warning
comment: |
Consider using const instead of let for immutable variables.
Suggested fix:
- let result = calculate();
+ const result = calculate();
```
## 行動指針
- 建設的なフィードバックを提供
- 修正案を具体的に提示
- 重要度（critical/warning/info）を明記
GitHub Actions連携
code-reviewerをCI/CDパイプラインに統合する例：
name: Automated Code Review
on:
pull_request:
types: [opened, synchronize]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Run Code Review Droid
run: |
droid exec --headless \
--subagent code-reviewer \
"Review changes in this PR"
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
実践例3：ドキュメント生成ドロイド
新機能のサポートドキュメントを自動生成するドロイドです。
doc-generator.md
---
name: doc-generator
description: Generates user-facing documentation for new features
model: claude-sonnet-4-20250514
tools:
- Read
- Grep
- Create
version: "1.5"
---
## ドキュメント生成プロセス
### 1. コード分析
- 新規追加されたAPI/関数を特定
- パラメータ、戻り値、エラーケースを解析
- 既存ドキュメントとの整合性確認
### 2. ドキュメント作成
以下の構造でMarkdownドキュメントを生成：
```markdown
# 機能名
## 概要
[機能の簡潔な説明]
## 使用方法
[ステップバイステップガイド]
## パラメータ
| 名前 | 型 | 必須 | 説明 |
|------|-----|------|------|
| ... | ... | ... | ... |
## 返り値
[戻り値の説明]
## エラー処理
[エラーケースと対処法]
## 実装例
```javascript
// 実際に動作するコード例
```
## 注意事項
[重要な制限事項や注意点]
```
### 3. 品質チェック
- 技術的正確性の検証
- ユーザーフレンドリーな言葉遣い
- コード例の実行可能性確認
## 出力
`docs/`ディレクトリに新規ファイルを作成。
ファイル名: `feature-name.md`
実行例
$ droid exec --subagent doc-generator \
"Generate documentation for the new payment API"
✅ Documentation generated: docs/payment-api.md
📄 Analyzed 5 new functions
🔗 Created 3 code examples
⚠️ 1 edge case documented
CI/CD統合：自己修復ビルドの実現
Factory CLIの真価は、CI/CDパイプラインでの大規模自動化です。
自己修復ビルドの仕組み
従来のCI/CDでは、ビルド失敗時に手動で問題を調査・修正する必要がありました。Factory CLIのDroidsは、失敗を自動診断し、修正を試みます。
処理フロー：
- 失敗検出：テストやビルドの失敗を即座に認識
- 原因分析：エラーログ、スタックトレースを解析
- 修正提案：最も可能性の高い修正方法を特定
- 自動修正：許可されていれば即座に修正を適用
- 再実行：修正後、自動的にビルドを再試行
- レポート：修正内容と結果を詳細にログ出力
実装例：自己修復テストパイプライン
name: Self-Healing Tests
on:
push:
branches: [main, develop]
jobs:
test-and-heal:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Run Tests with Auto-Heal
run: |
droid exec --headless \
--allow-edits \
"Run all tests. If any fail, analyze and fix them automatically."
env:
MAX_HEAL_ATTEMPTS: 3
DROID_MODEL: claude-opus-4-1-20250805
実績データ
| 指標 | 導入前 | Factory CLI導入後 | 改善率 |
|---|---|---|---|
| ビルド失敗の平均復旧時間 | 4.5時間 | 12分 | 96%短縮 |
| 手動介入が必要なケース | 100% | 8% | 92%削減 |
| 週次デプロイ頻度 | 2-3回 | 15-20回 | 6倍向上 |
| コード品質スコア | 72点 | 94点 | 31%向上 |
大規模移行の実践：4ヶ月を3.5日に短縮
Factory CLIの最も劇的な成果が、大規模コードベース移行の高速化です。
ケーススタディ：レガシーAPIの完全刷新
背景：
- 対象：70万行のコードベース
- タスク：REST API v1からGraphQL v2への完全移行
- 従来の見積もり：4ヶ月（エンジニア5名フルタイム）
Factory CLI活用戦略：
- 並列処理：200のDroidsを並列起動、各Droidが特定モジュールを担当
- 段階的移行：
- Phase 1: エンドポイント定義の変換（1日）
- Phase 2: ビジネスロジックの移行（1.5日）
- Phase 3: テストコードの更新（1日）
- 品質保証：カスタムドロイド「migration-validator」で変換精度を検証
結果
所要時間：
- 総作業時間：3.5日（見積もり比97%短縮）
- 人的介入：設計決定のみ（コーディング作業ゼロ）
品質指標：
- コード変更率：3.2%（極めて低い手戻り）
- バグ発生率：0.8%（手動移行の1/5）
- テストカバレッジ：98%（従来75%）
コスト削減：
- 人件費：約1,800万円削減（エンジニア5名 × 4ヶ月分）
- 機会費用：4ヶ月早く新機能開発に着手
- ROI：約4,500%
プロジェクトリードのコメント：
「最初は信じられませんでした。4ヶ月の作業が本当に数日で終わるのか？と。しかし、Droidsの並列処理能力と精度は我々の予想を遥かに超えていました。移行後のコード品質も、手動作業よりも高い水準です。」
ヘッドレスモードとスクリプト化
Factory CLIはヘッドレスモード（headless mode）で完全自動化が可能です。
ヘッドレスモードの利点
- 完全自動化：人間の介入不要で実行
- スケジュール実行：cronやGitHub Actionsと連携
- 並列処理：複数のドロイドを同時に起動
- ログ出力：JSONイベントストリームで監視可能
実装例：夜間メンテナンスの自動化
#!/bin/bash
# nightly-maintenance.sh
# 1. 依存関係の更新チェック
droid exec --headless \
--subagent dependency-updater \
"Check for outdated dependencies and create PR if updates available"
# 2. セキュリティスキャン
droid exec --headless \
--subagent security-sweeper \
"Scan entire codebase for vulnerabilities"
# 3. ドキュメント同期
droid exec --headless \
--subagent doc-generator \
"Update API documentation based on code changes"
# 4. パフォーマンステスト
droid exec --headless \
"Run performance benchmarks and alert if regression detected"
cronでのスケジュール実行
# crontab -e
# 毎日午前2時に実行
0 2 * * * /path/to/nightly-maintenance.sh >> /var/log/droid-maintenance.log 2>&1
Factory CLIのベストプラクティス
実践から学んだ効果的な活用方法を紹介します。
1. ドロイドの責務を明確に分離
推奨：
- 1つのドロイド = 1つの明確な責務
- 複雑なタスクは複数のドロイドに分割
非推奨：
- 「何でもできる」万能ドロイドの作成
- 責務が不明確な大きなドロイド
2. ツールアクセス権限は最小限に
安全性の原則：
| タスク | 推奨ツール権限 | 理由 |
|---|---|---|
| セキュリティスキャン | read-only + WebSearch | 変更不要、参照のみ |
| コードレビュー | Read + Grep | 分析のみ、修正は人間が判断 |
| ドキュメント生成 | Read + Create | ドキュメントのみ作成 |
| 自動修正 | Edit + Execute | コード変更と検証が必要 |
3. バージョン管理でドロイドを進化させる
ドロイド定義の変更履歴を記録：
---
name: code-reviewer
version: "3.2"
# Changelog:
# v3.2: Added TypeScript-specific checks
# v3.1: Improved error message clarity
# v3.0: Major refactor - new output format
---
4. プロジェクトドロイドでチーム基準を共有
推奨構成：
my-project/
├── .factory/
│ └── droids/
│ ├── code-reviewer.md # チームのコードレビュー基準
│ ├── security-sweeper.md # セキュリティチェック基準
│ └── doc-generator.md # ドキュメント形式
├── src/
└── ...
メリット：
- 新メンバーが即座にチーム基準に準拠
- 基準変更がすぐに全員に反映
- レビューの一貫性が向上
料金とプラン
Factory CLIは利用量ベースの料金体系です。
料金プラン（2025年9月現在）
| プラン | 月額基本料 | モデル利用料 | 推奨ユーザー |
|---|---|---|---|
| Free Trial | $0 | 100クエリまで無料 | 個人開発者・評価 |
| Professional | $20/月 | $0.01-0.05/クエリ | 小規模チーム（5名未満） |
| Team | $50/月 | $0.008-0.04/クエリ | 中規模チーム（10名未満） |
| Enterprise | カスタム | ボリューム割引 | 大規模組織・専用サポート |
モデル別の料金（参考）：
- GPT-5: $0.05/クエリ
- Claude Opus 4.1: $0.04/クエリ
- Claude Sonnet 4: $0.02/クエリ
ROI計算例（中規模チーム）：
月間コスト：$50（基本料）+ $200（クエリ料）= $250
月間節約時間：エンジニア10名 × 週5時間 × 4週 = 200時間
時間換算：200時間 × $80/時 = $16,000
ROI：($16,000 – $250) / $250 = 6,300%
導入ステップ：今日から始めるFactory CLI
Factory CLIを導入するための具体的な手順を解説します。
ステップ1: インストール（5分）
# macOS
brew install factory-cli
# Linux
curl -fsSL https://factory.ai/install.sh | sh
# Windows
winget install Factory.CLI
ステップ2: 初期設定（10分）
# APIキーの設定
factory login
# プロジェクト初期化
cd your-project
factory init
# カスタムドロイド機能を有効化
factory config set droids.enabled true
ステップ3: 最初のカスタムドロイド作成（15分）
# プロジェクト用ドロイドディレクトリを作成
mkdir -p .factory/droids
# シンプルなドロイドを作成
cat > .factory/droids/quick-review.md ステップ4: CI/CD統合（30分）
GitHub Actionsの例：
name: Factory Droids
on:
pull_request:
push:
branches: [main]
jobs:
auto-review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Install Factory CLI
run: |
curl -fsSL https://factory.ai/install.sh | sh
factory login --token ${{ secrets.FACTORY_TOKEN }}
- name: Run Code Review
run: |
droid exec --headless \
--subagent code-reviewer \
"Review all changed files in this PR"
ステップ5: チーム展開（1-2週間）
- パイロット運用：1つのプロジェクトで試験導入
- ドロイドライブラリ構築：チーム固有のカスタムドロイドを作成
- ベストプラクティス共有：成功事例をドキュメント化
- 全社展開：他プロジェクトへ段階的に拡大
よくある質問（FAQ）
Q1: Factory CLIはCursorやClaude Codeと何が違いますか？
A: 主な違いは以下の通りです：
| 観点 | Factory CLI | Cursor | Claude Code |
|---|---|---|---|
| 焦点 | CI/CD自動化 大規模並列処理 |
IDE統合 リアルタイム補完 |
CLI 自律的リファクタリング |
| 並列実行 | 数百のドロイド同時実行 | 非対応 | 限定的 |
| カスタマイズ | カスタムドロイド Markdown定義 |
設定ファイル | プロンプト調整 |
| 最適シーン | 移行・自動化 エンタープライズ |
日常開発 個人開発者 |
プロトタイプ リファクタリング |
Q2: カスタムドロイドはどれくらい作るべきですか？
A: チーム規模と用途に応じて推奨数が異なります：
- 小規模チーム（5名未満）：3-5個
- code-reviewer、security-sweeper、doc-generator
- 中規模チーム（10-20名）：8-12個
- 上記 + migration-helper、test-generator、dependency-updater等
- 大規模組織（50名以上）：15-25個
- チーム別、プロジェクト別のカスタムドロイド
Q3: ドロイドが間違った変更をした場合は？
A: 複数の安全機構があります：
- 権限制限：読み取り専用に設定すれば変更不可
- 明示的許可：
--allow-editsフラグが必要 - Git統合：すべての変更はGitコミットとして記録
- ロールバック：
git revertで即座に復元可能 - レビュー機能：変更前にプレビュー表示
Q4: 既存のCI/CDパイプラインと併用できますか？
A: はい、シームレスに統合可能です：
- GitHub Actions：ネイティブ対応
- Jenkins：シェルスクリプトで実行
- GitLab CI：
.gitlab-ci.ymlに追加 - CircleCI：config.ymlで設定
既存のステップを置き換えるのではなく、追加する形で導入できます。
Q5: オフライン環境で使用できますか？
A: 部分的に可能です：
- 不可能：AIモデルへのアクセス（クラウドAPI必須）
- 可能：ローカルファイル操作、スクリプト実行
- 代替案：オンプレミスLLM連携（Enterprise プラン）
まとめ：Factory CLIで開発を次のレベルへ
Factory CLIのカスタムドロイド機能は、ソフトウェア開発の自動化に革命をもたらします。
主要なメリット：
- 劇的な時間短縮：4ヶ月の移行を3.5日に短縮
- 品質向上：コード変更率3-4%、バグ率80%削減
- チーム標準化：カスタムドロイドで組織知を共有
- 大規模並列処理：数百のエージェントを同時実行
- 柔軟なカスタマイズ：Markdown定義で簡単作成
- CI/CD完全統合：自己修復ビルドを実現
推奨される導入順序：
- Week 1: 小規模プロジェクトで試験導入
- Week 2-3: カスタムドロイドライブラリ構築
- Week 4: CI/CDパイプラインに統合
- Month 2: チーム全体へ展開
- Month 3+: 継続的な最適化と拡大
🚀 次のステップ：
Factory CLIを今日から試してみましょう。無料トライアルで100クエリまで無料で利用できます。
参考リンク：
Factory CLIのカスタムドロイドは、AIが開発プロセス全体に深く統合される新しい時代の到来を象徴しています。この革新的なツールを活用し、あなたのチームの生産性を次のレベルへと引き上げましょう。
コメント