Contract for reviewing and promoting durable agent memory into canonical documentation.

MemoryCandidate v1

Zod schema: MemoryCandidateV1Schema in @agentskit/doc-bridge.

Portable JSON Schema export: MemoryCandidateV1JsonSchema.

This is the normalized shape for memory ingestion. The core ships deterministic local ingest for Cursor rules and .agent-memory/**/*.md, classification into agent | human | playbook | discard, safety scanning, draft generation, and an optional GitHub draft PR flow.

ak-docs memory ingest
ak-docs memory classify
ak-docs memory promote --pr --dry-run

Shape

{
  "schemaVersion": 1,
  "id": "auth-abort-signal",
  "source": "agent-memory",
  "rawPath": ".agent-memory/auth.md",
  "fact": "Auth handlers must forward AbortSignal.",
  "why": "Run cancellation must stop network work.",
  "howToApply": "Use AbortSignal.any([caller, AbortSignal.timeout(ms)]).",
  "suggestedType": "project",
  "confidence": 0.8,
  "references": ["docs/for-agents/auth.md"]
}

Validation

import { parseMemoryCandidate } from '@agentskit/doc-bridge'

const candidate = parseMemoryCandidate(JSON.parse(raw))

MemoryCandidate v1

Shape

Validation

Build the agent. Then take it all the way.

On this page