4.3 KiB
4.3 KiB
AGENTS.md - Clawdbot Workspace
This folder is the assistant's working directory.
First run (one-time)
- If BOOTSTRAP.md exists, follow its ritual and delete it once complete.
- Your agent identity lives in IDENTITY.md.
- Your profile lives in USER.md.
Backup tip (recommended)
If you treat this workspace as the agent's "memory", make it a git repo (ideally private) so identity and notes are backed up.
git init
git add AGENTS.md
git commit -m "Add agent workspace"
Safety defaults
- Don't exfiltrate secrets or private data.
- Don't run destructive commands unless explicitly asked.
- Be concise in chat; write longer output to files in this workspace.
Daily memory (recommended)
- Keep a short daily log at memory/YYYY-MM-DD.md (create memory/ if needed).
- On session start, read today + yesterday if present.
- Capture durable facts, preferences, and decisions; avoid secrets.
Daily habit: Git backup
This workspace is a git repo. At end of each day/session:
cd ~/.clawdbot/workspace
git add -A && git commit -m "Daily backup: YYYY-MM-DD" && git push
This keeps identity, memory, and progress backed up. Consider making it private on GitHub.
Customize
- Add your preferred style, rules, and "memory" here.
Smart Model Routing (MANDATORY)
Default model: Sonnet — use session_status(model="sonnet") at session start if on Opus.
Auto-escalate to Opus for:
- Multi-step architecture, system design, complex debugging
- Deep research synthesis (5+ sources, strategic analysis)
- Creative/nuanced writing, security analysis, pentesting strategy
- Business strategy, financial projections
- Anything Jake explicitly says needs deep thinking
- How: call
session_status(model="opus"), do the work, then switch back to Sonnet
Stay on Sonnet for:
- File reads, git ops, simple commands, quick lookups
- Casual chat, short answers, sending messages
- Memory searches, simple code edits, routine maintenance
- Anything that's basically CRUD or lookup
Spawn sub-agent on Opus for:
- Heavy research (competitive analysis, market research)
- Building entire files/projects from scratch
- Long code generation, multi-file refactors
- Why: keeps main session context lean, isolates expensive work
Label every message:
- End every reply with a model tag:
· sonnetor· opus - This costs ~2 tokens, helps Jake track what's being used
MCP Work — MANDATORY Commit Rule
ALL MCP-related work MUST be committed and pushed to mcpengine-repo/ (BusyBee3333/mcpengine).
This is non-negotiable. The mcpengine repo is the single source of truth.
What goes where:
- New MCP server →
mcpengine-repo/servers/{platform-name}/ - MCP apps/UI →
mcpengine-repo/servers/{platform-name}/src/apps/orui/ - Factory tools →
mcpengine-repo/infra/factory-tools/ - Pipeline state →
mcpengine-repo/infra/command-center/ - Reviews/evals →
mcpengine-repo/infra/factory-reviews/ - Landing pages →
mcpengine-repo/landing-pages/ - MCP research/docs →
mcpengine-repo/docs/
Workflow:
- Can build in workspace for speed (scratch space)
- When done:
rsync -a --exclude='node_modules' --exclude='.git' src/ mcpengine-repo/servers/{name}/ cd mcpengine-repo && git add -A && git commit -m "{name}: {what}" && git push- Never leave MCP work as loose workspace directories without also syncing to mcpengine
Also push to individual repos when they exist:
- GHL →
BusyBee3333/Go-High-Level-MCP-2026-Complete - 30 original servers →
BusyBee3333/{name}-mcp-2026-complete
Discord-specific rule
- If you ever feel like you lack context in a Discord conversation, proactively read the past few messages in that channel using the message tool (action=search or action=read with before/after parameters) before asking for clarification.
Research Intel Memory System
For ongoing research/monitoring (competitor tracking, market research, intel gathering):
- Store in:
memory/{project}-research-intel.md - Format: Current week's detailed intel at TOP, compressed 1-3 sentence summaries of previous weeks at BOTTOM
- Weekly maintenance: Compress previous week to summary, add new detailed intel at top
- When to check: Any request for "action items from research," "what should we do based on X," or strategic decisions
- Active files: Check USER.md for list of active research intel files