에이전트 설정

AI 코딩 에이전트를 bd CLI에 연결하여 bead를 생성, 업데이트, 닫을 수 있게 합니다. Beadbox가 에이전트의 작업을 실시간으로 보여줍니다.

사전 요구 사항

에이전트를 설정하기 전에 다음이 필요합니다:

  • bd CLI가 설치되어 PATH에 있어야 합니다 (시작하기)
  • 최소 하나의 초기화된 워크스페이스 (프로젝트 디렉터리에서 bd init)
  • Beadbox가 실행 중이고 해당 워크스페이스에 연결되어 있어야 합니다

에이전트 아이덴티티

각 에이전트에는 다음을 정의하는 CLAUDE.md 파일(또는 동등한 시스템 프롬프트)이 필요합니다:

  • 에이전트가 담당하는 범위 (구현, QA, 운영)
  • 에이전트가 담당하지 않는 범위 (다른 역할로 벗어나는 것을 방지)
  • 소통 방법 (bead에 코멘트, 코디네이터에 보고)

엔지니어링 에이전트의 최소 아이덴티티 예시:

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

경계 섹션은 에이전트가 QA의 역할을 수행하는 것을 방지합니다. 명시적 경계가 없으면 에이전트는 자체 검증하고 독립적인 리뷰를 건너뜁니다.

필수 명령어

에이전트가 가장 많이 사용하는 bd 명령어입니다:

bead 생성

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

bead 조회

bd show BEAD-ID

상태 업데이트 및 작업 인수

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

계획 또는 완료 보고 게시

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

bead 목록 조회

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

완료된 bead 닫기

bd close BEAD-ID

모든 명령어는 --db 플래그로 특정 워크스페이스 데이터베이스를 지정할 수 있어 에이전트가 여러 프로젝트에서 작업할 때 유용합니다.

bd prime 명령어

새 에이전트에게 bd CLI를 가장 빠르게 가르치는 방법:

bd prime

AI 코딩 어시스턴트를 위한 컨텍스트 블록을 출력합니다. 전체 명령어 세트, 출력 형식, 일반적인 워크플로를 다룹니다. 에이전트의 시스템 프롬프트나 컨텍스트 윈도우에 붙여넣으세요.

워크스페이스 디렉터리 안에서 bd prime을 실행하면 워크스페이스별 컨텍스트가 포함됩니다.

에이전트 워크플로

단일 bead에 대한 일반적인 에이전트 워크플로:

  1. bead 인수
  2. 코딩 전에 계획 코멘트
  3. 변경 사항 구현
  4. 테스트 실행
  5. 검증 단계를 포함한 완료 코멘트 게시
  6. 푸시하고 상태를 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

DONE 코멘트에는 다른 에이전트(또는 사람)가 소스 코드를 읽지 않고도 작업을 확인할 수 있는 검증 단계가 포함되어야 합니다.

실시간 피드백

에이전트가 bd 명령어를 실행하면 Beadbox가 데이터베이스 변경을 감지하고 2초 이내에 UI를 업데이트합니다. 수동 새로고침이 필요 없습니다.

에이전트의 작업을 실시간으로 관찰할 수 있습니다: bead가 open에서 in_progress로 이동하는 것을 보고, 계획이 코멘트로 나타나는 것을 확인하고, 블로커가 발생하는 순간을 포착할 수 있습니다.

멀티 에이전트 구성에서 활동 대시보드는 어떤 에이전트가 무엇을 작업 중인지, 파이프라인에서 작업이 어디에 쌓이고 있는지, 전체 플릿에서 방금 무엇이 일어났는지를 보여줍니다.