tk3.biz
ブログ一覧に戻る

dev-orchestra に、設計の前にインタビューさせてみた

はじめに

「タスクに期限を付けられるようにして。」とだけ頼むと、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 ライセンス)。役に立ちそうと思ったら、スターを付けてもらえるとうれしいです。

→ github.com/istb16/dev-orchestra

質問は 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-orchestra1.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」の一覧でまとめて読めます。

関連記事