TidyFactor/profile at main · TidyFactor/TidyFactor · GitHub
Skip to content

Latest commit

 

History

History

profile

Folders and files

README.md

⚡ TidyFactor Architecture Ecosystem

AI-Native Web Architecture, Design Systems & Agent Skills

Building sustainable, deterministic, and modular software for the era of Human-Agent Collaboration.

Official Website Documentation NPM Organization License: Apache 2.0 Location

🌐 Official Website • 📚 Documentation • 🤝 Partner (Alwkala) • 🏛️ Vision • 💬 WhatsApp



TidyFactor Architecture Ecosystem Hero Banner


🌟 Why TidyFactor Exists

The web has changed. Artificial Intelligence did not simply make software development faster — it fundamentally transformed how software is created, understood, maintained, and evolved.

The traditional web stack was designed exclusively for humans writing code. The next generation of web platforms must be designed for seamless collaboration between Humans, Developers, AI Models, Autonomous Coding Agents (Google Antigravity, Claude Code, Cursor, Codex, Windsurf), and Future Intelligent Systems.

TidyFactor provides the architectural foundations, deterministic agent skills, and modular codebases to make that reality reliable, secure, and production-grade.


🏛️ Ecosystem Architecture

TidyFactor Organization (github.com/TidyFactor)
│
├── 🛡️ Hygiene & Master Governance
│   ├── Cleaner      → Workstation & System   (Universal IDE, Framework Cache & System Hygiene Engine)
│   ├── GitHub       → Platform Operations    (GitHub Operations, CI/CD, Rulesets & CX Engine)
│   ├── Skill-Arch   → Master Governance      (14-Rule Architectural Governance & Skill Methodology)
│   └── TidyAgent    → Memory OS & Kernel     (Cognitive Memory OS, 4-Tier Taxonomy & Sovereign SQLite)
│
├── 🎨 Design Skills
│   ├── Cinematic    → Experience / "Wow"     (Apple × Cartier Scroll-Driven Landing Pages)
│   ├── Design       → Prototype / "Build"    (Code-Native UI Design Engine & Figma Alternative)
│   └── Styler       → Production / "Ship"    (Framework Styler, CVA Variants & RTL Polish Engine)
│
├── ⚡ Development Skills
│   ├── HTML         → Content & Static       (Semantic SEO, Agentic Browsing & llms.txt Discovery)
│   ├── HTMX         → Hypermedia             (Server-Driven Micro-Interactions)
│   ├── JS           → Vanilla SPA            (Framework-Free Reactive ES Modules)
│   ├── PHP          → Server-Rendered        (Modern PHP 8.x Modular Monolith Architecture)
│   └── Next         → Multi-Tenant SaaS      (Next.js 16, React 19, Supabase RLS & Dev-Perf)
│
└── 📈 Growth Skills
    └── Marketing    → Growth / Revenue       (Generative Engine Optimization GEO & Direct Response)

💎 The Frontend Triad

                TidyFactor
                    │
          ┌─────────┼─────────┐
          │         │         │
      Cinematic   Design    Styler
          │         │         │
      Experience Prototype Production
          │         │         │
        "Wow"      "Build"   "Ship"
  • Cinematic (TidyFactor/Cinematic): Creates unforgettable first impressions with scroll-driven <canvas> frame sequences and luxury brand storytelling.
  • Design (TidyFactor/Design): Bridges ideation and code with an interactive, code-native UI design system and zero-build prototyping.
  • Styler (TidyFactor/Styler): Operates across existing production codebases to deliver pixel-perfect section redesigns, CVA component variants, and native Arabic/RTL polish.

📦 Official Repositories & Community Packages

Category Repository Track / Focus Agent Skill NPM Package
Hygiene TidyFactor/Cleaner Universal IDE, framework cache & system hygiene engine tidyfactor-cleaner @tidyfactor/cleaner
Governance TidyFactor/skill-architect Master 14-rule governance layer & skill methodology engine tidyfactor-skill-architect @tidyfactor/skill-architect
Operations TidyFactor/GitHub GitHub platform ops, rulesets, CI/CD & contributor CX tidyfactor-github @tidyfactor/github
Memory TidyFactor/TidyAgent Cognitive memory OS, 4-tier taxonomy & sovereign SQLite tidyfactor-brain @tidyfactor/brain
Design TidyFactor/Cinematic Scroll-driven luxury landing pages (Apple × Cartier) tidyfactor-cinematic @tidyfactor/cinematic
Design TidyFactor/Design Interactive code-native UI design lifecycle engine tidyfactor-design @tidyfactor/design
Design TidyFactor/Styler Framework styler, CVA component variants & RTL polish tidyfactor-styler @tidyfactor/styler
Development TidyFactor/Doc Codebase interview, ADR generator, llms.txt & triple-publishing tidyfactor-doc @tidyfactor/doc
Development TidyFactor/Next Multi-tenant SaaS, Postgres RLS & Dev-Perf engine tidyfactor-next @tidyfactor/next
Development TidyFactor/HTML Content-first static platforms, Agentic Browsing & llms.txt tidyfactor-html @tidyfactor/html
Development TidyFactor/HTMX Server-driven hypermedia & micro-HTML endpoints tidyfactor-htmx @tidyfactor/htmx
Development TidyFactor/JS Framework-free reactive ES Modules & vanilla SPA tidyfactor-js @tidyfactor/js
Development TidyFactor/PHP Modern server-rendered PHP 8.x architecture & UI tidyfactor-php @tidyfactor/php
Growth TidyFactor/Marketing Generative Engine Optimization (GEO), copywriting & CRO tidyfactor-marketing @tidyfactor/marketing

🏛️ Core Architectural Principles

  1. Context-Efficient Architecture: Agent skills use lightweight dispatchers (~350 tokens) with progressive disclosure — loading deep domain memory strictly on demand.
  2. Deterministic Execution: Zero autonomous mass-edit scripts. Deterministic toolchains wrap native compiler diagnostics (tsc, node, git, OS APIs).
  3. Locked Tenant Isolation: Security boundaries live at the database layer (PostgreSQL RLS), ensuring application logic bugs cannot leak tenant data.
  4. Evidence-Based Performance: Measure before optimizing. Cold/warm benchmark separation with a strict 20% statistical noise threshold.
  5. Human-Agent Code Symmetry: Code structured for instant comprehension by both senior human engineers and autonomous AI agents.
  6. Inviolable Data Protection: Strict isolation for credentials, active sessions, .env secrets, database files, and local AI model weights (.gguf, .safetensors).

👨‍💻 Organization & Contact Details


📜 License

Distributed under the Apache License 2.0. Copyright (c) 2026 TidyFactor & Alwkala Digital Agency.