01 ディレクトリ設計 — SSOT vaultの階層構造

各ディレクトリに「役割」を持たせ、情報を迷わず格納できる構造を作る

ディレクトリ構造

ssot-vault/
├── 00_SYSTEM/           ← 🏛️ 憲法・自動化・設定
│   ├── 共通ルール/       ← 全プロジェクト共通の開発ルール
│   ├── 開発手法カタログ/ ← TDD・BDD・DDD等のレシピ
│   ├── プロフィール/     ← AIへの自己紹介
│   └── チャーター.md    ← vaultの憲法（変更不可）
│
├── 01_DECISIONS/        ← 📋 プロジェクト別決定ログ
│   ├── project-a/
│   │   ├── _INDEX.md    ← このプロジェクトの索引
│   │   └── YYYY-MM-DD_<内容>.md
│   └── project-b/
│
├── 10_DAILY/            ← 📅 日次セッション日記（ハブ）
│   └── YYYY-MM-DD.md    ← サマリー + 01_DECISIONSへのリンク
│
├── 20_PUBLISHING/       ← 📤 外部公開コンテンツ
│   └── _INDEX.md
│
├── 30_RESEARCH/         ← 🔬 外部調査結果
│   └── llm-models/      ← LLMベンチマーク・料金
│
├── 40_CAREER/           ← 💼 キャリア戦略
│   └── 01_ドキュメント/
│
├── 50_PROJECTS/         ← 📂 プロジェクト別作業ファイル
│
└── 70_PROMPTS/          ← 📝 自分用プロンプト集（music/coding/business）
    ├── music/           ← 楽曲制作系（make-song/sangoku/cyber-wa）
    ├── coding/          ← コードレビュー・リファクタ指示
    └── business/        ← ビジネス・文面テンプレ

各ディレクトリの責務

00_SYSTEM — 憲法・設定・ルール

役割: 「変わらない」または「ゆっくり変わる」ルールを格納

チャーター.md: vault全体の基本方針（ユーザーのみ変更可）
共通ルール/ルール.md: Tier 1キーワード・禁止操作・ログ形式
MCPツール使い分けガイド.md: どのMCPをいつ使うか
自動化.md: Hooks・Cronの一覧

ポイント: Claude Codeは CLAUDE.md から 00_SYSTEM/ へのリンクを通じてルールを読む

01_DECISIONS — 決定ログ

役割: 「なぜそうしたか」の変遷を記録

01_DECISIONS/
└── project-a/
    ├── _INDEX.md                           ← 決定一覧（索引）
    ├── 2026-01-15_データベース選定.md      ← 判断理由を記録
    └── 2026-02-20_API設計変更.md           ← 変更の経緯

ファイル名規則: YYYY-MM-DD_<内容>.md

記載内容:

何を決めたか（結論）
なぜその選択をしたか（理由・トレードオフ）
代替案と却下理由
実際に実装したコード・コマンド

10_DAILY — セッション日記（ハブ）

役割: 「今日何をしたか」のサマリーと01_DECISIONSへのリンク

## セッションログ (14:30)
- データベース移行スクリプトを実装
- バグ修正: NULL制約エラー対応
- 詳細: 01_DECISIONS/project-a/2026-05-31_db-migration.md
- 未解決: ステージング環境での検証が必要

重要: 日記には詳細を直書きしない。技術詳細は 01_DECISIONS/ に書き、日記はリンクのみ。

20_PUBLISHING — 外部公開コンテンツ

役割: Zenn・note・Qiita等への投稿を一元管理

下書き〜公開済みのステータス管理
_INDEX.md で全記事の状況を把握

30_RESEARCH — 外部調査結果

役割: LLMの知識カットオフ後の情報を補完

LLMモデルのベンチマーク・料金（週次更新）
特定ライブラリのAPI変更情報

70_PROMPTS — 自分用プロンプト集

役割: 生成AIに使い回す定型プロンプトの保管庫（music/coding/business）

01_DECISIONS/（意思決定の履歴）と区別:

履歴 = 過去を振り返る（日付必須・追記のみ）
プロンプト = 未来の作業で検索して即・使う素材（改良可・日付任意）

混ぜると両方の検索性が落ちるため分離。

ファイル命名規則

場所	規則	例
`01_DECISIONS/<project>/`	`YYYY-MM-DD_<内容>.md`	`2026-05-31_add-auth.md`
`10_DAILY/`	`YYYY-MM-DD.md`	`2026-05-31.md`
`30_RESEARCH/models/`	`<vendor-series>.md`	`anthropic-claude.md`

MOC（Map of Content）

大きなvaultでは MOC を作ると迷わない。

00_SYSTEM/全体マップ_MOC.md は全トピックへの入口:

テーブル形式でトピック → ファイルパスをリスト
セッション開始時にClaude Codeが自動読み込み
新しいトピックを追加したら必ずMOCにも追記

チャーター（憲法）

チャーター.md はvaultの基本方針を記述した特別なファイル:

変更権限: ユーザーのみ（AIエージェントは変更不可）
内容: 何のためのvaultか、何を格納し何を格納しないか
参照タイミング: ポリシーが不明な時、自動で参照される

# チャーター

このvaultはAIエージェントと人間の協働を支援するSSOTです。

## 基本方針
- 全ての技術決定はここに記録される
- 個人情報は格納しない
- 公開/非公開の区別を明確にする