Beads
의존성 그래프로 에이전트의 장기 작업을 붙드는 이슈 추적기
curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash코딩 에이전트가 긴 작업을 맥락을 잃지 않고 이어 가도록 만든 분산 그래프 이슈 추적기입니다. 흐트러지는 마크다운 계획 대신 의존성을 아는 그래프에 작업을 넣고, 막힌 것이 풀리면 착수 가능한 목록에 자동으로 올라옵니다. 저장소가 버전 관리되는 SQL 데이터베이스라 여러 기계와 에이전트 사이에서 밀고 당겨 상태를 맞춥니다. 설치는 시스템 전체에 한 번 하고 프로젝트마다 초기화해 씁니다. 초기화하면 에이전트가 읽는 안내 파일을 만들거나 갱신하고 주요 코딩 도구용 통합도 함께 깝니다.
판단
이럴 때 씁니다
- 에이전트가 여러 세션에 걸친 작업을 이어 가야 할 때
- 마크다운 할 일 목록이 흐트러져 관리가 안 될 때
- 여러 기계와 에이전트가 같은 작업 상태를 봐야 할 때
이럴 땐 쓰지 마세요
- 작업이 몇 개뿐이면 도구 하나가 늘 뿐입니다
- 팀이 이미 쓰는 이슈 추적기가 있으면 이중 관리가 됩니다
- 1.2.x 계열에서 검증 없이 배포된 판이 있었습니다
차별점
- 작업을 의존성 그래프로 두어 막힌 것이 풀리면 자동으로 착수 가능 목록에 올라옵니다.
- 버전 관리되는 SQL 데이터베이스라 기계 사이에서 상태를 밀고 당깁니다.
- 주요 코딩 도구용 통합 설치 명령이 준비돼 있습니다.
워크플로
- 01설치 스크립트로 CLI 를 시스템에 깝니다.
- 02프로젝트에서 초기화합니다.
- 03쓰는 코딩 도구용 통합을 설치합니다.
- 04작업을 만들고 의존 관계를 겁니다.
- 05착수 가능한 목록에서 하나를 잡아 끝내면 막혀 있던 작업이 풀립니다.
주요 명령
| 명령 | 설명 |
|---|---|
bd init | 프로젝트에서 초기화하고 에이전트 안내 파일과 통합을 설치합니다. |
bd ready | 지금 착수할 수 있는 작업을 봅니다. |
bd update <id> --claim | 에이전트가 작업을 잡습니다. |
bd remember "insight" | 프로젝트 기억을 남깁니다. 별도 기억 파일을 만들지 말라고 안내합니다. |
함정
설치 전에 확인하세요
- 저장소를 프로젝트 안으로 클론하지 말라고 문서가 명시합니다. 시스템에 한 번 깔고 어디서나 쓰는 CLI 입니다.
- 1.2.0 과 1.2.1 이 검증 없이 배포된 적이 있습니다. 1.2.2 는 검증된 1.1 계열 코드를 더 높은 번호로 다시 낸 판이라 1.2.x 에만 있던 기능은 빠져 있습니다.
- 초기화가 에이전트 안내 파일을 만들거나 고칩니다. 기존 파일을 쓰고 있다면 건드리지 않는 옵션을 확인해야 합니다.
- 상태가 버전 관리되는 데이터베이스에 들어갑니다. 다른 기계와 맞추려면 밀고 당기는 절차를 따로 밟아야 합니다.
비교
에이전트에게 계획을 맡기면 보통 마크다운 목록이 남는데, 세션이 바뀌면 무엇이 끝났는지 흐려집니다. 이쪽은 상태를 그래프 데이터베이스에 두어 그 문제를 없앱니다. 대신 팀이 쓰는 이슈 추적기와 별개 체계가 하나 더 생기므로 어느 쪽이 진짜인지 정해야 합니다.
최근 변경
검증 없이 나간 두 판을 대체하려고 검증된 1.1 계열 코드를 v1.2.2 로 다시 냈습니다. 모든 설치 경로가 검증된 코드로 올라가되 1.2.x 에만 있던 기능은 빠졌습니다.