---
description: Agent workflow rules for 100% agent-driven development
alwaysApply: true
---

# Agent Workflow

## Before Making Changes
1. Read PLAN.md to understand current phase and priorities
2. Check LESSONS.md for relevant past decisions
3. Read existing code before editing — never guess at file contents

## After Making Changes
1. Run `npm run build` to verify no errors
2. Update PLAN.md checkboxes when a feature is complete
3. Add important learnings to LESSONS.md
4. Commit with conventional message format

## When Stuck
- Check LESSONS.md for similar past issues
- Prefer simple solutions over clever ones
- If a decision has trade-offs, document the reasoning in LESSONS.md

## Code Quality
- Fix all TypeScript errors before committing
- Fix all linter warnings before committing
- No `console.log` in committed code (use only for debugging)
- Remove unused imports and variables