···11+22+# Use bd merge for beads JSONL files
33+.beads/issues.jsonl merge=beads
+40
AGENTS.md
···11+# Agent Instructions
22+33+This project uses **bd** (beads) for issue tracking. Run `bd onboard` to get started.
44+55+## Quick Reference
66+77+```bash
88+bd ready # Find available work
99+bd show <id> # View issue details
1010+bd update <id> --status in_progress # Claim work
1111+bd close <id> # Complete work
1212+bd sync # Sync with git
1313+```
1414+1515+## Landing the Plane (Session Completion)
1616+1717+**When ending a work session**, you MUST complete ALL steps below. Work is NOT complete until `git push` succeeds.
1818+1919+**MANDATORY WORKFLOW:**
2020+2121+1. **File issues for remaining work** - Create issues for anything that needs follow-up
2222+2. **Run quality gates** (if code changed) - Tests, linters, builds
2323+3. **Update issue status** - Close finished work, update in-progress items
2424+4. **PUSH TO REMOTE** - This is MANDATORY:
2525+ ```bash
2626+ git pull --rebase
2727+ bd sync
2828+ git push
2929+ git status # MUST show "up to date with origin"
3030+ ```
3131+5. **Clean up** - Clear stashes, prune remote branches
3232+6. **Verify** - All changes committed AND pushed
3333+7. **Hand off** - Provide context for next session
3434+3535+**CRITICAL RULES:**
3636+- Work is NOT complete until `git push` succeeds
3737+- NEVER stop before pushing - that leaves work stranded locally
3838+- NEVER say "ready to push when you are" - YOU must push
3939+- If push fails, resolve and retry until it succeeds
4040+