kok1eee

o-m-cc v0.31.1

English

Sisyphus Loop for Claude Code - TODOが完了するまで止まらないマルチエージェントワークフロー

Overview

o-m-cc は、Claude Code に仕様駆動開発（SDD）ワークフローを追加するプラグインです。

• Skill Chain: 要件分析 → 設計 → タスク分解 → 実装 → 品質ゲートを独立スキルとして chain 実行。各フェーズのコンテキストが分離される
• Agent Teams: peer-to-peer マルチエージェント協調。9の専門エージェントが SendMessage で相互検証
• diff ベース品質強制: Stop hook が変更行数を検知し、閾値超過時に quality-gate を自動強制。Claude の出力に依存しない
• Progressive Disclosure: エージェント定義を3層に分離し、常時ロードは全体の約10%に抑制

動作環境

• macOS / Linux: フルサポート
• Windows: WSL (Windows Subsystem for Linux) 経由で使用してください

Quick Start

# 1. marketplace 追加
claude plugin marketplace add kok1eee/o-m-cc

# 2. プラグインインストール
claude plugin install o-m-cc@kok1eee

# 3. プロジェクト初期化（CLAUDE.md作成 + Sisyphus有効化）
/o-m-cc:install

# 4. あとは普通に作業するだけ
「ログインボタンのバグを修正して」
→ 自動的に Sisyphus モードで動作

Agent Teams は plugin の settings.json で自動的に有効化されます。手動での環境変数設定は不要です。

Usage

簡単なタスク（バグ修正、小さな機能追加）

Sisyphus モード有効化後は、普通にタスクを依頼するだけ：

「APIのエラーハンドリングを追加して」
「ボタンの色を青に変更して」
「ログイン画面のバグを修正して」

自動的に TODO作成 → 実装 → レビュー → 完了 の流れで動作。

複雑なタスク（新機能、大きなリファクタリング）

計画フェーズを先に実行：

/o-m-cc:sisyphus "認証システムを実装"

計画→実装→品質ゲートまで自動で進行。

Skills

セットアップ

スキル	説明	自動発動
/o-m-cc:install	プロジェクト初期化（CLAUDE.md作成 + Sisyphus有効化）	手動のみ

既存プロジェクト（CLAUDE.md あり）でも /o-m-cc:install でOK。Sisyphusセクションのみ追加されます。

計画フェーズ

スキル	説明	Context	自動発動
/o-m-cc:deep-interview <idea>	ソクラテス式要件掘り下げ → discovery-council にハンドオフ	-	「要件が曖昧」「掘り下げて」「インタビュー」で発動
/o-m-cc:sisyphus <task>	計画→実装→品質ゲートまで止まらない Sisyphus ワークフロー	fork	「計画して」「この機能を実装したい」で発動
/o-m-cc:discovery-council <task>	3エージェント並列要件分析 Council	fork	「要件を整理して」「要件定義して」で発動
/o-m-cc:design	designer によるアーキテクチャ設計	-	「設計して」で発動
/o-m-cc:task-decomposition	planner によるタスク分解	-	「タスクに分解して」で発動

品質・運用

スキル	説明	Context	自動発動
/o-m-cc:quality-gate [files]	Review Council + 静的解析で品質最終確認	fork	「レビューして」「品質チェックして」で発動
/o-m-cc:audit [target]	エージェント・スキルの品質監査	-	手動のみ
/o-m-cc:handover	セッション文脈を .claude/context.md に保存	-	「引き継ぎ」「保存して」「今日はここまで」で発動

Context: fork — Council 系スキルが fork コンテキストで動くため、teammate のやり取りがメイン会話を汚さない。

Workflow

初回セットアップ

/o-m-cc:install
  → CLAUDE.md 作成（既存なら Sisyphus セクション追加）
  → .claude/agents/sisyphus.md 配置（デフォルトエージェント）
  → .gitignore、推奨パーミッション設定

簡単なタスク

「○○を修正して」→ TODO → 実装 → レビュー → 完了
※ stop-guard が diff 変更量を検知し、閾値以上なら /quality-gate を強制

複雑なタスク（/o-m-cc:sisyphus）

Agent Teams (Council + Pipeline ハイブリッド):
┌─────────────────────────────────────────────────────┐
│              Phase 1: Discovery Council               │
│     researcher ◄──► analyst ◄──► scout                │
│         peer-to-peer で findings を共有               │
└─────────────────────────────────────────────────────┘
          │ requirements.md
          ▼
  Phase 2 (designer) → Phase 3 (planner)
  design.md             TaskCreate
                           │
          ┌──────────────────────────────────────────┐
          │         Phase 4: 実装                      │
          │         Phase 5: Quality Gate              │
          │  code-reviewer ◄──► security-reviewer      │
          │         ◄──► critic                        │
          └──────────────────────────────────────────┘

Phase 1 は Discovery Council（peer-to-peer）、Phase 2-3 は Pipeline（順次）

実装フェーズ

「実装開始して」
  → Agent Teams → teammate 並列 spawn → レビュー → 完了

Architecture

Skill Chain（コンテキスト分離）

/o-m-cc:sisyphus は各フェーズを独立スキルとして chain 実行する:

sisyphus（オーケストレーター）
  → Skill: discovery-council  ← context: fork で分離
  → Skill: design             ← 前フェーズのコンテキストを引き継がない
  → Skill: task-decomposition
  → 実装（メインコンテキスト）
  → Skill: quality-gate       ← context: fork で分離

各スキルが context: fork で実行されるため、Council の大量のメッセージ交換がメインコンテキストを消費しない。フェーズ間の受け渡しは plan/requirements.md、plan/design.md、TaskCreate というファイル/タスクベース。

diff ベース品質強制

品質ゲートの強制は Claude の出力に一切依存しない:

stop-guard.sh（Stop hook）
  → jj diff --stat で変更行数を取得
  → セッションベースライン（開始時の既存差分）を差し引く
  → SISYPHUS_MIN_DIFF（デフォルト500行）以上なら quality-gate を強制
  → quality-gate 通過は proof ファイル（.claude/quality-gate-proof.json）で検証

LLM のトークン消費ゼロで品質チェックの実行を保証する。

peer-to-peer Council

Council パターン（Discovery Council、Review Council）では全 teammate が対等:

• Lead ロールなし（v0.20.0 で廃止）
• 全員が独立に分析し、SendMessage で findings を相互共有
• 相互検証を経た findings のみを最終報告

Dependencies

/o-m-cc:install 実行時に推奨プラグインをインストール。

# マーケットプレイス追加（初回のみ）
claude plugin marketplace add anthropics/claude-plugins-official

開発支援（共通）

プラグイン	用途
frontend-design	フロントエンド設計支援
feature-dev	機能開発ワークフロー
security-guidance	セキュリティレビュー支援

LSP（言語に応じて選択）