workflow-guide

# Workflow Guide Skill

Cursor ↔ Claude Code 2エージェントワークフローのガイダンスを提供するスキル。

---

## トリガーフレーズ

このスキルは以下のフレーズで起動します：

- 「ワークフローについて教えて」
- 「Cursor との連携方法は？」
- 「作業の流れを教えて」
- 「どうやって進めればいい？」
- "how does the workflow work?"
- "explain 2-agent workflow"

---

## 概要

このスキルは、Cursor（PM）と Claude Code（Worker）の役割分担と連携方法を説明します。

---

## 2エージェントワークフロー

### 役割分担

| エージェント | 役割 | 責務 |
|-------------|------|------|
| **Cursor** | PM（プロジェクトマネージャー） | タスク割り当て、レビュー、本番デプロイ判断 |
| **Claude Code** | Worker（作業者） | 実装、テスト、CI修正、staging デプロイ |

### ワークフロー図

```
┌─────────────────────────────────────────────────────────┐
│                    Cursor (PM)                          │
│  ・タスクを Plans.md に追加                              │
│  ・Claude Code に作業を依頼（/handoff-to-claude）            │
│  ・完了報告をレビュー                                    │
│  ・本番デプロイの判断                                    │
└─────────────────────┬───────────────────────────────────┘
                      │ タスク依頼
                      ▼
┌─────────────────────────────────────────────────────────┐
│                  Claude Code (Worker)                   │
│  ・/work でタスク実行（並列実行対応）                   │
│  ・実装 → テスト → コミット                             │
│  ・CI 失敗時は自動修正（3回まで）                        │
│  ・/handoff-to-cursor で完了報告                        │
└─────────────────────┬───────────────────────────────────┘
                      │ 完了報告
                      ▼
┌─────────────────────────────────────────────────────────┐
│                    Cursor (PM)                          │
│  ・変更内容を確認                                        │
│  ・staging 動作確認                                      │
│  ・本番デプロイ実行（承認後）                            │
└─────────────────────────────────────────────────────────┘
```

---

## Plans.md によるタスク管理

### マーカー一覧

| マーカー | 意味 | 設定者 |
|---------|------|--------|
| `pm:依頼中` | PM から依頼（互換: cursor:依頼中） | PM（Cursor/PM Claude） |
| `cc:TODO` | Claude Code 未着手 | どちらでも |
| `cc:WIP` | Claude Code 作業中 | Claude Code |
| `cc:完了` | Claude Code 完了 | Claude Code |
| `pm:確認済` | PM 確認完了（互換: cursor:確認済） | PM（Cursor/PM Claude） |
| `cursor:依頼中` | （互換）pm:依頼中 と同義 | Cursor |
| `cursor:確認済` | （互換）pm:確認済 と同義 | Cursor |
| `blocked` | ブロック中 | どちらでも |

### タスクの状態遷移

```
pm:依頼中 → cc:WIP → cc:完了 → pm:確認済
```

---

## 主要コマンド

### Claude Code 側

| コマンド | 用途 |
|---------|------|
| `/harness-init` | プロジェクトセットアップ |
| `/plan-with-agent` | 計画・タスク分解 |
| `/work` | タスク実行（並列実行対応） |
| `/handoff-to-cursor` | 完了報告（Cursor PMへ） |
| `/sync-status` | 状態確認 |

### スキル（会話で自動起動）

| スキル | トリガー例 |
|--------|-----------|
| `handoff-to-pm` | 「PMに完了報告」 |
| `handoff-to-impl` | 「実装役に渡して」 |

### Cursor 側（参考）

| コマンド | 用途 |
|---------|------|
| `/handoff-to-claude` | Claude Code にタスク依頼 |
| `/review-cc-work` | 完了報告のレビュー |

---

## CI/CD ルール

### Claude Code の責務範囲

- ✅ staging デプロイまで
- ✅ CI 失敗時の自動修正（3回まで）
- ❌ 本番デプロイは禁止

### 3回ルール

CI が 3回連続で失敗した場合：
1. 自動修正を中止
2. エスカレーションレポートを生成
3. Cursor に判断を委ねる

---

## よくある質問

### Q: Cursor がいない場合は？

A: 一人で作業する場合も、Plans.md でタスク管理することを推奨します。
本番デプロイは手動で慎重に行ってください。

### Q: タスクが不明確な場合は？

A: Cursor に確認を依頼するか、`/sync-status` で現状を整理してください。

### Q: CI が何度も失敗する場合は？

A: 3回以上は自動修正せず、Cursor にエスカレーションしてください。

---

## 関連ドキュメント

- AGENTS.md - 詳細な役割分担
- CLAUDE.md - Claude Code 固有の設定
- Plans.md - タスク管理ファイル