記憶 は何をしますか?
ファイルシステムベースの知識管理システム。ソースコードそのものが記憶媒体です。構造化マークダウンファイルに決定、パターン、コンテキストを保存します。
使用するタイミング
- アーキテクチャ上の決定を記録するとき
- 開発中に発見したパターンを文書化するとき
- 何かを特定の方法で構築した理由に関するコンテキストを保存するとき
- 既知の問題とその回避策を追跡するとき
- APIドキュメントや統合ノートを保存するとき
使用しないタイミング
- 一時的なデバッグ用メモ(代わりにコメントを使用)
- タスクの追跡(代わりにGit issueやプロジェクトボードを使用)
基本原則
- ソースコードが唯一の真実源である
- 知識はそれが使用される場所の近くに保存する
- 一貫性のために構造化マークダウンを使用する
- ファイルはフォーカスを絞る(トピックごとに1ファイル)
保存場所
| 種類 | 場所 | 例 |
|---|---|---|
| 技術ドキュメント | docs/technical/ | アーキテクチャ決定、パターン |
| 機能ドキュメント | docs/features/ | 機能仕様、要件 |
| APIドキュメント | docs/api/ | API契約、統合ノート |
記憶操作
覚える(書き込み)
新しい知識を保存する:
# [トピックタイトル]
## コンテキスト
[これが存在する理由、解決する問題]
## 決定
[何が決定され、なぜそうなったか]
## 詳細
[技術的詳細、コード例]
## 参照
- [関連ファイルやURL]
---
*作成日: [日付]*
*最終更新日: [日付]*
思い出す(読み取り)
知識を取得する:
docs/ディレクトリ構造を確認する- 関連ファイルを読む
- ドキュメント全体でキーワードを検索する
更新
既存の知識を変更する:
- 既存のファイルを読み込む
- 該当するセクションを更新する
- 重要な変更がある場合は進化履歴に追記する
関連スキル
| スキル | 連鎖するタイミング |
|---|---|
| feature-dev | 開発中にアーキテクチャ決定を保存するとき |
| planning | 将来の参照用に計画を文書化するとき |