maggy

Maggy Skill

Maggy は、汎用的なローカル AI エンジニアリングの司令塔です。一度インストールして、チームの課題管理ツールとコードベースを設定するだけで、次のことができます。

• AI による優先順位付けされた受信トレイ — 緊急度、OKR との整合性、更新日時に基づいて未解決の課題に優先順位を付けます
• ワンクリックで実行 — iCPG のコンテキストを注入して、ローカルで Claude Code を起動します
• 競合情報 — 競合状況について、AI による日次ブリーフィングを受け取れます
• ハードコーディング不要 — あらゆるチーム、技術スタック、課題管理ツールで動作します

⚠️ Execute の権限モデル（重要）

Execute は現在、TDD パイプラインが承認プロンプト待ちでブロックされないように（サブプロセスにターミナルがないため）、claude -p --dangerously-skip-permissions を実行します。このフラグを使うと、Claude に対象コードベース内のファイルの書き込み・編集と、シェルコマンドの実行に関する完全な権限が付与されます。また、Claude が受け取るプロンプトには課題管理ツールの内容が含まれます（チームのメンバーなら誰でも作成できます）。

すでに導入済みのセキュリティ対策：

• working_dir は ~/.maggy/config.yaml にあるコードベースのルート一覧と照合されます。Claude に任意のファイルシステムパスを指定することはできません。
• 設定済みのトラッカーのチケットのみが Execute に渡されます。プロンプトに公開インターネットからの入力は含まれません。

ロードマップ： 無条件に使われているフラグをコードベースごとの設定（auto_approve: true|false）に移し、特権実行をオプトインにする予定です。それまでは、ボタンを押したチケットに対して Execute を実行することは、git pull && make を実行するのと同じように扱ってください。所有しているリポジトリで、信頼できる作成者のチケットに対してのみ実行してください。

┌──────────────────────────────────────────────────────────────┐
│  maggy               ──────────────┐                          │
│  ├── skills/         ← installed globally → ~/.claude/       │
│  ├── commands/       ← installed globally → ~/.claude/       │
│  ├── scripts/icpg/   ← used by Maggy for context enrichment  │
│  └── maggy/          ← dashboard: run `./install.sh` to use  │
│      ├── src/                                                │
│      │   ├── providers/   ← GitHub / Asana / Linear          │
│      │   ├── services/    ← inbox, competitor, executor      │
│      │   └── api/         ← FastAPI routes                   │
│      └── install.sh                                          │
└──────────────────────────────────────────────────────────────┘

---

Maggy が役立つ場面

シナリオ	Maggy の活用方法
朝、未解決の課題 50 件をトリアージする	AI が順位付けし、優先度の高い項目を上位に保ちます
チケットを実装する	Execute → iCPG の情報を反映した TDD パイプライン
「競合他社は何をリリースしている？」	日次ブリーフィングと、フィルター可能なニュースフィード
チームで複数のリポジトリを使う	チケットの内容に基づいて適切なリポジトリを自動選択します
新しいチームメンバーをオンボーディングする	/maggy-init で設定でき、コードを書く必要はありません

---

インストールと設定

# One-time install
cd $(cat ~/.claude/.bootstrap-dir)/maggy
./install.sh

# Configure
# Edit ~/.maggy/config.yaml — see maggy/config.example.yaml for the schema

# Credentials
export GITHUB_TOKEN=ghp_...
export ANTHROPIC_API_KEY=sk-ant-...

# Run
python3 -m src.main

# Or from Claude Code:
#   /maggy-init    # interactive wizard
#   /maggy         # launch dashboard

---

プロバイダーの抽象化

Maggy のサービスが GitHub／Asana に直接アクセスすることはありません。IssueTrackerProvider Protocol を介してやり取りします。次のプロバイダーを簡単に切り替えられます。

• GitHubIssuesProvider — 複数のリポジトリをスキャンし、未解決の課題を集約し、「done」をクローズ済みにマッピングします
• AsanaProvider — プロジェクトを検索し、ワークスペースの範囲を尊重します
• LinearProvider — 将来に向けたスタブです

同じ受信トレイ、Execute パイプライン、競合情報機能を、どのプロバイダーでも利用できます。

---

Execute パイプライン

チケットの Execute をクリックすると、次の処理が行われます。

1. Maggy が設定済みの iCPG を検索し、関連するシンボル、影響範囲、過去のインテントを取得します
2. チケットのキーワードと設定済みのコードベースに基づいて、適切な作業ディレクトリを選択します
3. そのディレクトリで claude -p --dangerously-skip-permissions を起動します
4. 分析 → 失敗するテストの作成 → 実装を実行します
5. 出力をセッションに記録します。セッションは Sessions タブで確認できます

起動した Claude Code は対象リポジトリ内で実行されるため、次の情報を読み込みます。

• そのリポジトリの CLAUDE.md
• グローバルの ~/.claude/CLAUDE.md
• すべてのブートストラップスキル
• .claude/hooks/、.mcp.json

そのため Execute では、簡略化されていない完全なブートストラップ環境を利用できます。

---

競合情報

汎用的な設計で、あらゆるドメインで利用できます。

1. ~/.maggy/config.yaml で competitors.categories: ["fintech", "embedded-finance"] を設定します
2. Discover をクリックすると、Claude が競合他社を 12～18 社特定します（市場リーダー、AI を最優先する新興企業、特定分野の専門企業）
3. Maggy が各社の RSS ブログと Google News を毎日監視します
4. 日次ブリーフィングは 1 日に 1 回生成され、キャッシュされます。必要に応じて再生成することもできます

---

含まれない機能

Maggy の MVP は、対象を絞っています。次の機能はまだ提供されていません。

• ミーティングボット（音声）
• Slack 連携
• P2P ネットワークとセッションの引き継ぎ
• 自己改善（/improve-maggy）
• Linear プロバイダー（スタブのみ）

これらは v2 で対応する予定です。

---

Files

• maggy/PLAN.md — architecture rationale
• maggy/README.md — user docs
• maggy/src/providers/base.py — IssueTrackerProvider Protocol
• maggy/src/services/executor.py — TDD pipeline
• maggy/src/services/competitor.py — discovery + briefing
• maggy/src/services/inbox.py — AI prioritization
• commands/maggy.md — /maggy launcher
• commands/maggy-init.md — /maggy-init setup wizard