Skip to content

docs: ADR の決定文を部品名に依存させない規範を README へ移す #39

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
shnakatani merged 1 commit into from
Sep 20, 2026
Merged

docs: ADR の決定文を部品名に依存させない規範を README へ移す #39

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
1 change: 1 addition & 0 deletions docs/decisions/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -70,5 +70,6 @@
### 記述ルール

- 主張は実コード・実測で裏づける。コード参照は `src/path/to/file.ts` のようにファイルパスで書き、半年後も追える形にする
- 決定の文そのものを個別の部品名に依存させない。部品は改名されるが ADR は凍結されるので、決定が宙に浮く。根拠としてのファイルパス参照は上のとおり書いてよい
- 指示語（「本 PR」「今回の」）・チャット内画像参照（`[Image #N]`）を書かない。相対日付は絶対日付（`YYYY-MM-DD`）に変換する（`.claude/rules/doc-hygiene.md`）
- 外部料金・ライブラリ仕様など変動する数値は、前提条件と確認時点を明記し、可能なら出典 URL を「出典」セクションに置く
Loading