jb-beans

Beans

beans を使用して、.beans/ に保存された Git で管理しやすい Markdown の課題を管理します。

最初にプロジェクトのガイダンスを確認する

Beans 対応リポジトリで作業する前に、次を実行してください。

beans prime

出力内容に従ってください。リポジトリのワークフロー、課題モデル、ステータス、エージェントへの期待事項が定義されており、ここに記載された一般的なガイダンスより優先されます。

インストールとバイナリの安全性

Go CLI は Homebrew または Go を使ってインストールしてください。

brew install hmans/beans/beans
# or
go install github.com/hmans/beans@latest

beans を npm または Bun でインストールしないでください。同名のパッケージは、無関係な古い Node プログラムです。Beans が予期せず失敗した場合、特に coffee-script モジュールエラーが発生した場合は、コマンドのシャドーイングを調査してください。

which -a beans
beans version

必要に応じて、正常に動作する Homebrew または Go のバイナリを絶対パスで指定し、より広範な PATH の修正はこのタスクの範囲外としてください。

エージェントのワークフロー

コマンドが対応している場合は、--json を優先してください。一般的なライフサイクルは次のとおりです。

# Discover actionable or existing work
beans list --json --ready
beans list --json -S "login"
beans show --json <id>

# Create and start work
beans create --json "Add login screen" -t feature -s todo -d "Build the initial login UI"
beans update --json <id> -s in-progress

# Record useful progress
beans update --json <id> --body-append "## Notes\n\nStarted implementation"

# Complete with a durable summary
beans update --json <id> -s completed \
  --body-append "## Summary of Changes\n\nImplemented and validated the feature."

再現手順、決定事項、チェックリスト、進捗、最終的な要約を記載し、課題の本文を最新の状態に保ってください。依存関係を文章で重複して記載するのではなく、構造化された親子関係やブロック関係を使用してください。

並行編集によって内容が上書きされる可能性がある場合は、本文の一部だけを置換するか、--if-match による更新を使用してください。設定や関係を大幅に変更した後は、beans check を実行してください。アーカイブは、プロジェクトのワークフローまたはユーザーから求められた場合にのみ行ってください。

現在のコマンドを確認する

コピーしたコマンド一覧に頼らないでください。対応するフィールドやフラグは変更されることがあるため、インストール済みの CLI を確認してください。

beans --help
beans <command> --help
beans version

高度なフィルタリングや関係のたどり方については、beans graphql --help と beans graphql --schema を確認してください。Beans には組み込みの beans tui はありません。要求された場合は、別の beans-tui ツールを使用してください。

プロジェクト：https://github.com/hmans/beans