[IMPORTANT] Use TaskCreate to break ALL work into small tasks BEFORE starting — including tasks for each file read. This prevents context loss from long files. For simple tasks, AI MUST ask user whether to skip.
Prerequisites: MUST READ .claude/skills/shared/understand-code-first-protocol.md before executing.
Quick Summary
Goal: Create a structured handoff record documenting what's ready, what's outstanding, and context for the receiving role.
Workflow:
-
Summarize — What was completed by the sending role
-
Artifacts — List deliverables (PBI, stories, designs, code, tests)
-
Outstanding — Known issues, open questions, risks
-
Context — Key decisions made, rationale, assumptions
-
Next Steps — What the receiving role should do first
Key Rules:
-
Handoff must include artifact references (file paths, PBI IDs)
-
Flag any blockers or dependencies
-
Include contact/escalation info if applicable
Be skeptical. Apply critical thinking, sequential thinking. Every claim needs traced proof, confidence percentages (Idea should be more than 80%).
Handoff Types
From To Key Artifacts
PO → BA Idea, PBI draft Problem statement, business value, constraints
BA → Dev Refined PBI, stories Acceptance criteria, wireframes, dependencies
Dev → QA Code, unit tests Test data, deployment steps, known limitations
QA → PO Test results Coverage report, defect list, sign-off recommendation
Design → Dev Design spec Component inventory, tokens, states, interactions
Output Format
Handoff Record
From: [Role] To: [Role] Date: {date} Feature/PBI: [Reference]
Completed Work
- [Item with artifact reference]
Artifacts
| Artifact | Location | Status |
|---|
Outstanding Items
- [Open question/risk with owner]
Context & Decisions
- [Key decision + rationale]
Next Steps for [Receiving Role]
- [First action]
- [Second action]
Blockers
- [Any blocking items]
IMPORTANT Task Planning Notes (MUST FOLLOW)
-
Always plan and break work into many small todo tasks using TaskCreate
-
Always add a final review todo task to verify work quality and identify fixes/enhancements
Workflow Recommendation
IMPORTANT MUST: If you are NOT already in a workflow, use AskUserQuestion to ask the user:
-
Activate dev-qa-handoff workflow (Recommended) — handoff → test-spec
-
Execute /handoff directly — run this skill standalone