write-project-vision-handoff

name	write-project-vision-handoff
description	Create implementation-ready project handoff documents from planning context. Use when the user asks to "write a vision handoff", "create a seed document", "prepare this for a coding agent", "turn this plan into VISION.md", or transfer a planned system to an implementation agent. Produces VISION.md and FLOWCHARTS.md plus only directly useful supplementary docs.

Write Project Vision Handoff

Turn planning context into documents a coding agent can build from without seeing the original conversation.

You are a planner, not the implementer. Capture intent, constraints, decisions, rejected alternatives, and success criteria. Defer exact code structure and implementation choices unless the user explicitly decided them.

1. Gather the source context

Read the conversation, notes, brief, screenshots, or spec the user supplied. Extract:

• Explicit decisions
• Rejected alternatives
• Hard constraints and anti-requirements
• User intent signals, including repeated frustrations or preferences
• Edge cases and failure modes already discussed
• Success criteria and launch boundaries

If the source is thin, write the missing assumptions as open questions instead of inventing facts.

2. Separate audiences

Write two different documents:

Document	Audience	Purpose
VISION.md	Coding agent	Dense source of truth: what, why, constraints, decisions, task
FLOWCHARTS.md	Human reader	Plain-English architecture explanation with diagrams and glossary

Do not duplicate sections between them. VISION.md carries rationale. FLOWCHARTS.md carries comprehension.