puda-memory

Puda Memory

目標

各プロジェクトの情報源として project.md を維持します。プロトコルへのリンクと、実行を再現・監査できるようにする時系列の履歴を記録します。

重要：実行を再現・監査できるよう、プロジェクトに関連するすべての状態を永続化してください。

各プロジェクトフォルダーには、そのプロジェクトに関するすべての情報を長期記憶として記録する場所を project.md ひとつだけ設けます。以下のパスは、protocols/ を含むプロジェクトフォルダーからの相対パスです。

更新するタイミング

• プロトコルファイルの作成後
• プロトコルの更新後または新しいプロトコルの導出後
• プロトコルを実行するたび

project.md に記録する内容

• プロトコル：「Protocols」セクションに、protocols/ 内のプロトコルファイルへの明示的な Markdown リンクを記載します。それぞれを [<protocol_id>](protocols/<protocol_id>.json) の形式で列挙し、リンクの後に任意で短い説明を添えます（例：[<protocol_id>](protocols/<protocol_id>.json) — <summary>）。
• 履歴：ISO 8601 形式のタイムスタンプを付けた、操作の時系列ログです。実際のタイムスタンプを必ず使用してください。推測したり、プレースホルダーを使用したりしないでください。 タイムスタンプは該当するファイルから取得します。「ran」の項目ではログファイルの1行目から、「created」／「updated」の項目ではプロトコル JSON ファイルの timestamp キーから取得します。すべてのファイルパスには明示的な Markdown リンクを使用します。操作ごとに、次の形式で1行追記します。
  • <timestamp> created [<protocol_id>](protocols/<protocol_id>.json)
  • <timestamp> updated [<old_protocol_id>](protocols/<old_protocol_id>.json) to [<new_protocol_id>](protocols/<new_protocol_id>.json)
  • ` ran <protocol_id>