Skip to content

PD Phase 6: Handoff

Prepare and execute the development handoff with a complete package of PRD, prototype, specs, and design journey.

Command: /vt-c-pd-6-handoff [--package | --meeting | --verify]

When to use

After the prototype is validated and all previous quality gates have passed. This is the final product design phase before work transitions to spec generation and the development workflow.

What happens

The skill first checks for .repo-manifest.yaml to determine the handoff mode:

Unified repo mode (.repo-manifest.yaml exists)

No external handoff package needed -- all artifacts are in the same repo: 1. Verifies all design quality gates passed 2. Bootstraps tech stack if src/ is empty 3. Sets up .specify/ directory with constitution from PRD 4. Transitions .design-state.yaml to development mode 5. Points to /vt-c-activate for specs execution sequence

Separate project mode (standard handoff)

  1. Quality gate verification -- All six previous gates must pass. Blocks if any fail.
  2. Handoff package -- Creates 06-Handoff/ containing:
  3. README.md -- Overview and quick links
  4. handoff-checklist.md -- Verification checklist
  5. meeting-agenda.md -- 60-minute handoff meeting agenda
  6. development-guide.md -- Quick start for developers
  7. design-journey.md -- Full iteration history, key decisions, and rationale
  8. PRD feature table links -- Verifies all Prototyp and FB-Link columns are populated.
  9. Package verification -- Checks all files exist and cross-references are valid.

Modes

  • Default -- Full handoff workflow
  • --package -- Prepare handoff package only
  • --meeting -- Generate meeting agenda
  • --verify -- Verify package completeness

Output

  • Complete 06-Handoff/ directory with 5 documents
  • Design journey document capturing iteration history and decisions
  • Verified cross-links between PRD and prototype
  • .design-state.yaml marked as handoff_complete

Next step

Generate specs and start development:

  • /vt-c-specs-from-prd — generate implementation specs from the PRD
  • /vt-c-activate — load specs, see the wave dashboard, start building
  • Separate project: Development team runs /vt-c-0-start → /vt-c-1-bootstrap → /vt-c-activate