Skip to content

スプリントの配布: 版数を配布のステップを流す時点に決め、並行するスプリントが先に版を出してもプランを作り直さずに出せる(#2164) - #2331

Merged
takemi-ohama merged 5 commits into
developfrom
design/issue-2164
Nov 1, 2026

Conversation

@takemi-ohama

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

Copy link
Copy Markdown
Contributor

#2164 の要求と受け入れ条件の写し、および設計文書を追加しました。版数を決める時点を「キューへの差し込みで流す時点」とし、bump が版の戻りを止める設計です。あわせて用語集に用語を追記しています。

利用者向けの変化

  • 無し

移行の手順

  • 無し

変更の要点

  • 要求と受け入れ条件の写し: issues/issue-2164-requirements.md を追加しました(159 行)。写しの時点では、版数を「配布のステップを流す時点」に決める形で書いています。
  • 設計文書: issues/issue-2164-design.md を追加しました(483 行)。版数は「キューの差し込みで流す時点」に決めます。版の戻りは bump が止めます。自分の配布のマージ前に別のスプリントがその版を出したら、決め直して進みます(決定 8)。
  • 用語集: docs/glossary.md と docs/glossary/glossary.json に用語を追加しました。
  • 変更は 4 ファイルで、すべて追加です(578 行追加)。

テスト

supervise.py の run で、次のステップを実行しました。

ステップ exit 結果
glossary 0 ok(宣言と用語集が揃っている)
requirements-check 2 stopped(issues/issue-2164-requirements.md を読めない: No such file)

requirements-check はファイルを読めずに止まりました。このファイルは本 PR で追加しています。検査が実行された時点や場所でファイルが見えていなかった可能性があるため、再実行での確認が要ります。

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

🤖 Generated with Claude Code

決めたこと

issues/issue-2164-design.md

  • 決定 1: 作業場所とブランチの名前まで流す時点の版に揃えるため、版をキューの差し込みで決める
  • 決定 2: 流し直しで自分の開発版を「使われた版」と見ないため、決めた版を版の記録に書いて使い続ける
  • 決定 3: 承認した版と出す版を食い違わせないため、本番の版は開発版の記録から読み、タグがあれば止めて人へ戻す
  • 決定 4: 開発版と本番、キューと bump で版の規則を分けないため、判定を lib/release_version.py の 1 か所に置く
  • 決定 5: 既に作ったプランを書き換えずに版の戻りを止めるため、bump に下限の比較とタグの判定を足す
  • 決定 6: 上げ幅を中身から推さずに渡せるようにするため、new sprint / new close に --level を足し、プランの「版」の欄に載せる
  • 決定 7: .ndf/release.json の {version} と取り違えないため、版の差し込みの語を {release_version} と {release_base} にする
  • 決定 8: 記録を書いた後に別のスプリントが先に版を出してもプランを作り直さずに出すため、自分の配布のマージまでは記録の開発版を決め直す

takemi-ohama and others added 2 commits November 1, 2026 01:21
- 設計文書 issues/issue-2164-design.md(398 行)
- 用語集へ「版の差し込み」「版の記録」「明示の版」を足し、docs/glossary.md を作り直す

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 | APPROVE

指定されたドメインモデル節と用語集の範囲に、critical / major に該当する修正指摘はありません。

@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 | APPROVE

ドメインモデルの節(コンテキスト・集約・不変条件・ドメインイベント・用語)と用語集の差分を確認した。コンテキストは ndf-workflow / ndf-release の 2 つで顧客/供給者の関係が宣言され、集約は持ち主がライフサイクルの段で一意に決まり、不変条件 I1〜I8 に相互の矛盾は無く、ドメインイベント E1〜E8 は要求の番号を引き継ぎそれぞれ受け手を持つ。用語 3 語(版の差し込み・版の記録・明示の版)は docs/glossary.json と docs/glossary.md の差分に ndf-workflow として同じ意味で反映されている。このラウンドの基準(critical / major)に当たる修正アクションは見つからなかった。

@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

版の記録を 1 回だけ書いて書き換えない(I3)ことと、bump の下限の判定(I7)が組み合わさると、開発版の流し直しが同じプランのまま二度と進まない経路が 2 つある。どちらも受け入れ条件 3・7 と目的(プランを作り直さずに出す)に反するため、記録の有効期間か bump の打ち直しの判定を設計で決め直す。

Comment thread issues/issue-2164-design.md Resolved
Comment thread issues/issue-2164-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 | REQUEST_CHANGES

設計の bump の止まり方(I7・F5・入出力の契約・テスト設計 受け入れ条件 5)が、プロジェクトの結果 JSON の契約と食い違う。stopped の既定の終了コードは 1(EXIT_VIOLATION)で、終了コード 3(EXIT_PRECONDITION)は emit へ明示して渡したときだけ付く。設計は「status: stopped・終了コード 3」と「on_exit: {"3":"stop"}」を対にして書くが、どちらが引き金かを明記していないため、実装が既定の stopped で止めると終了コード 1 になり on_exit が発火せず、ステップが judge/fix を通って版が書き換わる(受け入れ条件 4「別の版へ移って進まない」を破る)。

Comment thread issues/issue-2164-design.md Resolved
@takemi-ohama

Copy link
Copy Markdown
Contributor Author

🔧 /ndf:fix サマリ | commit 53d588f

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

@takemi-ohama takemi-ohama added the design-approved 設計 Pull Request の承認の印 label Nov 1, 2026
@takemi-ohama
takemi-ohama marked this pull request as ready for review November 1, 2026 02:43
@takemi-ohama
takemi-ohama merged commit db6b4ec into develop Nov 1, 2026
25 checks passed
@takemi-ohama
takemi-ohama deleted the design/issue-2164 branch November 1, 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