メインコンテンツへスキップ
Specification Modeは、シンプルな機能説明を自動計画と安全性チェックを備えた動作するコードに変換します。実現したい内容の簡単な説明を提供すると、droidが変更を加える前に詳細な仕様と実装計画を作成します。

Simple Input

Just 4-6 sentences describing what you want built

Automatic Planning

Droid creates detailed specs and implementation plans

Safe Execution

No code changes until you approve the complete plan

Enterprise Ready

Built-in security, compliance, and team standards

​
仕組み

1

Describe your feature

Provide a simple description in 4-6 sentences. No need to write formal specifications.
2

Droid creates the spec

Droid analyzes your request and generates a complete specification with acceptance criteria, implementation plan, and technical details. You can optionally use mixed models to configure a different model for planning.
3

Review and approve

You review the generated specification and implementation plan. Request changes or approve as-is.
4

Implementation

Only after approval does droid begin making actual code changes, showing each modification for review.

​
ワークフロー例

あなたの入力: 
Add a feature for users to export their personal data.
It should create a ZIP file with their profile, posts, and uploaded files.
Send them an email when it's ready. Make sure it follows GDPR requirements.
The export should work for accounts up to 2GB of data.
Droidが生成:
  • 詳細な受け入れ基準を含む完全な仕様
  • バックエンド、フロントエンド、メールをカバーする技術実装計画
  • 必要な変更のファイル別内訳
  • テスト戦略と検証手順
  • セキュリティとコンプライアンスの考慮事項
承認後、droidが実装各変更をレビュー用に表示しながら完全なソリューションを実装します。
Specification Mode must be manually activated using Shift+Tab in the CLI. It does not automatically activate.

​
Specification Modeの有効化方法

Specification Modeに入るには、CLI上でShift+Tabを押してください。これにより次のリクエストに対して仕様計画ワークフローが有効になります。

​
計画中に起こること

分析フェーズ（読み取り専用）:
  • 既存のコードベースとパターンを調査
  • 関連ファイルと依存関係をレビュー
  • AGENTS.mdの規約を研究
  • 外部ソースからコンテキストを収集
計画フェーズ:
  • 包括的な実装戦略を開発
  • 変更が必要なすべてのファイルを特定
  • 変更の順序を計画
  • テストと検証手順を考慮
安全性の保証:
  • 分析中はファイルを編集できません
  • 何かを変更するコマンドは実行できません
  • ファイルの作成、削除、移動はできません
  • 承認されるまですべての探索は読み取り専用

​
効果的なリクエストの書き方

結果に焦点を当てる: 構築方法ではなく、ソフトウェアが達成すべきことを説明してください。 
Users need to be able to reset their passwords using email verification.
The reset link should expire after 24 hours for security.
Include rate limiting to prevent abuse.
重要な制約を含める: 
Add user data export functionality that works for accounts up to 5GB.
Must comply with GDPR and include audit logging.
Should complete within 10 minutes and not impact application performance.
既存のパターンを参照: 
Add a notification system similar to how we handle email confirmations.
Use the same background job pattern as our existing report generation.
Follow the authentication patterns we use for other sensitive operations.
検証について具体的に記述: 実装が正しく動作することをdroidがどのように確認するかを伝えてください。 完全なユーザージャーニーを考慮: 技術要件だけでなく、完全な体験を説明してください。 エラーシナリオを含める: 障害をどのように処理し、ユーザーに伝達すべきかを指定してください。 規模について考える: パフォーマンス要件と予想される使用パターンを言及してください。

​
エンタープライズ統合

リンクを貼り付けて外部要件を参照: 
Implement the user management features described in this Jira ticket:
https://company.atlassian.net/browse/PROJ-123

Follow our security standards and include comprehensive error handling.
FactoryのダッシュボードからプラットフォームをSCIM統合している場合、droidは分析中にチケット、ドキュメント、仕様からコンテキストを読み取ることができます。

​
メリット

Safety First

No accidental changes during exploration. See the complete plan before any modifications.

Thorough Planning

Comprehensive analysis leads to better architecture decisions and fewer surprises.

Full Control

Complete visibility into what will be done before any code changes happen.

Better Outcomes

Well-planned implementations are more likely to be correct, complete, and maintainable.

​
AGENTS.md統合

Specification Modeの計画を強化するため、プロジェクトの規約を文書化してください。詳細についてはAGENTS.mdを参照してください。 Specification Modeはこれらの規約を自動的に組み込み、チームの基準との一貫性を保証します。

​
大きな機能の分割

複数のコンポーネントにまたがる複雑な機能については、集中的なフェーズに分割してください: フェーズ1: 
Implement user data export backend API and job processing.
Focus only on the server-side functionality, not the UI yet.
フェーズ2: 
Add the frontend UI for data export using the API from Phase 1.
Include progress indicators and download management.
このアプローチにより、次のフェーズに進む前に各フェーズを検証できます。

​
仕様承認オプション

droidが仕様を提示した後、続行方法を選択してください:
  1. 実装を進める – 計画を承認し、通常の（手動）実行制御を維持します。
  2. 進める、ファイル編集と読み取り専用コマンドを許可（低） – 低自律性自動実行を有効にし、droidがファイルを編集し、安全な読み取り専用コマンドを自動的に実行できるようにします。
  3. 進める、可逆的コマンドを許可（中） – 中自律性自動実行を有効にし、droidが追加プロンプトなしで可逆的コマンドも実行できるようにします。
  4. 進める、すべてのコマンドを許可（高） – 簡単に元に戻せないコマンドを含む完全自動実行のため高自律性自動実行を有効にします。
  5. いいえ、仕様の改良を続ける – 実装前に計画を改良するためSpecification Modeに留まります。
いずれかの自動実行オプションを選択すると、セッションの残り時間で対応する自律性レベルが設定されます。改良を続けることを選択すると、計画を継続的に形作れるようSpecification Modeがアクティブなままになります。

​
仕様をMarkdownとして保存

Specification Modeは承認された計画を自動的にディスクに書き込むことができます。CLIの設定を開き、仕様をMarkdownで保存を有効にしてこれを有効にしてください。
  • デフォルトでは、計画は最寄りのプロジェクトレベル.factoryディレクトリ内の.factory/docsに保存されます。存在しない場合、CLIはホームディレクトリの~/.factory/docsにフォールバックします。
  • 仕様保存ディレクトリ設定を使用して、プロジェクトディレクトリ、ホームディレクトリ、またはカスタムパスから選択してください。カスタム値は絶対パス、~展開、.factory/...ショートカット、現在のワークスペースからの相対パスをサポートします。
  • 対象ディレクトリが存在しない場合CLIがディレクトリを作成し、承認ダイアログに表示されたとおりにMarkdownを書き込みます。
  • ファイルはYYYY-MM-DD-slug.mdとして命名され、スラグは仕様タイトルまたは最初の見出しから生成され、同名のファイルが既に存在する場合はカウンタが追加されます。

​
承認後に起こること

仕様計画を承認すると、droidはレビュー用に各変更を表示しながら体系的に変更を実装します。承認ワークフローを通じて完全な制御を維持し、要件との品質と整合性を確保できます。 包括的な計画が不要なシンプルな変更については、droidはすべての変更を承認用に表示しながら直接進めることができます。 Specification Modeを試す準備はできましたか？構築したい内容のシンプルな説明から始めて、droidに仕様と計画の複雑さを処理させましょう。