Agent Instructions

Agent Instructions

This project uses **bd** (beads) for issue tracking. Run `bd onboard` to get started.

Quick Reference

bd ready              # Find available work
bd show           # View issue details
bd update  --claim  # Claim work atomically
bd close          # Complete work
bd dolt push          # Push beads data to remote

Non-Interactive Shell Commands

**ALWAYS use non-interactive flags** with file operations to avoid hanging on confirmation prompts.

Shell commands like `cp`, `mv`, and `rm` may be aliased to include `-i` (interactive) mode on some systems, causing the agent to hang indefinitely waiting for y/n input.

**Use these forms instead:**

# Force overwrite without prompting
cp -f source dest           # NOT: cp source dest
mv -f source dest           # NOT: mv source dest
rm -f file                  # NOT: rm file

# For recursive operations
rm -rf directory            # NOT: rm -r directory
cp -rf source dest          # NOT: cp -r source dest

**Other commands that may prompt:**

undefined

Beads Issue Tracker

This project uses **bd (beads)** for issue tracking. Run `bd prime` to see full workflow context and commands.

Quick Reference

bd ready              # Find available work
bd show           # View issue details
bd update  --claim  # Claim work
bd close          # Complete work

Rules

undefined

Session Completion

**When ending a work session**, you MUST complete ALL steps below. Work is NOT complete until `git push` succeeds.

**MANDATORY WORKFLOW:**

undefined

**CRITICAL RULES:**

undefined