digital-garden-cultivator

デジタルガーデンの育成

生きたナレッジベースとして、デジタルガーデンを設計、管理、発展させます。デジタルガーデンとは、完璧さよりも発展を重視し、有機的に成長する相互につながったノートのコレクションです。

概要

ナレッジマネジメントにデジタルガーデンのアプローチを取り入れ、次のことを実現します。

• 時間とともに発展する動的なナレッジベースを構築する
• 双方向リンクでノートをつなぐ
• アイデアを文書として正式にまとめる前に育てる
• 情報をたどるための発見経路を作成する
• コンテンツの成熟度とメンテナンスの必要性を追跡する

クイックスタート

ガーデンのメトリクスを計算する

python -m memory_palace.garden_metrics path/to/garden.json --format brief

確認： python --version を実行して、Python 環境を確認します。

出力形式

• json - すべてのメトリクスを JSON 形式で出力
• brief - 1 行の概要
• prometheus - Prometheus のエクスポジション形式

使用する場面

• 時間とともに発展する動的なナレッジベースを構築する
• 双方向リンクでノート、スキル、パレスをつなぐ
• アイデアを文書として正式にまとめる前に育てる
• 情報をたどるための発見経路を作成する
• コンテンツのライフサイクル（芽生え → 成長 → 常緑）を管理する

使用しない場面

• メモリーパレスの 構造を作成する場合 - memory-palace-architect を使用
• 新しい知識を評価する場合
  • knowledge-intake を使用
• メモリーパレスの 構造を作成する場合 - memory-palace-architect を使用
• 新しい知識を評価する場合
  • knowledge-intake を使用

コンテンツの成熟度レベル

レベル	状態	説明
芽生え	新規／粗削り	初期段階のアイデア、未完成の考え
成長	発展中	積極的に磨かれている状態
常緑	成熟	安定した、十分に練られたコンテンツ

基本的なワークフロー

1. ソースを収集する - ノート、ブックマーク、アイデアを集めます
2. 構造を計画する - ガーデンの構成を定義します
3. リンクを作成する - 双方向のつながりを構築します
4. メンテナンスを計画する - 手入れの頻度を決めます
5. 成果を文書化する - 成熟したアイデアを正式な文書にまとめます

ガーデンのレイアウトテンプレート

garden:
  sections: ["research", "patterns", "experiments"]
  plots:
    - name: "My First Note"
      purpose: "reference"  # reference | evergreen | lab
      maturity: "seedling"  # seedling | growing | evergreen
      inbound_links: []
      outbound_links: []
      last_tended: "2025-11-24T10:00:00Z"

確認： --help フラグを付けてコマンドを実行し、利用可能であることを確認します。

メンテナンス頻度

作業	頻度	目的
簡易整理	2 日ごと	無効なリンクを削除し、誤字を修正する
古いコンテンツの確認	7 日間非アクティブの後	コンテンツの鮮度を評価する
アーカイブ	30 日間非アクティブの後	アーカイブに移動するか、削除する

成功指標

• リンク密度 - コンテンツ 1 件あたりの平均リンク数
• 双方向リンクの網羅率 - 相互リンクになっているリンクの割合
• 鮮度 - 領域ごとの最終更新からの経過時間
• 成熟度比率 - 常緑コンテンツ数 / コンテンツ総数

詳細なリソース

• リンクパターン： modules/linking-patterns.md を参照してください
• メンテナンスガイド： modules/maintenance.md を参照してください
• メトリクスの統合： modules/maintenance.md を参照してください

統合

• memory-palace-architect - パレス構造内にガーデンを配置する
• knowledge-locator - ガーデンのコンテンツを検索する
• session-palace-builder - セッションの知見をもとにガーデンの種をまく

トラブルシューティング

よくある問題

コミット前フックが失敗する 一時的に回避するには SKIP=... git commit を実行し、その後問題を修正します

マージコンフリクト git merge --abort を使用してリセットし、その後慎重にコンフリクトを解決します

コミットが拒否される フックの出力を確認し、報告された問題を修正してから再度コミットします

完了条件

• python -m memory_palace.garden_metrics が対象の garden.json に対してエラーなく実行され、リンク密度、双方向リンクの網羅率、 鮮度、成熟度比率を出力する
• 7 日を超えて非アクティブな古いノートが特定され、 ユーザーが確認できるよう提示される
• 対象範囲内の各ノートに、次のいずれかの成熟度レベルが割り当てられている： seedling、growing、evergreen
• 無効なリンクと孤立したノートが報告され、メンテナンス時に整理するか 再接続できるようになっている
• garden.json が存在しないか、形式が不正な場合、処理を黙って完了するのではなく、 検索したパスとともにエラーが報告される