---
kind: task
slug: completion-screenshot-capture
title: Optional automated screenshot capture for UI convoys
plan_slug: automation-foundation
epic_slug: owner-completion-artifacts
status: draft
priority: P2
tenant_id: global
owner: unassigned
cursor_todo_id: null
updated_at: "2026-08-12"
---

# Task summary

For UI-classified convoys, optionally capture one or more screenshots (Playwright or worker browser tool) of a configured preview URL and attach them to the completion package.

## Description

### Behavior

- Convoy/content flag or classification hints UI surface
- Preview URL from convoy metadata or connected repo deploy URL
- Capture on PR open or after merge (configurable)
- Fail soft: summary still works if capture fails

### Dependencies

- [Task-completion-artifact-gallery](./Task-completion-artifact-gallery.md)
- Worker or a small capture job runner

## Subtasks

- [ ] Capture runner (Playwright in worker job or sidecar)
- [ ] Wire attach to artifacts
- [ ] Opt-in per convoy

## Estimation

L

## Acceptance criteria

- [ ] Opt-in UI convoy gets ≥1 screenshot attached after successful capture
- [ ] Capture failure logs event and does not block `released`
- [ ] Backend-only convoys skip capture by default

## Links

- Epic: `./Epic-owner-completion-artifacts.md`