このプロジェクトについて

Beats PM Kit(Beats Agentic PM Harness)は、OfficeBeatsによるローカルファースト、クロスランタイムのハーネスで、証拠に基づいたプロダクトマネジメントワークフローを実現する。会議、チャットスレッド、メール、ドキュメント、ノートといった散在するプロダクトコンテキストを、プレーンなMarkdownとしてローカルにアーカイブし、検索可能にし、AIエージェントが実行可能なワークストリームやタスクに三角測量する。READMEによると、キット自体は何もアップロードしない。 構造と概念 このキットは、番号付きのボルトタクソノミーを使用する:0. Incoming、1. Company、2. Products、3. Meetings、4. People、5. Trackers、6. Resources、6. SOPs、7. Partners、8. Clients、それに加えて、標準的なエージェント、ルール、スキル、テンプレート、ワークフロー用の.agent/、スクリプト、テスト、ドキュメント用のsystem/がある。標準的なタスク状態は、5. Trackers/tasks/に、安定したID、証拠リンク、進捗、決定を持つ人間が読めるMarkdownノートとして存在する。TASK_MASTER.mdとワークストリームノートは、それらのファイルをナビゲートするための生成されたもので、第二の真実源ではない。 単一の真実源 .agent/command-registry.jsonは、ルーティング、エイリアス、実行プロファイル、ランタイムポリシーを所有する。.agent/workflows/はワークフローの動作を、.agent/skills/は再利用可能なPMメソッドを所有する。ルートアダプターファイル(AGENTS.md、CLAUDE.md、GEMINI.md、CODEX_COMMANDS.md)、.omp/config.yml、ツール無視ファイルは、system/scripts/sync_cli_adapters.pyによって生成されたビューである。編集は.agent/に対して行い、再生成するのが意図された方法で、手で編集した生成ファイルは上書きされる。 コマンドとコンテキスト 各スラッシュコマンドは、レジストリを通じて1つのワークフローファイルと1つの実行プロファイル(Fast、Balanced、Deep)に解決され、ランタイムごとの昇格レベルを持つ:昇格されたコマンドはネイティブスキルとして出荷され、ガードされたコマンドは確認を必要とし、残りはディスパッチのみである。文書化された実行ループは、ルート、限定されたコンテキストの読み込み、ツールを使用したアクション、チェックポイント、検証、アーティファクトの永続化である。初期の取得は制限されており、生のエビデンスはローカルでハッシュアドレス可能で、圧縮されたコンテキストはソースファイルに遡って追跡可能である。 サポートされているランタイム エントリーポイントは、omp、Claude Code、OpenAI Codex CLI、Google Antigravity、Gemini CLI、GitHub Copilot、そして同じボルト上でのオプションのObsidian UIのためにリストされている。READMEによると、動作は、プロバイダーの階層ではなく、検出された機能によって選択され、モデルのデフォルトはランタイムから継承され、未知の機能は閉じて失敗する。 開始とワークフロー セットアップは、git cloneに続いて./install.shを実行する。これは、python3 system/scripts/bootstrap.py --agent --non-interactiveの薄いラッパーである。Bootstrapは、リポジトリを検証し、既存のワークスペースに対してアップグレード互換性ゲートを実行し、無視されたローカルワークスペースフォルダを作成し、テンプレートをシードし、ランタイムアダプターを同期し、可能な場合はgitフックをインストールし、プライバシーとアダプターの健全性チェックを実行する。その後、ユーザーはランタイムでフォルダを開き、/startまたは/helpを実行する。 ワークフローは、取り込みとエビデンス(/paste、/find、/memory、/context、/chat、メッセージング統合)、会議(/meet、/transcript、/prep、/boss)、計画と戦略(/plan、/create、/deck、/discover、/interview、/intel、/prioritize、/sprint、/retro)、トラッキング(/track、/day、/week、/handoff)、コミュニケーションとドキュメント(/sop、/office-cli、/review、/challenge、/improve-plan)、品質とメンテナンス(/accuracy、/regression、/build、/vibe、/maintain、/update、/vacuum、/archive)、セットアップとオーケストレーション(/start、/help、/obsidian、/pack、/team、/fan-out)にグループ化されている。自然言語入力もサポートされている。 ローカルユーティリティ 繰り返される作業は、system/scripts/内のstdlibのみのPythonスクリプトに委任される。これには、タスク、ラベル、引用符に対する限定された読み取り専用クエリ用のvault_query.py、ローカルエビデンスフォルダ全体でのインデックス付き全文検索用のcontext_router.py、標準的なタスクノートの書き込みと高速取り込み用のtask_store.pyとtask_intake_fast.py、会議トランスクリプトの準備、検証、処理用のtranscript_pipeline.py、実行前の雑多なPM入力の分類用のpm_decision_router.py、キットフォルダをObsidianボルトとして使用するためのobsidian_bridge.py、Trelloなどの休眠中のオプション機能を有効にするためのpack_manager.py、レガシー構成の事前飛行と可逆的な移行用のupgrade_compat.py、共有コミットからのプライベートコンテンツ漏洩と生成されたアダプターのドリフトをブロックするprivacy_guard.pyとadapter_guard.pyが含まれる。 プライバシーとテスト プライバシー姿勢はローカルファーストである。個人用ボルトフォルダはgitignoredされ、.gitkeepファイルを通じてのみ追跡され、ローカルランタイム状態は.beats/内に無視される。ガードスクリプト(privacy_guard.py --tree、adapter_guard.py --mode check)は、プライベートコンテンツ、個人パス、トークンライクな文字列、トランスクリプト、アダプターのドリフトを共有コミットからブロックする。WATCHDOG.mdは、捏造された引用、ID、日付を禁止し、アウトバウンド送信に対して明示的なユーザー承認を要求し、タスク状態を標準的なトラッカーに保持するなどのアドバイザールールを定義している。READMEは、キット自体はクラウドサービスにファイルを同期しないが、選択したAIランタイムは、そのプロバイダーの独自の設定の下でプロンプトとツール出力を処理するという注記を追加している。テストは、system/tests/内にpytestスタイルで存在し、レジストリ、アダプター、タスクストア、トランスクリプトパイプライン、プライバシーとアダプターガード、アップグレード互換性、ボルト不変量などをカバーしている。 クレジット Beats PM Kitは、日々のプロダクトワークから構築された。アクションファーストの出力ポリシーは、MITライセンスのi-have-adhdプロジェクトからインスピレーションを受けた独立したアプローチと説明されており、アップストリームのプラグインやフックコードはバンドルされていない。