コアコンセプト
Minion Workspaceを構成する主要な概念を説明します。
ミニオンは、専用の機械の上で動く AI エージェント(Claude Code)です。機械は、Minion Workspace が用意するクラウド VPS、手元の PC やサーバー、Docker のコンテナのどれかです。機械には Minion が入り、次のもので動きます。
| コンポーネント | 説明 |
|---|---|
| Minion Agent | Minion Workspace へ自分から接続し続け、チャット・実行・ターミナル・画面共有・ファイルの依頼を受け取るサービス。機械でポートを開けません |
minion ユーザー | AI が動く OS のユーザー。エージェントとは分かれています。使える道具と権限は Minion Workspace から設定します |
| Claude Code | AI の実行環境。ミニオンの頭脳タブから入れます |
| 画面 | 機械の画面(Windows・macOS)か仮想のディスプレイ(Linux・Docker・クラウド VPS)。Minion Workspace から画面共有で見られます |
| 更新役 | Minion の新しい版を自分で入れます(Docker にはありません) |
追加のしかたは ミニオンの追加と管理 を参照してください。
プロジェクト
Section titled “プロジェクト”プロジェクトはワークフローとコンテキストをまとめる単位です。
- 人とミニオンをメンバーとして加え、一人ずつ権限(管理者 / 編集者 / メンバー)で何を変えられるかを決める。詳しくはプロジェクトのメンバーと権限
- 共有コンテキストをMarkdownで定義
- ワークスペースの人なら誰でもプロジェクトを見られる。変えられるのはメンバーだけ
ボードは、プロジェクトの「やること」を1枚ずつチケットに書き出して並べる場所です。チケットは Backlog → Todo → Doing → Review → Done の5列を左から右へ進むので、誰が何をしていて、どこで止まっているかが列の位置でわかります。
- チケットの担当には、人だけでなくミニオンも選べる。「何ができたら終わりか」(受け入れ要件)を書いておけば、ミニオンが作業して Review に置く
- チケットが増えてきたら、絞り込み・カスタムフィールド・スプリント・ロードマップが使える
- プロジェクトごとのオプトイン(プロジェクトの「設定」タブで有効化)
ワークフローとの違いは仕事の形です。ワークフローは決まった手順を繰り返し実行するためのもので、ボードはその都度発生する仕事を1件ずつ書き出して進めるためのものです。定型の手順はワークフロー、都度発生する作業はボード、と使い分けます。
詳しくはボードを参照してください。
スキルはClaude Codeの再利用可能なプロンプトです。SKILL.mdファイルとして定義され、バージョン管理されます。
---name: my-skilldisplay_name: My Skilldescription: スキルの説明---
ここにプロンプトの本文を記述します。スキルは付随するファイル(テンプレート、設定等)を持つこともできます。
ワークフロー
Section titled “ワークフロー”ワークフローはプロジェクト単位のグラフで、スキルと複数のミニオンを組織的なガバナンスのもとで協調させます。一本道のステップ列ではなく、ノードをエッジでつないだDAG(有向非巡回グラフ)として、HQのビジュアルエディタで構築します。
flowchart LR S(("Start")) --> A["Skill: fetch"] A --> C{{"Conditional"}} C -->|ok| F[["Fan-out"]] C -->|error| E(("End")) F --> J(("Join")) J --> R{"Review"} R -->|approved| E- 並列実行・fan-out/join・条件分岐 — 単なる直列ではなく実際の依存関係を表現できる
- cron式によるスケジュール実行、HQからのオンデマンド実行、外部からのWebhook URLによる起動
- 各ノードに実行ロール(PM / Engineer)を割り当て可能
- レビューノードで人間(またはミニオン)の承認ゲートと差し戻しループを挟める
- 完全なバージョン管理 — 変更のたびにイミュータブルなスナップショットを作成
- HQデータベースに完全な監査証跡を記録
利用できるノードの種類はDAGノードを参照してください。
ルーティンはミニオン単位のパイプラインで、自律的に完結するスケジュールタスクです。
flowchart LR A["skill-1"] --> B["skill-2"]- プロジェクトではなくミニオン個体が所有
- ミニオン上のcronスケジューラでHQを介さず自律実行
- ロール割り当てやレビューゲートなし — 所有ミニオンがすべてのステップを実行
- 常に最新のスキルバージョンを使用(バージョン固定なし)
- 実行履歴はミニオンのローカルに保存
ルーティンはミニオン個人のcrontabと考えてください。
使い分けの判断基準
Section titled “使い分けの判断基準”複数スキルを扱うかどうかではなく、ガバナンスのレベルとオーケストレーションの複雑さが差別化のポイントです。
- **「誰が実行するか」**が1体で決まっている → ルーティン
- **「誰が実行するか」**をロールで割り振る → ワークフロー
- レビューゲートや監査証跡が必要 → ワークフロー
- 並列分岐・fan-out・条件分岐が必要 → ワークフロー
- ミニオンの自律的な習慣 → ルーティン
同じスキルをルーティンにもワークフローにも使えます。詳細な比較と例はルーティン設計を参照してください。