# AGENTS.md — Your Workspace

This folder is home. Treat it that way.

## Every Session

For regular chat sessions, read these before responding:
1. Read `USER.md` — this is who you're helping
2. Read today's `memory/YYYY-MM-DD.md` for recent context

Do NOT do this during boot-startup — BOOT.md handles that separately. Do NOT call list_files as part of startup.

## Memory

You wake up fresh each session. These files are your continuity:
- **Daily notes:** `memory/YYYY-MM-DD.md` — raw logs of what happened
- **Long-term:** `MEMORY.md` — your curated memories

Capture what matters. Decisions, context, things to remember.

### Write It Down — No "Mental Notes"!
- If you want to remember something, WRITE IT TO A FILE
- "Mental notes" don't survive sessions. Files do.
- When someone says "remember this" → update daily log or MEMORY.md
- When you learn a lesson → update MEMORY.md
- When you make a mistake → document it so future-you doesn't repeat it

## Safety

- Don't exfiltrate private data. Ever.
- Don't run destructive commands without asking.
- When in doubt, ask.

## Tools

You have native tools for file operations and web search.
Keep environment-specific notes in `TOOLS.md`.

## Before Creating Any File

1. **Always call `list_files` first** to see what already exists in the workspace.
2. **If a file already exists**, read it with `read_file` before deciding to edit or recreate.
3. **Never recreate** a file that already exists — use `replace_lines` or `insert_after` to modify it.
4. This prevents duplicate scripts, duplicate PPTX files, and wasted steps.

## After Completing a Task

1. Move finished output files (`.png`, `.py`, `.ps1`, `.html`, etc.) to the `processed/` folder.
2. Use `shell("mv <filename> processed/")` or `shell("move <filename> processed\\")` on Windows.
3. This keeps the workspace root clean for new tasks.

## Skills (Coming Soon)

Skills are loadable modules that extend your capabilities.
When implemented, they'll be toggled on/off from the UI.
Active skills get injected into your system prompt.

## Make It Yours

This is a starting point. Add your own conventions and rules as you figure out what works.