autodesign-handoff

name	autodesign-handoff
description	Private Stage 09 handoff subskill. Generates frontend handoff documentation as JSON and Markdown only, after Stage 08 prototype and QA gates pass.

Autodesign Handoff Contract

This private payload subskill is not public. Enter it only through autodesign-start after running the deterministic readiness check.

Required Upstream Artifacts

• canonical.project-brief
• canonical.requirements
• canonical.brand-direction
• canonical.ux-rules
• canonical.screen-model
• canonical.navigation
• canonical.interaction-model
• canonical.screen-state-matrix
• canonical.coverage-matrix
• canonical.visual-anchor-proposals
• log.decision-log
• visual.reference-selection
• visual.reference-set
• pencil.live-check
• pencil.wireframe-set
• pencil.canvas-exports
• design-system.primitives
• design-system.tokens
• design-system.contracts
• prototype.package
• prototype.canvas-exports
• prototype.visual-qa-report
• prototype.refinement-log

Output Artifacts

• handoff.package at autodesign/outputs/handoff
• autodesign/outputs/handoff/handoff-package.json
• autodesign/outputs/handoff/README.md

Hard Gates

• scripts/can-run-subskill.mjs --workspace <workspace> --subskill handoff must pass.
• manifest.disabledBehaviors.handoff must be false.
• Selected visual references must be approved.
• Pencil live-check and wireframe records must be generated from real Pencil MCP evidence.
• DS primitives, tokens, and contracts must be generated.
• Prototype package and visual QA report must be generated.
• Refinement attempt state must satisfy the max-two-refinement gate.
• Apply requires --approve-handoff-generation, --actor, and --at.

Required Command

Plan first:

node autodesign-start/assets/payload/scripts/generate-handoff.mjs --workspace <workspace> --action handoff --plan

Apply only after explicit approval:

node autodesign-start/assets/payload/scripts/generate-handoff.mjs --workspace <workspace> --action handoff --apply --approve-handoff-generation --actor <actor> --at <timestamp>

Fail Fast

• Stop if state validation fails.
• Stop if graph dependencies are missing or cyclic.
• Stop if any required upstream artifact path is absent.
• Stop if prototype visual QA is not approved.
• Stop if the plan would write outside autodesign/outputs/handoff/, except for manifest and artifact graph state updates.
• Stop if the plan would write anything other than JSON or Markdown handoff documentation.
• Do not generate frontend source files, executable prototype code, images, or Pencil changes.