Agent Setup

अपने AI coding agents को bd CLI से जोड़ें ताकि वो beads create, update और close कर सकें। Beadbox उनका काम real-time में दिखाता है।

Prerequisites

Agents setup करने से पहले, आपको चाहिए:

  • bd CLI installed और PATH में (शुरू करें)
  • कम से कम एक initialized workspace (अपनी project directory में bd init)
  • Beadbox चल रहा हो और उस workspace से connected हो

Agent Identity

हर agent को एक CLAUDE.md file (या equivalent system prompt) चाहिए जो define करे:

  • Agent किसका ज़िम्मेदार है (implementation, QA, operations)
  • Agent किसका ज़िम्मेदार नहीं है (दूसरे roles में drift होने से रोकता है)
  • कैसे communicate करना है (beads पर comment, coordinator को report)

एक engineering agent के लिए minimal identity का example:

## 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.

Boundary section agent को QA का काम करने से रोकता है। बिना explicit boundaries के, agents ख़ुद को validate कर लेते हैं और independent review skip कर देते हैं।

ज़रूरी Commands

ये bd commands आपके agents सबसे ज़्यादा इस्तेमाल करते हैं:

Bead बनाएँ

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

Bead देखें

bd show BEAD-ID

Status update करें और काम claim करें

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

Plan या completion report post करें

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

Beads list करें

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

पूरा हुआ bead close करें

bd close BEAD-ID

सभी commands --db flag accept करते हैं ताकि specific workspace database target कर सकें, जो agents के multiple projects पर काम करने पर useful है।

bd prime Command

नए agent को bd CLI सबसे तेज़ सिखाने का तरीक़ा:

bd prime

यह AI coding assistants के लिए designed context block output करता है। इसमें पूरा command set, output formats और common workflows covered हैं। इसे अपने agent के system prompt या context window में paste करें।

Workspace directory के अंदर से bd prime चलाएँ ताकि workspace-specific context include हो।

Agent Workflow

एक bead के लिए typical agent workflow:

  1. Bead claim करें
  2. Coding से पहले plan comment करें
  3. Change implement करें
  4. Tests चलाएँ
  5. Verification steps के साथ completion comment करें
  6. Push करें और status ready_for_qa update करें
# 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

DONE comment में verification steps होने चाहिए जिनसे दूसरा agent (या human) source code पढ़े बिना काम verify कर सके।

Real-time Feedback

जब agent bd command चलाता है, Beadbox database change detect करता है और दो सेकंड में UI update करता है। Manual refresh की ज़रूरत नहीं।

इसका मतलब आप agents का काम real-time में देख सकते हैं: beads को open से in_progress होते देखें, plans को comments के रूप में appear होते देखें, और blockers को surface होते ही catch करें।

Multi-agent setups में, Activity Dashboard दिखाता है कि कौन सा agent किस पर काम कर रहा है, pipeline में कहाँ काम जमा हो रहा है, और fleet भर में अभी क्या हुआ।