From 524f93fd355dc2f1345d32cda950b8b2b8890805 Mon Sep 17 00:00:00 2001 From: promptadmin Date: Sat, 6 Jun 2026 20:38:45 +0000 Subject: [PATCH] Automated ingestion of prompt: Design Handoff Notes - AI First, Human Readable --- ...doff_notes_ai_first_human_readable_1444.md | 31 +++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 prompts/coding/design_handoff_notes_ai_first_human_readable_1444.md diff --git a/prompts/coding/design_handoff_notes_ai_first_human_readable_1444.md b/prompts/coding/design_handoff_notes_ai_first_human_readable_1444.md new file mode 100644 index 0000000..b2b8be4 --- /dev/null +++ b/prompts/coding/design_handoff_notes_ai_first_human_readable_1444.md @@ -0,0 +1,31 @@ +--- +title: "Design Handoff Notes - AI First, Human Readable" +contributor: "@gokbeyinac" +tags: #coding, #gokbeyinac +--- + +# Design Handoff Notes — AI-First, Human-Readable + +### A structured handoff document optimized for AI implementation agents (Claude Code, Cursor, Copilot) while remaining clear for human developers + +--- + +## About This Prompt + +**Description:** Generates a design handoff document that serves as direct implementation instructions for AI coding agents. Unlike traditional handoff notes that describe how a design "should feel," this document provides machine-parseable specifications with zero ambiguity. Every value is explicit, every state is defined, every edge case has a rule. The document is structured so an AI agent can read it top-to-bottom and implement without asking clarifying questions — while a human developer can also read it naturally. + +**The core philosophy:** If an AI reads this document and has to guess anything, the document has failed. + +**When to use:** After design is finalized, before implementation begins. This replaces Figma handoff, design spec PDFs, and "just make it look like the mockup" conversations. + +**Who reads this:** +- Primary: AI coding agents (Claude Code, Cursor, Copilot, etc.) +- Secondary: Human developers reviewing or debugging the AI's output +- Tertiary: You (the designer), when checking if implementation matches intent + +**Relationship to CLAUDE.md:** This document assumes a CLAUDE.md design system file already exists in the project root. Handoff Notes reference tokens from CLAUDE.md but don't redefine them. If no CLAUDE.md exists, run the Design System Extraction prompts first. + +--- + +## The Prompt +