docs: 保留課題をbacklogへ分離し、運用ルール5を追加

未確認事項が「現在の仕様が答えに依存するもの」と「答えが出なくても進められる
もの」を混ぜて抱えていた。後者を backlog/README.md へ移し、仕様書の未確認事項を
前者だけに絞る。移す際は保留中の対応範囲・暫定仕様を仕様書本文に明記し、
backlogへの移動が仮説の採用を意味しないようにする。

PHY・ELC・IDXの10件を移し、3ファイルとも未確認事項が空になった。
ルール4では、事実確認の「格上げ条件」と意思決定の「完了条件」を区別する。
仕様書側の保留課題はbacklogの区分へのリンク箇条書きだけに固定し、
末尾は保留課題 → 検討済み・非採用 → 未確認事項の順に置く。

doc-lintをルール5に対応させ、backlogを検査対象に加えた。回帰テストを追加。

Journal: journal/2026-09-22-document-backlog.md

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DKW58HEg8zAQoLrkWByPfD
This commit is contained in:
2026-09-22 19:52:39 +09:00
co-authored by Claude Opus 5
parent 66a594a378
commit 5b671976d5
10 changed files with 535 additions and 102 deletions
+8 -8
View File
@@ -83,6 +83,9 @@ QとAは共通キー、バックスラッシュと `#` は排他キーとする
全体の並びは `Q → バックスラッシュ → A → #`、ANSI出力は `Q → バックスラッシュ → A`、
ISO出力は `Q → A → #` になる。
既存コミュニティレイアウトとの互換出力は、要求順を再現できることを確認したものを対象とする。
単一の `order` で既存レイアウト全般を再現できることは、現行仕様の前提にしない。
## 他レイヤーとの関係
IDXはPHYのキーIDだけを参照する。ELCを参照しない。
@@ -118,6 +121,10 @@ type IDX = {
出力番号の対象は `order` に挙げたキーに限る。PHYの部品ノードと `decal` のキーは対象にならない。
## 保留課題
- [IDXの保留課題](backlog/README.md#idx)
## 検討済み・非採用
- PHYのツリー順をキー番号とする (journal/2026-09-21-idx-necessity.md)
@@ -128,11 +135,4 @@ type IDX = {
## 未確認事項
### P-1 単一のorderから既存コミュニティレイアウトの並びを得られる範囲
- 位置づけ: 本文「レイアウトバリアント」の方式を、既存レイアウトとの互換出力に使う際の未検証部分
- 現状の認識: 同じ配線を使う別のPHYキーを別々の位置に置けるため、本文のANSI/ISO例は取捨で表せる。
既存のコミュニティレイアウト全般で同じように表せるかは未検証。同じPHYキーIDを使う共通キー同士の
要求順がレイアウト間で逆転する場合は、単一のorderからの取捨では表せないが、その実例の有無は未確認
- 格上げ条件: 実データのキーを共通キーとバリアント別のPHYキーに対応づけ、全体のorderから各レイアウトの
要求順を取捨で再現できるか確認する。再現できないものが残る場合は、対応範囲と扱いを決める
(なし)