53 lines
2 KiB
Markdown
53 lines
2 KiB
Markdown
|
---
|
||
|
|
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 |
|