vibe-kanban

Vibe Kanban

vibe-kanban は、コーディングボード／ワークスペース／レビューのコントロールプレーン用のスキルです。

可視化されたボード、分離されたワークスペース、人によるレビュー、再試行、PR の引き継ぎを通じて、範囲を限定したコーディングタスクを調整することが難しい場合に使用します。

ワークフローの形を決める前に、以下のサポートドキュメントを読んでください。

• references/modes-and-routing.md
• references/board-packets-and-surface-selection.md
• references/review-and-cleanup.md
• references/tracker-and-non-code-boundaries.md
• references/environment-variables.md
• references/mcp-api.md

このスキルを使用する場合

以下のいずれかに当てはまる場合は、vibe-kanban を使用してください。

• コーディングタスク用のビジュアルボードまたはワークスペースキューが必要です。
• ワークフローで、1つの長時間のエージェントセッションではなく、並列ワークスペース／ワークツリーが必要です。
• 複数のコーディングカードにわたって、人が差分、再試行、PR の引き継ぎをレビューする必要があります。
• オペレーターが、ブランチの分離、エージェントの割り当て、レビュー、クリーンアップを1つのコントロールプレーンで管理したいと考えています。
• PM の信頼できる情報源として既存のトラッカーを置き換えることなく、ボードをトラッカーに連携させる必要があります。
• 依頼にカンバンボード、レビューキュー、ワークツリーボード、コーディングトラッカーとの同期、並列コーディングエージェント、または vibe-kanban が含まれています。

このスキルを使用しない場合

• コーディングボードを使う前に計画、分解、または承認が必要 → task-planning、survey、jeo、または plannotator を使用してください
• ボード、レビュー、ワークスペースが不要な単一エージェントのコーディング実行 → 該当するコーディング／オーケストレーションスキルを直接使用してください
• 本当に必要なのがブラウザでのレビュー、または認証済みブラウザーの再利用 → agentation、browser-harness、または playwriter を使用してください
• 作業の大半が、コーディング用ワークスペース、差分、PR を伴わない PM／運用調整 → task-planning、standup-meeting、sprint-retrospective などの PM ワークフロースキルを使用してください
• 作業の中心がマーケティング／コンテンツ運用 → marketing-automation または関連する GTM／コンテンツスキルを使用してください
• コーディングボードでの実行を伴わないゲーム制作の計画 → bmad-gds またはその他のゲーム制作スキルを使用してください

クイックルーティングルール

必要な作業	使用するもの
ワークツリー、レビュー、再試行、PR の引き継ぎに対応した、範囲を限定したコーディングタスク用のボード	vibe-kanban
コーディング開始前の計画レビューまたは成果物の承認	plannotator
ボード／ワークスペースのコントロールプレーンが不要な単一エージェントタスク	直接的なコーディング／オーケストレーションスキル
レンダリングされた UI の厳密なレビューまたはブラウザー状態の再利用	agentation ／ playwriter ／ browser-harness
コード以外の作業調整（PM、マーケティング、ゲーム運用）	該当するドメインのワークフロースキル

手順

ステップ 1：本当に必要なのがボードか確認する

ボードを開いたり MCP を設定したりする前に、依頼の内容を整理してください。

vibe_kanban_mode:
  board_need: coding-board | tracker-sync | review-queue | compare-agents | unknown
  task_shape: single-bounded-task | several-independent-tasks | epic-needs-splitting | unknown
  review_surface: board-review | PR-review | board-then-PR | unknown
  repo_scope: one-repo | several-repos | no-repo | unknown
  agent_mix: claude | codex | gemini | opencode | mixed | unknown
  cleanup_need: low | medium | high | unknown

ワークフローで本当にコーディングボードが必要な場合にのみ、vibe-kanban を選択してください。タスクがまだ漠然としたエピックであれば、ボードが混乱の元になる前に分割してください。

ステップ 2：範囲を限定したコーディングタスクを1カードにつき1つにする

適切なカードには、レビュー可能な成果が1つあります。

• 1つの API エンドポイント
• 1つの失敗テスト群
• 1つの分離された UI コンポーネント
• 1つのタスクにおける2つのエージェントの比較

「移行を完了する」のような巨大なエピックや、コード以外のワークフローとコーディングを混在させたカードは不適切です。

ステップ 3：ボードパケットとレビューフローを選ぶ

references/board-packets-and-surface-selection.md を使って、以下から選んでください。

• 並列コーディングカード
• エージェントの比較
• レビューキュー
• トラッカーとの同期

ローカルでの素早い反復を重視しつつ、最終レビューを引き続き GitHub で行う場合は、デフォルトで board-then-PR を選択してください。

Step 4: 各カードをワークスペースの契約として扱う

各カードには、次の内容を記録してください。

• 正確な目標と受け入れチェック
• リポジトリとベースブランチ
• 選択したエージェント
• レビュー対象
• クリーンアップ担当者
• 外部のボードが引き続き正式な管理元である場合は、トラッカーへのリンク

カードの最小例：

Title: Fix signup validation regression
Goal: Restore server-side validation for missing email/phone on /signup
Acceptance: failing tests pass, new regression test added, PR ready for review
Agent: Claude Code
Review: board-then-PR

Step 5: ボードのループを実行する

1. 範囲を限定したカードを作成するか、内容を調整する
2. そのカード専用の独立したワークスペースを1つ開始する
3. ログと差分を確認する
4. カードの契約に照らしてレビューする
5. 再試行、分割、承認、または PR レビューへの引き継ぎを行う
6. ブランチ／ワークツリー／サーバーを明示的にクリーンアップする

Step 6: レビューとクリーンアップを誠実に行う

受け入れのループには references/review-and-cleanup.md を使用してください。簡潔なルールは次のとおりです。

• ファイルに変更があったかどうかだけでなく、成果物をカードの契約と照合する
• 1つのワークスペースがいつまでも逸脱し続ける状態にするより、再試行または分割を優先する
• ボードのステータスを、作業完了の証拠として扱わない
• 古くなったカードを閉じ、古くなったワークツリーを意図的に整理する

Step 7: 共有ボードの制御に役立つ場合のみ MCP を使用する

まず UI またはローカルのワークフローから始めてください。別のオーケストレーターからカードの作成、状態の確認、プログラムによる作業の移動を行う必要がある場合に、MCP を導入してください。

Step 8: 適切な場所に正直に振り分ける

vibe-kanban は、有用性を保てる範囲に絞ってください。

• 計画の作成または承認 → task-planning、survey、plannotator、jeo
• ボード／ワークスペースのループを伴わないコードレビュー → code-review
• ブラウザレビューまたは QA のエビデンス → agentation、browser-harness、playwriter
• PM のみの定例業務またはロードマップの調整 → PM スキル
• コーディング用ワークスペースを伴わないマーケティング／コンテンツパイプラインの調整 → marketing-automation
• コーディングボードの制御を伴わないゲーム制作の計画 → bmad-gds

価値の高いコマンドパターン

# start local board on a safe port
PORT=3001 npx vibe-kanban --port 3001

# run MCP server for orchestrators
npx vibe-kanban --mcp

# inspect worktree cleanup state
git worktree list
git worktree prune

例

例 1：並行コーディングボード

• プロンプト：「Claude と Codex が、次の3つの独立したバグ修正をそれぞれ1つずつ担当でき、PR を作成する前に差分をレビューできるボードを設定してください。」
• 期待される動作：vibe-kanban を使用し、範囲を限定したカードを作成してワークスペースを分離し、ボードレビューから PR への引き継ぎループを選択します。

例 2：エージェントの比較

• プロンプト：「同じ API のバグに2つのエージェントを取り組ませ、差分を比較して、どちらの PR を残すか決められるようにしてください。」
• 期待される動作：vibe-kanban を使用し、試行を分離したまま保ち、レビューでの判断を明示します。

例 3：計画のみ

• プロンプト：「この移行をフェーズに分け、コードを書く前に承認を得られるようにしてください。」
• 期待される動作：ボードの導入は時期尚早なため、task-planning または plannotator に振り分けます。

例 4：マーケティングボード

• プロンプト：「コンテンツカレンダーの承認とローンチ用コピーの修正に使うボードが必要です。」
• 期待される動作：vibe-kanban はコーディング用ワークスペース、差分、PR への引き継ぎを目的としているため、marketing-automation または PM／コンテンツのワークフロースキルに振り分けます。

例 5：トラッカーと連携したコーディングボード

• プロンプト：「GitHub Projects を正式な管理元として維持しつつ、ワークツリーを分離した3つの機能カード用にコーディングボードを開き、完了した各カードを PR レビューに引き継いでください。」
• 期待される動作：トラッカーを正式な管理元として維持し、コーディングの実行状態には vibe-kanban を使用して、クリーンアップと PR への引き継ぎを明示します。

ベストプラクティス

1. 各カードには、範囲を限定したコーディング成果を1つだけ設定します。
2. GitHub Projects／Linear／Jira は外部トラッカーとして扱い、コーディングボードが不要である証拠とはみなさないでください。
3. アクティブなカードの数は、1人のレビュアーが現実的に対応できる範囲に制限します。
4. 再試行の判断とコメントは、永続的な場所に残します。
5. 共有リポジトリでの迅速な反復には、ボードから PR に進む流れを優先します。
6. ワークフローの一環として、ワークツリー、ブランチ、プレビューサーバーをクリーンアップします。
7. PM、マーケティング、コード以外のゲーム制作ボードは、早い段階で別の場所に振り分けます。

参考資料

• BloopAI/vibe-kanban
• Git worktree のドキュメント
• Claude Code の一般的なワークフロー
• GitHub Projects のドキュメント
• GitHub merge queue のドキュメント