From bc2d33f856447614648e5617a6e3af2fc71f0944 Mon Sep 17 00:00:00 2001 From: EwdErna Date: Tue, 22 Sep 2026 22:04:29 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9C=AC=E6=96=87=E3=81=8B=E3=82=89?= =?UTF-8?q?=E6=9C=AA=E7=A2=BA=E8=AA=8D=E4=BA=8B=E9=A0=85=E3=81=B8=E3=81=AE?= =?UTF-8?q?=E3=83=AA=E3=83=B3=E3=82=AF=E5=BD=A2=E5=BC=8F=E3=82=92=E9=81=8B?= =?UTF-8?q?=E7=94=A8=E3=83=AB=E3=83=BC=E3=83=AB4=E3=81=AB=E8=BF=BD?= =?UTF-8?q?=E5=8A=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 本文で「未決」とだけ書くと、末尾のどの項目に対応するか読む側が追えない。 同一ファイル内・他ファイルからのリンク形式を定め、問いの内容は `## 未確認事項` にだけ置いて二重管理を避ける。 Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_01MtVk8W4yK6j3eCqQpEQBLS --- CLAUDE.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 4058988..7c90971 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -69,6 +69,9 @@ PHY(物理配置) / ELC(電気配線) / IDX(キー識別) / MAP(キーマップ) - **現在の仕様・実装が答えに依存する未確認事項**は、仕様書の末尾に残す。2種類ある: - 本文が前提にしている推測 → 本文に `[推測:P-n]` を付け、末尾の `## 未確認事項` に対応項目を置く - 実装前に判断が必要な未解決の問い → 本文タグなしで `## 未確認事項` に直接置く +- 本文が未決の問いに触れるときは、「未決」と書いて終わらせず該当項目へリンクする。 + 同一ファイル内は `[P-3](#p-3-...)`、他ファイルからは `[MAPのP-3](MAPレイヤー.md#p-3-...)` の形とする。 + 問いの内容は `## 未確認事項` にだけ書き、本文へ写さない(二重管理を避ける)。 - 未確認の推測には、**何を確認できれば事実に格上げできるか**を「格上げ条件」として書く。 設計判断には、**何を決めれば解決するか**を「完了条件」として書く。意思決定を事実確認と混同しない。 - 答えに依存せず進められる課題は `backlog/` に置く(ルール5)。保留中の対応範囲・暫定仕様は仕様書に残す。