diff --git a/README.ar.md b/README.ar.md index f84498c..f64646a 100644 --- a/README.ar.md +++ b/README.ar.md @@ -29,6 +29,34 @@ --- +## 🚀 التثبيت والبدء السريع + +اختر طريقة التثبيت المناسبة لمشروعك: + +### الخيار (أ): عبر TidyFactor CLI الرسمي (الموصى به) +التثبيت الفوري دون الحاجة لتثبيت الأداة عالمياً في بيئة عملك النشطة: +```bash +npx @tidyfactor/cli add html +``` +*أو في حال كانت الأداة مثبتة لديك عالمياً (`npm i -g @tidyfactor/cli`):* +```bash +tidyfactor add html +``` + +### الخيار (ب): عبر معيار مهارات الوكلاء المفتوح (skills.sh) +التثبيت العالمي المتوافق مع كافة بيئات الوكلاء ومحررات الذكاء الاصطناعي (Antigravity, Cursor, Claude Code, Windsurf, Codex): +```bash +npx skills add tidyfactor/html +``` + +### الخيار (ج): التثبيت المباشر الفردي عبر NPM +تشغيل مثبت المهارة المستقل مباشرة مع تجاوز الذاكرة المخبأة وضمان أحدث إصدار: +```bash +npx @tidyfactor/html@latest +``` + +--- + ## 🏛️ معمارية منظومة TidyFactor **منظومة TidyFactor** هي بيئة معمارية برمجية مفتوحة وحزم مهارات لوكلاء الذكاء الاصطناعي قائمة على الفصل التام للمسؤوليات عبر دورة حياة المنتجات: diff --git a/README.md b/README.md index a6ebcfa..02fc35b 100644 --- a/README.md +++ b/README.md @@ -45,6 +45,34 @@ Built and maintained by **alwkala** — github.com/alwkala Licensed under the Apache License 2.0. +--- + +## 🚀 Installation & Quick Start + +Choose your preferred installation method: + +### Option A: Via TidyFactor CLI (Recommended) +Install directly using the official ecosystem package runner into your active workspace: +```bash +npx @tidyfactor/cli add html +``` +*Or if you have the CLI installed globally (`npm i -g @tidyfactor/cli`):* +```bash +tidyfactor add html +``` + +### Option B: Via Open Agent Skills Ecosystem (skills.sh / Vercel Labs) +Install using the universal multi-agent standard across all supported IDEs (Cursor, Antigravity, Claude Code, Windsurf, Trae, Codex): +```bash +npx skills add tidyfactor/html +``` + +### Option C: Standalone Zero-Dependency Runner (NPM Direct) +Run the dedicated skill installer directly with automatic cache invalidation: +```bash +npx @tidyfactor/html@latest +``` + --- ## 🏛️ TidyFactor Ecosystem Architecture diff --git a/dist/tidyfactor-html.skill b/dist/tidyfactor-html.skill deleted file mode 100644 index fe59738..0000000 Binary files a/dist/tidyfactor-html.skill and /dev/null differ diff --git a/dist/tidyfactor-html/.tidyfactor b/dist/tidyfactor-html/.tidyfactor deleted file mode 100644 index ddd1895..0000000 --- a/dist/tidyfactor-html/.tidyfactor +++ /dev/null @@ -1,31 +0,0 @@ -{ - "ecosystem": "tidyfactor", - "track": "html", - "name": "tidyfactor-html", - "version": "1.2.0", - "npmPackage": "@alwkala/tidyfactor-html", - "github": "https://github.com/TidyFactor/HTML", - "skillFile": "../tidyfactor-html-v1.1.0.skill", - "category": "static-site", - "commands": [ - "brief", - "assets", - "compo", - "deploy", - "i18n", - "init", - "modules", - "pages", - "seo", - "store" - ], - "foundations": [ - "native-css", - "tailwind" - ], - "visionRef": "../TidyFactor-VISION.md", - "commercialPartner": "alwkala", - "website": "https://tidyfactor.com", - "docs": "https://tidyfactor.com/documentation", - "license": "Apache-2.0" -} diff --git a/dist/tidyfactor-html/AGENTS.md b/dist/tidyfactor-html/AGENTS.md deleted file mode 100644 index 9d97d82..0000000 --- a/dist/tidyfactor-html/AGENTS.md +++ /dev/null @@ -1,3 +0,0 @@ -# Agent Rules — tidyfactor-html - -All work must follow the TidyFactor Vision (`VISION.md`) and single-source-of-truth guidelines in `SKILLS-LAB-GUIDE.md`. diff --git a/dist/tidyfactor-html/CHANGELOG.md b/dist/tidyfactor-html/CHANGELOG.md deleted file mode 100644 index 127483a..0000000 --- a/dist/tidyfactor-html/CHANGELOG.md +++ /dev/null @@ -1,28 +0,0 @@ -# Changelog - TidyFactor HTML - -All notable changes to the **[@tidyfactor/html](https://www.npmjs.com/package/@tidyfactor/html)** package will be documented in this file. - -## [1.2.0] - 2026-08-29 - -### Added - Global Multi-Tier & Multi-Language Documentation Architecture -- **Rule 13 Implementation**: Two-tier documentation separation between Canonical Technical Documentation (`README.md` SSOT) and First-Class Market Localizations. -- **Universal Multi-Language Switcher**: Standardized 8-language switcher navigation bar across all documentation files (`EN`, `AR`, `FA`, `ES`, `PT`, `ZH`, `DE`, `FR`). -- **First-Class Localized Developer Adoption Guides**: `README.es.md`, `README.pt.md`, `README.fa.md`, `README.zh.md`, `README.de.md`, `README.fr.md`. -- **Automated Validation & Packaging**: Updated `tools/build-skill.js` and `tools/validate_skill.py`. - -The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), -and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). - -## [1.1.0] - 2026-08-25 - -### Added -- **Contextual Decision Layer (CDL v1.0)**: Added `references/memory/decision-points.md` with thin arbitration protocol (H1–H5: Componentization Model, CSS Styling Strategy, Content Source, Deployment Target, Output Scope). -- **Brief Command (`/brief`)**: Added `references/commands/brief.md` and `references/workflows/brief.md` for pre-flight static architecture discovery. -- **7-Axis Static Quality Gate (`P/H/E/S/R/V/D`)**: Added `references/memory/quality-bar.md` enforcing 100% static delivery, semantic HTML5, and relative link integrity. -- **Structured References & Workflows Architecture**: Created `references/memory/` and `references/workflows/` (init, pages, compo, deploy, brief). -- **Validation & CLI Suite**: Added `bin/add-skill.js`, updated `package.json` `"bin"` map, created `tools/validate_skill.py`, and updated `brand.json` version. - ---- - -## [1.0.0] - 2026-07-28 -- Initial Release of `@tidyfactor/html` diff --git a/dist/tidyfactor-html/LICENSE b/dist/tidyfactor-html/LICENSE deleted file mode 100644 index 8ea93e1..0000000 --- a/dist/tidyfactor-html/LICENSE +++ /dev/null @@ -1,17 +0,0 @@ - Apache License - Version 2.0, January 2004 - http://www.apache.org/licenses/ - - Copyright 2026 TidyFactor Ecosystem & Alwkala Digital Agency (https://alwkala.com) - - Licensed under the Apache License, Version 2.0 (the "License"); - you may not use this file except in compliance with the License. - You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. diff --git a/dist/tidyfactor-html/README.ar.md b/dist/tidyfactor-html/README.ar.md deleted file mode 100644 index f84498c..0000000 --- a/dist/tidyfactor-html/README.ar.md +++ /dev/null @@ -1,100 +0,0 @@ -
- -# 🌐 مهارة تايتفكتور للمواقع الثابتة `TidyFactor HTML v1.2.0` -### محرك المواقع الثابتة بنسبة 100% ومكونات الويب Web Components لوكلاء الذكاء الاصطناعي - -[![npm version](https://img.shields.io/npm/v/@tidyfactor/html.svg?style=for-the-badge&color=E34F26&logo=npm)](https://www.npmjs.com/package/@tidyfactor/html) -[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg?style=for-the-badge)](LICENSE) -[![Ecosystem](https://img.shields.io/badge/TidyFactor-Skills--LAB-purple.svg?style=for-the-badge)](https://github.com/TidyFactor) -[![Compatibility](https://img.shields.io/badge/Agents-Antigravity%20|%20Claude%20|%20Cursor%20|%20Codex-orange.svg?style=for-the-badge)](SKILL.md) -[![طبقة القرارات](https://img.shields.io/badge/CDL-طبقة%20القرارات%20السياقية-purple.svg?style=for-the-badge)](SKILL.md) -[![أداء لايتهاوس](https://img.shields.io/badge/لايتهاوس-100%2F100-success.svg?style=for-the-badge)](SKILL.md) -[![RTL Native Arabic](https://img.shields.io/badge/RTL-Native%20Arabic-emerald.svg?style=for-the-badge)](README.ar.md) -[![Architect Score](https://img.shields.io/badge/Architect%20Score-13%2F13%20Pass%20(100%25)-green.svg?style=for-the-badge)](#-معايير-الحوكمة-والجودة) -[![AI Agents Compatible](https://img.shields.io/badge/AI%20Agents-Universal%20Compatibility-4285F4.svg?style=for-the-badge)](SKILL.md) - -[ English ](README.md) • [ العربية ](README.ar.md) • [ فارسی ](README.fa.md) • [ Español ](README.es.md) • [ Português ](README.pt.md) • [ 简体中文 ](README.zh.md) • [ Deutsch ](README.de.md) • [ Français ](README.fr.md)](https://www.npmjs.com/package/@tidyfactor/html) -[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=for-the-badge)](LICENSE) -[![RTL Native Arabic](https://img.shields.io/badge/RTL-Native%20Arabic-emerald.svg?style=for-the-badge)](#-معمارية-منظومة-tidyfactor) - -[⚡ الأوامر](#-أوامر-المهارة) • [🏛️ المنظومة](#-معمارية-منظومة-tidyfactor) • [📖 English Version](README.md) - -

- -

- TidyFactor HTML Hero Banner -

- -
- ---- - -## 🏛️ معمارية منظومة TidyFactor - -**منظومة TidyFactor** هي بيئة معمارية برمجية مفتوحة وحزم مهارات لوكلاء الذكاء الاصطناعي قائمة على الفصل التام للمسؤوليات عبر دورة حياة المنتجات: - -```text -منظمة TidyFactor الرسمية (github.com/TidyFactor) -│ -├── مهارات التصميم (Design Skills) -│ ├── Cinematic ← تجربة الإبهار البصري / Experience ("Wow") (صفحات سينمائية تفاعلية) -│ ├── Design ← بناء النماذج الأولية / Prototype ("Build") (محرك تصميم كودي وبديل Figma) -│ └── Styler ← الجاهزية للإنتاج والتنسيق / Production ("Ship") (محرك التنسيق ودعم RTL) -│ -├── مهارات التطوير البرمجي (Development Skills) -│ ├── HTML ← المواقع الثابتة وسيو المحتوى / Static & SEO (هياكل خفيفة وسريعة) -│ ├── HTMX ← الواجهات التفاعلية الخفيفة / Hypermedia (تفاعلات بدون جافاسكريبت معقدة) -│ ├── JS ← تطبيقات الصفحة الواحدة بدون أطر / Vanilla SPA (نماذج تفاعلية بـ ES Modules) -│ ├── PHP ← المنظومات المخدمية الحديثة / Server-Rendered (مكونات حديثة وتطبيقات PHP 8) -│ └── Next ← منصات الساس متعددة المستأجرين / Multi-Tenant (Next.js 16 + Postgres RLS) -│ -└── مهارات النمو والتسويق (Growth Skills) - └── Marketing ← استراتيجيات النمو والمبيعات / Growth & SEO (تسويق الاستجابة المباشرة) -``` - -### 💎 ثلاثي الواجهات الأمامية والتجربة (Frontend Triad) - -```text - TidyFactor - │ - ┌─────────┼─────────┐ - │ │ │ - Cinematic Design Styler - │ │ │ - Experience Prototype Production - │ │ │ - "Wow" "Build" "Ship" -``` - -### 📦 مصفوفة التكامل الشامل للمجتمع (GitHub • Skill • NPM) - -| المسار البرمجي | الفئة | مستودع GitHub | مهارة الوكيل | حزمة NPM | -| :--- | :--- | :--- | :--- | :--- | -| **Cinematic** | التصميم | [`TidyFactor/Cinematic`](https://github.com/TidyFactor/Cinematic) | `tidyfactor-cinematic` | [`@tidyfactor/cinematic`](https://www.npmjs.com/package/@tidyfactor/cinematic) | -| **Design** | التصميم | [`TidyFactor/Design`](https://github.com/TidyFactor/Design) | `tidyfactor-design` | [`@tidyfactor/design`](https://www.npmjs.com/package/@tidyfactor/design) | -| **Styler** | التصميم | [`TidyFactor/Styler`](https://github.com/TidyFactor/Styler) | `tidyfactor-styler` | [`@tidyfactor/styler`](https://www.npmjs.com/package/@tidyfactor/styler) | -| **Next** | التطوير | [`TidyFactor/Next`](https://github.com/TidyFactor/Next) | `tidyfactor-next` | [`@tidyfactor/next`](https://www.npmjs.com/package/@tidyfactor/next) | -| **HTML** | التطوير | [`TidyFactor/HTML`](https://github.com/TidyFactor/HTML) | `tidyfactor-html` | [`@tidyfactor/html`](https://www.npmjs.com/package/@tidyfactor/html) | -| **HTMX** | التطوير | [`TidyFactor/HTMX`](https://github.com/TidyFactor/HTMX) | `tidyfactor-htmx` | [`@tidyfactor/htmx`](https://www.npmjs.com/package/@tidyfactor/htmx) | -| **JS** | التطوير | [`TidyFactor/JS`](https://github.com/TidyFactor/JS) | `tidyfactor-js` | [`@tidyfactor/js`](https://www.npmjs.com/package/@tidyfactor/js) | -| **PHP** | التطوير | [`TidyFactor/PHP`](https://github.com/TidyFactor/PHP) | `tidyfactor-php` | [`@tidyfactor/php`](https://www.npmjs.com/package/@tidyfactor/php) | -| **Marketing** | النمو | [`TidyFactor/Marketing`](https://github.com/TidyFactor/Marketing) | `tidyfactor-marketing` | [`@tidyfactor/marketing`](https://www.npmjs.com/package/@tidyfactor/marketing) | - ---- - -## 👨‍💻 المنظمة والتواصل والدعم - -- 🌐 **الموقع الرسمي للمنظومة:** [https://tidyfactor.com/](https://tidyfactor.com/) -- 📚 **التوثيق الرسمي المعتمد:** [https://tidyfactor.com/documentation](https://tidyfactor.com/documentation) -- 🤝 **الشريك التقني الرسمي:** [الوكالة الرقمية Alwkala](https://alwkala.com/) -- 🐙 **منظمة GitHub الرسمية:** [github.com/TidyFactor](https://github.com/TidyFactor) -- 📧 **استفسارات الأعمال والشركات:** [hello@tidyfactor.com](mailto:hello@tidyfactor.com) -- 📱 **واتساب:** [+20 101 665 6899](https://wa.me/201016656899) -- 📞 **الهاتف:** +20 101 665 6899 -- 📍 **المقر:** القاهرة، جمهورية مصر العربية - ---- - -## 📜 الترخيص والمجتمع - -مرخصة تحت رخصة **Apache License 2.0**. حقوق النشر محفوظة (c) 2026 لصالح [منظومة TidyFactor](https://tidyfactor.com) و[الوكالة الرقمية Alwkala](https://alwkala.com). diff --git a/dist/tidyfactor-html/README.md b/dist/tidyfactor-html/README.md deleted file mode 100644 index a6ebcfa..0000000 --- a/dist/tidyfactor-html/README.md +++ /dev/null @@ -1,118 +0,0 @@ -
- -# 🌐 TidyFactor HTML `v1.2.0` -### 100% Static Platform Starter, Web Components & Contextual Decision Engine - -**The official static web engineering track within the TidyFactor Architecture Ecosystem.** - -[![npm version](https://img.shields.io/npm/v/@tidyfactor/html.svg?style=for-the-badge&color=E34F26)](https://www.npmjs.com/package/@tidyfactor/html) -[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=for-the-badge)](LICENSE) -[![RTL Ready](https://img.shields.io/badge/RTL-Native%20Arabic-emerald.svg?style=for-the-badge)](README.ar.md) -[![Zero Runtime](https://img.shields.io/badge/Runtime-Zero%20Server-purple.svg?style=for-the-badge)](#-three-lifecycle-modes) - -[🚀 Quick Start](#-quick-start) • [⚡ 9 Commands](#-command-set) • [🏛️ Ecosystem](#%EF%B8%8F-tidyfactor-ecosystem-architecture) • [📖 بالعربية](README.ar.md) - -

- -

- TidyFactor HTML Hero Banner -

- -
- ---- - -Part of the TidyFactor ecosystem. Sibling tracks (`tidyfactor-php`, -`tidyfactor-vanilla-js`, `tidyfactor-micro-js`, `tidyfactor-track-*`) live -as separate skills so each can carry a full, framework-appropriate -command set instead of one skill trying to cover every stack at once. - -## Three lifecycle modes -- **Init** — scaffold a brand-new static project. -- **Convert** — bring an existing site, SPA, or other stack onto this - track. -- **Improve** — audit and upgrade a project already on this track. - -## Command set -`init` · `assets` · `compo` · `store` · `pages` · `modules` · `i18n` · -`seo` · `deploy` — see `SKILL.md` for the full sequencing and each -command's reference file under `references/commands/`. - -## Developer -Built and maintained by **alwkala** — github.com/alwkala - -## License -Licensed under the Apache License 2.0. - - ---- - -## 🏛️ TidyFactor Ecosystem Architecture - -**TidyFactor** is a modular web architecture and AI coding agent skill ecosystem built on clear separation of concerns across the product lifecycle: - -``` -TidyFactor Organization (github.com/TidyFactor) -│ -├── 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 & RTL Polish Engine) -│ -├── Development Skills -│ ├── HTML → Content & Static (Semantic SEO & Static Platform Starter) -│ ├── HTMX → Hypermedia (Server-Driven Micro-Interactions) -│ ├── JS → Vanilla SPA (Framework-Free Reactive ES Modules) -│ ├── PHP → Server-Rendered (Modern PHP 8.x Component UI & Architecture) -│ └── Next → Multi-Tenant SaaS (Next.js 16, React 19, Supabase RLS & Dev-Perf) -│ -└── Growth Skills - └── Marketing → Growth / Revenue (Direct Response, Pillar SEO & Content Lifecycles) -``` - -### 💎 Frontend Triad - -``` - TidyFactor - │ - ┌─────────┼─────────┐ - │ │ │ - Cinematic Design Styler - │ │ │ - Experience Prototype Production - │ │ │ - "Wow" "Build" "Ship" -``` - -### 📦 Community Package & Skill Parity - -| Track | Category | GitHub Repository | Agent Skill | NPM Package | -| :--- | :--- | :--- | :--- | :--- | -| **Cinematic** | Design | [`TidyFactor/Cinematic`](https://github.com/TidyFactor/Cinematic) | `tidyfactor-cinematic` | [`@tidyfactor/cinematic`](https://www.npmjs.com/package/@tidyfactor/cinematic) | -| **Design** | Design | [`TidyFactor/Design`](https://github.com/TidyFactor/Design) | `tidyfactor-design` | [`@tidyfactor/design`](https://www.npmjs.com/package/@tidyfactor/design) | -| **Styler** | Design | [`TidyFactor/Styler`](https://github.com/TidyFactor/Styler) | `tidyfactor-styler` | [`@tidyfactor/styler`](https://www.npmjs.com/package/@tidyfactor/styler) | -| **Next** | Development | [`TidyFactor/Next`](https://github.com/TidyFactor/Next) | `tidyfactor-next` | [`@tidyfactor/next`](https://www.npmjs.com/package/@tidyfactor/next) | -| **HTML** | Development | [`TidyFactor/HTML`](https://github.com/TidyFactor/HTML) | `tidyfactor-html` | [`@tidyfactor/html`](https://www.npmjs.com/package/@tidyfactor/html) | -| **HTMX** | Development | [`TidyFactor/HTMX`](https://github.com/TidyFactor/HTMX) | `tidyfactor-htmx` | [`@tidyfactor/htmx`](https://www.npmjs.com/package/@tidyfactor/htmx) | -| **JS** | Development | [`TidyFactor/JS`](https://github.com/TidyFactor/JS) | `tidyfactor-js` | [`@tidyfactor/js`](https://www.npmjs.com/package/@tidyfactor/js) | -| **PHP** | Development | [`TidyFactor/PHP`](https://github.com/TidyFactor/PHP) | `tidyfactor-php` | [`@tidyfactor/php`](https://www.npmjs.com/package/@tidyfactor/php) | -| **Marketing** | Growth | [`TidyFactor/Marketing`](https://github.com/TidyFactor/Marketing) | `tidyfactor-marketing` | [`@tidyfactor/marketing`](https://www.npmjs.com/package/@tidyfactor/marketing) | - ---- - -## 👨‍💻 Organization & Support - -- 🌐 **Official Website:** [https://tidyfactor.com/](https://tidyfactor.com/) -- 📚 **Official Documentation:** [https://tidyfactor.com/documentation](https://tidyfactor.com/documentation) -- 🤝 **Official Partner Website:** [Alwkala Digital Agency](https://alwkala.com/) -- 🐙 **GitHub Organization:** [github.com/TidyFactor](https://github.com/TidyFactor) -- 📧 **Business Inquiries:** [hello@tidyfactor.com](mailto:hello@tidyfactor.com) -- 📱 **WhatsApp:** [+20 101 665 6899](https://wa.me/201016656899) -- 📞 **Phone:** +20 101 665 6899 -- 📍 **Location:** Cairo, Egypt - ---- - -## 📜 License - -Licensed under the **Apache License 2.0**. Copyright (c) 2026 [TidyFactor](https://tidyfactor.com) & [Alwkala](https://alwkala.com). diff --git a/dist/tidyfactor-html/SKILL.md b/dist/tidyfactor-html/SKILL.md deleted file mode 100644 index 9697502..0000000 --- a/dist/tidyfactor-html/SKILL.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -name: tidyfactor-html -description: "Static HTML/CSS/JS platform starter with Contextual Decision Layer (CDL). Built for zero server runtime, Web Components, and free/shared hosting (GitHub Pages, Cloudflare, Netlify, cPanel). Trigger on commands 'brief', 'init', 'compo', 'pages', 'assets', 'store', 'modules', 'i18n', 'seo', 'deploy', or requests to scaffold or convert to plain static HTML." ---- -# TidyFactor HTML (Content-First Static Platform Starter) - -A command dispatcher for 100% static HTML/CSS/JS web platforms. This router declares commands and workflows without performing execution directly. - -## Commands - -| User intent | Command | What it loads | -|---|---|---| -| Strategic Static Discovery & Brief Resolution | `references/commands/brief.md` | `references/workflows/brief.md` + `references/memory/decision-points.md` + `references/memory/quality-bar.md` | -| Primary deliverable — scaffold a new static site | `references/commands/init.md` | `references/workflows/init.md` + `references/memory/architecture.md` | -| Componentization & Web Components partials | `references/commands/compo.md` | `references/workflows/compo.md` + `references/memory/architecture.md` | -| Add new content pages / blog articles | `references/commands/pages.md` | `references/workflows/pages.md` + `references/memory/architecture.md` | -| Asset hygiene, favicon, and SVG optimization | `references/commands/assets.md` | `references/commands/assets.md` + `references/memory/quality-bar.md` | -| JSON / Markdown client-side content stores | `references/commands/store.md` | `references/commands/store.md` + `references/memory/decision-points.md` | -| Zero-build ES Modules & utility helpers | `references/commands/modules.md` | `references/commands/modules.md` + `references/memory/architecture.md` | -| Multilingual translation & Arabic RTL formatting | `references/commands/i18n.md` | `references/commands/i18n.md` + `references/memory/quality-bar.md` | -| SEO metadata, OpenGraph tags, sitemap generation | `references/commands/seo.md` | `references/commands/seo.md` + `references/memory/quality-bar.md` | -| Prepare deployment (GitHub Pages, Cloudflare, cPanel) | `references/commands/deploy.md` | `references/workflows/deploy.md` + `references/memory/quality-bar.md` | - -Read only the command file that matches the request. Do not load all commands simultaneously. - -## Non-Negotiable Invariants - -1. **Contextual Decision Layer (CDL)**: Resolve static baselines via `/brief` or `.tidyfactor/html-brief.md` before emitting code. -2. **Zero Server Runtime**: Deliverable runs directly from static storage without Node, PHP, or database servers. -3. **Clean Relative Paths**: Never output absolute workstation drive paths (`file:///C:/...`). Use root-relative or relative links. -4. **Semantic HTML5**: Use proper semantic tags (`header`, `nav`, `main`, `section`, `footer`) and heading hierarchy. -5. **7-Axis Pre-Emit Critique**: All generated pages must be evaluated with `/* Pre-emit critique: P5 H5 E5 S5 R5 V5 D5 */`. diff --git a/dist/tidyfactor-html/assets/hero-banner.png b/dist/tidyfactor-html/assets/hero-banner.png deleted file mode 100644 index ee5b0b3..0000000 Binary files a/dist/tidyfactor-html/assets/hero-banner.png and /dev/null differ diff --git a/dist/tidyfactor-html/assets/og-default.png b/dist/tidyfactor-html/assets/og-default.png deleted file mode 100644 index ee5b0b3..0000000 Binary files a/dist/tidyfactor-html/assets/og-default.png and /dev/null differ diff --git a/dist/tidyfactor-html/bin/add-skill.js b/dist/tidyfactor-html/bin/add-skill.js deleted file mode 100644 index 4f8b011..0000000 --- a/dist/tidyfactor-html/bin/add-skill.js +++ /dev/null @@ -1,65 +0,0 @@ -#!/usr/bin/env node -/** - * bin/add-skill.js — Multi-Agent Skill Installer Wrapper for tidyfactor-html - * Supports Trae, Cursor, Windsurf, Antigravity, GitHub Copilot, RooCode, OpenCode, KiloCode, Warp, and Universal. - * - * @license Apache-2.0 - */ - -const fs = require('fs'); -const path = require('path'); -const os = require('os'); - -const targetDir = process.cwd(); -const skillSource = path.resolve(__dirname, '..'); -const skillName = 'tidyfactor-html'; - -const AGENT_MAP = [ - { name: 'Trae AI IDE', dir: path.join(targetDir, '.trae', 'skills', skillName), test: path.join(targetDir, '.trae') }, - { name: 'Cursor IDE', dir: path.join(targetDir, '.cursor', 'skills', skillName), test: path.join(targetDir, '.cursor') }, - { name: 'Windsurf Cascade', dir: path.join(targetDir, '.windsurf', 'skills', skillName), test: path.join(targetDir, '.windsurf') }, - { name: 'GitHub Copilot', dir: path.join(targetDir, '.github', 'prompts', skillName), test: path.join(targetDir, '.github') }, - { name: 'RooCode', dir: path.join(targetDir, '.roo', 'skills', skillName), test: path.join(targetDir, '.roo') }, - { name: 'OpenCode / Zen', dir: path.join(targetDir, '.opencode', 'skills', skillName), test: path.join(targetDir, '.opencode') }, - { name: 'KiloCode', dir: path.join(targetDir, '.kilocode', 'skills', skillName), test: path.join(targetDir, '.kilocode') }, - { name: 'Warp Terminal', dir: path.join(targetDir, '.warp', 'skills', skillName), test: path.join(targetDir, '.warp') }, - { name: 'Kiro Spec IDE', dir: path.join(targetDir, '.kiro', 'skills', skillName), test: path.join(targetDir, '.kiro') }, - { name: 'Claude Code', dir: path.join(targetDir, '.claude', 'skills', skillName), test: path.join(targetDir, '.claude') }, - { name: 'Zed AI Agent', dir: path.join(targetDir, '.zed', 'skills', skillName), test: path.join(targetDir, '.zed') }, - { name: 'Google Antigravity/Gemini', dir: path.join(targetDir, '.agents', 'skills', skillName), test: path.join(targetDir, '.agents') }, -]; - -function copyRecursive(src, dest) { - fs.mkdirSync(dest, { recursive: true }); - const entries = fs.readdirSync(src, { withFileTypes: true }); - for (const entry of entries) { - const srcPath = path.join(src, entry.name); - const destPath = path.join(dest, entry.name); - if (['.git', 'node_modules', 'dist'].includes(entry.name)) continue; - if (entry.isDirectory()) { - copyRecursive(srcPath, destPath); - } else { - fs.copyFileSync(srcPath, destPath); - } - } -} - -// Determine installation targets -let mountedTargets = []; - -for (const agent of AGENT_MAP) { - if (fs.existsSync(agent.test)) { - copyRecursive(skillSource, agent.dir); - mountedTargets.push(agent.name + ' (' + path.relative(targetDir, agent.dir) + ')'); - } -} - -// Always ensure universal fallback in .agents/skills/ -const defaultDir = path.join(targetDir, '.agents', 'skills', skillName); -copyRecursive(skillSource, defaultDir); -if (!mountedTargets.some(t => t.includes('.agents'))) { - mountedTargets.push('Universal Default (.agents/skills/' + skillName + ')'); -} - -console.log('✨ Successfully injected ' + skillName + ' into:'); -mountedTargets.forEach(t => console.log(' • ' + t)); diff --git a/dist/tidyfactor-html/bin/create-kit.js b/dist/tidyfactor-html/bin/create-kit.js deleted file mode 100644 index 4b87924..0000000 --- a/dist/tidyfactor-html/bin/create-kit.js +++ /dev/null @@ -1,20 +0,0 @@ -#!/usr/bin/env node -const fs = require('fs'); -const path = require('path'); - -const args = process.argv.slice(2); -if (args.includes('-v') || args.includes('--version')) { - console.log('tidyfactor-html v1.0.0'); - process.exit(0); -} - -if (args.includes('-h') || args.includes('--help')) { - console.log('Usage: npx @tidyfactor/cli-html [project-directory] [options]'); - console.log('Options:'); - console.log(' -y, --yes Non-interactive / AI Agent mode'); - console.log(' -v, --version Show version'); - console.log(' -h, --help Show help'); - process.exit(0); -} - -console.log('✨ Scaffolded tidyfactor-html starter project successfully.'); diff --git a/dist/tidyfactor-html/brand.json b/dist/tidyfactor-html/brand.json deleted file mode 100644 index 1cbf2bc..0000000 --- a/dist/tidyfactor-html/brand.json +++ /dev/null @@ -1,15 +0,0 @@ -{ - "name": "TidyFactor HTML", - "version": "1.2.0", - "schemaVersion": "brand-core-v2", - "meta": { - "product": "TidyFactor HTML", - "tagline": "Content-First Static Platform Starter", - "description": "100% static HTML/CSS/JS starter with zero runtime and zero mandatory build tooling.", - "owner": "TidyFactor Ecosystem", - "website": "https://tidyfactor.com", - "repo": "https://github.com/TidyFactor/HTML", - "version": "1.1.0", - "lastUpdated": "2026-08-25" - } -} diff --git a/dist/tidyfactor-html/memory/overview.md b/dist/tidyfactor-html/memory/overview.md deleted file mode 100644 index a2410b6..0000000 --- a/dist/tidyfactor-html/memory/overview.md +++ /dev/null @@ -1 +0,0 @@ -# Deep Reference Memory — tidyfactor-html diff --git a/dist/tidyfactor-html/package.json b/dist/tidyfactor-html/package.json deleted file mode 100644 index 97861d6..0000000 --- a/dist/tidyfactor-html/package.json +++ /dev/null @@ -1,63 +0,0 @@ -{ - "name": "@tidyfactor/html", - "version": "1.2.0", - "description": "TidyFactor HTML track — 100% static HTML/CSS/JS platform starter with Contextual Decision Layer (CDL)", - "main": "SKILL.md", - "bin": { - "tidyfactor-html": "bin/add-skill.js", - "add-skill": "bin/add-skill.js", - "add-html-skill": "bin/add-skill.js" - }, - "keywords": [ - "tidyfactor", - "static-site", - "html5", - "css3", - "vanilla-js", - "web-components", - "github-pages", - "ai-agents", - "antigravity", - "claude-code", - "cursor" - ], - "author": "TidyFactor (https://tidyfactor.com)", - "license": "Apache-2.0", - "repository": { - "type": "git", - "url": "git+https://github.com/TidyFactor/HTML.git" - }, - "scripts": { - "validate": "python tools/validate_skill.py", - "build": "node tools/build-skill.js", - "release": "python ../tools/release_skill.py ." - }, - "publishConfig": { - "access": "public" - }, - "files": [ - ".tidyfactor", - "AGENTS.md", - "CHANGELOG.md", - "LICENSE", - "README.ar.md", - "README.de.md", - "README.es.md", - "README.fa.md", - "README.fr.md", - "README.md", - "README.pt.md", - "README.zh.md", - "SKILL-REGISTRY.md", - "SKILL.md", - "VISION.md", - "assets", - "bin", - "brand.json", - "memory", - "references", - "scripts", - "templates", - "tools" - ] -} diff --git a/dist/tidyfactor-html/references/commands/_template.md b/dist/tidyfactor-html/references/commands/_template.md deleted file mode 100644 index 953989a..0000000 --- a/dist/tidyfactor-html/references/commands/_template.md +++ /dev/null @@ -1,27 +0,0 @@ -# Command: `` — - -## Purpose -One or two sentences: what this command extracts/organizes, and why it's -its own command rather than folded into another one. - -## When to run it -- Signal from the audit that suggests this command applies. -- User phrasing that should trigger it (besides the bare command word). - -## What it does -Numbered steps — concrete actions, not vague principles. - -## Output convention -``` -Example file tree fragment showing where output lands. -``` - -## Checklist -- [ ] Concrete, checkable outcomes for this command specifically. - ---- -To register a new command: -1. Copy this file to `references/commands/.md` and fill it in. -2. Add a row to the Command Index table in `SKILL.md`. -3. If it interacts with an existing command (consumes/produces the same - files), cross-reference it in both files' "What it does" sections. diff --git a/dist/tidyfactor-html/references/commands/assets.md b/dist/tidyfactor-html/references/commands/assets.md deleted file mode 100644 index 402453d..0000000 --- a/dist/tidyfactor-html/references/commands/assets.md +++ /dev/null @@ -1,44 +0,0 @@ -# Command: `assets` — Asset Hygiene - -## Purpose -Consolidate and organize CSS/JS/images, and apply the performance basics -that matter most on a track with no server-side caching/compression -control (many free hosts serve files as-is). - -## When to run it -- The audit shows inline `