Skip to main content
SECTION · WORKFLOW COMMANDS

ワークフローコマンド

情報
所属バリュー: エージェント型ハーネス

SPEC 3フェーズパイプライン

SPEC ベースの 3-Phase ライフサイクル (plan → run → sync) を実行するコマンド群です。

エージェンティックハーネスの中心 — 3-Phase ライフサイクル

MoAI-ADK v3 の中核的な価値の 1 つが エージェンティックハーネス (Agentic Harness) です。コードを直接書く代わりに、エージェントがうまく働ける環境 — SPEC ドキュメント、品質ゲート、フィードバックループ — を設計するという意味です。ワークフローコマンドは、このハーネスの中心軸である plan → run → sync パイプラインを実行します。

各段階は専門化されたエージェントが担当し、作った本人が検査しないように 計画と監査が分離 されています。plan 段階の成果物は plan-auditor が独立して監査し、sync 段階の結果物は sync-auditor が 4 次元 (Functionality・Security・Craft・Consistency) で評価します。run 段階に入る直前には 実装着手承認 (ヒューマンゲート) が常にユーザーに戻ってきます。

flowchart TD
    A["/moai project
プロジェクトドキュメント生成"] --> B["/moai plan
SPEC ドキュメント生成"] B --> D["/moai run
DDD/TDD 実装"] D --> E["/moai sync
ドキュメント同期と PR"] E -.-> B D -.-> B F["/moai harness
ハーネス学習システム"] -.-> D

コマンド要約

コマンド段階担当エージェントトークン予算目的
/moai projectPhase 0manager-docs-プロジェクトドキュメントの自動生成
/moai planPhase 1manager-spec30KSPEC ドキュメントの生成
/moai runPhase 2manager-develop180KDDD/TDD 方式の実装
/moai syncPhase 3manager-docs40Kドキュメント同期と PR 作成
/moai harness補助builder-harness-ハーネス生成と学習ライフサイクル管理

段階ごとにトークン予算が異なるのも、v3 の トークノミクス (Token Economics) 設計の一部です。計画は深い推論が必要ですが成果物が小さく (30K)、実装はコード量が多いため余裕のある予算が必要で (180K)、ドキュメント同期はその中間 (40K) です。段階の間に /clear でコンテキストを空にする慣行も同じ理由から生まれます — 前の段階の会話を次の段階に持ち込まないことで、各段階が予算をまるごと使えます。

情報

初めて使う場合は /moai project から始めてください。プロジェクトドキュメントがあってこそ、以降の段階で AI がプロジェクトを正確に理解して作業できます。

/moai harness はハーネス学習サブシステム管理用の補助コマンドです — CLAUDE.md の変更をモニタリングし、ティアベースの自動更新を提案します。

全サブコマンド (15 個)

/moai オーケストレーターは 15 個のサブコマンドをルーティングします。このセクション (ワークフロー) は SPEC 3-Phase ライフサイクルのコマンドを、ユーティリティコマンド セクションは自動化・修正ループ・コード管理・フィードバックのコマンドを扱います。

ワークフローコマンド (このセクション):

サブコマンド目的
/moai planSPEC ドキュメント生成
/moai runDDD/TDD 実装
/moai syncドキュメント同期と PR
/moai projectプロジェクトドキュメント生成
/moai harnessハーネス生成と学習ライフサイクル

ユーティリティコマンド (ユーティリティセクション):

サブコマンド目的
/moai fix一回限りの自動修正
/moai loop反復修正ループ
/moai mx@MX コード注釈
/moai feedbackGitHub イシューフィードバック
/moai review多観点コードレビュー (セキュリティ・@MX)
/moai cleanデッドコード除去
/moai codemapsアーキテクチャコードマップ生成
/moai gateコミット前の品質ゲート
/moai e2eマルチプラットフォーム E2E テスト
/moai goal条件宣言型の自律ループ

クイックスタート

bash
# Phase 0: プロジェクトドキュメント生成 (初回 1 回)
> /moai project

# Phase 1: SPEC 生成
> /moai plan "ユーザー認証機能の実装"
> /clear

# Phase 2: DDD 実装
> /moai run SPEC-AUTH-001
> /clear

# Phase 3: ドキュメント同期と PR
> /moai sync SPEC-AUTH-001

# 補助: ハーネス学習管理 (任意)
> /moai harness status
> /moai harness apply

自然言語でそのままリクエストしてもかまいません。/moai "ログインのバグを直して" のようにサブコマンドなしで入力すると、Analyze-First ルーティング が意図を分析して適切なワークフローに自動接続します。

関連ドキュメント