⚡ TidyFactor Architecture Ecosystem Documentation¶
The Dual-Tier AI Coding Agent Skill Ecosystem & Web Architecture Framework¶
🎯 The Core Problem & The TidyFactor Solution¶
The Problem: Modern AI coding agents generate code at superhuman speeds, but without strict architectural boundaries, they produce monolithic sprawl, leaky database queries, fragile styling, and silent technical debt.
The Solution: TidyFactor delivers locked architectural foundations, deterministic compiler-wrapping toolsets, database-level security boundaries (Postgres RLS), and context-efficient skills (~350 tokens) that keep human architects and autonomous AI agents in 100% deterministic alignment.
🏛️ Master Ecosystem Topology (45+ Production Skills)¶
TidyFactor Ecosystem
├── 🌐 [01] Community Core Tier (Skills-LAB — 12 Skills, Apache-2.0)
│ ├── Governance: tidyfactor-skill-architect
│ ├── Operations: tidyfactor-github
│ ├── 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] TidyFactor Multi-Platform CLI & Go Platform
├── Platform OS: TidyFactor Go CMS (SQLite 3 WAL & JSON-First)
└── Multi-Mount: npx @tidyfactor/cli & Standalone Shell Installers
📚 Complete Technical Documentation Index¶
🏛️ 1. Architecture, Overview & Skills Matrix¶
- 🌐 Ecosystem Architecture Guide — Architectural thesis, lifecycle stages, and the human-agent collaboration model.
- ⚡ Multi-Platform CLI & Shell Installers — Interactive 3-step setup wizard, dual-redundant installation, and workflow packs.
- 📦 Skills Matrix (45+ Production Skills) — Complete catalog of all 45 skills across Community and Pro tiers.
- 🔮 Roadmap & Vision 2026+ — Strategic milestones and upcoming platforms.
👑 2. Commercial Pro Suites (33+ Skills)¶
- ⚙️ DevOps Pro Suite Guide (13 Skills) — Server diagnostics, web tuning, CSF shields, mail relays, and disaster recovery.
- 🏢 PocketOffice Pro Suite Guide (11 Skills) — CRM pipelines, automated invoicing, financial forecasts, and custom module architecture.
- 🛠️ Engineering & Growth Pro Guide (9 Skills) — PHP Kernel monolithic platforms, PWAs, clean code refactoring, and MENA conversion copywriting.
🌐 3. Community Core Tier (12 Skills — Apache-2.0)¶
- 🏛️ TidyFactor Skill Architect — Master governance, 8 structural rules & validation checklist enforcement.
- 🐙 TidyFactor GitHub — GitHub Platform Operations, Rulesets, Actions CI/CD & Anti-Slop README Engine.
- 🎬 Cinematic Landing Kit — 60 FPS HTML5 Canvas frame sequence scrubbing & Apple × Cartier aesthetic.
- 🎨 TidyFactor Design — 7-stage code-native UI design lifecycle & Figma alternative.
- 💅 TidyFactor Styler — In-place framework refactoring, logical CSS & native Arabic RTL polish.
- 📚 TidyFactor Doc — AST codebase interview, automated API specs & Docsify portal generator.
- ⚡ TidyFactor Next.js — Multi-tenant SaaS, Postgres RLS isolation & Dev-Perf engine.
- 📈 TidyFactor Marketing — 7 growth pillars, direct-response copywriting & pillar-cluster SEO.
- 📄 TidyFactor HTML — 100% static platform starter, zero server runtime & semantic SEO.
- ⚡ TidyFactor HTMX — Server-rendered hypermedia micro-endpoints with local Morphdom.
- 🍦 TidyFactor Vanilla JS — Framework-free reactive ES Modules SPA (<10KB runtime).
- 🐘 TidyFactor PHP Monolith — Modern server-rendered PHP 8.x component monolith (Flight + Medoo + Plates).
🚀 4. TidyFactor Go Platform (Website Operating System)¶
- 🏗️ Go Platform Architecture & Overview — SQLite 3 WAL storage, JSON fields, and zero build step.
- ⚡ Quick Start Guide — Running locally and deploying in 5 minutes.
- 👑 Admin User Guide (دليل لوحة التحكم) — Control panel manual and media management.
- 📝 Editing Content Guide (دليل تحرير المحتوى) — Managing homepage, services, and dynamic sections.
- 🗄️ Database & Storage Architecture — SQLite 3 table schema and self-healing routines.
- 🔒 Security & Anti-Bot Hardening — Bcrypt auth, rate limiting, and anti-bot shields.
- 📰 Content Engine & REST API | API Reference — Programmatic REST endpoints & schemas.
👨💻 Organization & Contact Details¶
- 🌐 Official Website: https://tidyfactor.com/
- 📚 Documentation Portal: https://tidyfactor.com/documentation
- 🤝 Strategic Partner: Alwkala Digital Agency
- 🐙 GitHub Organization: github.com/TidyFactor
- 📧 Business Inquiries: hello@tidyfactor.com
📜 License¶
Licensed under the Apache License 2.0. Copyright © 2026 TidyFactor & Alwkala Digital Agency.