[takemi-ohama]

Pull Request

Summary

スプリント m10b（#450 でマージ済み）の確定仕様化。#435・#444 の要求・設計のうち確定仕様に未反映だったもの（決定の記録・補完の位置の規則・テスト観点）を確定仕様へ移し、issues/ の元 4 ファイルを消す。コードは変えない。

関連 Issue

• シェル補完が --context を open と post-start でしか出さない #435 PR #442 の構造改善で時間の枠を超えて見送った提案の残り 13 件（_aws_sync_plan の _SyncContext 化・env list / keygen の長い関数・テストの補助の重複） #444（いずれも スプリント m10b #450 で閉じ済み）

変更点

• cli-argument-resolution.md（シェル補完が --context を open と post-start でしか出さない #435）: 新しい節「補完が --context を出す位置」に、位置（道の直後・名前の直後・値・それより後ろ）ごとの bash / zsh の振る舞いと、実装の形（bash の _devbase_complete_flags と旗の候補・値の位置で先に終える段、zsh の _devbase_arguments <深さ>）を書いた。決定 11〜13（値を補完しない・名前の後で出す道の範囲・zsh で words を詰める理由）、テスト観点 3 項、関連リンクの実装 PR を足した
  • 設計と実装が違ったところは実装に合わせた: bash は設計の「共通の段で足す」ではなく分岐ごとの旗の候補の形、zsh は設計の *: ではなく _devbase_arguments で詰めて 1: を保つ形（スプリント m10b #450 のレビューで直した 54ed5bf）。設計の決定 5（余分も比べる）は一致テストに入っていないため書いていない
• post-start.md（PR #442 の構造改善で時間の枠を超えて見送った提案の残り 13 件（_aws_sync_plan の _SyncContext 化・env list / keygen の長い関数・テストの補助の重複） #444 決定 6）: _ComposeDeployment にまとめる 4 つの値と、indices・config・run_deploy を組に入れない理由を足した
• secret-backend.md（PR #442 の構造改善で時間の枠を超えて見送った提案の残り 13 件（_aws_sync_plan の _SyncContext 化・env list / keygen の長い関数・テストの補助の重複） #444 決定 4）: TUI の「使えないグループ名」の行に、検証が check_group_option の 1 か所にあり、TUI と CLI で文の接頭が分かれる理由を足した
• PR #442 の構造改善で時間の枠を超えて見送った提案の残り 13 件（_aws_sync_plan の _SyncContext 化・env list / keygen の長い関数・テストの補助の重複） #444 のほかの件（R1・R3・R4・R6〜R13）は振る舞いを変えない関数の分け方だけで、確定仕様に書くべき振る舞いが無い
• issues/issue-435-requirements.md・issue-435-design.md・issue-444-requirements.md・issue-444-design.md を削除

利用者向けの変化

• 無し

移行の手順

• 無し

Test plan

• env -u DEVBASE_ROOT uv run --locked pytest tests/ -q → exit=0（4141 passed, 20 skipped）
• uvx ruff check --select=E9,F63,F7,F82 lib → exit=0
• env -u DEVBASE_ROOT uv run --locked pytest tests/cli/test_name_context_consistency.py tests/cli/test_completion.py -q → 73 passed（確定仕様の表を読む一致テストを含む）
• python3 .github/scripts/proper_term_check.py → exit=0。ただし「語の一覧が無いため飛ばした」と出ており、検査はしていない

🤖 Generated with Claude Code

https://claude.ai/code/session_015XbbCFwDscRn71xF8sXn5z