Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion docs/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -318,6 +318,7 @@ NDF が提供する工程・承認ゲート・モード・ステップの語。d
| 欠けの残る結果 | — | 手順は終わったが、出すはずの材料・記録の一部が無いか、目標(収束など)に届かなかった結果。stopped と終了コード 6 と gaps で返し、ok で返さない | — | — | `docs/specifications/ndf-step-result-gaps-and-reading.md` |
| 結果の置き場 | — | 読む側が結果 JSON や材料を探す場所(プランの実行の記録・記録のファイル)。置き場が無いことと、材料が 0 件であることを分けて扱う | — | — | `docs/specifications/ndf-step-result-gaps-and-reading.md` |
| 欠け | `gaps` | 結果 JSON の gaps の 1 件。出すはずだったのに出せなかった材料・記録、届かなかった目標を、種類・名前・理由で書く | — | — | `docs/specifications/ndf-step-result-gaps-and-reading.md` |
| ステップの延長 | — | drive のステップの子孫(駆動と、駆動が起動した init)が自分の見込みの秒を延長のファイル(NDF_STEP_EXTEND_FILE の指すパス)へ書き、エンジンがその試行の締め切りを with_margin を足して後ろへずらすこと。前へはずらさない | — | — | — |
| 過程の項目 | `process` | 結果 JSON の process。スクリプトが実行したこと(コマンド・操作)と、その結果の要旨を順に並べる | — | — | `docs/specifications/ndf-step-result-gaps-and-reading.md` |
| 判断の項目 | `decisions` | 結果 JSON の decisions。スクリプトが決めたことと、その根拠を並べる | — | — | `docs/specifications/ndf-step-result-gaps-and-reading.md` |
| 最終工程の記録 | — | 最終工程を終えたことを示す、GitHub に残った記録。配布は配布の記録の `段階:`、リリース後テストはその課題の行、振り返りは課題の本文の `振り返り: <コメントの URL>` の行。sprint-close.py が閉じる前に確かめる | — | — | `plugins/ndf/skills/progress-tracking/SKILL.md` |
Expand Down Expand Up @@ -467,8 +468,12 @@ Pull Request のレビューを CLI へ委譲し、新しい指摘が出なく
| 対象のリポジトリ | — | cross-refactoring が Pull Request を取り、作業ディレクトリを作るリポジトリ。打った場所(現在のディレクトリ)が属する git の worktree の根で決まる | — | — | — |
| 提案担当 | — | cross-refactoring の propose で改善の提案を出す参加者 | — | — | `docs/specifications/cross-assignee-reassignment-on-no-result.md` |
| 着手前のテスト | — | `cross-refactoring` の init が改修の前に 1 回走らせるテスト。CI に任せる戦略では --scope のテストの置き場所の範囲テスト、ほかは全体テスト(round-only はラウンドテストも) | — | — | — |
| 想定最大時間の下限 | `required_budget_minutes` | 着手前のテストの実測から求める、手順の枠と計画の後の見込みが収まる想定最大時間の最小値(分)。init が「--budget-minutes を N 以上に」と案内する N | — | — | — |
| 着手前のテストの初回の上限 | — | 同じ範囲の打ち切りと実測が配分の履歴に無いときの、着手前のテストの上限(秒)。max(0.10·B, 3·s) で、s は手元の全体テストの直近の実測 m → 宣言の w の順に採る(どちらも無ければ 0.10·B) | — | — | — |
| 想定最大時間の出所 | `budget_source` | その実行の想定最大時間をどこから決めたか。explicit(引数か宣言で渡した)・default(省いて既定の 30 分を使った)・floor(省いて想定最大時間の下限まで上げた)の 3 つ | — | — | — |
| 時間の枠の不足 | — | 着手前のテストが上限で打ち切られたか、明示した想定最大時間が想定最大時間の下限に届かないこと。init は SKIP を出して止まり、駆動はリファクタリングを飛ばした欠けの残る結果を返す | — | — | — |
| 手順の枠 | — | `cross-refactoring` で提案とリファクタリング計画に充てる時間。着手前のテストの終わり(started_at + 実測)から 0.20·B と 0.10·B。枠が想定最大時間に収まらずに止めた後の init の打ち直しでは打ち直した時刻から数える | — | — | — |
| 範囲テストの所要 | — | CI に任せる戦略で、着手前に走らせる範囲テストの所要の見込み(秒)。同じ範囲の履歴の実測か、範囲が全体テストの suite のパスを覆うときの w | — | — | — |
| 範囲テストの所要 | — | CI に任せる戦略で、着手前に走らせる範囲テストの所要の見込み(秒)。同じ範囲の履歴の実測 → 手元の全体テストの直近の実測 m → 宣言の w の順に採る | — | — | — |
| 積み直し | — | 取り消しで、取り消しの起点から HEAD までの残すコミット(未公開のもの)を cherry-pick で順に積み直すこと。項目に属するコミットが衝突したら、その項目だけを外して続ける | — | — | `docs/specifications/cross-refactoring-failed-item-rules.md` |
| 外した項目 | — | cross-refactoring の取り消しの積み直しで、自分のコミットが衝突したために取り消した改善項目。外した理由(どの項目の取り消しで、どのコミットが衝突したか)を持つ | — | — | `docs/specifications/cross-refactoring-failed-item-rules.md` |
| 直さなかった項目 | — | cross-refactoring で、結果を残して終わった修正の起動の後、修正の範囲に自分の Item-Id のコミットが 1 つも無い改善項目。次の検証の最初に取り消す | — | — | `docs/specifications/cross-refactoring-failed-item-rules.md` |
Expand Down
42 changes: 40 additions & 2 deletions docs/glossary/glossary.json
Original file line number Diff line number Diff line change
Expand Up @@ -3439,6 +3439,36 @@
"meaning": "`cross-refactoring` の init が改修の前に 1 回走らせるテスト。CI に任せる戦略では --scope のテストの置き場所の範囲テスト、ほかは全体テスト(round-only はラウンドテストも)",
"source": ""
},
{
"term": "想定最大時間の下限",
"context": "ndf-cross-refactoring",
"meaning": "着手前のテストの実測から求める、手順の枠と計画の後の見込みが収まる想定最大時間の最小値(分)。init が「--budget-minutes を N 以上に」と案内する N",
"code": "required_budget_minutes",
"source": "",
"pending_source": "issues/issue-2047-requirements.md"
},
{
"term": "着手前のテストの初回の上限",
"context": "ndf-cross-refactoring",
"meaning": "同じ範囲の打ち切りと実測が配分の履歴に無いときの、着手前のテストの上限(秒)。max(0.10·B, 3·s) で、s は手元の全体テストの直近の実測 m → 宣言の w の順に採る(どちらも無ければ 0.10·B)",
"source": "",
"pending_source": "issues/issue-2047-design.md"
},
{
"term": "想定最大時間の出所",
"context": "ndf-cross-refactoring",
"meaning": "その実行の想定最大時間をどこから決めたか。explicit(引数か宣言で渡した)・default(省いて既定の 30 分を使った)・floor(省いて想定最大時間の下限まで上げた)の 3 つ",
"code": "budget_source",
"source": "",
"pending_source": "issues/issue-2047-design.md"
},
{
"term": "時間の枠の不足",
"context": "ndf-cross-refactoring",
"meaning": "着手前のテストが上限で打ち切られたか、明示した想定最大時間が想定最大時間の下限に届かないこと。init は SKIP を出して止まり、駆動はリファクタリングを飛ばした欠けの残る結果を返す",
"source": "",
"pending_source": "issues/issue-2047-design.md"
},
{
"term": "手順の枠",
"context": "ndf-cross-refactoring",
Expand All @@ -3448,8 +3478,9 @@
{
"term": "範囲テストの所要",
"context": "ndf-cross-refactoring",
"meaning": "CI に任せる戦略で、着手前に走らせる範囲テストの所要の見込み(秒)。同じ範囲の履歴の実測か、範囲が全体テストの suite のパスを覆うときの w",
"source": ""
"meaning": "CI に任せる戦略で、着手前に走らせる範囲テストの所要の見込み(秒)。同じ範囲の履歴の実測 → 手元の全体テストの直近の実測 m → 宣言の w の順に採る",
"source": "",
"pending_source": "issues/issue-2047-design.md"
},
{
"term": "gws",
Expand Down Expand Up @@ -4593,6 +4624,13 @@
"code": "gaps",
"source": "docs/specifications/ndf-step-result-gaps-and-reading.md"
},
{
"term": "ステップの延長",
"context": "ndf-workflow",
"meaning": "drive のステップの子孫(駆動と、駆動が起動した init)が自分の見込みの秒を延長のファイル(NDF_STEP_EXTEND_FILE の指すパス)へ書き、エンジンがその試行の締め切りを with_margin を足して後ろへずらすこと。前へはずらさない",
"source": "",
"pending_source": "issues/issue-2047-design.md"
},
{
"term": "過程の項目",
"context": "ndf-workflow",
Expand Down
Loading
Loading