From 30282ac9aded6052dbce8a87dab25b05c2bbedc6 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sat, 7 Mar 2026 17:23:38 +0000
Subject: [PATCH] Add post-handoff invocations to code-review, create-story,
 and dev-story workflows
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

These three workflows complete work that hands off to another agent but
were missing the post-handoff task invocation needed for orchestrator
dispatch:
- code-review: QA → SM (review_complete) on passing review
- create-story: SM → Dev (story_prepared) when story is Ready for Dev
- dev-story: Dev → QA (dev_complete) when transitioning to Review

https://claude.ai/code/session_01GE7R9vLGsTa785ieSmeTT4
---
 .../code-review/instructions-jira.md                | 13 ++++++++++++-
 .../create-story/instructions-jira.md               | 11 ++++++++++-
 .../4-implementation/dev-story/instructions-jira.md |  9 +++++++++
 3 files changed, 31 insertions(+), 2 deletions(-)

diff --git a/src/atlassian/workflow-overrides/4-implementation/code-review/instructions-jira.md b/src/atlassian/workflow-overrides/4-implementation/code-review/instructions-jira.md
index be30318e1..55e6244e0 100644
--- a/src/atlassian/workflow-overrides/4-implementation/code-review/instructions-jira.md
+++ b/src/atlassian/workflow-overrides/4-implementation/code-review/instructions-jira.md
@@ -114,9 +114,20 @@ additional_fields:
 <action>Report the specific findings that need to be addressed</action>
 </step>
 
-<step n="5" goal="Unlock and report">
+<step n="5" goal="Unlock, hand off, and report">
 <action>Invoke `lock-issue` task with `issue_key: "{selected_issue_key}"`, `action: "unlock"`, `agent_name: "code-review"`</action>
 
+{if_passed}
+<action>Invoke `post-handoff` task with:</action>
+
+```
+handoff_to: "SM"
+handoff_type: "review_complete"
+summary: "Code review passed for {selected_issue_key}. Story transitioned to Done. SM should check if next story is ready or if retrospective is needed."
+jira_issue_keys: ["{selected_issue_key}"]
+```
+{end_if}
+
 <action>Report to user:</action>
 
 **Code Review: {verdict}**
diff --git a/src/atlassian/workflow-overrides/4-implementation/create-story/instructions-jira.md b/src/atlassian/workflow-overrides/4-implementation/create-story/instructions-jira.md
index 87fa567b4..f5bdde928 100644
--- a/src/atlassian/workflow-overrides/4-implementation/create-story/instructions-jira.md
+++ b/src/atlassian/workflow-overrides/4-implementation/create-story/instructions-jira.md
@@ -120,7 +120,16 @@ fallback_status_name: "Ready for Dev"
 ```
 </step>
 
-<step n="7" goal="Report">
+<step n="7" goal="Hand off and report">
+<action>Invoke `post-handoff` task with:</action>
+
+```
+handoff_to: "Dev"
+handoff_type: "story_prepared"
+summary: "Story {selected_issue_key} prepared with full dev context and subtasks. Ready for implementation."
+jira_issue_keys: ["{selected_issue_key}"]
+```
+
 <action>Report to user:</action>
 
 **Story Prepared: {story_title}**
diff --git a/src/atlassian/workflow-overrides/4-implementation/dev-story/instructions-jira.md b/src/atlassian/workflow-overrides/4-implementation/dev-story/instructions-jira.md
index 4887a4623..b51906043 100644
--- a/src/atlassian/workflow-overrides/4-implementation/dev-story/instructions-jira.md
+++ b/src/atlassian/workflow-overrides/4-implementation/dev-story/instructions-jira.md
@@ -118,6 +118,15 @@ fallback_status_name: "Review"
 
 <action>Invoke `lock-issue` task with `issue_key: "{selected_issue_key}"`, `action: "unlock"`, `agent_name: "dev"`</action>
 
+<action>Invoke `post-handoff` task with:</action>
+
+```
+handoff_to: "QA"
+handoff_type: "dev_complete"
+summary: "Implementation complete for {selected_issue_key}. All tests passing. Ready for code review."
+jira_issue_keys: ["{selected_issue_key}"]
+```
+
 <action>Report to user:</action>
 
 **Story Complete: {story_title}**