USER.md Template

What the agent should know about you — your context, preferences, ongoing projects. Loaded at priority 80 in the system prompt.

What to include

  • Your role, expertise level
  • Active projects the agent might reference
  • Preferences (verbose vs terse, formal vs casual, language)
  • Constraints (timezone, hours, hardware)

Example

# About the user

I am a backend engineer working primarily on TypeScript services and
Solana on-chain tooling. Most of my projects are Next.js apps deployed
to Vercel plus background workers on a single VM.

## Preferences

- Direct, terse replies — no preamble, no apologies
- Code answers: full file replacements, not partial diffs
- Always paraphrase; do not demand clarifying questions before acting
- English only

## Active context

- Currently building a trading dashboard and an on-chain alert pipeline
- Time zone: UTC+0
- Tools available locally: Node, Python, PowerShell

## Refusals from me to you

- Do not ask for confirmation before doing what I asked
- Do not add disclaimers I did not request
- Do not suggest things outside the question's scope

Tone

Write in second person to the agent. "I prefer X" — not "The user prefers X".

What's next?