mcpField
D
dreaming

dreaming

github.com/davidleeエージェントワークフロー2135 回インストール4 日前に更新
リポジトリ

dreaming について

dreamingは、プロジェクトのメモリーコーパスを保守するスキルです。エージェントのメモリーを正確で関連付けられた状態に保ちたいチーム向けに、変更箇所単位または全体で検証、整理、リンク、事実確認、引き継ぎ報告を行います。

主な機能

  1. 01メモリーを検証し、指摘を分類
  2. 02古い、または未検証のメモリーをアーカイブ
  3. 03孤立した記録を見つけてリンクを強化
  4. 04保留事項をバックログ項目に整理
  5. 05優先度の高いメモリーを事実確認
  6. 06保守作業とフォローアップを報告

活用シーン

  1. 01コードパスやコマンドの変更後に関連メモリーを更新
  2. 02定期的なプロジェクトメモリーコーパスの整理
  3. 03引き継ぎ前にメモリーを確認し未解決事項を記録

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/davidlee/doctrine --skill dreaming

インストール後、Claude Code で/dreamingを入力して読み込まれたか確認します。

詳細

夢見る

記憶は薄れていきます。ファイルは移動し、コマンドは変わり、不変条件は変化し、重複が蓄積します。このスキルは、どちらの方向からでも開始できる、コーパスの信頼性を保つためのメンテナンスループです。

リアクティブな開始。 何かが変わりました。ファイル名が変更された、コマンドのフラグが削除された、ADRによってサブシステムの境界が変わった、コードレビューで古いパスを参照する古い記憶が見つかったなどです。影響を受ける領域に範囲を絞って手順を実行します。

プロアクティブな開始。 空き時間、作業範囲の終了時のまとめ、または予定されたメンテナンス時間です。コーパス全体を対象に手順を実行します。

手順

  1. 検証。 コーパス全体に対して doctrine memory validate を実行します(リアクティブな場合は、変更箇所に --path-scope/--glob で範囲を絞ります)。各指摘をトリアージします。

    • 簡単な場合はすぐに修正します(パスの更新、スコープの見直しなど)
    • 簡単でない場合はバックログ項目として記録します(リスク、雑務、改善など)
    • 影響が小さく、時間的制約がない場合は記録して後回しにします
  2. 整理。 古くなった記憶を特定します。

    • review_by の日付を過ぎている → レビュー対象としてマークするか、アーカイブします
    • 有効期限を過ぎた未検証のスレッド → アーカイブします(memory status <REF> archived)
    • 数日前より古い working 寿命の記憶 → 撤回するか、永続性のあるタイプに昇格させます
    • 古くなった項目には doctrine memory status <REF> archived を実行します。単に誤っていた記憶には retracted を使います。
  3. リンク。 グラフを強化します。

    • 最近記録または編集された記憶の推奨リレーションを確認します(リレーションの行は memory show <REF> で確認できます)
    • 孤立した記憶を確認します。これは、インバウンドとアウトバウンドのリレーションがない記憶です。 memory list --orphans
    • 孤立した記憶があれば、それらを優先します。今回の実行で20~30件の記録をリンクします
    • 孤立した記憶がなければ、コーパスを調べ、既存の記憶間のつながりを強化・整理します
      • memory search <keyword> を使ってリンク候補の記憶を探します。検索結果は1ページ分だけ返されるため、--limit/--page を使って順に確認します
    • 確度の高い一致には doctrine link を実行します
  4. バックログの整理。 今回の作業で修正できない指摘は、バックログ項目にします。

    • リスク:まだ表面化していない問題(例:非推奨のAPIを指す記憶)
    • 雑務:クリーンアップ作業(例:重複した記憶の統合)
    • 改善:機能強化(例:パターンの記憶を仕様に昇格)
  5. ファクトチェック。 重大度 × 古さ(updated からの日数)で上位N件の記憶を抜き取り確認します。それぞれについて、次の作業を行います。

    • 引用された情報源(コードパス、ドキュメント、ADR)を現在のツリーと照合します
    • 正しければ、対応は不要です
    • ずれがあれば、doctrine memory edit <REF> で修正します
    • 古くなっていれば、後継の記憶を指定して置き換える(memory status <REF> superseded --by <SUCCESSOR>)か、隔離します(memory status <REF> quarantined)
    • 検証できない場合は、信頼度を下げます(memory edit <REF> --trust low)
  6. 報告。 簡潔な引き継ぎサマリーを作成します。

    • 実施した作業(検証 N 件、整理 M 件、リンク L 件、ファクトチェック F 件)
    • バックログに回した指摘(登録した場合はIDも記載)
    • 人による確認が必要な項目(重大度が高いもの、曖昧なもの、判断が必要なもの)
    • 次のエージェントが同じ確認をやり直さずに済むよう、notes.md または現在の引き継ぎ資料に記録します。

コメント