メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://factory-apigettingstarted.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Droidをより速く、より賢く、より少ない反復で動作させたいですか？このページで紹介するテクニックは、良い結果を卓越した結果に変換します。各テクニックはトークンを節約し、ツール呼び出しを減らし、より良いコードを提供します — まずは4つの基礎的な機能から始め、その後で下記のワークフローブースターを重ねていきましょう。

ツール呼び出しの削減

IDEプラグインはリアルタイムのコンテキストを提供し、Droidがあなたと同じものを見られるようにします

初回からより良い結果

仕様モードはコーディング前に調査し、無駄な着手を防ぎます

一貫した品質

AGENTS.mdは標準を一度記録し、常に適用します

自己修正するコード

リンターとテストにより、問題を見る前にDroidが修正できます

​
Factory IDE Plugin — リアルタイムコンテキスト認識

DroidにFactory IDE pluginをインストールするようにしてください。Factory IDE pluginはMCPサーバーとして機能し、Droidに開発環境の即座の認識を与えます。どのファイルを見ているかを説明したり、エラーメッセージをコピーしたりする必要がありません。Droidはあなたが見ているものを正確に見ることができます。 Droidが自動的に取得するもの：
  • 開いているファイルと選択された行
  • VSCodeのエラーハイライトと診断情報
  • プロジェクト構造とアクティブなターミナル出力
  • あなたのカーソル位置と最近の編集
プラグインなしの場合： 
"Fix 'Property user does not exist on type AuthContext' error in auth.ts"
プラグインありの場合： 
"Fix error"
プラグインは、やり取りのカテゴリ全体を排除します。Droidはコンテキストを知り、あなたが見るエラーを見て、最小限の入力からあなたの意図を理解します。
クイックセットアップ: VSCode MarketplaceからFactory拡張機能をインストールします。

​
Spec Mode — まず探索と計画、次にコーディング

複雑な機能は実装前に探索が必要です。Spec Modeは、Droidがコードを1行も書く前にコードベースを徹底的に調査することで、コストのかかる失敗を防ぎます。
1

Spec Modeを有効化

複雑な作業を始めるときはShift+Tabを押します
2

目標を説明

やりたいことを1〜2文で書くか、既存の詳細な技術仕様を提供します。
3

Droidが探索

関連ファイルを検索し、パターンを理解し、依存関係を特定します
4

計画を確認

変更前に実装手順を含む詳細な仕様を取得します
5

承認して実行

承認後にのみDroidが変更を開始します
以下に最適：
  • 2つ以上のファイルに触れる機能
  • アーキテクチャの変更
  • 馴染みのないコードベース
  • セキュリティに敏感な作業
Spec Modeなしでは、Droidは実装に早すぎるタイミングでジャンプし、あなたが望む正確な方法で作業を行わない可能性があります。Spec Modeがあれば、詳細な仕様を取得し、多くのトークンが無駄になる前にパスを修正する機会を得ます。
仕様モードは機能開発だけのものではありません。複雑なデバッグ、リファクタリング、実行前の理解が必要なあらゆるタスクに使用できます。

​
AGENTS.md — あなたの設定、記憶される

AGENTS.mdは、あなたのコーディング標準、プロジェクト規約、個人的な設定を1つの場所に集約します。Droidは全てのタスクに対してこれを自動的に読み込みます。 文書化すべき内容：
カテゴリ例
コードスタイル”function宣言ではなくアロー関数を使用”
“ネストした条件文よりもearly returnsを優先”
テスト”新しいエンドポイントには全て統合テストが必要”
“テストデータにはfixtureではなくfactoryを使用”
アーキテクチャ”サービスは対応するインターフェースと共にsrc/servicesに配置”
“全てのデータベースクエリはrepositoryパターンを使用”
ツール”タスク完了前にnpm run verifyを実行”
“scripts/deploy.shでデプロイ、手動コマンドは決して使わない”
避けるべき間違い”.envファイルは決してコミットしない”
“any!型注釈を使用しない”
シンプルに始めて、時間をかけて進化させる： プロジェクトルートにAGENTS.mdを作成： 
# Project Guidelines

## Testing
- Run `npm test` before completing any feature
- New features need unit tests
- API changes need integration tests

## Code Style
- Use TypeScript strict mode
- Prefer composition over inheritance
- Keep functions under 20 lines

## Common Commands
- Lint: `npm run lint:fix`
- Test: `npm test`
- Build: `npm run build`
Droidが間違いを繰り返したり、何かを2回説明したりするたびに、それをAGENTS.mdに追加してください。数週間以内に、あなたの作業方法を正確に知るパーソナライズされたアシスタントを手に入れることができます。
プロのヒント: プロジェクト内の良いコード例を含めてください。“src/services/UserService.tsのパターンに従う”のように伝えると、Droidに具体的なテンプレートを提供できます。

​
Agent Readiness — ツールに教育を任せる

プロジェクトを自己修正可能にします。DroidがCI/CDパイプラインと同じ検証ツールを実行できるとき、あなたが指摘するのを待つ代わりに、問題を即座に修正します。

リンター

ESLintやPylintがスタイル問題を即座に検出します

型チェッカー

TypeScriptやmypyは実行前に型エラーを防ぎます

高速テスト

数秒で実行できるユニットテストは即時フィードバックを提供します

Pre-commitフック

Huskyやpre-commitはコミット前に一貫性を確保します
重要: 検証を高速に保ってください。遅いテストはエンドツーエンドの作業を遅くします。

​
キーボードショートカット — TUI をプロのように操る

TUI には、ほぼすべての一般的な操作のためのショートカットが用意されています。いくつか覚えるだけで、マウスに手を伸ばしたり延々とスクロールしたりする必要がなくなります。
ショートカットアクション
Ctrl+O詳細トランスクリプト表示の切り替え（メッセージ詳細をすべて表示）
Ctrl+TMission Control オーバーレイの切り替え（オーケストレーターセッション）
Ctrl+N利用可能なモデルを順番に切り替え
Ctrl+L自律レベルを順番に切り替え（low / medium / high）
Ctrl+Y/btw のサイド質問スクロールビューを切り替え
Ctrl+E承認の詳細を切り替え
Alt+Up / Alt+Downトランスクリプトをターン単位でスクロール
Alt+PageUp / Alt+PageDownユーザーのターンのみをジャンプ
Shift+Enterプロンプト入力に改行を挿入
Escapeアクティブなオーバーレイやメニューを閉じる
!入力が空のときに bash モードを切り替え
全リストは CLI リファレンス を参照してください。

​
Bash モード — TUI を離れずに素早くシェルへアクセス

入力が空の状態で ! を押すと bash モードに入ります。入力した内容はあなたのシェルで実行され、出力はトランスクリプトに残るため、Droid は次のターンでそれを参照できます — コピー＆ペースト不要です。 
! git status
! npm test -- --watch=false
状態の確認、簡単なビルドの実行、Droid に反応してほしい出力の取得などに使えます。Escape を押すか、空のまま送信すると bash モードを抜けます。

​
ワークツリー — 同一リポジトリで並列セッションを実行

--worktree フラグを使うと、Droid を新しい git worktree 内で起動でき、複数のセッションが同じリポジトリを編集してもお互い干渉しません。--worktree-dir（または worktreeDirectory 設定）と組み合わせれば、すべての worktree を1か所にまとめられます。 
droid --worktree feature-auth
droid --worktree feature-billing
各セッションはそれぞれ独立したブランチで動くため、並列で実験を走らせ、最良の結果だけをマージできます。

​
セッション管理 — /sessions、/fork、/compress

長時間の作業は1つのセッションに閉じ込める必要はありません。これらのコマンドで会話の移動、分岐、整理ができます：
  • /sessions — 過去のセッションを一覧表示し、再開する
  • /fork — 現在のセッションを分岐し、元の場所を失わずに別のアプローチを試す
  • /compress — コンテキスト上限が近づいたらトランスクリプトをコンパクト化する（/compact や /handoff でも利用可能）
/fork
/compress focus on the failing migration
フォークは「もし〜だったら」の実験に特に強力です。分岐してリスクのあるリファクタリングを試し、うまくいかなければ元のセッションに戻れます。

​
速度と反復 — /fast

/fast は現在のモデルを高速バリアントに切り替えるので、小さな編集や調査を反復するときにテンポよく進みます。/fast off で元に戻せます。 
/fast

​
コンテキスト管理 — /context と /btw

/context は、コンテキストウィンドウの内訳をリアルタイムで表示します。システムプロンプト、ファイル、ツール結果、会話のそれぞれに何トークン使われているかが分かるので、コンパクション発動前に膨らみを見つけるのに役立ちます。 /btw ではサイド質問ができます — Droid は別スクロールバッファ（Ctrl+Y で表示）で回答するため、メイントランスクリプトを汚さずに、タスクから集中を逸らさずに調べ物ができます。 
/context
/btw what does the @decorator pattern in src/auth.ts do?
両者を組み合わせると、メインセッションを集中状態に保ったまま、横で調査を進められます。

​
カスタムスラッシュコマンド — /commands

よく使うプロンプトを再利用可能なショートカットとして保存しましょう。/commands を実行するとマネージャーが開き、プロジェクトレベルまたはユーザーレベルでカスタムスラッシュコマンドを作成・編集・スコープ設定できます。 
/commands
リリースチェックリストを実行する /ship、新しいバグをスキャンする /triage など、よく入力する内容を何でもコマンド化できます。カスタムコマンドは引数を受け取れるので、他のワークフローとも組み合わせやすいです。

​
フック — ツール呼び出し前後の自動化

/hooks を使うと、Droid がツールを実行する前や後に発火するライフサイクルスクリプトを登録できます — pre-commit チェック、監査ログ、自動フォーマッター、危険なシェルコマンドを拒否するガードレールなどに活用できます。 
/hooks
フックは設定ファイルに保存され、すべてのセッションに適用されます。プロンプトで毎回繰り返さずにチームの規約を強制するのに最適です。

​
MCP 連携 — /mcp

Model Context Protocol を使うと、Droid は標準インターフェースを通じて外部ツール（データベース、課題管理、デザインツール、社内サービスなど）と対話できます。サーバーは TUI の /mcp、もしくはコマンドラインの droid mcp add/remove で管理します。 
droid mcp add linear https://mcp.linear.app/sse --type http
接続後は、Droid がチケットを読んだり、データベースに問い合わせたり、サーバーが提供する任意の機能を呼び出したりできます — カスタム連携を組まずに済みます。

​
ミッション — 大規模なマルチエージェントプロジェクトの調整

複数の機能やファイルにまたがる作業では、/missions でミッションに切り替えましょう。Droid が作業を計画し、専門のワーカーエージェントを生成し、各マイルストーンを検証します — 「チャットの中のエージェント」と「計画を実行するエージェントチーム」のギャップを埋める仕組みです。 
/missions
missionModelSettings でワーカーと検証エージェントのモデルを設定し、droid exec --mission でヘッドレス実行できます。完全なガイドはミッションを参照してください。

​
カスタム Droid — 専門化されたエージェントを必要に応じて

/droids は、独自のシステムプロンプト、ツールセット、モデルを持つサブエージェントのライブラリを管理します。専門知識を1つの Droid に閉じ込めることで（「フロントエンドレビュー担当」「SQL マイグレーション作成」「リリースノート」など）、任意のセッションから呼び出せるようになります。 
/droids
自然言語による説明から新しい Droid を生成し、他の設定と同じように反復改善することもできます。詳細はカスタム Droid を参照してください。

​
カスタマイズ — サウンド、テーマ、ステータスライン

TUI を自分の家のような場所にしましょう。/themes でカラースキームを切り替え、/statusline でカスタムステータスバーを設定でき、completionSound、soundFocusMode、subagentSounds などの設定で重要なイベント（完了、入力待ち、サブエージェントの活動）に音声キューを割り当てられます。 
/themes
/statusline
サウンド通知を長時間のミッションと組み合わせれば、状況把握を失わずにターミナルから離れることができます。

​
すべてを組み合わせる

これらの機能は相乗効果があります。IDE プラグインと AGENTS.md が Droid に必要なコンテキストと規約を与え、仕様モードと Agent Readiness が初回の試みを正しく保ち、キーボードショートカット、bash モード、/btw がキーボードから手を離さずに作業を続けさせ、/fast、ワークツリー、ミッション、カスタム Droid が作業そのものをスケールさせます。
始めたばかりですか？ まずは IDE プラグインをインストールしてください — より良い結果への最短経路です。次にテストコマンドを含む AGENTS.md を追加し、3〜4個のショートカットを覚え、そこから少しずつ広げていきましょう。