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

Documentation Index

Fetch the complete documentation index at: https://factory-docs-auto-sync-jp-docs.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はコミット前に一貫性を確保します
重要: 検証を高速に保ってください。遅いテストはエンドツーエンドの作業を遅くします。

最大の効果を得るための4つ全ての組み合わせ

これらの機能は相乗効果があります。IDE pluginがコンテキストを提供 → Spec Modeがそのコンテキストを使ってより良い計画を立てる → AGENTS.mdが一貫した実装を保証 → Agent readinessが問題を即座にキャッチします。
始めたばかりですか? まずIDEプラグインをインストールしてください。より良い結果への最短経路です。次にテストコマンドだけを含むAGENTS.mdを追加し、そこから拡張します。