decisiondecided

記録の分類と境界定義

Context

  • 判断・参考・雑記を同じ場所に混ぜると腐る
  • 「仕様書との違い」を明確にしないと境界がぶれる

Options

案混在防止運用容易性合計
全部混ぜる(Baseline)000
完全分離(サイト分離)++—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