成果物格納ルール・Issue索引ルール
対象: knowledge/projects/wasa_kisaka/
1. 保存先フォルダ構成
knowledge/projects/wasa_kisaka/
├─ governance/ # ルール文書
├─ templates/ # テンプレート
├─ index/
│ ├─ issue-index.md # 全Issue横断索引
│ └─ by-issue/
│ └─ issue-<番号>.md # Issue単位索引
└─ deliverables/
└─ issue-<番号>-<slug>/
├─ YYYYMMDD_<type>_<title>_vNN.md
├─ assets/
└─ refs.md
2. 命名規則
2.1 フォルダ名
- Issue単位:
issue-<番号>-<slug> <slug>は英小文字・数字・ハイフンのみ- 例:
issue-142-storage-index-rule
2.2 ファイル名
YYYYMMDD_<type>_<title>_vNN.<ext>
YYYYMMDD: JST基準の日付(8桁)type:rule/index/report/memo/datatitle: 英小文字・数字・ハイフンvNN: 2桁連番(v01開始)
例: 20260501_rule_storage-and-indexing_v01.md
2.3 版数ルール
- 同日修正でも内容差分があれば
vNNを増加 - 破壊的改訂は新規版として保存し、旧版は保持
3. Issueリンク索引ルール
3.1 最低記録項目
- Issue番号 / タイトル / URL
- 状態(Todo/In Progress/Done)
- 親子関係(親Issue、連動Issue)
- 関連成果物パス
- 最終更新日(JST)
3.2 更新タイミング
- Issue着手時:
index/by-issue/issue-<番号>.mdを作成 - 成果物追加時: 参照パスを追記
- クローズ時: 状態更新 + 残課題明記
4. 運用ルール
- 生成AI中間出力は
deliverables/.../assets/に格納 - 最終成果物のみ
deliverables/.../直下に配置 - 外部参照リンクは
refs.mdに集約
5. 適用開始
- 適用日: 2026-05-01
- 初回適用Issue: #142