From 1698f24241084808065a76332d1efa86faac53bc Mon Sep 17 00:00:00 2001
From: StanisLove <me@tungulov.space>
Date: Tue, 14 Jul 2026 13:57:07 +0300
Subject: [PATCH] Add design and product documentation

---
 DESIGN.md  | 13 +++++++++++++
 PRODUCT.md | 13 +++++++++++++
 2 files changed, 26 insertions(+)
 create mode 100644 DESIGN.md
 create mode 100644 PRODUCT.md

diff --git a/DESIGN.md b/DESIGN.md
new file mode 100644
index 0000000..2181908
--- /dev/null
+++ b/DESIGN.md
@@ -0,0 +1,13 @@
+# Design
+
+Status: draft required before major visual implementation.
+
+## Required decisions
+
+- Visual direction and anti-directions.
+- Typography, color, spacing, radius, imagery, and icon language.
+- Layout rhythm and responsive priorities.
+- Motion policy, reduced-motion fallback, and performance budget.
+- Accessibility requirements and intentional detector exceptions.
+
+Use semantic Tailwind tokens and existing shadcn primitives. The AI must propose a coherent direction, show the diff, and receive explicit approval before treating it as authoritative.
diff --git a/PRODUCT.md b/PRODUCT.md
new file mode 100644
index 0000000..b907766
--- /dev/null
+++ b/PRODUCT.md
@@ -0,0 +1,13 @@
+# Product
+
+Status: draft required before major implementation.
+
+## Required decisions
+
+- Audience and primary job-to-be-done.
+- Three most important user journeys.
+- Required pages, content, data, and integrations.
+- Explicit non-goals and legal or operational constraints.
+- Measurable acceptance criteria.
+
+The AI must draft this document from supplied specs and conversation, show the diff, and receive explicit approval before treating it as authoritative.