Beads：GitをバックエンドにAIエージェントのメモリを革新する課題追跡システム

AIの支援による開発が急速に進む中、コーディングエージェントにとっての重要な課題は、メモリと長期的なタスク管理です。Beadsは、あなたのAIコラボレーターに待望の「メモリのアップグレード」を提供するように設計された、独創的なオープンソースプロジェクトです。Beadsは、Gitの力を活用して分散型で高効率なシステムを構築し、複雑なコーディングタスクを管理するための、軽量でグラフベースの課題追跡システムとして機能します。

問題点：エージェントの記憶喪失と衝突の混沌

AIエージェントのワークフローを管理する従来のやり方では、ばらばらのMarkdownプラン、失われたコンテキスト、そして複数のエージェントやブランチが課題を追跡しようとする際の頻繁なマージ衝突につながりがちです。同様のシステムにおける以前の課題追跡システムは、順次IDに苦慮し、同時タスク作成を困難にしていました。Beadsはこれらの問題に直接対処します。

Beadsの解決策：インテリジェントな分散型課題追跡

Beadsは、AIエージェントの能力を向上させるための不可欠なツールとなる、いくつかの画期的な機能を提供します。

ハッシュベースのID：衝突を排除

Beads v0.20.1における最も重要なアップグレードは、順次番号の代わりにハッシュベースのID（例：bd-a1b2）に切り替えたことです。このシンプルながら奥深い変更により、複数のエージェントやブランチが同時にタスクを作成する際のマージ衝突や競合が解消されます。段階的な長さのスケーリングとバースデーパラドックスの数学を利用することで、数千の課題があっても衝突の確率は極めて低く保たれ、同時に人間が読みやすい形式を維持します。

Gitをバックエンドとする「データベース」：集中管理された感覚、分散された現実

Beadsの最も注目すべき革新の一つは、Gitを利用して、実際のサーバーやデーモンを必要とせずに、集中管理されたSQLデータベースのような感覚を生み出すことです。各マシンはローカルのSQLiteキャッシュを保持していますが、信頼できる情報源であるJSONLファイル（.beads/issues.jsonl）はGitにコミットされます。インテリジェントな自動同期メカニズムにより、ローカルキャッシュはGitリポジトリと同期され、異なるマシン上のエージェントが同じ論理データベースをシームレスに共有および更新できます。これは、PostgreSQLもMySQLも、ホスト型サービスも不要で、Gitがその役割を果たすことを意味します。

優れた計画のためのグラフベースの依存関係

Beadsは、課題間の依存関係を追跡するために洗練されたグラフベースのシステムを採用しています。blocks（ブロック）、related（関連）、parent-child（親子）、discovered-from（発見元）の4種類の依存関係により、エージェントは複雑なタスクチェーンを作成できます。これにより、長距離の目標を追求し、複雑なタスクストリームを正しい順序で実行することが可能になり、長期的な計画能力が劇的に向上し、「エージェントの記憶喪失」を軽減します。

エージェントフレンドリーな設計

Beadsは、その核においてAIエージェントのために構築されています。人間もBeadsとやり取りできますが、主要なユーザーはAIアシスタントです。簡単なbd onboardコマンドでBeadsをエージェントのワークフローに統合でき、課題を自動的に提出し、そのライフサイクルを管理し、準備完了の作業を照会できます。--jsonフラグは、シームレスな自動化のためのプログラム統合を提供します。

主要な機能概要

• ゼロセットアップ: bd initはプロジェクトローカルのデータベースを作成します。
• 依存関係追跡: 4つのタイプ（blocks、related、parent-child、discovered-from）。
• 準備完了作業の検出: 未解決のブロッカーがない課題を自動的に特定します。
• Gitでバージョン管理: JSONLレコードは共有状態のためにGitにコミットされます。
• 分散設計: 異なるマシン上のエージェントが1つの論理データベースを共有します。
• 拡張可能: SQLiteデータベースにカスタムテーブルを追加できます。
• 完全な監査証跡: すべての変更がログに記録されます。
• メモリ劣化対策: セマンティックな圧縮により、古いクローズされた課題を適切にアーカイブします。
• 美しいCLI: 人間向けにはカラー出力、ボット向けにはJSON。

Beadsを始めるには

インストールは非常に簡単です。ほとんどのプラットフォームでは、単一のcurlコマンドで起動して実行できます。

curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash

インストール後、コーディングエージェントにbdツールをすべての新しい作業に使用するように指示します。エージェントは残りの処理を行い、Beadsを活用してタスクを作成、更新、管理し、複雑なプロジェクトを計画および実行する前例のない能力を提供します。

Beadsはまだ活発に開発中で、「アルファ版」とされており、1.0リリースまでにはAPIの変更が予想されます。しかし、その中核機能は堅牢であり、大きな価値を提供するため、内部プロジェクトや実験的なAI開発にとって魅力的なツールです。AIコーディングエージェントを扱っていて、メモリ、タスクオーケストレーション、または共同作業の問題に悩んでいるのであれば、Beadsは注目に値する説得力のあるオープンソースソリューションを提供します。