Paca: 軽量で完全無料のオープンソースプロジェクト管理プラットフォーム

Paca は、Jira、Trello、ClickUp、Monday などの主要なツールを凌駕する、完全にカスタマイズ可能でセルフホスト型の代替手段です。

概要と特徴

• 人間と AI の平等な協業:
  • シングルソース（チャットボットの横付け）ではなく、AI エージェントをスクラムチームのメンバーとして扱います。
  • スプリント計画、ボード上のタスク遂行、BDD 仕様書の作成に直接参加します。
• オープンソース:
  • Apache 2.0 ライセンスで公開されたソースコードです。
  • ベンダーロックインなし。データは自社のインフラストラクチャ上で完結します。
• 軽量かつ構成可能:
  • 機能過多（Bloatware）に陥らず、必要な分だけの機能のみを拡張できます。
  • ワークフロー、データモデル、UI を構成ファイルで駆動し、プラグインシステムにより柔軟な拡張が可能です。

Paca vs 従来のツール

P-A-C-A サイクル：人間と AI の協業モデル

Paca はスクラムおよび科学的手法の 4 つの段階「Plan → Act → Check → Adapt」に基づいてチームの協業を構成しています。

主要機能一覧

• 統合型 Scrumban ボード: 人間と AI エージェントが同じリアルタイムボードを共有します。
• アプリ内 AI チャット: プロジェクト内で AI とチャットし、エピック、ストーリー、ドキュメントを作成・更新可能（英語）。
• アクティビティ差分とリバート: フィールド変更の前後を可視化し、ワンクリックで元に戻せます。
• BDD 協力: Gherkin シナリオエディタを PO、BA、AI で共同編集可能です。
• システム設計文書 (SDD): AI エージェントが自律的に動作するための「生きている」アーキテクチャドキュメントです。
• MCP サーバー搭載: Claude などの AI エージェントを Paca のデータ層に直接接続します（スクレイピング不要）。
• Claude Code スキル:

  /paca

  コマンドでエディターから離れたことなく、自然言語でタスク管理を行えます。
• リアルタイム更新: Socket.IO を使用し、変更発生直後全員に見られます。
• WASM プラグインサンドボックス: 安全な拡張環境を提供します。
• 軽量コア: デフォルトで軽量な設計であり、チームが必要とする機能のみを追加できます。

始め方

Docker Compose を使用したインストールが推奨されます。

オプション 1：インタラクティブなスクリプト（本番向け）

リポジトリのクローン不要。設定をインタラクティブに行います。

curl -fsSL https://github.com/Paca-AI/paca/releases/latest/download/install.sh | bash

完了後、

http://your-server-ip

オプション 2：Docker Compose（手動）

1. 構成ファイルのダウンロード

mkdir paca && cd paca
curl -fsSL https://github.com/Paca-AI/paca/releases/latest/download/docker-compose.yml -o docker-compose.yml
mkdir -p nginx
curl -fsSL https://github.com/Paca-AI/paca/releases/latest/download/gateway.conf -o nginx/gateway.conf

2. 環境変数ファイルの作成

以下のコマンドを実行し、生成された

<run: ...>

cat > .env <<'EOF'
JWT_SECRET=<run: openssl rand -hex 32>
ADMIN_PASSWORD=<your-admin-password>
POSTGRES_PASSWORD=<run: openssl rand -hex 32>
AGENT_API_KEY=<run: openssl rand -hex 32>
INTERNAL_API_KEY=<run: openssl rand -hex 32>
ENCRYPTION_KEY=<run: openssl rand -hex 32>
PUBLIC_URL=http://localhost
EOF

3. スタックの起動

docker compose --env-file .env up -d

設定した管理者ユーザーとパスワードで

http://localhost

スタックのカスタマイズ（スケールダウン）

必要に応じて以下のサービスのみを起動し、リソース使用量を削減できます。

• 外部 PostgreSQL への切り替え:

  docker compose --env-file .env up -d --scale postgres=0
  # DATABASE_URL を .env に指定してください
  

• AWS S3 への切り替え (MinIO の不使用):

  docker compose --env-file .env up -d --scale minio=0
  # .env で STORAGE_PROVIDER=s3 に設定してください
  

• AI エージェントの無効化:

  docker compose --env-file .env up -d --scale ai-agent=0
  

オプション 3：ローカル開発環境

1. リポジトリのクローン

git clone https://github.com/Paca-AI/paca.git && cd paca

2. インフラ依存サービスの起動

docker compose -f deploy/docker-compose.dev.yml up -d postgres valkey

3. フル開発スタックの起動（任意）

docker compose -f deploy/docker-compose.dev.yml up -d

詳細は

docs/guides/local-development.md

AI エージェント接続方法

Paca は Model Context Protocol (MCP) サーバーを搭載しており、Claude Desktop などの AI ツールと連携可能です。

構成ファイルの追加（例：Claude Desktop）

macOS / Windows の設定ファイル（

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "paca": {
      "command": "npx",
      "args": ["-y", "@paca-ai/paca-mcp"],
      "env": {
        "PACA_API_KEY": "your-api-key-here",
        "PACA_API_URL": "http://localhost:8080"
      }
    }
  }
}

• PACA_API_KEY: Paca の設定メニューから取得します。
• PACA_API_URL: パカのインスタンス URL です。

接続後、AI はプロジェクトのリストやタスク操作、スプリント計画などを自然言語で実行できます。

コマンドラインでの使用（Claude Code など）

以下のコマンドを実行することで MCP サーバーを追加します。

claude mcp add paca \
  --env PACA_API_KEY=<your-api-key> \
  --env PACA_API_URL=<your-paca-url> \
  -- npx -y @paca-ai/paca-mcp

またはガイド付き設定

/paca-setup

利用可能なコマンド一覧

/paca <request>

/paca-epic

/paca-clarify

/paca-breakdown

/paca-sprint

/paca-estimate

/paca-prioritize

/paca-do

/paca-test

/paca-doc

/paca-setup

MCP サーバー環境変数

PACA_API_KEY

PACA_API_URL

http://localhost:8080

システムアーキテクチャ

システムは以下のモジュール構成で設計されています。

• UI (Frontend): React + TanStack Start + shadcn/ui (

  apps/web

  )
• AI 統合サーバー:

  @paca-ai/paca-mcp

  (

  apps/mcp

  )
• バックエンド (API): Go + Gin (

  services/api

  )
• リアルタイム通信: Node.js + Socket.IO (

  services/realtime

  )
• AI エージェントオーケストレーション: Python + FastAPI + OpenHands SDK (

  services/ai-agent

  )
• テストスイート: Playwright (

  apps/e2e

  )
• AI スキル定義: Agent Skills (

  skills/

  )
• データベース: PostgreSQL（永続化ストレージ）
• キャッシュ・ストリーミング: Valkey

詳細なアーキテクチャ図は docs/architecture/overview.md を参照してください。

コントリビュートとドキュメント

リポジトリ構造とプラグイン

プラグインはバックエンド（WASM）、フロントエンド（ESM）の 2 つのディレクトリに分けられます。

plugins/
├── backend/        # WASM モジュール — カスタムロジック、ルート、データモデルを追加
└── frontend/       # UI モジュール — カスタムページ、ボードビュー、ウィジェットを追加

ローカルでカスタムプラグインをインストールする場合

./scripts/install-local-plugin.sh ./my-plugin --api-key <your-api-key>

ドキュメントリソース

docs/architecture/overview.md

docs/guides/getting-started.md

docs/guides/local-development.md

docs/guides/mcp-server-setup.md

docs/guides/claude-code-skill.md

/paca

deploy/README.md

CHANGELOG.md

CONTRIBUTING.md

ライセンス情報

• ライセンス: Apache License 2.0
• 詳細:

  LICENSE

  ファイルを参照してください。