Context
- 判断・参考・雑記を同じ場所に混ぜると腐る
- 「仕様書との違い」を明確にしないと境界がぶれる
Options
| 案 | 混在防止 | 運用容易性 | 合計 |
|---|
| 全部混ぜる(Baseline) | 0 | 0 | 0 |
| 完全分離(サイト分離) | ++ | — | 0 |
| 種別ごとに格納場所分離 | + | + | +2 |
Decision
分類を採用し、格納場所を分離する。
| 種別 | 用途 | 格納 |
|---|
| Decision | 判断記録 | decisions/ |
| Reference | 技術分析 | references/ |
| Log | 生ボイス | logs/ |
| Backlog | やる/やらない | GitHub Issues |
Rationale
- 仕様は書かない: プロジェクト固有情報は各プロジェクトの
docs/ に置く
- 境界の目安: プロジェクト名を消して意味が通るなら判断、通らないなら仕様
- Backlog を Issues に外部化するのは既存パターン優先(2026-09-20-existing-framework-priority)
Consequences
- Positive: 種別ごとに独立した運用ルールを決められる
- Negative: 記事作成時に種別判断が必要(迷ったら Log)
- Follow-up: 更新方式は 2026-09-20-update-workflow
Update (2026-09-20)
Page 種別を追加し、5分類に拡張。詳細は 2026-09-20-page-type-addition 参照。
| 種別 | 用途 | 格納 |
|---|
| Decision | 判断記録 | decisions/ |
| Reference | 技術分析 | references/ |
| Page | 独立静的ページ | pages/ |
| Log | 生ボイス・雑記 | logs/ |
| Backlog | やる/やらない | GitHub Issues |