What is the 2-agent workflow for Claude Code?

It is a collaborative pattern where Cursor acts as the Project Manager (PM) for planning and review, and Claude Code acts as the Worker for implementation, testing, and staging.

Which commands facilitate the handoff process?

Key commands include /handoff-to-claude (Cursor side) to assign work and /handoff-to-cursor (Claude Code side) to report completion and request review.

How are tasks tracked between Cursor and Claude Code?

Tasks are managed in a shared Plans.md file using standardized markers like 'pm:依頼中' (requested) and 'cc:完了' (completed) to transition between roles.

Can Claude Code deploy to production in this workflow?

No, the workflow strictly limits Claude Code to staging deployments. Production deployment decisions and executions remain the responsibility of the PM/User via Cursor.

What happens if a CI build fails during the workflow?

Claude Code will attempt to automatically fix CI failures up to 3 times. If the issue persists, it generates an escalation report for the PM to review.

Workflow Guide for Cursor & Claude Code

Name: Workflow Guide for Cursor & Claude Code
Author: Chachamaru127

byChachamaru127

•

협업 도구

Guides developers through the collaborative 2-agent workflow between Cursor and Claude Code for efficient project management and task execution.

This skill provides a comprehensive framework for orchestrating a dual-agent development environment where Cursor acts as the Project Manager (PM) and Claude Code serves as the primary implementation Worker. It defines clear role boundaries, manages task transitions via a structured Plans.md system, and outlines standardized handoff protocols. By following this guide, developers can leverage autonomous Plan-Work-Review cycles that include automated testing and staging deployments while maintaining human oversight for production releases.

주요 기능

01Defines specific PM (Cursor) and Worker (Claude Code) responsibilities

02Standardizes task tracking using a shared Plans.md status marker system

03Outlines automated handoff commands between development agents

04Establishes CI/CD rules including a 3-try limit for autonomous fixes

056 GitHub stars

06Supports parallel execution and status synchronization across tools

사용 사례

01Setting up a multi-agent development environment between Cursor and Claude Code

02Onboarding developers to the 'Project Manager vs Worker' AI collaboration pattern

03Coordinating task handoffs and state management in complex coding projects

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add chachamaru127/claude-code-harness workflow-guide

For use in Claude.ai and ChatGPT

Download Skill