はじめに
「タスクに期限を付けられるようにして。」とだけ頼むと、dev-orchestra は設計の前に質問してきます。16 本目では、design.ask_questions: auto で 3 つの質問がまとめて届き、選択肢から選んで答えれば済みました。手軽ですが、選択肢にない考えや、答えのあいまいさはそのまま設計に流れます。
1.4.0 で、この質問をインタビューにする grill が入りました。CHANGELOG によると、質問を 1 つずつ聞き、答えがあいまい・前と食い違う・条件を足した、というときは掘り下げます。16 本目と同じ依頼で試してみました。
結果を先に言うと、質問は 1 つずつ、全部で 8 問でした。条件を足した答えには、ちゃんと追加の質問が来ました。一方で、わざとあいまいに答えたときは掘り下げずに解釈して進み、資料に挙がっている「意図」や「成功をどう判断するか」は一度も聞かれませんでした。試したのは 1 回だけなので、どれも「今回はそうだった」という結果です。ほかの変更は、同じ日に出した v1.4.0 のリリース紹介にまとめています。
dev-orchestra は GitHub で公開しています(MIT ライセンス)。役に立ちそうと思ったら、スターを付けてもらえるとうれしいです。
質問は 1 つずつ、8 問になった
設定は 1 行です。今回は普段とは別の設定フォルダで変えました。
dev-orchestra config set design.ask_questions grill
16 本目と同じ小さな Python の todo パッケージで、同じ依頼を Claude Code に渡すと、27 秒で最初の質問が返ってきました。
質問は1つずつ行います。まず最初の質問です。
**Q1. 期限はどの粒度で指定しますか?**
- (a) 日付のみ(例: `2026-12-01`)
- (b) 日付と時刻(例: `2026-12-01 18:00`)
私のおすすめは **(a) 日付のみ**です。この CLI は小さく、時刻まで扱うとタイムゾーンや入力形式の考慮が増えます。後から (b) へ拡張することもできます。
ご回答をいただいたら、次の質問(指定方法、一覧での表示と並び順、期限切れの扱い、既存データの互換性)に進みます。「お任せ」の場合はその旨をお知らせください。私の推奨で進めます。
16 本目の auto では 3 問が 1 通にまとまっていましたが、grill では 1 通に 1 問です。選択肢と推奨が付く形は同じなので、1 問ずつの答えやすさは変わりません。そのかわり、往復の回数が増えます。今回聞かれたのは、次の 8 問でした。
| 問 | 聞いた側 | 内容 | 私の答え |
|---|---|---|---|
| Q1 | オーケストレーター | 期限の粒度(日付か、時刻も) | あいまいに答え、次の答えで日付だけに |
| Q2 | オーケストレーター | 期限の付け方 | add --due と due <id> |
| Q3 | オーケストレーター | 一覧での表示と並び順 | list --sort due のときだけ期限順 |
| Q4 | オーケストレーター | 付けた期限を消せるか | due <id> none で消す |
| Q5 | 設計役 | 一覧の行の書き方 | 括弧の形。期限切れは赤くしたい |
| Q8 | オーケストレーター | Q5 への追加質問:どこを赤くするか | 行全体、ターミナルのときだけ |
| Q6 | 設計役 | 過去の日付を受け付けるか | お任せ |
| Q7 | 設計役 | --sort due で完了済みをどこに置くか | 未完了を先に |
Q1〜Q4 はオーケストレーター(呼び出し元の Claude Code)の質問です。Q4 に答えたところで設計役のコードを読む質問の回が走り、Q5〜Q7 が 1 問ずつ続きました。Q8 は、Q5 への答えを受けた追加の質問です。番号は記録された順なので、聞かれた順とは前後しています。
あいまいに答えたら、解釈して先へ進んだ
試したかったのは、掘り下げです。Q1 には、わざとあいまいに答えました。
うーん、だいたい日付でいいけど、場合によっては時間もほしいかも。
返ってきたのは、追加の質問ではありませんでした。
了解です。「基本は日付のみ、必要なら時刻も付けられる」という方針として記録します。入力は `2026-12-01` と `2026-12-01 18:00` のどちらも受け付け、時刻は任意とします。
**Q2. 期限はどのように指定しますか?**
「場合によっては」がどんな場合かは聞かれず、時刻を任意で受け付ける、と解釈されて次の質問に移りました。続く Q2 の答えに「やっぱり時刻はいらない。日付だけにして。」と書き足すと、今度は「Q1 は日付のみで確定」と受け取って、時刻まわりの決めごとを取り下げました。記録に残った Q1 の答えは、最後に言い直した「日付のみ」です。
私の言い直しは、前の質問への答えを自分で訂正したもので、資料の言う「前の答えと食い違う答え」を試したことにはなっていません。気になったのは、最初のあいまいな答えが、そのまま方針として記録されかけていたことです。実際、Q2 の質問には「時刻を省略した場合は『その日の終わり(23:59)まで有効』として扱う想定です」と、時刻ありの前提がもう入っていました。今回は自分で言い直したので取り下げられましたが、言い直さなければ、その前提のまま進んでいたことになります。
条件を足すと、追加の質問が来た
設計役の Q5(一覧の行の書き方)には、選択肢に条件を 1 つ足して答えました。
a で。ただ、期限切れの行はターミナルで赤くしたい。
これには、すぐに追加の質問が来ました。
Q5 は「(a) 括弧付きの接尾辞、期限切れの行は赤で表示」として記録しました。
**Q8. 期限切れの行を赤くする条件と範囲は?**(Q5 の追加質問)
- (a) 期限切れの行全体を赤にする。ただし標準出力がターミナルのときだけで、環境変数 `NO_COLOR` が設定されている場合は赤にしない。
- (b) `OVERDUE` の語だけを赤にする。条件は (a) と同じ。
- (c) 期限切れの行全体を、常に赤にする。
「赤くしたい」の一言に、パイプに流したときに色の制御文字が混ざらないか、という問題が隠れています。追加の質問は、その点を選択肢に分けて聞き返してきました。記録でも、Q8 の題は資料の決まりどおり Follow-up to Q5: で始まっています。
Q8 [answered] Follow-up to Q5: Red overdue lines (asked by the orchestrator)
When and how much should an overdue line be colored red?
聞かれたのは仕様で、目的ではなかった
資料(Design questions)では、grill のオーケストレーターは、依頼で答えが出ていないものについて、次の観点から大事な順に 5 問まで聞くことになっています。意図、成功をどう判断するか、範囲の外にあるもの、やめた案とその理由、元に戻しやすさ、どう失敗しうるか、もっと小さい変更や何もしないことで足りないか、です。
今回の Q1〜Q4 は、粒度・付け方・表示・消し方と、どれも仕様の質問でした。「なぜ期限がほしいのか」「何ができたら成功か」は聞かれていません。題材が小さく、依頼から目的が読み取れると判断されたのかもしれませんが、1 回しか試していないので確かめられていません。インタビューで目的まで詰めたいなら、今のところは、依頼の文に目的を書いておくほうが確実だと思います。
もう 1 つ、資料では 1 問ずつ記録してから聞くことになっていますが、今回は Q4 に答えたあとで、Q1〜Q4 がまとめて記録されていました。最後の記録には 8 問すべてと答えがそろっていたので、結果に違いは出ていません。
計画には、誰が決めたかが残る
最後の Q7 に答えると、設計役が計画を書き、設計レビューの 12 件の指摘を反映した計画で、承認を求めてきました。計画の ## Decisions には、私が決めたことと、設計役が決めたことが分けて書かれています(抜粋)。
- **Q5 Line format** (user): parenthesized suffix, `(due D)` or `(due D, OVERDUE)`.
- **Q6 Past dates when setting** (me): accepted silently, with exit 0 and no warning. The task shows OVERDUE on the next `list`, which is the feedback. Rejecting would stop users recording tasks that are already late, and would make writes depend on the clock.
- **Q7 Done tasks under `--sort due`** (user): open tasks first, then done; each group by due with no-due last; ties by id.
- **Q8 Red** (user): whole overdue line, only when stdout is a TTY and NO_COLOR is unset.
「お任せ」と答えた Q6 には、設計役が理由つきで決めた内容が残っていました。この形は 16 本目と同じです。今回は承認を求められたところで止め、実装には進んでいません。
依頼から承認を求められるまでは、待ち時間を合わせて約 8 分でした。そのうち、設計と設計レビューを含む最後の 1 往復が 4 分 42 秒です。dev-orchestra が記録した設計役と設計レビューの費用は $1.69、Claude Code 側のセッションが報告した額(9 往復の累計)は $0.92 で、合わせて約 $2.61 です。どちらも API 料金に換算した額です。
どんなときに使うか
grill は、答えるたびに 1 往復かかります。今回は 8 問で、16 本目の auto の 3 問より手間はかかりました。その分、条件を足したときには、その条件の裏にある問題(色とパイプ)を選択肢に分けて聞いてきました。
あいまいな答えを掘り下げてくれることを期待するなら、1 回試した限りでは、まだ当てにできません。自分の答えがあいまいだと気づいたら、次の答えで言い直す。目的や成功の基準が大事な変更なら、依頼の文に書いておく。この 2 つを補えば、仕様の詰めの抜けを減らす道具としては使えると思います。
まとめ
grillでは、設計の前の質問が 1 通に 1 問ずつ届き、今回は 8 問になった- 条件を足した答えには、
Follow-up to Q5:の追加の質問が来た。あいまいな答えは、今回は掘り下げずに解釈して進んだ - 資料にある「意図」「成功をどう判断するか」などの観点は聞かれず、仕様の質問だけだった。目的は依頼の文に書いておくほうが確実
試した条件
| 項目 | 内容 |
|---|---|
| dev-orchestra | 1.4.0、プリセット standard、design.ask_questions: grill |
| 呼び出し元 | Claude Code 2.1.327。claude -p で依頼し、答えは claude -p --resume で渡した |
| 設計役 | Claude Fable |
| 題材 | 作業用に作った小さな Python のパッケージ todo(タスクを JSON に保存する Store と、add・done・list の CLI、テスト 2 件) |
| 環境 | Windows 11、Python 3.14.10。設定は普段とは別のフォルダ(DEV_ORCHESTRA_HOME)に置いた |
試したのは 1 回だけで、依頼も 1 つです。人が見ていない実行(CI など)での動きは試していません。
細かな仕様
この節は資料と CHANGELOG に書かれている決まりです。今回の実行で確かめたのは、1 問ずつ聞くことと Follow-up to Q<n>: の題だけで、上限の数や、人が見ていない実行での動きは試していません。
設定の値
design.ask_questions は false(既定)・auto・true・grill の 4 つです。grill は、質問の回を必ず挟む点では true と同じで、聞き方だけがインタビューになります。設計役の質問の回の数とその上限(design.max_question_rounds、既定 2)も変わりません。status の Design questions: の行には grill と出ます。status --json の mode も grill です。1.4.0 から、設定の値を表示する行では true が on ではなく true と出るようになりましたが、--json の mode では true は今までどおり on のままです。
インタビューの決まり
オーケストレーター自身の質問は、大事な順に 5 問まで。追加の質問は、1 つの質問につき 2 問までです。追加の質問を含めて 10 問聞いたら、続けるかどうかをユーザーに聞きます。追加の質問は、題を Follow-up to Q<n>: で始める決まりで、ふつうのオーケストレーターの質問として記録されます。CLI はこれらの数を数えず、追加の質問と元の質問のつながりも確かめません。守るのはオーケストレーターの側です。ユーザーが「もういい」と言ったら、残りは設計役に任せます(--delegate)。
人が見ていない実行では
design.require_approval: false のときや、design.require_approval: auto で CI か DEV_ORCHESTRA_UNATTENDED が設定されているときは、答える人がいません。このとき grill は true と同じに動き、質問はまとめて記録されるだけで、追加の質問はしません。開いたままの質問は、計画を書く実行が設計役に任せたものとして記録します。
詳しくは資料の Design questions にあります。
GitHub: istb16/dev-orchestra(スターを付けてもらえると励みになります)
この連載の記事は、「dev-orchestra」の一覧でまとめて読めます。
関連記事
dev-orchestra に、設計の前に質問させてみた
dev-orchestra 1.3.0 の「設計の前の質問」(design.ask_questions)を、あいまいな依頼とはっきりした依頼で試しました。auto ではあいまいな依頼にだけ質問が来て、true では「はっきりしている」と思った依頼にもアーキテクトが4つ質問しました。人が見ている実行では、答えるまで計画は書かれません。
Claude Codeの/insightsで自分の使い方を分析してもらってみた
Claude Codeの/insightsコマンドで過去41セッションを分析してもらいました。うまくいっている使い方や詰まりポイント、自分の使い方の癖まで指摘されたレポートの中身を紹介します。
[Released] dev-orchestra: 設計の前のインタビューと、レビューの手間を減らす機能を追加 v1.4.0
dev-orchestra v1.4.0 の変更をまとめました。設計の前に 1 問ずつ聞くインタビュー(design.ask_questions: grill)が入りました。レビューでは、決めたことをレビュアーに伝え、元からあった軽い問題を仕分けから外し、再レビューの人数を減らします。軽い段の自動選択や、新しいセッションでの続きも入りました。