agent-template

A minimal, forkable workspace template for AI agent development. Defines the file structure and conventions used by Antfarm and other multi-agent systems.

What This Is

When building multi-agent workflows, each agent needs a consistent workspace with clear identity, instructions, and memory. This template provides that structure.

Fork it. Customize it. Use it as the foundation for every agent in your pipeline.

New here? Start with the Quickstart.

The Memory System

The MEMORY/ directory persists state across sessions. Each agent session starts fresh -- memory files bridge the gap.

• context.md -- Updated every session. "Where are we right now?"
• decisions.md -- Append-only log. "Why did we choose this approach?"
• lessons.md -- Append-only log. "What did we learn?"
• blockers.md -- Active list. "What is broken and how do we work around it?"

Usage with Antfarm

In Antfarm workflows, each agent gets its own copy of these files:

Customize AGENTS.md and SOUL.md for each role. The Planner has different instructions and personality than the Developer or Verifier.

Usage Standalone

Even without Antfarm, this pattern works for any AI agent:

• Fork this repo
• Customize the identity files for your agent's role
• Point your agent framework to read these files at session start
• Update MEMORY/ at the end of each session