Agent OS
A plain-files operating layer for agents and LLM tools.
First Read
- Read
identity.mdfor owner preferences, hard limits, and communication style. - Read
brain.mdfor stable infrastructure and project facts. - Read
memory/active-projects.mdfor current work. - Read
memory/constraints.mdfor non-negotiable safety rules. - Read
CLAUDE.mdfor runtime conventions and project status.
Runtime Contract
- Runtime root:
/opt/agent-os/ - Machine-readable agent status:
/opt/agent-os/logs/<agent>/last-run.json - Human-readable agent output:
/opt/sites/<short-name>/last-output.md - Credentials: reference the approved secret store only; do not write secret values into this repo.
Directory Layout
| Path | Purpose |
|---|---|
identity.md |
Owner profile, communication preferences, hard limits |
brain.md |
Stable facts, services, hosts, ports, standing decisions |
memory/ |
Persistent and recent working memory |
context/ |
Dated task-specific working notes |
skills/ |
Repeatable workflows and skill learnings |
logs/ |
Generated runtime status output, ignored by Git |
This bundle is generic. Replace placeholders before trusting an agent to act.