mcpField
W
workflow-guide

workflow-guide

github.com/chachamaru127Agent workflows3.2k40 installsUpdated 2w ago
Repository

About workflow-guide

workflow-guide explains a two-agent workflow between Cursor and Claude Code. It covers role assignments, task tracking in Plans.md, commands, and CI/CD boundaries for teams or individuals using this process.

Key features

  1. 01Explain Cursor and Claude Code roles
  2. 02Track task states with Plans.md
  3. 03Document commands for both agents
  4. 04Describe escalation after CI failures
  5. 05Define staging and production deployment responsibilities

Use cases

  1. 01Set up task handoffs between Cursor and Claude Code
  2. 02Track tasks from assignment through review
  3. 03Handle repeated CI failures
  4. 04Clarify staging and production deployment responsibilities

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/chachamaru127/claude-code-harness --skill workflow-guide

After installing, type/workflow-guidein Claude Code to confirm it loaded.

Bundled filesexamples/typical-workflow.mdreferences/commands.md

Details

From the project README

Workflow Guide Skill

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

トリガーフレーズ

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

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

概要

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

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

役割分担
エージェント役割責務
CursorPM（プロジェクトマネージャー）タスク割り当て、レビュー、本番デプロイ判断
Claude CodeWorker（作業者）実装、テスト、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:TODOClaude Code 未着手どちらでも
cc:WIPClaude 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-claudeClaude 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 - タスク管理ファイル

Comments

Markdown supported