Skip to content

TidyFactor Ecosystem Architecture Guide

🏛️ The Vision: Software for Human-Agent Collaboration

The web has entered a transformative era. Software development is no longer an isolated human activity — it is a continuous partnership between senior human architects and autonomous AI coding agents (Google Antigravity, Claude Code, Cursor, Codex, Windsurf).

Traditional software architectures fail in this new paradigm because they rely on: - Monolithic sprawl and bloated, fragile prompts. - Complex runtime lock-in and opaque build steps. - Fragile per-page styles and spaghetti state management. - Undocumented drift and lack of deterministic validation.

TidyFactor solves this by establishing a Dual-Tier AI-Native Web Architecture & Agentic Skill Framework (44+ Skills) built on 5 fundamental pillars:

                TidyFactor Core Vision
                          │
       ┌──────────────────┼──────────────────┐
       ↓                  ↓                  ↓
  Deterministic      Locked Tenant       Evidence-First
   Toolchains          Isolation          Performance
       │                  │                  │
       └──────────────────┼──────────────────┘
                          ↓
              Human-Agent Collaboration

🗺️ Dual-Tier Ecosystem Topology (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] TidyFactor Go Platform & Universal Installer
    ├── Platform OS:   TidyFactor Go CMS (SQLite 3 WAL & JSON-First)
    └── Installer CLI: tools/installer/install.js (Antigravity, Claude Code, Cursor)

💎 The Frontend Triad

               TidyFactor Frontend Triad
                         │
        ┌────────────────┼────────────────┐
        │                │                │
    Cinematic          Design           Styler
        │                │                │
    Experience       Prototype        Production
        │                │                │
      "Wow"            "Build"          "Ship"
  1. Cinematic (tidyfactor-cinematic): Scroll-driven canvas frame sequences producing luxury, Apple × Cartier aesthetic product pages with zero video lag and zero build steps.
  2. Design (tidyfactor-design): Code-native interactive UI prototyping engine and Figma alternative covering the entire 7-stage UI lifecycle with brand.json v2 tokens.
  3. Styler (tidyfactor-styler): Production-grade styling engine that surgically refines existing codebases, redesigns components, and enforces native Arabic/RTL direction-agnostic logical CSS.

🏗️ Core Platforms & Operating Systems

TidyFactor-Go CMS

A standalone, zero-dependency, JSON-first Website Operating System built on SQLite 3 (WAL mode) and PHP runtime, designed to run instantly on standard shared hosting (cPanel/WHM) or cloud VPS with complete data sovereignty and zero monthly SaaS subscriptions.