Skip to content

差分の棚卸し: 見積の段階をそのスプリントの課題だけに付け、縮んだ所要をコマンド 1 本で確かめる(#2315) - #2526

Merged
takemi-ohama merged 6 commits into
developfrom
design/issue-2315
Nov 5, 2026
Merged

takemi-ohama merged 6 commits into
developfrom
design/issue-2315

Conversation

@takemi-ohama

@takemi-ohama takemi-ohama commented Nov 5, 2026 •

Copy link
Copy Markdown
Contributor

#2315(差分の棚卸しの所要)の残りについて、要求と受け入れ条件、設計の文書を置きました。あわせて用語集へ 2 語を追加し、その意味を設計に合わせて定めています。プラグインの動作は変わりません。

利用者向けの変化

  • 無し

移行の手順

  • 無し

変更の要点

ファイル 追加 削除
docs/glossary.md 3 1
docs/glossary/glossary.json 13 1
issues/issue-2315-design.md 320 0
issues/issue-2315-requirements.md 140 0
合計 476 2

テスト

確認の項目 終了コード 結果
用語集の照合(glossary) 0 文書で宣言した語と用語集の内容が一致している
要求のコピーの照合(requirements-check) 0 issues/issue-2315-requirements.md は #2315 の本文と一致する(15 節)

モード: standard / 通した工程: 設計 → 要求と受け入れ条件 → ドキュメント再構成 → ドキュメントレビュー

🤖 Generated with Claude Code

決めたこと

issues/issue-2315-design.md

  • 決定 1: 課題の数で伸び縮みする工程を縮めるため、差分の棚卸しで見積の段階を付ける課題を起点のタグより後に作られた課題に絞り、ほかの作業は外さない
  • 決定 2: 秒・ドルを機械で写すため、記録のステップが同じプランの進行の記録を読む
  • 決定 3: 開発ループの名前と周回を残すため、開発ループが new close へ引数で渡す
  • 決定 4: 言語モデルが変わった回を機械で外すため、差分の棚卸しの行の values に言語モデルの名前を写す
  • 決定 5: 比べ方を 1 本のコマンドにするため、depth compare を足し、基準・件数・言語モデルは引数で受ける
  • 決定 6: 起点の時刻を 1 つにするため、作られた時刻の比較は候補の収集が使う起点のコミットの時刻で行う

takemi-ohama and others added 3 commits November 5, 2026 01:37
差分の棚卸しで見積の段階を付ける課題を起点のタグより後に作られた課題に絞り、深さの記録の
差分の棚卸しの行へプランの進行の記録から秒・ドル・言語モデルを、開発ループから名前と周回を写し、
所要の中央値を基準と比べるコマンドを足す設計。工程ごとの所要の実測(会話の記録 4 本)を決定 1 に置く。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
章の順は設計の雛形のまま保ち、内容は足していない。
平均文長 36.4 字 → 33.7 字、最長文 112 字 → 84 字、題 69 字 → 56 字。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@takemi-ohama takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 1 | codex | REQUEST_CHANGES

比較対象を同じ周回の重複記録で水増ししない条件を、不変条件に追加してください。

Comment thread issues/issue-2315-design.md Resolved

@takemi-ohama takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 1 | kiro | REQUEST_CHANGES

ドメインモデルの用語の表(### 用語)の「用語集への反映」列が、同じ PR の用語集の差分と食い違う。深さの記録・プランの進行の記録はどちらも用語集に新規追加されているのに、表では「意味の変更」「変更なし」と書かれている。表どおりに用語集を保守する実装者は、新規追加すべき語を更新扱い/対象外にして取り違える。

Comment thread issues/issue-2315-design.md Resolved
Comment thread issues/issue-2315-design.md Resolved
- 不変条件 I6・決定 5・比べ方のコマンドの出力・テスト設計に、同じ開発ループ・周回
  (開発ループの外では同じスプリント)の行は最後の 1 行だけを数える条件を足す
- 用語の表で、深さの記録・プランの進行の記録の用語集への反映を新規追加にそろえる

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@takemi-ohama

Copy link
Copy Markdown
Contributor Author

🔧 /ndf:fix サマリ | round 1 | commit 848a033

対応件数: critical=0 / major=3 / minor=0(合計 3 件)
決着: 3 件 / 見送り: 0 件 / 却下: 0 件
CI: PENDING

@takemi-ohama takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 2 | claude | REQUEST_CHANGES

I6 の重複の除き方で、秒・ドル・言語モデルの絞り込みと「最後の 1 行」の順序が決まっておらず、実装によって数える件数が変わる。順序を I6 とテスト設計に明記する。

Comment thread issues/issue-2315-design.md Resolved

@takemi-ohama takemi-ohama left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 cross-review | round 2 | kiro | APPROVE

round 1 の指摘(同じ周回の重複記録で比較対象を水増ししない条件・用語集の反映列の食い違い)は、I6・用語の表(深さの記録/プランの進行の記録を「新規追加」へ)・入出力の契約(excluded の reason に duplicate を追加)・決定 5・テスト設計 17d の各所で整合して反映されている。新しい major/critical の指摘は無い。

@takemi-ohama

Copy link
Copy Markdown
Contributor Author

🔧 /ndf:fix サマリ | commit df2be4b

対応件数: critical=0 / major=0 / minor=0(合計 0 件)
決着: 1 件 / 見送り: 0 件 / 却下: 0 件
CI: NONE

用語集(docs/glossary/glossary.json)は #2315 の 2 語と #2346 の 1 語の両方を残した。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KYHP82YBP3K8vVBou7sEBN
@takemi-ohama
takemi-ohama merged commit 1b32edb into develop Nov 5, 2026
24 checks passed
@takemi-ohama
takemi-ohama deleted the design/issue-2315 branch November 5, 2026 02:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

design-approved 設計 Pull Request の承認の印

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant