diff --git a/packages/agents/content/skills/orchestrate/SKILL.md b/packages/agents/content/skills/orchestrate/SKILL.md index 0a8205b4..22265aad 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. 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} + ## 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