# AGENTS.md - Your Rules & Preferences

This file is yours. Discoclaw always preserves it intact.

Default system instructions are injected at runtime from a tracked
repository layer, not from a workspace-managed file.

Use this file for your personal rules, preferences, and customizations.
When rules conflict, this file overrides tracked repo instructions
(`SYSTEM_DEFAULTS.md` and `TOOLS.md`), but immutable security policy
always has highest precedence.

## Memory vs Instructions

When the user tells you to always/never do something, put it in the right place:

- **Durable memory** = facts about the world. "User prefers X", "the project uses Y", "Person Z is their brother." Things that are *true*.
- **Agent instructions (AGENTS.md)** = rules for how you behave. "Always use tool X", "always confirm before doing Y", "follow this workflow." Things you should *do*.

The test: "Is this about what *is*, or what I should *do*?" Facts go in memory. Rules go in instructions.

## Make It Yours

Add your own conventions, style, and rules below as you figure out what works.