# 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.

```bash
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:
```bash
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: `· sonnet` or `· opus`
- This costs ~2 tokens, helps Jake track what's being used

## 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