docs: ドキュメント配置ルール(SSOT)確立
## 追加内容 - CLAUDE.md にドキュメント配置ルール(SSOT)セクション追加 - DOCS_LAYOUT.md (SSOT): 置き場所ルール定義 - phases/README.md: Phase ドキュメント説明 - design/README.md: 設計図ドキュメント説明 - investigations/README.md: 調査ログ説明 ## ルール概要 1. **Phase 文書** → phases/phase-<N>/ 2. **設計図** → design/ 3. **調査ログ** → investigations/ (結論を 10-Now/20-Decisions に反映) ## 導線 - CLAUDE.md で概要説明 - DOCS_LAYOUT.md で詳細定義(SSOT) - 各フォルダ README で参照方法 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
This commit is contained in:
10
AGENTS.md
10
AGENTS.md
@ -216,6 +216,16 @@ fn check_layer_boundary() {
|
||||
3. テストを書く
|
||||
4. 最後に実装
|
||||
|
||||
### 7.1 docs 置き場所 SSOT(迷子防止)
|
||||
|
||||
`docs/development/current/` は文書が増えやすいので、**入口/設計図/Phaseログ/調査ログを混ぜない**運用を必須にするよ。
|
||||
|
||||
- SSOT: `docs/development/current/main/DOCS_LAYOUT.md`
|
||||
- 追加ルール(最小):
|
||||
- 新しい Phase 文書は `docs/development/current/main/phases/` 配下に置く(`main/` 直下に増やさない)
|
||||
- 長期参照の設計図は `docs/development/current/main/design/` に置く
|
||||
- 切り分けログは `docs/development/current/main/investigations/` に置き、結論だけ `10-Now.md` / `20-Decisions.md` に反映する
|
||||
|
||||
---
|
||||
|
||||
**Fail-Fast原則**: フォールバック処理は原則禁止。過去に分岐ミスでエラー発見が遅れた経験から、エラーは早期に明示的に失敗させること。特にChatGPTが入れがちなフォールバック処理には要注意だよ!
|
||||
|
||||
Reference in New Issue
Block a user