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

•

Collaboration Tools

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

About

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.

Key Features

Defines specific PM (Cursor) and Worker (Claude Code) responsibilities
Standardizes task tracking using a shared Plans.md status marker system
Outlines automated handoff commands between development agents
Establishes CI/CD rules including a 3-try limit for autonomous fixes
6 GitHub stars
Supports parallel execution and status synchronization across tools

Use Cases

Setting up a multi-agent development environment between Cursor and Claude Code
Onboarding developers to the 'Project Manager vs Worker' AI collaboration pattern
Coordinating task handoffs and state management in complex coding projects

About

Key Features

Defines specific PM (Cursor) and Worker (Claude Code) responsibilities
Standardizes task tracking using a shared Plans.md status marker system
Outlines automated handoff commands between development agents
Establishes CI/CD rules including a 3-try limit for autonomous fixes
6 GitHub stars
Supports parallel execution and status synchronization across tools

Use Cases

Setting up a multi-agent development environment between Cursor and Claude Code
Onboarding developers to the 'Project Manager vs Worker' AI collaboration pattern
Coordinating task handoffs and state management in complex coding projects