From d1a4e3db09d4517d0416b3b05406d9eaca98b25e Mon Sep 17 00:00:00 2001 From: William Thorsen Date: Sun, 1 Mar 2026 16:05:04 -0800 Subject: [PATCH 1/2] agents|feat: Add rich summary sections to orchestrated run output Expand the Phase 5 run-summary.md template with three new narrative sections between Phases and Files changed: "What was built" (synthesized end-to-end result), "Insights" (notable observations), and "Deferred items" (intentional omissions with rationale). The Deferred items section subsumes the previous conditional "Deviations from reference plan" line. Also add an instruction for the orchestrator to present the same summary in the conversation after writing the artifact. --- .../content/skills/orchestrate/SKILL.md | 32 +++++++++++++++++-- 1 file changed, 30 insertions(+), 2 deletions(-) diff --git a/packages/agents/content/skills/orchestrate/SKILL.md b/packages/agents/content/skills/orchestrate/SKILL.md index 0a8205b4..11aee70c 100644 --- a/packages/agents/content/skills/orchestrate/SKILL.md +++ b/packages/agents/content/skills/orchestrate/SKILL.md @@ -400,13 +400,41 @@ Write run-summary artifact to `{artifact-dir}/{timestamp}_orchestrator_run-summa | Code simplifier | {ran/skipped} | {actionable findings, fix cycle ran/not needed} | | Holistic review | {ran/skipped} | {criticality, late-stage fixes} | +## What was built + +{Synthesized narrative of the end-to-end result. Describe each major component or subsystem that was implemented — what it does and why, not just file paths. Draw from the accumulated context across all coder change-summaries and review outcomes. Focus on the final state, not the iteration history.} + +{If the run failed or needs manual review, describe what was completed and what remains.} + +## Insights + +{Notable observations that emerged during the run. Include only items worth preserving — omit this section entirely if nothing notable emerged.} + +{Examples of what belongs here:} +{- Architectural patterns discovered or validated} +{- Design trade-offs surfaced during review} +{- Conventions or project-specific patterns learned} +{- Surprising findings from reviewers that revealed something non-obvious} +{- Technical debt or risks identified but not in scope to address} + +## Deferred items + +{Items intentionally not addressed during this run, with rationale for each.} + +{Include:} +{- Deviations from reference plan (when external plan was provided)} +{- Acceptance criteria from the ticket that were intentionally not addressed} +{- Any other intentional omissions} + +{Omit this section if nothing was deferred.} + ## Files changed {from git diff --name-only} - -{If external plan was provided: include "Deviations from reference plan" section from planner's plan.md} ``` +After writing the artifact, present the same summary to the user in the conversation. The conversational output should match the artifact content — do not abbreviate or omit sections. + Finalize run-index.json with `completedAt` timestamp and final status. ## Output contract From 59410e44086a61f27eb0fd49861fadf1a6f32d9c Mon Sep 17 00:00:00 2001 From: William Thorsen Date: Sun, 1 Mar 2026 16:14:58 -0800 Subject: [PATCH 2/2] agents|refactor: Consolidate template placeholder blocks in summary sections MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Merge fragmented curly-brace template blocks in the Insights and Deferred items sections into single coherent blocks. Each section now uses one {…} wrapper with inline bullet lists instead of six or five separate placeholder blocks. No behavioral change — purely structural simplification of the template prose. --- .../content/skills/orchestrate/SKILL.md | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/packages/agents/content/skills/orchestrate/SKILL.md b/packages/agents/content/skills/orchestrate/SKILL.md index 11aee70c..22265aad 100644 --- a/packages/agents/content/skills/orchestrate/SKILL.md +++ b/packages/agents/content/skills/orchestrate/SKILL.md @@ -408,25 +408,25 @@ Write run-summary artifact to `{artifact-dir}/{timestamp}_orchestrator_run-summa ## Insights -{Notable observations that emerged during the run. Include only items worth preserving — omit this section entirely if nothing notable emerged.} +{Notable observations that emerged during the run. Include only items worth preserving — omit this section entirely if nothing notable emerged. -{Examples of what belongs here:} -{- Architectural patterns discovered or validated} -{- Design trade-offs surfaced during review} -{- Conventions or project-specific patterns learned} -{- Surprising findings from reviewers that revealed something non-obvious} -{- Technical debt or risks identified but not in scope to address} +Examples of what belongs here: + +- Architectural patterns discovered or validated +- Design trade-offs surfaced during review +- Conventions or project-specific patterns learned +- Surprising findings from reviewers that revealed something non-obvious +- Technical debt or risks identified but not in scope to address} ## Deferred items -{Items intentionally not addressed during this run, with rationale for each.} +{Items intentionally not addressed during this run, with rationale for each. Omit this section entirely if nothing was deferred. -{Include:} -{- Deviations from reference plan (when external plan was provided)} -{- Acceptance criteria from the ticket that were intentionally not addressed} -{- Any other intentional omissions} +Include: -{Omit this section if nothing was deferred.} +- Deviations from reference plan (when external plan was provided) +- Acceptance criteria from the ticket that were intentionally not addressed +- Any other intentional omissions} ## Files changed