workflow-guide

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

⭐85stars🔀4forks📁View on GitHub🕐Updated Dec 29, 2025

When & Why to Use This Skill

This Claude skill provides comprehensive guidance on the 2-agent workflow between Cursor and Claude Code. It defines the roles of Cursor as the Project Manager and Claude Code as the Worker, ensuring efficient task delegation, status tracking via Plans.md, and seamless handoffs for software development projects.

Use Cases

  • 1. Multi-Agent Collaboration: Coordinating tasks between Cursor (PM) and Claude Code (Worker) to streamline the development lifecycle.
  • 2. Task Management & Tracking: Using Plans.md markers to monitor progress from task assignment to final review.
  • 3. Automated CI/CD Workflows: Implementing the '3-strike rule' for CI failure recovery and managing staging vs. production deployments.
  • 4. Developer Onboarding: Providing clear instructions and command references for teams adopting the Cursor-Claude Code ecosystem.
nameworkflow-guide
description"Provides guidance on Cursor ↔ Claude Code 2-agent workflow. Use when user asks about workflow, collaboration, or process. Do NOT load for: implementation work, workflow setup, or executing handoffs."
allowed-tools["Read"]
user-invocablefalse

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 - タスク管理ファイル