AI-Native Engine Zero Hallucination

طبقة قرار الذكاء الاصطناعي (AI Decision Layer)

قاهرة ليست مجرد مكتبة مكونات، بل منظومة أصلية للذكاء الاصطناعي (AI-Native) مبنية ببيانات وصفية صلبة وعقود موحدة تمنع وكلاء البرمجة (Antigravity, Claude, Cursor) من الهلوسة.

1. دليل استخدام مهارة /qahera-ui الرسمية

مهارة /qahera-ui هي موجه الأوامر الذكي (Command Dispatcher) الرسمي للوكيل البرمجي. يمكنك تفعيلها واستدعاؤها عبر الـ Slash Command:

/qahera-ui compose <intent> Screens & Layouts

تركيب شاشات ولوحات تحكم إنتاجية من المكونات والأنماط الرسمية مع تطبيق المعايير الـ 16.

/qahera-ui pattern <name> UX Patterns

تجميع الأنماط المعتمدة مثل شريط التصفية، لوحة كانبان، تدفق المحادثة، وإحصائيات KPI.

/qahera-ui scaffold <component> Contracts & Recipes

صياغة عقود YAML ووصفات هندسية ورسم الرموز الدلالية للمكونات وفق المفردات المحكومة.

/qahera-ui audit Quality & Invariants

فحص الكود والتحقق من عدم وجود ألوان صلبة أو إيموجي، وضمان سلامة ترطيب Alpine.js.

/qahera-ui theme <neighborhood> 12 Cairo Themes

نقل السمات المعمارية بين أحياء القاهرة (الزمالك، مصر الجديدة، وسط البلد، النوبة، وغيرها).

2. بروتوكول السياق التدرجي (Progressive AI Context Protocol)

لتوفير استهلاك التوكنز وضمان استجابة فائقة السرعة، يتبع الوكيل البرمجي 5 مستويات تدرجية:

المستوى 0 (الفهرس - Level 0 Index): قراءة ai/components.yaml لاكتشاف المكونات بأقل من 200 توكن.

المستوى 1 (البيانات الوصفية - Level 1 Metadata): فحص الغرض (Purpose)، متى يُستخدم، ومتى يُتجنب لتحديد الخيار الصحيح.

المستوى 2 (الوصفة الهندسية - Level 2 Recipe): قراءة recipes/*.yaml لمعرفة هيكلية المكون والفتحات والعقود.

المستوى 3 (مسار التصيير - Level 3 Target): استدعاء الشيفرة المحددة للبيئة المطلوبة فقط دون بقية الأطر.

المستوى 4 (المعاينة الحية - Level 4 Previews): فحص النماذج الحية في examples/previews/ والقوالب.

3. معمارية الـ 0kb Client Boundary لـ React Server Components

كافة مكونات قاهرة في React هي Server Components نقية بنسبة 0kb على المتصفح، مع قصر التفاعل عند الضرورة القصوى.

معادلة الأداء: 0kb Runtime + RSC Purity

مكونات مثل Button, Card, Badge, Alert لا ترسل أي كود جافاسكريبت للعميل. تعليمة 'use client' تُحصر حصراً في المكونات الطرفية التي تحتاج أحداث DOM تفاعلية مثل القوائم المنبثقة والنوافذ المشروطة.

4. مصفوفة المعايير الـ 16 الحاكمة (Non-Negotiable Invariants)

المعيار	القاعدة المعمارية الصارمة	الممارسات المحظورة (Prohibited Slop)
`YAML Authority`	المصدر الأوحد للحقيقة هو YAML (العقود والوصفات).	تعديل ملفات renderers المجمعة يدوياً.
`Tokens Precede`	كافة الألوان والمسافات تشتق من `--qhr-*`.	كتابة ألوان صلبة مثل #FFF أو #0b6bcb.
`Logical RTL`	خصائص منطقية حصراً (`margin-inline-start`).	استخدام `margin-left` أو `padding-right`.
`Zero Emoji`	حظر تام للإيموجي واستخدام SVG كنسي 24x24 حصراً.	وضع أي إيموجي في الأزرار أو العناوين.
`Alpine Hydration`	مفاتيح فريدة `:key`، حظر `x-for` المتداخل.	وضع عناصر تفاعلية داخل وسوم روابط `<a>`.

5. خاتم الجودة والنقد المسبق (7-Axis Pre-Emit Critique)

قبل إصدار أي كود، يختم الوكيل البرمجي الكود بتحليل المحاور السبعة:

Pre-Emit Critique Header

/* Pre-emit critique: P5 H5 E5 S5 R5 V5 D5 */
// P: Paradigm (100% Canonical) | H: Heritage (Egyptian Tokens)
// E: Elegance (Zero Slop)       | S: Semantics (HTML5 & ARIA)
// R: RTL (Logical CSS)          | V: Visual (0 Emoji, 24x24 SVG)
// D: Dogfooding (qhr-* exclusively)

6. مولد موجهات الذكاء الاصطناعي التفاعلي (Interactive Prompt Generator)

اختر المهمة التي تريد تنفيذها مع وكيل البرمجة لنسخ موجه معتمد وخالٍ من الهلوسة:

Agent Prompt

→ الصفحة السابقة القوالب التطبيقية الجاهزة الصفحة التالية ← سجل التغييرات (Changelog)