From 1193a361bdc7173beed17b5510664014235d4ae0 Mon Sep 17 00:00:00 2001
From: kleap-admin <admin@kleap.co>
Date: Thu, 15 Jan 2026 13:42:36 +0000
Subject: [PATCH] Update AI_RULES.md

---
 AI_RULES.md | 67 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 AI_RULES.md

diff --git a/AI_RULES.md b/AI_RULES.md
new file mode 100644
index 0000000..de6e747
--- /dev/null
+++ b/AI_RULES.md
@@ -0,0 +1,67 @@
+# AI Rules - Template (Next.js 16 pre-configured)
+#⛔ NEVER RECREATE EXISTING FILES
+##🔒 PROTECTED FILES (NEVER TOUCH):
+-`public/_kleap/*` (all system files)
+-`components/kleap-scripts.tsx`
+
+## Pre-configured (DON'T RECREATE):
+- Configs: package.json, next/tailwind/tsconfig, app/layout.tsx
+- Components: 10 ui/*, hero, navbar, footer, pricing, features, testimonials, forms, auth
+- Pages: login, signup, pricing, contact, blog
+- Utils: lib/*, context/*
+##✅ WORKFLOW:
+1. List files FIRST
+2. MODIFY existing (Edit/MultiEdit)
+3. IMPORT existing - don't rewrite
+4. CREATE only new
+
+##🚫 BLOG SYSTEM (CRITICAL - DO NOT MODIFY):
+The blog system is pre-configured and working. To prevent errors:
+- **NEVER modify lib/blog.ts** - it uses hardcoded data to avoid MDX build issues
+- **NEVER delete existing blog articles** in app/blog/
+- **NEVER create page.mdx directly** - causes "createContext only works in Client Components" error
+- **For blog content**: Only modify the markdown content inside existing .mdx files
+- **Blog structure**: Each article has page.mdx with metadata and content
+- The blog index page at app/blog/page.tsx works correctly - don't touch it
+
+##🚨 MISSING COMPONENT FIX (CRITICAL - SAVE 3 CREDITS):
+When build error shows "Cannot find module '@/components/ui/X'":
+❌ DON'T: searchFiles, grep, or ls (you already know it's missing!)
+✅ DO: Create immediately from shadcn/ui template
+Steps:
+1. Create components/ui/X.tsx (copy standard shadcn pattern)
+2. Add @radix-ui/react-X to package.json if needed
+3. checkRuntime → refreshApp (HMR handles updates)
+4. restartApp ONLY if checkRuntime shows crash
+Example: slider missing → create slider.tsx + add @radix-ui/react-slider + checkRuntime → done (3 steps max)
+⚠️ restartApp requires checkRuntime first (system protection)
+# Stack
+Next.js 16, App Router, TypeScript, Turbopack, Tailwind CSS, Radix UI, Framer Motion, MDX, Lucide
+#Structure
+app/(auth)/* login/signup | app/blog/* | app/pricing/ | app/contact/ | components/* | lib/*
+#Design
+Aceternity UI, Framer inspiration, dark mode, mobile-first
+#SEO
+Customize ALL metadata (title, description, OG). Specific keywords, no generic text. Headlines: value+benefits. CTAs: action words.
+#Key Files
+Homepage: app/page.tsx (START HERE)
+Nav: components/site-header.tsx, navbar/*
+Pages: pricing, contact, blog, auth
+# Components (IMPORT - DON'T RECREATE)
+## UI Components (/components/ui/ - 10 components):
+✅ EXIST: Button, Card, Input, Textarea, Label, Checkbox, Switch, Select, RadioGroup, Form
+❌ DON'T EXIST: Badge, Dialog, Tabs, Avatar, Tooltip, Popover, Sheet, Accordion, Alert, Progress, Skeleton, DropdownMenu
+→ If you need a missing component, BUILD IT with Tailwind CSS (don't try to import!)
+
+## Feature components:
+Hero, Features, Testimonials, Pricing, CTA, Footer, Newsletter, Contact, Login, Signup, KleapForm, Navbar
+#Forms
+Use KleapForm component with fields array. Types: text, email, tel, textarea, number, select, checkbox, radio, url
+#Env Vars
+Auto: NEXT_PUBLIC_APP_ID, NEXT_PUBLIC_FORMS_API_URL (Kleap-provided)
+#KleapForm Usage
+Never modify component. Customize via fields array. title = form name in Data Management.
+```typescript
+const fields = [{ name: 'email', label: 'Email', type: 'email', required: true }];
+<KleapForm formId="lead" title="Contact" fields={fields} />
+```