| name | workspace-review |
| description | Audit workspace structure and memory files against OpenClaw conventions. Use when asked to "review workspace", "audit files", "check structure", or during periodic self-maintenance. Helps catch drift from standard patterns. |
Workspace Review
A self-audit process to verify workspace files follow OpenClaw conventions and haven't drifted into non-standard patterns.
When to Run
- Periodically (weekly or after major changes)
- When asked to "review", "audit", or "check" workspace
- After bootstrap or significant reorganization
- During heartbeat maintenance cycles
Review Process
1. Structure Check
Verify expected files exist in correct locations:
~/.openclaw/workspace/
├── AGENTS.md ← Operating instructions (REQUIRED)
├── SOUL.md ← Persona/tone (REQUIRED)
├── USER.md ← User profile (REQUIRED)
├── IDENTITY.md ← Agent name/vibe/emoji (REQUIRED)
├── TOOLS.md ← Local tool notes (REQUIRED)
├── HEARTBEAT.md ← Heartbeat checklist (optional)
├── MEMORY.md ← Curated long-term memory (optional)
├── BOOT.md ← Runs on gateway restart (optional, boot-md hook)
├── BOOTSTRAP.md ← One-time first-run ritual (delete after use)
├── memory/ ← Daily logs + reference docs (vector-indexed)
│ └── YYYY-MM-DD.md
└── skills/ ← Workspace-specific skills (optional)
Note on BOOT.md vs BOOTSTRAP.md:
BOOT.md — Persistent; runs every gateway restart (if boot-md hook enabled)
BOOTSTRAP.md — One-time; agent follows it on first run, then deletes it
Check: Run ls -la on workspace root. Flag missing required files.
2. File Purpose Audit
Each file has ONE job. Check for scope creep: