Configuration des agents

Connecte tes agents de code IA au CLI bd pour qu'ils puissent créer, mettre à jour et fermer des beads. Beadbox affiche leur travail en temps réel.

Prérequis

Avant de configurer les agents, tu as besoin de :

  • Le CLI bd installé et dans le PATH (Premiers Pas)
  • Au moins un workspace initialisé (bd init dans ton répertoire de projet)
  • Beadbox lancé et connecté à ce workspace

Identité de l'agent

Chaque agent a besoin d'un fichier CLAUDE.md (ou prompt système équivalent) qui définit :

  • Ce que l'agent gère (implémentation, QA, opérations)
  • Ce que l'agent ne gère pas (empêche les agents de dériver vers d'autres rôles)
  • Comment communiquer (commenter sur les beads, rapporter au coordinateur)

Voici une identité minimale pour un agent d'ingénierie :

## 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 section des limites empêche l'agent de faire le travail du QA. Sans limites explicites, les agents s'auto-valident et sautent la revue indépendante.

Commandes essentielles

Voici les commandes bd que tes agents utilisent le plus :

Créer un bead

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

Consulter un bead

bd show BEAD-ID

Mettre à jour le statut et prendre en charge du travail

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

Poster un plan ou un rapport d'achèvement

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

Lister les beads

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

Fermer un bead terminé

bd close BEAD-ID

Toutes les commandes acceptent un flag --db pour cibler une base de données de workspace spécifique, utile quand les agents travaillent sur plusieurs projets.

La commande bd prime

Le moyen le plus rapide de former un nouvel agent au CLI bd :

bd prime

Cela génère un bloc de contexte conçu pour les assistants de code IA. Il couvre l'ensemble des commandes, les formats de sortie et les workflows courants. Colle-le dans le prompt système ou la fenêtre de contexte de ton agent.

Lance bd prime depuis ton répertoire de workspace pour inclure le contexte spécifique au workspace.

Workflow de l'agent

Un workflow typique d'agent pour un seul bead :

  1. Prendre en charge le bead
  2. Commenter un plan avant de coder
  3. Implémenter le changement
  4. Lancer les tests
  5. Commenter l'achèvement avec les étapes de vérification
  6. Pousser et mettre à jour le statut à 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

Le commentaire DONE doit inclure des étapes de vérification permettant à un autre agent (ou un humain) de confirmer le travail sans lire le code source.

Retour en temps réel

Quand un agent exécute une commande bd, Beadbox détecte le changement dans la base de données et met à jour l'interface en moins de deux secondes. Pas besoin de rafraîchir manuellement.

Tu peux ainsi observer tes agents travailler en temps réel : voir les beads passer de open à in_progress, regarder les plans apparaître en commentaires et repérer les blocages dès qu'ils surgissent.

Pour les configurations multi-agents, le Dashboard d'Activité montre quel agent travaille sur quoi, où le travail s'accumule dans le pipeline et ce qui vient de se passer dans toute la flotte.