moai-domain-design-handoff

name	moai-domain-design-handoff
description	Claude Design handoff package specialist for /moai brain Phase 7. Assembles 5-file handoff bundle (prompt/context/references/acceptance/checklist) for paste-ready claude.com Design session. Handles brand-absent fallback and section regeneration.
when_to_use	Use for /moai brain Phase 7 design handoff: assembling the 5-file Claude Design package (prompt, context, references, acceptance, checklist), brand-voice context, and paste-ready claude.com session bundles.
license	Apache-2.0
compatibility	Designed for Claude Code
allowed-tools	Read, Write, Edit, Grep, Glob
user-invocable	false
metadata	{"version":"1.0.0","category":"domain","status":"active","updated":"2026-05-04","modularized":"false","tags":"design-handoff, claude-design, prompt-template, brand, acceptance, brain","related-skills":"moai-domain-ideation, moai-workflow-brain, moai-workflow-design"}
progressive_disclosure	{"enabled":true,"level1_tokens":100,"level2_tokens":5000}

Design Handoff Domain Specialist

Assembles the 5-file Claude Design handoff package for the brain workflow's Phase 7. The package is designed for paste-and-go use in the external claude.com Design product.

Quick Reference

The handoff package lives at .moai/brain/IDEA-NNN/claude-design-handoff/:

File	Purpose	Paste target
prompt.md	Master prompt — paste directly into claude.com Design	Yes (primary)
context.md	Extended context for reference during design session	Optional supplement
references.md	Visual reference URLs and design inspiration sources	Referenced in prompt
acceptance.md	Design acceptance criteria (WCAG, responsive, brand)	Referenced in prompt
checklist.md	Pre-paste self-check before using in claude.com Design	Human review tool

Key guarantees:

• [HARD] prompt.md contains NO MoAI-specific tokens (no SPEC-, .moai/, manager-, IDEA-)
• [HARD] Brand voice integrated when .moai/project/brand/brand-voice.md exists
• [HARD] Brand-absent fallback: Brand Voice (default — please customize) placeholder section
• [HARD] Phase 7 exits with AskUserQuestion offering 3 options (a/b/c per the relevant requirement)
• [HARD] All 5 files produced regardless of brand context availability

---

Phase 7: Handoff Package Assembly

Input

• ideation.md (Lean Canvas + Evaluation Report from Phases 4 and 5)
• proposal.md (product summary and SPEC decomposition from Phase 6)
• Optional: .moai/project/brand/brand-voice.md (brand context)
• Optional: .moai/project/brand/visual-identity.md (design tokens, colors)

Step 0: Brand Context Detection

Before writing any file, check brand context:

IF .moai/project/brand/brand-voice.md exists AND is non-empty:
  Load brand voice → use in Brand Voice section of prompt.md
  SET brand_present = true
ELSE:
  Use default brand voice placeholder
  SET brand_present = false
  Note: will include AskUserQuestion offer to run brand interview