name	workflow-guide
description	Provides guidance on Cursor ↔ Claude Code 2-agent workflow. Use when user mentions ワークフローについて, Cursorとの連携, 作業の流れ, 2-agent workflow, collaboration. Do NOT load for: 実装作業, ワークフロー設定, ハンドオフ実行.
allowed-tools	Read
metadata	[object Object]

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回連続で失敗した場合：

自動修正を中止
エスカレーションレポートを生成
Cursor に判断を委ねる

よくある質問

Q: Cursor がいない場合は？

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

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

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

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

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

workflow-guide

Install Skill

SKILL.md