trictrac/AGENTS.md

25 lines
844 B
Markdown
Raw Permalink Normal View History

2026-01-17 20:42:59 +01:00
# Agent Instructions
2026-01-18 20:19:10 +01:00
This project uses **bd** (beads) for issue tracking.
Run `bd prime` for workflow context, or install hooks (`bd hooks install`) for auto-injection.
2026-01-17 20:42:59 +01:00
## Quick Reference
2026-01-18 20:19:10 +01:00
- `bd ready` - Find unblocked work
- `bd create "Title" --type task --priority 2` - Create issue
- `bd update <id> --status in_progress` # Claim work
- `bd close <id>` - Complete work
- `bd sync` - Sync with git (run at session end)
2026-01-17 20:42:59 +01:00
## Landing the Plane (Session Completion)
2026-01-18 20:19:10 +01:00
**When ending a work session**, you MUST complete ALL steps below.
2026-01-17 20:42:59 +01:00
**MANDATORY WORKFLOW:**
1. **File issues for remaining work** - Create issues for anything that needs follow-up
2. **Run quality gates** (if code changed) - Tests, linters, builds
3. **Update issue status** - Close finished work, update in-progress items
2026-01-18 20:19:10 +01:00
4. **Hand off** - Provide context for next session