---
id: "action-create-markdown-os"
type: "action-item"
source_timestamps: ["00:06:37", "00:07:18"]
tags: ["system-architecture", "configuration"]
related: ["concept-markdown-as-agent-os", "framework-markdown-agent-os-architecture"]
speakers: ["Nate B. Jones"]
action: "Write explicit markdown files defining the agent's role, identity, user, and heartbeat."
outcome: "Provides the agent with the deep, durable context required to execute tasks autonomously and accurately."
sources: ["s08-real-problem-agents"]
sourceVaultSlug: "s08-real-problem-agents"
originDay: 8
---
# Create a Markdown OS for your agent

## Action

**Write explicit markdown files defining the agent's role, identity, user, and heartbeat.**

Translate the output of your [[action-run-interviewer-agent|expertise elicitation]] into a specific directory of plain-text markdown files. At minimum:

- `soul.md` — role and boundaries
- `identity.md` — personality
- `user.md` — your profile
- `heartbeat.md` — operational checklist

See [[framework-markdown-agent-os-architecture]] for the full schema.

## Outcome

Provides the agent with the deep, durable context required to execute tasks autonomously and accurately. Quality of these files determines agent quality (see [[claim-markdown-quality-determines-agent-quality]]).

## Pair with

[[action-implement-agent-memory]] for the dynamic learning layer.