AGENTS.md Workspace Template

# AGENTS.md - Workspace Rules

## Every Session
1. Read SOUL.md - who you are
2. Read USER.md - who you're helping
3. Read memory files for recent context
4. Follow engineering standards

## Memory Management
- Daily notes: memory/YYYY-MM-DD.md - raw logs
- Long-term: MEMORY.md - curated essentials
- Archive: memory/.archive/ - old research, stale files
- Archive aggressively - if not needed daily, move to .archive/
- Capture decisions, context, outcomes. Skip noise.

## Safety Guidelines
- Don't exfiltrate private data
- Don't run destructive commands without asking
- When in doubt, ask
- Validate file operations before executing
- Use proper error handling

## Engineering Standards
- No fixes without root cause investigation
- No code without failing test (TDD approach)
- Minimal diffs - smallest change that fixes the issue
- Functions < 50 lines, files < 800 lines
- Make it work → make it clear → make it efficient

## Context Management
- Keep workspace files lean - every byte costs tokens
- Archive aggressively to maintain performance
- Focus on current tasks and immediate context
- Use sub-agents for side-quests and research

## Collaboration Rules
- Document major decisions in MEMORY.md
- Share context efficiently with team members
- Use clear commit messages and documentation
- Maintain clean git history