dreaming について
dreamingは、プロジェクトのメモリーコーパスを保守するスキルです。エージェントのメモリーを正確で関連付けられた状態に保ちたいチーム向けに、変更箇所単位または全体で検証、整理、リンク、事実確認、引き継ぎ報告を行います。
主な機能
- 01メモリーを検証し、指摘を分類
- 02古い、または未検証のメモリーをアーカイブ
- 03孤立した記録を見つけてリンクを強化
- 04保留事項をバックログ項目に整理
- 05優先度の高いメモリーを事実確認
- 06保守作業とフォローアップを報告
活用シーン
- 01コードパスやコマンドの変更後に関連メモリーを更新
- 02定期的なプロジェクトメモリーコーパスの整理
- 03引き継ぎ前にメモリーを確認し未解決事項を記録
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ davidlee/ doctrine --skill dreamingインストール後、Claude Code で/dreamingを入力して読み込まれたか確認します。
詳細
夢見る
記憶は薄れていきます。ファイルは移動し、コマンドは変わり、不変条件は変化し、重複が蓄積します。このスキルは、どちらの方向からでも開始できる、コーパスの信頼性を保つためのメンテナンスループです。
リアクティブな開始。 何かが変わりました。ファイル名が変更された、コマンドのフラグが削除された、ADRによってサブシステムの境界が変わった、コードレビューで古いパスを参照する古い記憶が見つかったなどです。影響を受ける領域に範囲を絞って手順を実行します。
プロアクティブな開始。 空き時間、作業範囲の終了時のまとめ、または予定されたメンテナンス時間です。コーパス全体を対象に手順を実行します。
手順
-
検証。 コーパス全体に対して
doctrine memory validateを実行します(リアクティブな場合は、変更箇所に--path-scope/--globで範囲を絞ります)。各指摘をトリアージします。- 簡単な場合はすぐに修正します(パスの更新、スコープの見直しなど)
- 簡単でない場合はバックログ項目として記録します(リスク、雑務、改善など)
- 影響が小さく、時間的制約がない場合は記録して後回しにします
-
整理。 古くなった記憶を特定します。
review_byの日付を過ぎている → レビュー対象としてマークするか、アーカイブします- 有効期限を過ぎた未検証のスレッド → アーカイブします(
memory status <REF> archived) - 数日前より古い
working寿命の記憶 → 撤回するか、永続性のあるタイプに昇格させます - 古くなった項目には
doctrine memory status <REF> archivedを実行します。単に誤っていた記憶にはretractedを使います。
-
リンク。 グラフを強化します。
- 最近記録または編集された記憶の推奨リレーションを確認します(リレーションの行は
memory show <REF>で確認できます) - 孤立した記憶を確認します。これは、インバウンドとアウトバウンドのリレーションがない記憶です。
memory list --orphans - 孤立した記憶があれば、それらを優先します。今回の実行で20~30件の記録をリンクします
- 孤立した記憶がなければ、コーパスを調べ、既存の記憶間のつながりを強化・整理します
memory search <keyword>を使ってリンク候補の記憶を探します。検索結果は1ページ分だけ返されるため、--limit/--pageを使って順に確認します
- 確度の高い一致には
doctrine linkを実行します
- 最近記録または編集された記憶の推奨リレーションを確認します(リレーションの行は
-
バックログの整理。 今回の作業で修正できない指摘は、バックログ項目にします。
- リスク:まだ表面化していない問題(例:非推奨のAPIを指す記憶)
- 雑務:クリーンアップ作業(例:重複した記憶の統合)
- 改善:機能強化(例:パターンの記憶を仕様に昇格)
-
ファクトチェック。 重大度 × 古さ(
updatedからの日数)で上位N件の記憶を抜き取り確認します。それぞれについて、次の作業を行います。- 引用された情報源(コードパス、ドキュメント、ADR)を現在のツリーと照合します
- 正しければ、対応は不要です
- ずれがあれば、
doctrine memory edit <REF>で修正します - 古くなっていれば、後継の記憶を指定して置き換える(
memory status <REF> superseded --by <SUCCESSOR>)か、隔離します(memory status <REF> quarantined) - 検証できない場合は、信頼度を下げます(
memory edit <REF> --trust low)
-
報告。 簡潔な引き継ぎサマリーを作成します。
- 実施した作業(検証 N 件、整理 M 件、リンク L 件、ファクトチェック F 件)
- バックログに回した指摘(登録した場合はIDも記載)
- 人による確認が必要な項目(重大度が高いもの、曖昧なもの、判断が必要なもの)
- 次のエージェントが同じ確認をやり直さずに済むよう、
notes.mdまたは現在の引き継ぎ資料に記録します。
コメント
Markdown 対応