memory-contract

Write structured memory entries with YAML frontmatter to agent-output/memory/.

Updated Jan 12, 2026
One-click install
npx skills add https://github.com/seanspiesman/Agents-and-Workflows --skill memory-contract-seanspiesman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: memory-contract
Source: https://github.com/seanspiesman/Agents-and-Workflows/tree/main/custom-agents/skills/memory-contract
Command: npx skills add https://github.com/seanspiesman/Agents-and-Workflows --skill memory-contract-seanspiesman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Project teams and AI agents often lose context between sessions. This skill defines a disciplined memory system that records decisions, constraints, and learnings in a centralized place to enable continuity and audits.

Core Features & Use Cases

  • Memory storage: Writes structured memory files under agent-output/memory/ with YAML frontmatter and markdown body.
  • Semantic retrieval: Supports searching and reading relevant memory entries to inform current decisions.
  • Guided workflow: Adheres to the store-before-reasoning and retrieve-before-action commitments to maintain traceability.

Quick Start

Create a memory entry describing a decision, constraint, or learning at the end of a task.

Frequently Asked Questions about memory-contract

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I persist project memory and context between AI agent sessions?

To persist project memory between AI agent sessions, you can use a structured memory system that writes decisions, constraints, and learnings to markdown files with YAML frontmatter under a centralized directory, ensuring long-term context continuity and traceability.

What is agent memory retrieval and how does it preserve project context?

Agent memory retrieval is the process of searching and reading structured memory entries to inform current decisions. It preserves project context by enforcing a retrieve-before-action commitment, allowing agents to access past learnings and constraints during active workflows.

Can I use markdown with YAML frontmatter to store structured agent memory?

Yes, you can use markdown with YAML frontmatter to store structured agent memory. This approach enforces consistent indexing and search by applying defined fields such as type, topic, status, and date directly within the memory file format.

When do I need to capture memory entries during project workflows?

You need to capture memory entries at specific decision points, constraints, and learnings within project workflows. Adhering to a store-before-reasoning commitment ensures that critical context is recorded immediately after a task is completed for future audits.

What's the best way to index AI agent memory files for auditing?

The best way to index AI agent memory files for auditing is to enforce a standardized file format using YAML frontmatter fields like type, topic, status, and date, which enables consistent semantic retrieval and search across all stored project memory entries.

Does this memory system require any external dependencies to manage project context?

No, this memory system requires no external dependencies to manage project context. It operates independently by writing structured markdown files with YAML frontmatter to a local directory, ensuring memory capture and retrieval works without additional software installations.