v3.0 PRODUCTION RELEASE منظومة TidyFactor — هندسة معمارية هادئة لوكلاء البرمجة ومطوري الويب قراءة المانيفستو
المخطط المعماري الشامل • Architecture & Ecosystem Topology

طبقة المعرفة والسلوك المعماري
لوكلاء البرمجة بالذكاء الاصطناعي (AI Coding Agents)

TidyFactor ليست مجرد إطار عمل جديد، بل هي منظومة معمارية متكاملة لـ AI-Native Web Architecture تقسم المعرفة إلى مسارات متخصصة، وتعتمد على الإفصاح التدريجي (Progressive Disclosure) لمنح الوكلاء قدرة حقيقية على العمل المنضبط داخل مشاريع الإنتاج المعقدة.

التحول المعماري الأساسي

من التوليد العشوائي إلى هندسة السياق

لماذا تفشل نماذج الـ LLM في المشاريع الكبرى؟ وكيف تعالج TidyFactor معضلة السياق عبر الـ Skills والذاكرة التشغيلية؟

01 • TRADITIONAL PROMPTING هش وغير منضبط

فخ البرومبت المتضخم والتوليد العشوائي

Developer ──► Bloated Prompt ──► Context Drift ──► Fragile Code
  • ✕ تشتت سياق الـ LLM: إعطاء نصوص ضخمة يشتت الذاكرة ويؤدي لفقدان المعايير وتكرار الأخطاء.
  • ✕ غياب انضباط الإنتاج: صعوبة التعديل في مكان المشروع القائم دون كسر القواعد الأمنية.
  • ✕ تشوه واجهات الـ RTL: افتقار النموذج لقواعد Logical CSS الصارمة يفسد تجربة اللغة العربية.
02 • TIDYFACTOR SKILL-DRIVEN حتمي وقابل للتحقق

الإفصاح التدريجي والذاكرة التشغيلية

Intent ──► Dispatcher (~350t) ──► Operational Memory ──► Deterministic
  • ✓ الإفصاح التدريجي: تحميل المعرفة الحتمية فقط عبر Dispatcher صغير يوفر 90% من السياق.
  • ✓ حوكمة معمارية حتمية: إلزام الوكيل بقوائم تحقق (Validation Checklists) وصفر هلوسة.
  • ✓ دعم أصيل لـ Logical CSS: حظر مبتذلات الذكاء الاصطناعي وبناء كود مستدام لـ 20 عاماً.
طوبولوجيا المنظومة

الهيكل التنظيمي للمنظومة (4 مجموعات رئيسية)

تتوزع قدرات TidyFactor عبر أربع طبقات وظيفية معزولة تضمن فصل المسؤوليات:

TidyFactor Dual-Tier SSOT Architecture (44+ Skills) 
TidyFactor Ecosystem
├── [01] Community Core Tier (Skills-LAB — 11 Skills, Apache-2.0)
│   ├── Governance:    tidyfactor-skill-architect
│   ├── Frontend:      tidyfactor-cinematic, tidyfactor-design, tidyfactor-styler
│   ├── Engineering:   tidyfactor-next, tidyfactor-php, tidyfactor-htmx, tidyfactor-js, tidyfactor-html
│   └── Docs & Growth: tidyfactor-doc, tidyfactor-marketing
│
├── [02] DevOps Pro Suite (Skills-pro-pack/DevOps — 13 Skills)
│   ├── Servers & Web: ops-cpanel, ops-lamp, ops-wp, ops-node, ops-local-dev
│   ├── Security & CI: ops-security (CSF/cPHulk), ops-cicd, ops-docker, ops-testing
│   └── Infra & Data:  ops-mail (Exim/SRS), ops-db (MariaDB/Index), ops-dns, ops-dr
│
├── [03] PocketOffice Pro Suite (Skills-pro-pack/PocketOffice — 11 Skills)
│   ├── Business Ops:  pocket-crm, pocket-invoicing, pocket-finance, pocket-calendar
│   ├── Marketing & KB:pocket-proposals, pocket-marketing, pocket-kb-manager, pocket-memory
│   └── Architect:     pocket-module-builder, pocket-release, pocketoffice-module-builder
│
├── [04] Engineering & Growth Pro (Skills-pro-pack — 9 Skills)
│   ├── Core Engines:  tidyfactor-php-kernel, tidyfactor-pwa, clean-code-refactor
│   ├── Micro Stacks:  tidyfactor-php-micro, tidyfactor-php-mono, tidyfactor-js-micro
│   └── Conversion:    tidyfactor-seo, website-copywriting-mena, mena-proposal-writer
│
└── [05] Universal Release Engine & Installer
    ├── Installer:     tools/installer/install.js (Antigravity, Claude Code, Cursor)
    └── CI/CD Hub:     .github/workflows/ci-validate.yml, release-ecosystem.yml
FRONTEND TRIAD

ثلاثية الواجهات المعمارية

فصل دقيق للمسؤوليات يضع كل مهارة في مكانها الإنتاجي الصحيح دون خلط بين التجربة والنماذج وكود الإنتاج:

EXPERIENCE • 'WOW'

TidyFactor Cinematic

محرك السرد البصري الفاخر لصفحات الهبوط (أسلوب Apple × Cartier) بملف واحد مستقل؛ تحريك تسلسل إطارات عالي الدقة على HTML5 Canvas بدقة 60 FPS دون تقطيع الفيديو على الجوال.

الغرض: صناعة الانطباع الأول الفاخر
PROTOTYPE • 'BUILD'

TidyFactor Design

محرك دورة حياة تصميم الواجهات بالكود الأصيل (بديل فيجما)؛ الانتقال المباشر من الفكرة إلى نماذج تفاعلية حقيقية بالـ HTML/CSS بدون أدوات بناء وبحوكمة توكنز brand.json v2.

الغرض: بناء وتجربة النماذج الأولية
PRODUCTION • 'SHIP'

TidyFactor Styler

المسار الأكثر عملية للمشاريع القائمة في الإنتاج؛ فحص الكود الموجود، احترام الـ Conventions، حظر مبتذلات الذكاء الاصطناعي (Anti-Slop)، وفرض خصائص Logical CSS لدعم العربية.

الغرض: التعديل الجراحي لواجهات الإنتاج
مسارات التطوير المتخصصة

التشريح الهندسي للمسارات البرمجية

آراء معمارية صريحة (Opinionated Stacks) تلزم الوكيل بقرارات متسقة وعالية النضج:

tidyfactor-next Next.js 16

tidyfactor-next

بناء تطبيقات SaaS متعددة المستأجرين على Next.js 16 مع حظر تسريب البيانات عبر سياسات Postgres Row-Level Security الحتمية.

Stack: Next.js 16 • React 19 RSC • Supabase / Postgres RLS
tidyfactor-php PHP 8.4+

tidyfactor-php

مونوليث معياري بـ PHP 8.4+ (Flight + Medoo + Plates) كبديل ووردبريس، مقسم لـ 13 موديولاً بصفر أدوات بناء.

Stack: PHP 8.4+ • Flight • Medoo • Plates • Zero-Build
tidyfactor-htmx HTMX 2.0

tidyfactor-htmx

تفاعلية SPA موجهة بالسيرفر مع استبدال جزئي بالـ Morphdom وإلغاء طبقات كود الـ API المزدوجة.

Stack: HTMX 2.0 (Vendored) • Morphdom • Local CSRF
tidyfactor-js < 10KB

tidyfactor-js

تطبيقات SPA بجافاسكربت الصرفة (< 10KB) عبر Web Components وإدارة الحالة بـ Proxy بدون أطر عمل هشة.

Stack: Native ES Modules • Web Components • Proxy State
tidyfactor-doc AST Doc

tidyfactor-doc

استقراء السورس كود (AST Interviewing) وتوليد مواقع توثيق Docsify تفاعلية بدقة 100% وبدون هلوسة.

Tools: AST Codebase Interviewer • Docsify Markdown Engine
tidyfactor-marketing 7 Pillars

tidyfactor-marketing

محرك نمو وتسويق شامل يغطي 7 أركان و 28 قدرة تسويقية قائمة على أطر الاستجابة المباشرة (AIDA, PAS).

Frameworks: AIDA • PAS • Pillar-Cluster SEO • Direct Response
دورة حياة المهام البرمجية

المراحل الثلاث للتعامل مع الكود (Lifecycle)

إدراك حتمي بأن إنشاء مشروع جديد يختلف كلياً عن تعديل أو تحسين مشروع قائم؛ لذا تنظم مهارات TidyFactor العمل عبر ثلاث حالات واضحة:

INIT • التأسيس النظيف

Scaffolding

تأسيس مشروع جديد من الصفر بهيكل نظيف، ملفات تهيئة مضبوطة، عقود أمان واضحة، وربط تلقائي بتوكنز الـ Design System.

CONVERT • التحويل الجراحي

In-Place Migration

تحويل كود قديم أو واجهات موروثة إلى معمارية المنظومة دون كسر قواعد العمل القائمة أو إعادة كتابة المشروع عشوائياً.

IMPROVE • التدقيق والتحسين

Audit & Hardening

تدقيق الأداء، إغلاق ثغرات الصلاحيات، إزالة الـ CSS المكرر، وتحسين مؤشرات الأداء بناءً على قياسات مقارنة قبل وبعد.

استكشف الكتالوج والمنتجات ← استعراض مصفوفة المهارات (45+ مهارة)