Workspace structure
An Agentic OS workspace is a normal folder with a clear layout.
An Agentic OS workspace is a normal folder with a clear layout.
Root files
| Path | Purpose |
|---|---|
AGENTS.md | Shared instructions for AI tools that read Agentic OS rules. |
CLAUDE.md | Claude Code wrapper that imports AGENTS.md. |
CLAUDE.local.md | Optional local Claude Code rules that updates leave alone. |
.env | Local secrets and API keys. Do not commit this file. |
.mcp.json | Local MCP tool configuration when used. Do not commit private values. |
.claude/settings.json | Shared Claude Code settings managed by Agentic OS. |
.claude/settings.local.json | Personal Claude Code settings that updates leave alone. |
VERSION | Installed Agentic OS version. |
Main folders
| Path | Purpose |
|---|---|
brand_context/ | Brand voice, positioning, ideal customer profile, and related files. |
context/ | Shared memory source files, user profile, learnings, and session context. |
clients/ | Client workspaces. Each client can have its own context and outputs. |
projects/ | Generated project work and deliverables. |
cron/ | Scheduled job definitions, logs, and status files. |
scripts/ | Install, update, memory, skill, client, and runtime scripts. |
command-centre/ | Local UI and runtime app. |
.command-centre/ | Local runtime state, caches, memory store, and app data. |
.backup/ | Backups created before an update changes protected files. |
Shared instructions
AGENTS.md is the canonical shared instruction file.
Claude Code still needs CLAUDE.md, so Agentic OS keeps CLAUDE.md as a thin
wrapper. The wrapper imports AGENTS.md.
This keeps shared methodology in one place while keeping Claude Code compatible.
Existing work
Your old projects do not need a new structure.
Move existing project folders into projects/. Keep their files and folders as
they are.
Then add a short note in CLAUDE.local.md that tells Claude Code where the
work lives and what it contains.
Use the local file for this note because base CLAUDE.md is refreshed by
updates.
Data safety
Agentic OS updates are designed to preserve user data.
The root workspace keeps your local .env, brand context, memory source files,
projects, clients, scheduled jobs, and local settings.
Client workspaces keep their own context, brand data, memory, projects, cron
jobs, local settings, client-only skills, and SKILL.local.md overrides.
Read Updating Agentic OS for the full protected file list.
Next: Custom edits