Skip to content

設計の承認で問われた 3 点(用語・適用範囲・あるべき姿の根拠)が提示物に無く、関門 1 の問いが 9 回になった #772

Description

@takemi-ohama

何を見つけたか

v10.15.0 のまとまり(設計 PR #739 #740 #741 #742 を 1 回の承認に載せた)で、関門 1(設計の承認)の AskUserQuestion は 9 回になった(設計の承認 7 回 + 用語の問い 2 回。2026-09-17T05:29Z〜09-18T02:34Z)。拒否の理由は 3 種類で、いずれも設計の中身ではなく提示物に欠けていたものである。

問われたもの 何が起きたか
用語 工程を担う実行単位と最上位の層の呼び方が 窓 → window → supervisor / worker → president → conductor と 4 回変わった(PR #740 のコミット 2026-09-17T19:06Z〜20:58Z)。そのたびに要求・設計・契約の 3 文書を書き直し、クロスレビューを 11 + 9 ラウンド回した
適用範囲 #742 の検査が ai-plugins 限定に読め、配布先のリポジトリで使う形かを問われた
あるべき姿の根拠 #742 に「エージェント向けの指示書はどうあるのが適切か」の考察が無く、外部調査(出典 23 件)を足して 38 ラウンドで収束した

どこで見つけたか

conductor のセッションの記録(AskUserQuestion 10 回のうち関門 1 が 9 回、関門 2 が 1 回)、PR #740 のコミット履歴、PR #742 の本文と #554 へのコメント。v10.15.0 の振り返り(issue #550 のコメント)で集めた。

なぜこの変更の範囲外なのか

#550 の計画(issue-550-unattended-run-plan.md)の「やらないこと」に「関門の数・承認の形・提示物の変更」がある。承認の提示物を変える課題は、このまとまりの受け入れ条件に含まれない。

直さないと何が起きるか

設計の supervisor が承認まで到達した後に用語や範囲で差し戻され、文書の書き直しとクロスレビューの再走が起きる。設計の supervisor の context window が 割る候補(最大充填 787,115)になった主因もここにある(実作業の大半が同じ設計の書き直しである)。

直し方の候補

  • requirements-design の要求文書の先頭に用語の表(層・実行単位の名前、候補と選んだ理由)を置き、conductor が設計の前に関門とは別の軽い問いで確定する
  • design の提示物に「適用範囲(このリポジトリ限定か、配布先でも使うか)」と「あるべき姿の根拠(外部の一次情報)」の欄を置く。欄が空なら supervisor が関門を返す前に埋める

由来

issue #550(v10.15.0 の振り返り)

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area: ndf-skillNDF の Skill 本体enhancementNew feature or requestpriority: medium保守性・設計一貫性など、計画的に対応する

    Type

    No type

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions