tk3.biz
ブログ一覧に戻る

[Released] dev-orchestra: 再開した設計のコストを正しく記録する修正 v1.3.2

はじめに

dev-orchestra は、1 文の依頼から設計・実装・テスト・複数の AI によるレビュー・修正までを回す、Claude Code / Codex / Antigravity のプラグインです。

この記事では、v1.3.2(2026-11-09)の変更をまとめます。v1.3.1 の変更は前回のリリース記事に書いています。v1.3.2 は不具合の修正の版で、新しい機能はありません。

dev-orchestra は GitHub で公開しています(MIT ライセンス)。役に立ちそうと思ったら、スターを付けてもらえるとうれしいです。

→ github.com/istb16/dev-orchestra

主な変更

再開した設計の実行に、その回のコストだけを記録する

dev-orchestra は、設計をやり直すとき、前の設計のセッションを再開して続きから考えさせることができます(run architect --resume)。

これまで、Claude の設計役でこの再開をすると、その回のコストとして、再開元のセッションまで含めた累計が記録されていました。Claude CLI は、再開したセッションのコスト(total_cost_usd)を、それまでの連なり全体の額で返すためです。トークン数のほうは、その回の分だけが返ってきます。

このため、設計をやり直すたびに前の回の額が足され、次のところで設計役のコストが実際より大きく出ていました。

  • run の終了イベントの cost_usd
  • tokens show の architect と architect:resumed
  • optimization report の、再開した実行の比率

1.3.2 では、再開元のセッションの額を引いて、その回のコストにするようになりました。CLI が返した累計の額は、終了イベントの resume.session_cost_usd に残り、次にまた再開したときにはその額を引きます。引く元の額が分からないとき(再開元の実行が額を記録していないときなど)は、そのコストを不明(null)として記録し、stderr に note: this continued run's own cost is unknown; recorded without one を出します。

トークン数の記録は変わりません。また、1.3.2 に更新する前に記録したイベントの額は直りません。設計役のコストが大きく見えていた記録は、更新したあとの記録と分けて見てください。再開元の額を引くのは Claude の設計役だけで、Codex の設計役の記録は前と変わりません。

1.3.1 と 1.3.2 で比べてみた

作業用のリポジトリで、同じ設計の依頼を 1 回流し、そのあと 2 回再開して、記録された額を比べました。設計役は Claude の sonnet、Claude Code は 2.1.322 です。

まず 1.3.1 です。3 回の合計が $0.0885 と記録されました。

$ dev-orchestra tokens show
  stage              meas.     input    output     total    billed      cost   tools  tool out
  architect            3/3        14     1,245         -     5,786   $0.0885       5       345
  ALL                  3/3        14     1,245         -     5,786   $0.0885       5       345

Per reviewer and tier:
  architect:resumed    2/2         4       470         -     1,787   $0.0645       0         0

各回の終了イベントの cost_usd は、$0.0239219、$0.0291082、$0.0354341 と増えていきます。2 回目と 3 回目は、その回の額ではなく、それまでの累計です。実際にかかったのは、3 回目の累計の $0.0354341 だけで、記録はその約 2.5 倍になっていました。

次に 1.3.2 です。同じ手順で、3 回の合計は $0.0336 と記録されました。

$ dev-orchestra tokens show
  stage              meas.     input    output     total    billed      cost   tools  tool out
  architect            3/3        12     1,180         -     5,617   $0.0336       4       331
  ALL                  3/3        12     1,180         -     5,617   $0.0336       4       331

Per reviewer and tier:
  architect:resumed    2/2         4       509         -     1,874   $0.0121       0         0

3 回目の終了イベントでは、cost_usd がその回の額、resume.session_cost_usd が CLI の返した累計です(イベントの一部を抜き出しています)。

{
  "stage": "architect",
  "status": "ok",
  "cost_usd": 0.006636,
  "resume": {
    "requested": true,
    "mode": "resumed",
    "outcome": "ok",
    "trust": "newer",
    "session_cost_usd": 0.0335753
  }
}

2 回目の累計は $0.0269393 で、$0.0335753 − $0.0269393 = $0.006636 が 3 回目の額です。各回の額($0.021508、$0.0054313、$0.006636)を足すと $0.0335753 で、3 回目の累計と同じになります。

1.3.1 で記録した連なりを、更新したあとに再開しても、その回の額だけが記録されます。上の 1.3.1 の連なりを 1.3.2 でもう一度再開すると、CLI の返した累計は $0.0420237 で、1.3.1 が 3 回目に記録した累計の $0.0354341 を引いた $0.0065896 が cost_usd になりました。1.3.1 が記録した額のほうは、累計のまま残ります。

細かな変更と不具合の修正

  • 再開できることを確かめた CLI の版に、Claude Code 2.1.319 と codex-cli 0.166.0 を足した。これより新しい版(同じメジャー版)は、確かめた版より新しいものとして信頼して再開する。今回の 2.1.322 では、再開のたびに note: claude 2.1.322 (Claude Code) is trusted to resume as newer than 2.1.319 (Claude Code), … が出た
  • CHANGELOG の 1.3.1 の項で、書き込みの実行に渡すツールを絞ったときのコストの増減の向きが逆になっていたのを直した(絞ると 26% 安くなる。$1.72 から $1.28)

安定化のための対応

設計の再開のコストを記録するテストを足すなど、動作を安定させるための対応を行いました。

更新方法

更新のしかたは、使っている CLI ごとに違います。アップデートの方法の手順で、新しい版のタグ(v1.3.2)を指定して更新してください。更新したら、dev-orchestra doctor を一度実行しておくと安心です。

まとめ

  • 再開した設計の実行には、その回のコストだけを記録するようになった。Claude の設計役で run architect --resume をすると、再開元のセッションの額まで足して記録していたが、1.3.2 からは再開元の額を引く。CLI の返した累計は resume.session_cost_usd に残る
  • 試した例では、1.3.1 の記録は実際の約 2.5 倍だった。1.3.2 では各回の額の合計が実際の額と同じになる
  • 更新する前に記録した額は直らない。トークン数は前から正しい

GitHub: istb16/dev-orchestra(スターを付けてもらえると励みになります)

関連記事

[Released] dev-orchestra: 設計の前のインタビューと、レビューの手間を減らす機能を追加 v1.4.0

dev-orchestra v1.4.0 の変更をまとめました。設計の前に 1 問ずつ聞くインタビュー(design.ask_questions: grill)が入りました。レビューでは、決めたことをレビュアーに伝え、元からあった軽い問題を仕分けから外し、再レビューの人数を減らします。軽い段の自動選択や、新しいセッションでの続きも入りました。

[Released] dev-orchestra: テストと並行してレビューを始める機能を追加 v1.3.1

dev-orchestra v1.3.1 の変更をまとめました。テストの終わりを待たずにコードレビューを始められるようになりました(既定は無効)。計画の承認の既定が auto になり、CI などで誰も見ていないときは、条件がそろえば承認を省きます。Claude の書き込みの実行は、使うツールだけで MCP サーバーなしに始まります。

[Released] dev-orchestra: 最後に変更全体をレビューする機能を追加 v1.3.0

dev-orchestra v1.3.0 の変更をまとめました。修正だけを見たレビューで Low より上の指摘が無くなったら、最後に変更全体をもう一度レビューして終わるようになりました。既定で有効で、Medium の指摘でも再レビューになるので、レビューの回数が前より増えることがあります。