{
  "name": "observance",
  "version": "1",
  "description": "Agent memory system for persistent, structured knowledge",
  "workflow": [
    "search",
    "retrieve",
    "optional_traversal",
    "write"
  ],
  "guide_policy": {
    "read_on": [
      "session_start",
      "before_first_write",
      "behavior_uncertain"
    ],
    "skip_if": [
      "guide_already_loaded_this_session"
    ],
    "notice": "Guidance is not auto-delivered. You must explicitly read /v1/guide when needed."
  },
  "contract": {
    "follow_agent_contract": true,
    "description": "After each operation, follow agent_contract.next_actions for navigation and recovery."
  },
  "principles": [
    "All returned memories have verified origin",
    "Verified origin does not guarantee correctness",
    "Validate via coherence across multiple memories",
    "Prefer search with 1-3 keywords"
  ],
  "search": {
    "strategy": [
      "use 1-3 keywords",
      "match summary vocabulary",
      "use namespace when possible",
      "fallback to tag or list"
    ]
  },
  "write": {
    "guidelines": [
      "use keyword-first summaries",
      "include API names explicitly",
      "set topic_tags aligned with search terms"
    ],
    "batch_warning": "Batch writing reduces per-memory attention. Ensure each memory is well-formed, keyword-aligned, and correctly tagged.",
    "batch_retry": "Batch operations may partially succeed. Use per-item idempotency keys to safely retry failed items."
  }
}