Product Demo Seeding

Product Demo Seeding

Build a truthful product state before recording pixels. Treat narrative, data, and UI route as one artifact.

Current-Main Source Gate

Product capture represents current Kandev, so old checkouts and old builds are invalid even when their scripts still run.

1. Fetch origin/main immediately before capture setup.
2. Create a clean detached capture worktree from origin/main; do not reuse the task worktree or a landing branch.
3. Record both SHAs and prove HEAD equals origin/main. Require an empty git status --porcelain before building and before capture.
4. Install dependencies and build frontend/backend from that worktree. Verify it contains scripts/dev-isolated and apps/web/e2e/.
5. Stage specs, raw masters, configs, proofs, logs, and delivery candidates under a fresh artifact root outside production assets.

Reject stale UI, selector, script, or capture choreography until current source is built and the complete route passes rehearsal. Never substitute an old server, cached bundle, or last month's working selectors for this gate.

Workflow

1. Read /e2e and the relevant existing specs/page objects under apps/web/e2e/.
2. Write a one-sentence story: user goal, visible action, visible result.
3. Identify separate desktop and native-mobile routes. Mobile must use native mobile surfaces, not a desktop crop.
4. Explore manually with scripts/dev-isolated --web when needed. For reproducible capture, use the worker-scoped E2E fixture and ApiClient.
5. Create a fresh fictional repository, workspace, workflow, tasks, sessions, and provider state through supported E2E/API methods.
6. Seed only enough state to make the story legible. Dense believable data beats empty fixtures; excessive data hides the action.
7. Open the intended UI and verify every visible label, control, and transition before recording.
8. Rehearse without a recorder, discard rehearsal mutations, then reseed an identical pristine baseline for each take.
9. Hand the scenario, routes, selectors, semantic target bounds, complete intentional pointer journeys, provenance, and cleanup command to /product-video-capture.

Safety Contract

• Allocate a fresh temp HOME, KANDEV_HOME_DIR, database, repository/worktree root, unique ports, unique display, unique browser profile, and artifact root. Names and ownership must identify one take.
• Use deterministic mock GitHub and Jira providers plus a controlled agent. Use fixed IDs and timestamps, authors, titles, bodies, states, checks, and ordering.
• No credentials or network access to real provider services is permitted. Unset provider tokens and fail closed if mock routing cannot be proven in backend logs.
• Never copy the developer's database for marketing capture. scripts/dev-isolated --copy-db is outside this workflow.
• Never query, mutate, stop, or reuse the developer's instance, DB, or data.
• Keep temporary capture specs or harness code under CAPTURE_ROOT, outside the source worktree. If the runner requires an in-worktree file, write only its exact path to a take-owned excludes file under CAPTURE_ROOT and pass it through command-local core.excludesFile configuration inherited by the capture process. Prove the clean-worktree status gate still returns an empty git status --porcelain, stage a source copy, then remove the file and exclusion during teardown. Never mutate the shared .git/info/exclude; linked worktrees and sibling agents may depend on it.
• Stop if isolation cannot be proven from process args, ports, paths, and logs.

Read isolation-and-seeding.md before starting an instance.