tomevault-io Workflow Guide Skill
A skill providing guidance on the Cursor ↔ Claude Code 2-agent workflow.
Trigger Phrases
This skill is invoked by the following phrases:
- "Tell me about the workflow"
- "How do I collaborate with Cursor?"
- "Explain the work process"
- "How should I proceed?"
- "how does the workflow work?"
- "explain 2-agent workflow"
Overview
This skill explains the role assignment and collaboration method between Cursor (PM) and Claude Code (Worker).
2-Agent Workflow
Role Assignment
| Agent | Role | Responsibilities |
|---|---|---|
| Cursor | PM (Project Manager) | Task assignment, review, production deploy decisions |
| Claude Code | Worker | Implementation, testing, CI fixes, staging deploy |
Workflow Diagram
┌─────────────────────────────────────────────────────────┐
│ Cursor (PM) │
│ - Add tasks to Plans.md │
│ - Delegate work to Claude Code (/handoff-to-claude) │
│ - Review completion reports │
│ - Make production deploy decisions │
└─────────────────────┬───────────────────────────────────┘
│ Task delegation
▼
┌─────────────────────────────────────────────────────────┐
│ Claude Code (Worker) │
│ - Execute tasks with /work (parallel execution) │
│ - Implement → Test → Commit │
│ - Auto-fix CI failures (up to 3 times) │
│ - Completion report with /handoff-to-cursor │
└─────────────────────┬───────────────────────────────────┘
│ Completion report
▼
┌─────────────────────────────────────────────────────────┐
│ Cursor (PM) │
│ - Review changes │
│ - Verify on staging │
│ - Execute production deploy (after approval) │
└─────────────────────────────────────────────────────────┘
Task Management with Plans.md
Marker List
| Marker | Meaning | Set by |
|---|---|---|
pm:requested |
Requested by PM (compatible: cursor:requested) | PM (Cursor/PM Claude) |
cc:TODO |
Claude Code not started | Either |
cc:WIP |
Claude Code in progress | Claude Code |
cc:done |
Claude Code complete | Claude Code |
pm:confirmed |
PM confirmation complete (compatible: cursor:confirmed) | PM (Cursor/PM Claude) |
cursor:requested |
(compatible) Same as pm:requested | Cursor |
cursor:confirmed |
(compatible) Same as pm:confirmed | Cursor |
blocked |
Blocked | Either |
Task State Transitions
pm:requested → cc:WIP → cc:done → pm:confirmed
Key Commands
Claude Code Side
| Command | Purpose |
|---|---|
/harness-init |
Project setup |
/plan-with-agent |
Planning/task breakdown |
/work |
Task execution (parallel execution supported) |
/handoff-to-cursor |
Completion report (to Cursor PM) |
/sync-status |
Status check |
Skills (Auto-invoked in Conversation)
| Skill | Trigger Example |
|---|---|
handoff-to-pm |
"Report completion to PM" |
handoff-to-impl |
"Hand off to implementation" |
Cursor Side (For Reference)
| Command | Purpose |
|---|---|
/handoff-to-claude |
Delegate tasks to Claude Code |
/review-cc-work |
Review completion reports |
CI/CD Rules
Claude Code's Scope of Responsibility
- ✅ Up to staging deploy
- ✅ Auto-fix CI failures (up to 3 times)
- ❌ Production deploy is prohibited
3-Strike Rule
If CI fails 3 times in a row:
- Stop auto-fix
- Generate escalation report
- Defer decision to Cursor
Frequently Asked Questions
Q: What if Cursor is not available?
A: Even when working alone, task management with Plans.md is recommended. Perform production deploys manually and carefully.
Q: What if a task is unclear?
A: Request clarification from Cursor, or use /sync-status to organize the current state.
Q: What if CI keeps failing?
A: Do not auto-fix more than 3 times; escalate to Cursor.
Related Documents
- AGENTS.md - Detailed role assignments
- CLAUDE.md - Claude Code specific configuration
- Plans.md - Task management file
Source: maxwell2732/claudecode-research-harness-workflow — distributed by TomeVault.