Configurazione degli agenti

Collega i tuoi agenti di codice IA al CLI bd perché possano creare, aggiornare e chiudere bead. Beadbox mostra il loro lavoro in tempo reale.

Prerequisiti

Prima di configurare gli agenti, ti serve:

  • Il CLI bd installato e nel PATH (Per iniziare)
  • Almeno un workspace inizializzato (bd init nella directory del tuo progetto)
  • Beadbox in esecuzione e connesso a quel workspace

Identità dell'agente

Ogni agente ha bisogno di un file CLAUDE.md (o prompt di sistema equivalente) che definisca:

  • Di cosa è responsabile l'agente (implementazione, QA, operazioni)
  • Di cosa non è responsabile l'agente (impedisce agli agenti di sconfinare in altri ruoli)
  • Come comunicare (commentare sui bead, riferire al coordinatore)

Ecco un'identità minimale per un agente di ingegneria:

## Identity
Engineer for MyProject. You implement features, fix bugs,
and write tests. You own implementation quality.

## Boundary with QA
QA validates your work independently. You provide QA with
executable verification steps. If your DONE comment doesn't
let QA verify without reading source code, it's incomplete.

La sezione dei confini impedisce all'agente di fare il lavoro del QA. Senza confini espliciti, gli agenti si auto-validano e saltano la revisione indipendente.

Comandi essenziali

Questi sono i comandi bd che i tuoi agenti usano più spesso:

Creare un bead

bd create --title="Fix login bug" --type=bug --priority=2

Visualizzare un bead

bd show BEAD-ID

Aggiornare lo stato e reclamare lavoro

bd update BEAD-ID --claim --actor agent-name
bd update BEAD-ID --status in_progress

Pubblicare un piano o un report di completamento

bd comments add BEAD-ID --author agent-name "PLAN: ..."
bd comments add BEAD-ID --author agent-name "DONE: ..."

Elencare i bead

bd list --status=open --assignee=agent-name

Chiudere un bead completato

bd close BEAD-ID

Tutti i comandi accettano un flag --db per puntare a un database workspace specifico, utile quando gli agenti lavorano su più progetti.

Il comando bd prime

Il modo più veloce per insegnare a un nuovo agente il CLI bd:

bd prime

Questo genera un blocco di contesto progettato per assistenti di codice IA. Copre l'intero set di comandi, i formati di output e i flussi di lavoro comuni. Incollalo nel prompt di sistema o nella finestra di contesto del tuo agente.

Esegui bd prime dalla directory del tuo workspace per includere il contesto specifico del workspace.

Flusso di lavoro dell'agente

Un tipico flusso di lavoro dell'agente per un singolo bead:

  1. Reclamare il bead
  2. Commentare un piano prima di programmare
  3. Implementare la modifica
  4. Eseguire i test
  5. Commentare il completamento con i passi di verifica
  6. Fare push e aggiornare lo stato a ready_for_qa
# Full workflow example
bd update proj-a1b2 --claim --actor eng1
bd comments add proj-a1b2 --author eng1 "PLAN: 1. Fix auth check 2. Add test"

# ... implement and test ...

bd comments add proj-a1b2 --author eng1 "DONE: Fixed auth. Commit: abc123"
git push
bd update proj-a1b2 --status ready_for_qa

Il commento DONE deve includere passi di verifica che permettano a un altro agente (o a una persona) di confermare il lavoro senza leggere il codice sorgente.

Feedback in tempo reale

Quando un agente esegue un comando bd, Beadbox rileva la modifica al database e aggiorna l'interfaccia entro due secondi. Nessun aggiornamento manuale necessario.

Questo significa che puoi osservare i tuoi agenti lavorare in tempo reale: vedere i bead passare da open a in_progress, guardare i piani apparire come commenti e individuare i blocchi non appena emergono.

Per configurazioni multi-agente, la Dashboard di Attività mostra quale agente sta lavorando su cosa, dove il lavoro si accumula nella pipeline e cosa è appena successo in tutta la flotta.