homeclaw/.smallclaw/users/papa/workspace/AGENTS.md

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.