MAXAM

MAXAM

Multi Agent eXecution And Management - AIエージェントチームによる開発支援システム

概要

MAXAMは6人のAIエージェントが協調して開発業務を遂行するシステムです。

前列左から: Shiori Tanaka（田中 栞）、Mei Chen（メイ・チェン）、Yuki Tanaka（田中 雪） 後列左から: Amara Okonkwo（アマラ・オコンクォ）、Rin Sato（佐藤 凛）、Priya Sharma（プリヤ・シャルマ）

セットアップ

必要環境

• Claude Code CLI (claude)

インストール方法

ダウンロード（推奨）

GitHub Releases からお使いの環境に合ったバイナリをダウンロード：

https://github.com/ytnobody/MAXAM/releases

go install

go install github.com/ytnobody/MAXAM/cmd/maxam@latest

ソースからビルド

git clone https://github.com/ytnobody/MAXAM.git
cd MAXAM
make build

使い方

チームチャット（メイン）

./bin/maxam

リッチなターミナルUIでチームとチャットできます。

操作方法

コマンド

使用例

┌─ MAXAM Team Chat ─────────────────────────────────┐
│                                                   │
│ You: ログイン機能作りたいんだけど                   │
│                                                   │
│ Mei: いいですね！いくつか確認させてください：       │
│ 1. 認証方式は？（JWT / セッション / OAuth）        │
│ 2. ...                                            │
│                                                   │
│ You: @yuki JWTでお願い                            │
│                                                   │
│ Yuki: 了解。JWT認証で実装する。                    │
│                                                   │
├───────────────────────────────────────────────────┤
│ 履歴:2 ↑↓:履歴 PgUp/Dn:スクロール                 │
│ You: _                                            │
└───────────────────────────────────────────────────┘

機能

• プロジェクト自動分析: 起動時にカレントディレクトリを分析し、README.md等の情報をエージェントと共有
• カラー表示: 各エージェントが異なる色で表示
• 入力履歴: 過去の入力を↑↓キーで再利用可能
• コンテキストモード: トークン消費を抑えるsummaryモード対応
• YOLOモード: Ctrl+Yで切り替え。エージェントが確認質問をせず自分の判断で進める

設定ファイル

~/.maxam/config.yaml で動作をカスタマイズできます：

# コンテキストモード: full（デフォルト）または summary
# summaryモードはCLAUDE.summary.mdを使用し、トークン消費を約80%削減
context_mode: summary

# YOLOモード: 起動時からONにする場合
yolo_mode: true

# エージェントごとのモデル指定（省略時はデフォルトモデル）
agents:
  - name: mei
    model: sonnet
  - name: yuki
    model: sonnet
  - name: priya
    model: haiku  # レビューサイクルはhaiku推奨
  - name: amara
    model: sonnet

context_modeの選び方:

• full: フルコンテキストが必要な複雑な作業向け
• summary: 日常的な作業でコスト削減したい場合（CLAUDE.summary.mdが必要）

モデル選択のヒント:

• sonnet: バランス型、通常の実装・分析向け
• haiku: 高速・低コスト、レビュー・軽量タスク向け
• opus: 複雑な判断が必要な場合

CLIコマンド

# 対話モード
./bin/maxam chat yuki    # Yukiと1対1で対話
./bin/maxam chat team    # チーム全体と対話

# 単発コマンド
./bin/maxam task "ログイン機能を実装して"
./bin/maxam review "テストを書いて"
./bin/maxam ask priya "このコード大丈夫？"
./bin/maxam analyze      # Amaraの分析
./bin/maxam status       # ステータス確認

エージェントへの指示

メンション

自然に話しかける

You: 新しいAPI作りたい
Mei: どんなAPIですか？詳しく教えてください。

You: ユーザー一覧を返すGET /users
Mei: 了解です。Yukiに実装を依頼しますね。@yuki、お願いできる？

You: @yuki お願い
Yuki: 了解。GET /users 作る。DBスキーマはある？

情報が足りないときはエージェントが質問してきます。

ディレクトリ構造

MAXAM/
├── cmd/
│   └── maxam/          # CLIツール（チームチャット）
├── internal/
│   ├── agent/          # エージェント管理
│   ├── tui/            # ターミナルUI
│   ├── task/           # タスク管理
│   └── ...             # その他のパッケージ
├── agents/             # 各エージェントのCLAUDE.md
│   ├── mei/
│   ├── yuki/
│   ├── rin/
│   ├── shiori/
│   ├── priya/
│   └── amara/
├── logs/               # 実行ログ
└── CLAUDE.md           # 共通規約

ワークフロー

基本フロー

ユーザー → Mei（要件整理）→ Yuki/Rin（実装）→ Shiori（テスト）→ Priya（レビュー）
                ↑                                                      │
                └─────────────────── フィードバック ───────────────────┘

自己改善

ログ蓄積 → Amara分析 → CLAUDE.md更新

スーパーバイザー運用

チーム開発では、オーナー（スーパーバイザー）との連携が重要です。

相談するタイミング:

• 判断に迷ったとき
• 設計の大きな分岐点
• 要件の解釈が複数あるとき
• セキュリティに関わる問題

気軽に聞いてOK:

• 「〜でいいですか？」レベルで確認
• 完璧な質問でなくていい
• 大きな作業に入る前は方針を共有

エージェント → オーナーに相談 → 方針決定 → 実行

コントリビューション

コントリビューションを歓迎します！詳しくは CONTRIBUTING.md をご覧ください。

セキュリティ

セキュリティに関する問題を発見された場合は SECURITY.md をご確認ください。

ライセンス

MIT License - 詳細は LICENSE を参照してください。

作者

ytnobody