# Agent Instructions

**IMPORTANT**: All agents MUST read `.agent/AGENTS.md` for project-specific instructions before starting work.

## Project Overview

This project uses **bd** (beads) for issue tracking and **Gitea** for external issue tracking.

- **Primary workflow**: Use `bd` CLI for issue tracking
- **External issues**: Gitea API for external bug/feature tracking
- **Agent instructions**: `.agent/` directory contains project-specific agent guidance

## Quick Reference

```bash
bd ready              # Find available work
bd show <id>          # View issue details
bd update <id> --status in_progress  # Claim work
bd close <id>         # Complete work
bd sync               # Sync with git
```

## Documentation

- `.agent/AGENTS.md` - Project-specific agent instructions (READ THIS FIRST)
- `GITEA_ISSUES.md` - Gitea issue workflow details
- `README.md` - Project overview and setup