Reference
Asset Capture Checklist
| Asset ID | Page Or Flow | Target File | Notes | | --- | --- | --- | --- | | `web-login` | Login page | `docs/assets/screenshots/web-login.png` | Show GitHub and email sign-in choices | | `web-start` | `/start` welcome screen | `docs/assets/screenshots/web-start.png` | Include the three activation choices | | `web-onboarding-setup` | `/onboarding/setup` | `docs/assets/screenshots/web-onboarding-setup.png` | Show workspace and project selection | | `web-decisions-list` | `/decisions` | `docs/assets/screenshots/web-decisions-list.png` | Include status, scope, and filters | | `web-decision-detail` | `/decisions/:decisionId` | `docs/assets/screenshots/web-decision-detail.png` | Show history and suggestion areas | | `web-decision-edit` | `/decisions/:decisionId/edit` | `docs/assets/screenshots/web-decision-edit.png` | Capture editor structure after copy stabilizes | | `web-organization` | `/organization` | `docs/assets/screenshots/web-organization.png` | Show overview cards and navigation | | `web-projects-repos` | `/organization/projects` | `docs/assets/screenshots/web-projects-repos.png` | Include project and repo assignment UI | | `web-members` | `/organization/members` | `docs/assets/screenshots/web-members.png` | Show role labels and invite status | | `web-api-keys` | `/organization/api-keys` | `docs/assets/screenshots/web-api-keys.png` | Avoid showing full token values | | `web-github` | `/integrations/github` | `docs/assets/screenshots/web-github.png` | Show install or connected state | | `web-agents` | `/integrations/agents` | `docs/assets/screenshots/web-agents.png` | Include platform selector and connected clients | | `web-monitoring` | `/monitoring` | `docs/assets/screenshots/web-monitoring.png` | Show alerts and coverage | | `web-rules` | `/rules` | `docs/assets/screenshots/web-rules.png` | Show rule list and config panel | | `web-overrides` | `/pr-gatekeeper/overrides` | `docs/assets/screenshots/web-overrides.png` | If route remains user-visible in docs scope |
- Use a seeded demo organization, two projects, and a small fixed repository set.
- Avoid secrets, personal email addresses, real GitHub installations, and unstable timestamps.
- Prefer screenshots for stable states.
- Use short video clips only for auth handoff, multi-state transitions, or config flows that are hard to explain statically.
- Keep clips under 20 seconds and show one action per asset.
- Existing E2E coverage already exercises onboarding, decisions, integrations, and core MCP flows in
e2e/.
- Playwright is configured today for traces on failure, not for asset capture automation yet.
- If asset capture becomes repeatable, extend Playwright fixtures before adding manual-only steps to release checklists.
| Asset ID | Page Or Flow | Target File | Notes |
|---|
web-login | Login page | docs/assets/screenshots/web-login.png | Show GitHub and email sign-in choices |
web-start | /start welcome screen | docs/assets/screenshots/web-start.png | Include the three activation choices |
web-onboarding-setup | /onboarding/setup | docs/assets/screenshots/web-onboarding-setup.png | Show workspace and project selection |
web-decisions-list | /decisions | docs/assets/screenshots/web-decisions-list.png | Include status, scope, and filters |
web-decision-detail | /decisions/:decisionId | docs/assets/screenshots/web-decision-detail.png | Show history and suggestion areas |
web-decision-edit | /decisions/:decisionId/edit | docs/assets/screenshots/web-decision-edit.png | Capture editor structure after copy stabilizes |
web-organization | /organization | docs/assets/screenshots/web-organization.png | Show overview cards and navigation |
web-projects-repos | /organization/projects | docs/assets/screenshots/web-projects-repos.png | Include project and repo assignment UI |
web-members | /organization/members | docs/assets/screenshots/web-members.png | Show role labels and invite status |
web-api-keys | /organization/api-keys | docs/assets/screenshots/web-api-keys.png | Avoid showing full token values |
web-github | /integrations/github | docs/assets/screenshots/web-github.png | Show install or connected state |
web-agents | /integrations/agents | docs/assets/screenshots/web-agents.png | Include platform selector and connected clients |
web-monitoring | /monitoring | docs/assets/screenshots/web-monitoring.png | Show alerts and coverage |
web-rules | /rules | docs/assets/screenshots/web-rules.png | Show rule list and config panel |
web-overrides | /pr-gatekeeper/overrides | docs/assets/screenshots/web-overrides.png | If route remains user-visible in docs scope |
| Asset ID | Flow | Target File | Why Motion Helps |
|---|
ide-auth-handoff | first MCP tool call to OAuth consent | docs/assets/video/ide-auth-handoff.webm | hard to explain browser-to-IDE handoff in still images |
web-draft-create | create a decision from the editor | docs/assets/video/web-draft-create.webm | shows generate, edit, and save flow |
web-approve-supersede | approve or supersede from detail view | docs/assets/video/web-approve-supersede.webm | captures status transition and resulting state |
github-install-claim-sync | install app, claim installation, sync repos | docs/assets/video/github-install-claim-sync.webm | multiple visible states across one user journey |
ide-config-codex | add Codex MCP config and retry tool call | docs/assets/video/ide-config-codex.webm | config plus auth trigger |
ide-config-cursor | add Cursor MCP config and retry tool call | docs/assets/video/ide-config-cursor.webm | config plus auth trigger |
- Confirm button labels and routes still match the current app.
- Re-record any asset touched by onboarding, auth, integrations, or platform catalog changes.
- Check that screenshots and clips match the final written steps before merging.