WF Management System

AI（Claude Code）と人間が同じ状態と成果物を見ながら作業するためのワークフロー管理システム。

概要

このシステムは以下の課題を解決します：

• 状態の共有: AIと人間が同じ作業状態を把握
• 成果物の一元管理: ドキュメントとコードを連携して管理
• 作業の再現性: 異なるPCやセッションで作業を継続可能
• 計画外変更の防止: 計画された作業のみを実装

セットアップ

前提条件

以下のツールが必要です：

• bash - シェルスクリプト実行
• jq - JSON処理
• gh - GitHub CLI
• git - バージョン管理

インストール

方法1: amuを使用（推奨）

amuを使うと複数のdotclaude設定を簡単に管理できます。

# 1. このリポジトリをクローン
git clone https://github.com/your-org/dotclaude.git

# 2. ~/.claudeディレクトリでamu addを実行
cd ~/.claude
amu add /path/to/dotclaude/dotclaude

方法2: シンボリックリンク

# 1. このリポジトリをクローン
git clone https://github.com/your-org/dotclaude.git

# 2. dotclaudeを~/.claudeにシンボリックリンク（グローバル設定）
ln -s /path/to/dotclaude/dotclaude ~/.claude

# または、プロジェクト単位で使用
cd your-project
ln -s /path/to/dotclaude/dotclaude .claude

初期化

# プロジェクトでWFシステムを初期化
./path/to/dotclaude/scripts/wf-init.sh

以下が作成されます：

• .wf/config.json - 共有設定
• .wf/state.json - 共有状態
• docs/wf/ - ワークフロードキュメント
• .gitignoreに.wf/local.jsonを追加

コマンド一覧

環境コマンド (wf0-*)

ワークフローコマンド (wf1-6)

ユーティリティコマンド

ワークフロー

基本フロー

/wf1-kickoff github=123（ワークスペース＋目標と成功基準を定義）
    ↓
/wf2-spec（変更仕様を作成）
    ↓
/wf3-plan（実装ステップを計画）
    ↓
/wf4-review（任意: 計画レビュー）
    ↓
/wf5-implement（1ステップずつ実装）
    ↓ ↑ 繰り返し
/wf6-verify pr（検証してPR作成）

自動進行

# 次のステップを自動実行
/wf0-nextstep

作業の復元

# 別のPCで作業を継続
/wf0-restore FEAT-123-export-csv

Kickoffの修正

# 指示を与えて修正
/wf1-kickoff revise "CSVエクスポートのみにスコープを絞る"

リモート操作

# GitHub Issueコメントで承認待ちモード
/wf0-remote start FEAT-123-auth

# 複数ワークを同時監視
/wf0-remote start --all

リポジトリ構造

dotclaude/                 # リポジトリルート
├── dotclaude/             # ~/.claudeにリンクする対象
│   ├── agents/            # サブエージェント定義
│   ├── commands/          # スラッシュコマンド定義
│   ├── skills/            # アーキテクチャスキル（iOS/Android/KMP/AWS SAM）
│   ├── rules/             # プロジェクトルール・スキーマ
│   ├── guides/            # アーキテクチャガイド
│   ├── examples/          # 設定ファイル例
│   ├── scripts/           # シェルスクリプト
│   └── templates/         # ドキュメントテンプレート
├── .gitignore
└── README.md

ディレクトリ構造

your-project/
├── .wf/
│   ├── config.json      # 共有設定（コミット対象）
│   ├── state.json       # 共有状態（コミット対象）
│   └── local.json       # ローカル設定（gitignore）
├── docs/wf/
│   └── FEAT-123-slug/
│       ├── 00_KICKOFF.md
│       ├── 01_SPEC.md
│       ├── 02_PLAN.md
│       ├── 03_REVIEW.md
│       ├── 04_IMPLEMENT_LOG.md
│       └── 05_REVISIONS.md
└── .claude/             # dotclaudeからのシンボリックリンク
    └── commands/        # スラッシュコマンド
        ├── wf1-kickoff.md
        ├── wf0-restore.md
        └── ...

設定ファイル

config.json

{
  "default_base_branch": "develop",
  "base_branch_candidates": ["develop", "main", "master"],
  "branch_prefix": {
    "FEAT": "feat",
    "FIX": "fix",
    "REFACTOR": "refactor",
    "CHORE": "chore",
    "RFC": "rfc"
  },
  "worktree": {
    "enabled": false,
    "root_dir": ".worktrees"
  }
}

state.json

{
  "active_work": "FEAT-123-export-csv",
  "works": {
    "FEAT-123-export-csv": {
      "current": "wf5-implement",
      "next": "wf6-verify",
      "source": {
        "type": "github",
        "id": "123",
        "title": "Add CSV export feature"
      },
      "git": {
        "base": "develop",
        "branch": "feat/123-export-csv"
      },
      "plan": {
        "total_steps": 5,
        "current_step": 3
      }
    }
  }
}

サブエージェント

Claude CodeのTaskツールを活用した専門エージェント群。 ワークフローコマンドと連携して動作し、/agentコマンドで直接呼び出すことも可能。

ワークフロー支援型

タスク特化型

| エージェント | 目的 | |---

...