Kanban Board Application

VibeKanban 🚦🤖

エージェントを活用したコーディングを明確に！

VibeKanban へようこそ。VibeKanban は、あなたのためだけでなく、AI エージェントのためにも使える、シンプルでモダンなカンバンボードです！

✨ 作業を追跡し、エージェントにコンテキストを与え、あらゆるステップで何が起きているかを確認できます。

---

VibeKanban を使う理由 🤔

バグの修正や機能の構築をエージェントに頼んだとき、実際に何をしているのか気になったことはありませんか？VibeKanban は、人間のワークフローとエージェントによる自動化の間をつなぎます。

• 📝 視覚的なカンバンボード — 見やすいドラッグ＆ドロップ操作のインターフェースで、プロジェクトとチケットを整理できます。
• 🤖 エージェント連携（MCP サーバー） — AI エージェントが実際のチームメイトのように、チケットを作成、更新、追跡できます。
• 📊 指標と分析 — デプロイ率やバグの発生頻度などを追跡し、あなたとエージェントの進捗を確認できます。
• ⚡ すぐにセットアップ — スクリプトを1つ実行するだけで、すぐに使い始められます！

---

機能

• プロジェクト管理：プロジェクトの作成、表示、編集、削除
• チケット管理：種別（bug、story、task、spike）と優先度（low、medium、high、critical）を指定してチケットを作成・管理
• カンバンボード表示：ドラッグ＆ドロップ機能を備えた視覚的なボード
• MCP 連携：Cursor と連携し、チケットの作成と更新を自動化
• DORA 指標：開発パフォーマンス指標を追跡

技術スタック

• バックエンド：Python と Flask
• フロントエンド：HTML、JavaScript、Tailwind CSS
• データベース：SQLite（ローカル）

クイックセットアップ（推奨）

1. リポジトリをクローンします。

   git clone https://github.com/shahriarb/vibekanban.git
   cd vibekanban
   

2. セットアップスクリプトを実行します。

   ./setup.sh
   

   このスクリプトによって仮想環境が作成され、依存関係がインストールされ、データベースがセットアップされます。

3. アプリケーションを起動します。

   ./run.sh
   

4. ブラウザーを開き、次のアドレスにアクセスします。

   http://localhost:5050
   

手動セットアップ

手動でセットアップする場合や、スクリプトで問題が発生している場合は、以下の手順を実行します。

1. リポジトリをクローンします。

   git clone https://github.com/shahriarb/vibekanban.git
   cd vibekanban
   

2. 仮想環境を作成して有効化します。

   python3 -m venv .venv
   source .venv/bin/activate   # On Windows, use: .venv\Scripts\activate
   

3. 依存関係をインストールします。

   pip install -r requirements.txt
   

4. データベースとマイグレーションを初期化します。

   プロジェクトを初めてセットアップする場合は、次を実行します。

   flask db init
   flask db migrate -m "Initial migration"
   flask db upgrade
   

   これにより、現在のモデルに基づいてデータベーステーブルが作成されます。

   すでに migrations/ フォルダーがある場合は、次を実行するだけで構いません。

   flask db upgrade
   

5. アプリケーションを手動で実行します。

   python run.py
   

Python バージョンの互換性

このアプリケーションは Python 3.13.2 でテストされています。Python の管理に conda を使用している場合は、.zshrc ファイルで適切な環境を有効化してください。また、依存関係の競合を避けるため、このアプリケーション用に別の venv を作成してください。

Cursor MCP 連携

Cursor の MCP と連携するには、次の手順に従います。

1. アプリケーションが実行中であることを確認します。
2. Cursor で Cursor Settings > MCP Servers > Add New Global MCP server に移動します。

Cursor の MCP 設定で、次のように指定します。

• 名前：KanbanBoard
• 種類：Command
• コマンド：/full/path/to/.venv/bin/python /full/path/to/kanban_mcp_server.py

mcp.json の例：

{
  "mcpServers": {
    "KanbanBoard": {
      "command": "/full/path/to/.venv/bin/python /full/path/to/kanban_mcp_server.py",
      "args": [],
      "enabled": true
    }
  }
}

KanbanBoard MCP の使用方法

設定が完了すると、次のようなコマンドを使用できます。

• @KanbanBoard get kanban status - 状態別のチケット数を表示
• @KanbanBoard get project ID by name - プロジェクト名からプロジェクト ID を検索
• @KanbanBoard list projects - すべてのプロジェクトを一覧表示
• @KanbanBoard list tickets - すべてのチケットを一覧表示
• @KanbanBoard create ticket - 指定した種別と優先度で新しいチケットを作成
• @KanbanBoard update ticket state - チケットの状態を更新
• @KanbanBoard add comment - チケットにコメントを追加

Cursor で MCP サーバーを使用するためのルールの例

You are an AI assistant specialized in software development design and architecture.

Note: Please use @KanbanBoard MCP to document your work in each step. The project_id is <ADD_PROJECT_NUMBER>.
That's a crucial part of the process.

For each feature or improvment request:
- Evaluate the request's complexity to determine if it should be a single ticket or broken into multiple tickets.

- Break Down Subtasks: Identify subtasks for frontend, backend, database, and testing and create them in the @KanbanBoard

- Determine Dependencies: Establish any task dependencies upfront and document them in the @KanbanBoard

- Define Acceptance Criteria: Set clear criteria for each task and document in the @KanbanBoard

- Tailor Testing Methods: For each subtask, define appropriate testing methods. For example, backend tasks might include API tests with tools like Postman or CURL, while frontend tasks might require unit tests with frameworks like Jest. Document the Test Steps in the @KanbanBoard.

- Ticket Flexibility: Allow flexibility to adjust the number of tickets based on ongoing discoveries during development.

- Prioritization: After all tasks defined follow these rules to set the priority for each task:
     - Assess urgency and impact to prioritize critical bugs and high-impact features.
    - Address tasks with dependencies first to unblock other work.
    - Prioritize tasks delivering significant business value.
    - Balance effort and complexity for practical progress.
Set the priority in the @KanbanBoard

- Development: Follow defined acceptance criteria for each task.
    Conduct task-specific testing (unit, integration, end-to-end).

- Ticket Flexibility: Remain flexible to add tasks during development if required.

For each Bug report:
- Create a ticket with the type of 'bug' and add the information I shared with you in the @KanbanBoard. Set clear criteria about what should be fixed and set the priority as high or critical based on the bug's impact.

- Evaluate the reason bug is happening and add findings as the comment to the ticket in the @KanbanBoard.

- Move the ticket to 'in progress' state in the @KanbanBoard and start fixing the bug based on defined criteria.
    
- Move the ticket to 'done' state in the @KanbanBoard when the bug is fixed.

ライセンス

MIT