Embedr
ダウンロード

プランモード

エージェントがヒアリングし、specs/に仕様書を書き、ワンクリックで実装します。

プランモードでは、エージェントは何も作りません。あなたに質問し、回答をプロジェクト内の1つのMarkdownの仕様書にまとめて止まります。仕様書が望みどおりの内容になったら、Implement this spec で通常モードのエージェントに渡します。

前提を間違えると高くつく作業の前に使ってください。新しい基板、バッテリーや筐体のある製品、ファームウェアのアーキテクチャなど、普段なら何通ものメッセージで説明するようなものです。

プランモードのオンとオフ

場所 方法
チャット入力欄 Shift+Tab で切り替えます。入力欄のツールバーに Plan チップが表示されます
終了 もう一度 Shift+Tab を押すか、Plan チップ（Exit Plan Mode · Shift+Tab）をクリックします
ホーム画面 ホームのプロンプトから始めた新しいプロジェクトでは、最初のチャットがプランモードで開きます

モードはスレッドごとです。他のスレッドはそれぞれのモードを保ちます。プランモードはデスクトップアプリでもブラウザでも使えます。

ヒアリング

エージェントはまず、プロジェクトを見ればわかることを尋ねずに済む程度にだけプロジェクトを確認します。その後、影響の大きいものから順に、入力欄の部分で何回かに分けて質問します。よくある話題:

  • デバイスの用途と使う人
  • 使う場所: 環境、筐体、電源
  • 厳しい制約: サイズ、電池寿命、コスト、数量、認証、期限
  • インターフェースとコネクタ
  • カスタムPCBの場合、どのメーカーのどのプロセスで製造するか
  • 目標同士がぶつかったときにどれを優先するか
  • 求める完成度: 概念実証、動作するプロトタイプ、量産

最初のメッセージが詳しければ質問は少なく、曖昧なら多くなります。

質問に答える

1回の質問は1〜4問で、ヘッダーに "2 of 4" のように表示されます。各質問には2〜4個の選択肢があり、最適な既定値には Recommended が付きます。

選択肢 内容
一覧の選択肢 あなたの回答です。質問に "Select all that apply." とあれば複数選べます
Something else 入力欄（"Describe what you have in mind"）が開きます。Cmd/Ctrl+Enterで次に進みます
You decide "The agent picks a sensible default and notes it as an assumption."（エージェントが妥当な既定値を選び、前提として記録します）

単一選択の選択肢をクリックすると、そのまま次の質問に進みます。複数選択と Something else では Continue をクリックします。Back でその回の前の質問に戻ります。最後の質問では Send answers（1問だけのときは Send answer）をクリックします。タイムラインには各回の記録が残ります: "Asked 1 question"、Answered、Custom response、実行が中断された場合は Not answered。

プランモード以外でも、あなたにしか決められないことがあれば、エージェントは同じ方法で質問します。

仕様書ファイル

エージェントは会話ごとに1つの仕様書を、プロジェクトの specs/ 以下（例: specs/greenhouse-sensor-node.md）に保ちます。毎回同じファイルを更新し、その前に読み直すので、ターンの合間にあなたが加えた編集も残ります。

my-project/
  specs/
    greenhouse-sensor-node.md
  embedr.yaml
  src/
  pcb/

セクション:

セクション 内容
Intent 何を、なぜ作るのか
Requirements それぞれに [confirmed]（あなたが述べた、または選んだ）、[assumed]（エージェントが選んだ、または You decide と答えた）、[open]（まだ決まっていない）が付きます
Decisions 決めたことと、それぞれの理由
Out of scope この作業で行わないこと
To research 実装中に解決する問い: 比較する部品、読むデータシート、確認する制限値
Plan 未決の項目が設計を変えなくなった時点で書かれます: アーキテクチャ、作業の順序、各部分の確認方法

抜粋:

## Requirements

- Runs 12 months on 2x AA cells. [confirmed]
- Reports temperature and humidity every 10 minutes over LoRaWAN (EU868). [confirmed]
- IP54 enclosure, wall mounted. [assumed]
- Fabricated by PCBWay, standard 2-layer process. [confirmed]
- External antenna connector. [open]

## To research

- Lowest-power humidity sensor with a ±2 % RH spec.
- LoRa module with a sleep current under 2 µA.

各ターンは、仕様書で何が変わったか、何がまだ未決か、仕様書のパスを伝える短いメッセージで終わります。仕様書そのものはチャットに繰り返し表示されません。

仕様書カードと実装

プランモードの返信が終わると、仕様書のタイトルとパス、エディタでファイルを開く Open ボタンを持つカードが表示されます。

最後の返信の下で、入力欄の部分に Ready to start implementation? と表示されます。

ボタン 効果
Implement this spec スレッドのプランモードを解除し、エージェントに仕様書の実装を依頼します
Keep refining カードを閉じて入力欄に戻り、計画を続けられます

Implement this spec をクリックする前に、仕様書を直接編集できます。実装時、エージェントは次のように進めます。

  1. まず仕様書を読みます。
  2. 指定された部品、値、定格、パッケージ、基板メーカーを含め、すべての [confirmed] の要件を必須として扱います。
  3. 作り始める前に To research の項目を解決します。
  4. 確定した要件を変更、置き換えする前にあなたに確認し、それに合わせて仕様書を更新します。
  5. 完成した作業を検証します。

返信で仕様書ファイルが作られなかった場合、ボタンは Implement this plan と Revise the plan になります。

プランモードでできること、できないこと

プランモードでできること プランモードでできないこと
余計な質問を避けるためにプロジェクトのファイルを読む specs/ 以下のMarkdownファイル以外の編集
あなたに質問する ターミナルコマンド、ビルド、アップロード、書き込みの実行
仕様書を作成、更新する ライブラリや依存関係のインストール
技術的な知識から現実的な選択肢を提案する PCBソース、回路図、基板、ルールの変更、配置、配線、エクスポートの実行
シミュレーションの実行、データシートのインデックス作成、機構モデルのビルド
Webでの調査、データシートの読み込み、コンポーネントライブラリの検索、部品の比較。これらは To research に記載されます

エージェントがブロックされた操作を試みると、その呼び出しは実行されず、理由がエージェントに伝えられます。操作させるには、プランモードを終了するか Implement this spec をクリックしてください。

ヒント

  • わかっていることは最初のメッセージで伝えましょう（「2層、PCBWay、USB-C給電、ESP32-S3」）。ヒアリングが短くなります。
  • こだわらない点には遠慮なく You decide を使ってください。[assumed] として記録されるので、後で見直せます。
  • 1つの仕様書に1つのスレッドを使います。プランモードで新しいスレッドを始めると、新しい仕様書になります。
  • 仕様書はプロジェクトと一緒にコミットしてください。設計意図を読みやすく記録したものになります。

関連

Embedrエージェントヘルパー