# AgentMemory Contract

This repository's stable AgentMemory identity is stored in `.agentmemory-project`. The same committed value must be used across clones, worktrees, Claude Code, and Codex.

## Authority

Current Git, approved issues/specifications, repository documentation, and ADRs override recalled memory. The `workflow_status` slot is the current handoff checkpoint. Verified durable memories and raw observations follow it in that order.

## Active Checkpoint

Maintain exactly one project-scoped slot named `workflow_status`. Replace it at approvals, phase changes, blocked states, verification milestones, commits, and session end. Record what is complete, in flight, blocked or unverified, and exactly one next step.

## Durable Memory

Save approved architectural decisions, rejected alternatives, non-obvious constraints, verified recurring bug fixes, deployment or migration gotchas, important module relationships, and durable preferences. Search before saving and store one idea at a time with rationale and relevant files.

Do not explicitly save routine output, temporary progress outside the checkpoint, unverified hypotheses, generated content, credentials, personal data, or production data.

## Availability

If AgentMemory preflight fails, plan-build asks the interactive user to retry, continue in explicitly degraded mode, or stop. A non-interactive failure stops. Degraded sessions must report that previous context was not restored.