From d5292a14b7ac402ebf3c061e19426e1f5fa3fb05 Mon Sep 17 00:00:00 2001
From: Matt Van Horn <455140+mvanhorn@users.noreply.github.com>
Date: Fri, 27 Mar 2026 06:25:35 -0700
Subject: [PATCH] feat: structured session report format for Step 11

Replace the loose "report the process" instruction in Step 11 with
a specific markdown template. Agents now emit a consistent table
showing planning rounds, review rounds, convergence speed, HEAD,
changed files, and residual issues.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 SKILL.md | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/SKILL.md b/SKILL.md
index f7845b2..b1fb9c5 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -301,6 +301,28 @@ Clean up temporary artifacts created during the loop (for example plan scratch f
 
 If the implementation subagent is still open, close it and clear its saved handle or `session_id` before handing off to finishing.
 
-Report the process to the user using concrete facts and returned artifacts: how many plan-editor rounds, how many code-review rounds, the current `HEAD`, the changed-file list, the implementation subagent's latest summary and verification results, and any reviewer-reported residual issues.
+Report the process to the user in this format:
+
+```
+## Trycycle Session Report
+
+| Phase            | Rounds | Result                                      |
+|------------------|--------|---------------------------------------------|
+| Planning         | {N}/5  | {READY on round N / ESCALATED to user}      |
+| Test plan        | 1      | {approved / revised N times}                |
+| Implementation   | 1      | {complete}                                  |
+| Review           | {N}/8  | {clean on round N / ESCALATED to user}      |
+
+**Convergence:** plan locked in {N} round(s), review passed in {N} round(s)
+**HEAD:** `{short hash}`
+**Changed files:**
+{file list from git diff --name-only}
+
+**Implementation summary:** {from the implementation subagent's latest report}
+**Verification results:** {from the implementation subagent's latest report}
+**Residual issues:** {any non-blocking issues from the final review, or "none"}
+```
+
+Fill each placeholder from the artifacts returned by planning, implementation, and review subagents during the session. Omit sections that do not apply (for example, omit **Residual issues** when there are none).
 
 Then read and follow `<skill-directory>/subskills/trycycle-finishing/SKILL.md` to present the user with options for integrating the implementation workspace (merge, PR, etc.).