03 SSOT
SSOT関連スキルと特性カタログ
SSOTレコード
「記録して」「保存して」と言うだけでSSOTへの記録・振り分け・ガイド転記まで自動化されるスキル。
トリガーワード
- 「記録して」
- 「保存して」
- 「メモして」
- 「SSOTに入れて」
- 「ガイドに追加して」
/ssot-record
フロー
「記録して」と言う
↓
GLMが内容を分析して振り分け先を判定
↓
📋 判定結果を一画面で提示(転記先も含む)
↓
「yes」で承認
↓
SSOTファイル作成 → _INDEX.md追記 → 日記追記 → ガイド転記 → push
判定結果の画面例
📋 記録先の判定結果
📁 メイン: 01_DECISIONS/ssot-guide/2026-05-31_テスト構成.md
📅 日記追記: あり(10_DAILY/2026-05-31.md)
📖 ガイド転記: あり → ssot-guide「09_ガイドサイト構築.md」
└ 追記内容: test_convert.pyの9クラス構成・テスト保護パターン
🏷️ タグ: #テスト #品質管理
この振り分けでよいですか?[yes/修正指示]
「yes」と答えるだけで、ファイル作成・日記追記・ガイド転記・pushまで一括実行される。
実装詳細
ssot-recordスキルは ~/.claude/skills/ssot-record/ にあり、以下を担当する:
- 判定: 内容の機密レベル・想定寿命・削除可能性・検索優先度に基づく保管場所判定
- 転記: 適切なSSOTフォルダへのファイル生成
- 連携:
_INDEX.md更新・日記追記・ガイド転記 - 記録: プロジェクト固有の記録フォルダ(例:
01_DECISIONS/<project>/)
詳細: ~/.claude/skills/ssot-record/SKILL.md
SSOT Search
SSOTを横断検索するスキル。
トリガーワード
- 「SSOTから探して」
- 「SSOT検索」
- 「SSOTで検索」
- 「ナレッジベースを検索」
- 「過去の決定を探して」
/ssot-search
検索対象
ssot-searchは以下を検索できる:
- 01_DECISIONS: 決定ログ・技術詳細
- 10_DAILY: 日次サマリー・セッションログ
- 00_SYSTEM: 全体マップ・共通ルール・自動化・設定
- 30_RESEARCH: 参考資料・調査結果
- バックログ: 未完了タスク・WIP構想
検索例
「過去の決定を見たい」
→ 01_DECISIONS/ssot-guide配下の決定ログをタイトル・内容で全文検索
「今日何をしたか確認したい」
→ 10_DAILY/2026-07-12.mdのセッションログを検索
「バックログで未完了タスクを確認」
→ 00_SYSTEM/バックログ.mdの未完了タスクを抽出
SSOTチェック
SSOTと実際のファイル/設定の整合性をチェックし、乖離があれば修正するスキル。
トリガーワード
- 「SSOT整合性チェックして」
- 「SSOT整理して」
- 「SSOT同期して」
- 「SSOTのズレを直して」
- 「00_SYSTEM更新して」
- 「乖離を修正して」
/ssot-check
チェック対象
| 対象 | 内容 |
|---|---|
00_SYSTEM/自動化.md |
hooks/cron/スクリプトの記載漏れ |
00_SYSTEM/repo-index.yaml |
リポジトリ数・visibility・last_updated |
00_SYSTEM/MCPツール使い分けガイド.md |
有効サーバー数 |
00_SYSTEM/全体マップ_MOC.md |
リポジトリ数・プロジェクト一覧 |
00_SYSTEM/チャーター.md |
禁止操作リスト |
乖離パターン
SSOTの記述は実態の変更に追従しきれず、以下の乖離が蓄積する:
- 設計変更後の記述未更新: 例: MCPのプロファイル分離で帰属だけが古いまま
- リポジトリ追加時のindex未追記: 新しいプロジェクトを追加してもrepo-index.yamlが更新されない
- Cron実体の増減と記述のズレ: ゴーストCron(記載のみで実体なし)や消失したCronの残骸
定期運用
- 自動修正: 月金の
ssot-sync auto(高重要度のみ自動修正) - 対話検証: sentaku L2で実測ベースの検証(表層の数だけでなく実態を計測)
特性カタログ
SSOTの9つの保管場所の分類基準。
保管場所構成
| 場所 | 機密レベル | 想定寿命 | 削除可能性 | 検索優先度 | 用途 |
|---|---|---|---|---|---|
| ⭐ 00_SYSTEM/ | 高 | 長期(基本永続) | 困難(全体マップ) | 中 | 最重要:全体マップ・共通ルール・自動化・設定の正典(禁止操作リスト・Hook設定含む) |
| 01_DECISIONS/<project> | 高 | 長期(数ヶ月〜1年) | 困難(履歴付き) | 高 | 決定ログ・技術詳細・なぜそうしたか |
| 10_DAILY/YYYY-MM-DD | 中 | 短期(数日〜1週間) | 容易(日次ローテーション) | 中 | 日次サマリー・セッションログ |
| 30_RESEARCH/ | 中 | 中期(数週間〜1ヶ月) | 中等 | 低〜中 | 参考資料・調査結果・調査プロセス |
| バックログ.md | 中 | 中期(プロジェクト期間) | 中等 | 中 | 未完了タスク・WIP構想・作業管理 |
| 20_PUBLISHING/ | 高 | 短期(公開期間限定) | 容易(公開終了後) | 低 | 外部公開コンテンツ・記事下書き |
| プロジェクト固有フォルダ | プロジェクト依存 | 短期〜中期 | 中等 | 低〜中 | プロジェクト固有のドキュメント |
| メモリ | 高 | 短期(セッション期間) | 即時 | 高 | セッション中のコンテキスト・一時情報(APIキー等機密含む可能性) |
| feedback_*.md | 低 | 中期 | 中等 | 低〜中 | ユーザー指摘・好みのパターン |
判定基準
保管場所の決定基準:
- 機密レベル: 外部公開可否
- 想定寿命: 将来の参照頻度
- 削除可能性: 定期的な整理が必要か
- 検索優先度: よく検索する内容か
用途に応じた振り分け:
- 「なぜそう決めたか」 →
01_DECISIONS/ - 「今日何をしたか」 →
10_DAILY/ - 「全体像」 →
00_SYSTEM/ - 「調査内容」 →
30_RESEARCH/ - 「やるべきこと」 →
バックログ.md - 「外部公開」 →
20_PUBLISHING/
詳細は 00_SYSTEM/特性カタログ/01_保管場所.md を参照。