--- kind: epic slug: owner-completion-artifacts title: Owner completion packages — summaries, demos, screenshots plan_slug: automation-foundation status: draft priority: P1 tenant_id: global cursor_epic_id: null updated_at: "2026-08-12" --- # Epic objective When a convoy reaches `merged` / `released` (or a brief completes), produce an **owner-facing completion package**: plain-language summary of what shipped, optional **screenshots or demo clips** for UI work, and a short backend summary when there is no UI — not a code diff. Serves non-developer operators who need to verify “did it build what I wanted?” ## In scope / out of scope **In scope** - Generate summary from convoy events, PR title/body, brief acceptance, and optional agent notes (via `resolveModel` / doc-writer or gate-copilot-style role) - Artifact storage: screenshot images / short demo URLs attached to convoy (workspace-scoped object storage or forge release assets — pick one, document) - Mission Control / fleet “Completed” view: card with summary + media - Heuristic: UI-touching briefs request screenshot capture (Playwright or worker tool) when feasible; backend-only → summary only **Out of scope** - Full design QA - Replacing PR review for engineers - Autensa-style marketing site research ## Dependencies - Epic 7 worker (real completions) - Epic 8 webhooks (merge signal) preferred - Epic 5 Mission Control detail panel ## Acceptance criteria - [ ] Released convoy shows owner summary without opening git - [ ] UI convoy can attach at least one screenshot or demo URL - [ ] Backend-only convoy shows prose summary, no empty “diff” UI ## Tasks | Task | Link | Status | |------|------|--------| | Completion summary generation | [Task-completion-summary-generator](./Task-completion-summary-generator.md) | ready | | Artifact attach + gallery UI | [Task-completion-artifact-gallery](./Task-completion-artifact-gallery.md) | draft | | Optional UI screenshot capture | [Task-completion-screenshot-capture](./Task-completion-screenshot-capture.md) | draft |