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

Plans.md によるタスク管理

マーカー一覧

タスクの状態遷移

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

主要コマンド

Claude Code 側

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

Cursor 側（参考）

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