@tidyfactor/doc 1.3.0

package/.tidyfactor

@@ -0,0 +1,16 @@
+{
+  "name": "tidyfactor-doc",
+  "version": "1.3.0",
+  "category": "architecture",
+  "description": "TidyFactor Doc - Code Documentation Builder & Dual-Engine Publishing Platform (MkDocs Material & Docsify)",
+  "repository": "https://github.com/TidyFactor/Doc",
+  "npm": "@alwkala/tidyfactor-doc",
+  "compatibility": [
+    "antigravity",
+    "claude-code",
+    "cursor",
+    "codex",
+    "windsurf"
+  ],
+  "license": "Apache-2.0"
+}

package/AGENTS.md

@@ -0,0 +1,10 @@
+# AGENTS.md — TidyFactor Doc Governance Rules
+
+This file governs all AI coding agents working on or with `tidyfactor-doc`.
+
+## Core Invariants
+1. **SSOT Rule:** `tidyfactor-doc/` in Skills-LAB is the single source of truth.
+2. **Docs in `/docs` Only:** Generated documentation artifacts MUST live under `/docs` (except root `README.md`).
+3. **No Assumed Details:** `generate` never invents facts or env vars not gathered during `collect`.
+4. **Docsify Persistence:** Always generate `alias: { '/.*/_sidebar.md': '/_sidebar.md' }` and root-relative paths.
+5. **SemVer SSOT:** All changes must bump version and update `CHANGELOG.md`.

package/CHANGELOG.md

@@ -0,0 +1,75 @@
+# CHANGELOG — TidyFactor Doc
+
+All notable changes to `tidyfactor-doc` will be documented in this file.
+This project adheres to [Semantic Versioning](https://semver.org/).
+
+## [1.2.1] - 2026-08-25
+
+### Fixed
+- **CLI Executable & NPX Packaging**: Added standard `"add-skill": "bin/add-skill.js"` mapping in `package.json` to ensure unified `npx @tidyfactor/cli-doc add-skill` execution.
+- **Workflow Compliance**: Standardized `## Validation checklist` headers across all 8 workflows.
+
+---
+
+## [1.3.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`.
+
+## [1.2.0] - 2026-08-25
+
+### Added
+- **MkDocs Material Publishing Engine**:
+  - Full static HTML compilation track for high-performance production doc portals.
+  - Native bilingual parallel build support (`/` and `/ar/`) via `mkdocs-static-i18n`.
+  - Built-in Lunr.js offline search indexing (English + Arabic tokenization).
+  - Neo-Brutalist luxury styling tokens (`tidyfactor-light` & `tidyfactor-dark`) via `stylesheets/extra.css`.
+  - macOS-style terminal dots on highlighted code blocks with line spans.
+  - GitHub-style alert callout transformer (`[!IMPORTANT]`, `[!NOTE]`, `[!WARNING]`, `[!TIP]`) via `javascripts/extra.js`.
+  - Local Apache subfolder transparent routing via `.htaccess`.
+- **Interactive Engine Selector Command (`site`)**:
+  - Interactive evaluation matrix in `references/commands/site.md` and `references/memory/site-engines.md`.
+  - Auto-detection of local Python/pip environment vs. zero-build CDN requirements.
+  - Clear user choice and recommendation guidance between MkDocs Material and Docsify.
+- **Dedicated Direct Commands**:
+  - `mkdocs`: Direct entry point for MkDocs Material static portal compilation.
+  - `docsify`: Direct entry point for Docsify zero-build lightweight SPA.
+- **New Workflows & Memory Specs**:
+  - `references/workflows/mkdocs.md`: End-to-end scaffolding, building, and validation checklist.
+  - `references/memory/mkdocs-config.md`: Master `mkdocs.yml` schema, theme configuration, and i18n rules.
+  - `references/memory/site-engines.md`: Technical comparison between Docsify and MkDocs Material.
+
+---
+
+## [1.1.0] - 2026-08-20
+
+### Added
+- **Security Sanitization Constraint (Zero Sensitive Data Leakage)**:
+  - Enforced strict automated redaction of sensitive credentials across all workflows and memory files.
+  - Prohibited real API keys, passwords, database credentials, secret auth tokens, and private server IP addresses from leaking into `/docs`.
+  - Added safe placeholder standard replacements table in `references/memory/collection-sources.md` (RFC 5737 doc IP ranges, dummy token formats).
+- **Clean Relative Links Constraint (Clean Relative Links Only)**:
+  - Prohibited local machine URLs (`file:///C:/...`, `file:c:`, and absolute workstation paths) in all generated documentation.
+  - Mandated clean relative markdown links (`./docs/README.md`, `../api/project.md`) and standard public URLs.
+- **Workflow & Memory Hardening**:
+  - Updated `collect.md`, `generate-api.md`, `generate-guide.md`, `generate-readme.md`, `generate-inline.md`, and `docsify.md` with explicit validation checkboxes for zero credential leaks and clean link paths.
+  - Updated `doc-templates.md` to showcase secure dummy placeholders in environment variable tables and relative link cross-references.
+  - Added automated build pipeline script (`tools/build-skill.js`) for packaging and multi-target synchronization.
+
+---
+
+## [1.0.0] - 2026-08-19
+
+### Added
+- Initial canonical release of `tidyfactor-doc` under the TidyFactor Skills-LAB ecosystem.
+- Standard 4-command router architecture in `SKILL.md`:
+  - `init`: Scaffolds standard `/docs` folder structure and manifest.
+  - `collect`: Non-destructive codebase analysis for PHP, TS/JS, and React/Next stacks.
+  - `generate`: Produces API references, developer setup guides, inline docblocks, and READMEs.
+  - `docsify`: Generates responsive Docsify documentation websites with persistent subfolder sidebar routing.
+- Stack-specific memory rules for PHP 8, TypeScript, JavaScript, and React/Vue/Next component docs.
+- Full cross-agent compatibility across Google Antigravity, Claude Code, Cursor, Codex, and Windsurf.
+- Packaging as `@tidyfactor/doc` under Apache License 2.0.

package/LICENSE

@@ -0,0 +1,17 @@
+                                 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.

package/README.ar.md

@@ -0,0 +1,180 @@
+<div align="center">
+
+# 📚 TidyFactor Doc `v1.3.0`
+### محرك استقراء الأكواد البرمجية، وتوليد مراجع الـ API، ومنصة النشر المزدوجة (MkDocs Material و Docsify)
+
+**بناء توثيقات فنية دقيقة، مستدامة، آمنة، وقابلة للتصفح لعصر التعاون بين المطورين ووكلاء الذكاء الاصطناعي.**
+
+[![حزمة NPM](https://img.shields.io/npm/v/@tidyfactor/doc.svg?style=for-the-badge&color=4F46E5)](https://www.npmjs.com/package/@tidyfactor/doc)
+[![الترخيص: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=for-the-badge)](LICENSE)
+[![GitHub](https://img.shields.io/badge/GitHub-TidyFactor%2FDoc-181717.svg?style=for-the-badge&logo=github)](https://github.com/TidyFactor/Doc)
+[![حماية البيانات والخصوصية](https://img.shields.io/badge/Security-Redaction%20Certified-emerald.svg?style=for-the-badge)](#-ضمانات-الأمان-وحجب-البيانات-الحساسة)
+[![روابط نظيفة ونسبية](https://img.shields.io/badge/Links-Clean%20%26%20Relative-cyan.svg?style=for-the-badge)](#-معايير-الروابط-النسبية-والتصفح-النظيف)
+[![توافق شامل مع وكلاء الذكاء الاصطناعي](https://img.shields.io/badge/AI%20Agents-Universal%20Compatibility-4285F4.svg?style=for-the-badge)](README.md)
+
+[🌐 الموقع الرسمي](https://tidyfactor.com/) • [📚 مركز التوثيق](https://tidyfactor.com/documentation) • [🤝 الشريك (الوكالة)](https://alwkala.com/) • [⚡ سجل الأوامر](#-سجل-الأوامر-ومسارات-التوثيق-الأربعة) • [🛡️ الضمانات الأمنية](#-ضمانات-الأمان-وحجب-البيانات-الحساسة) • [📖 النسخة الإنجليزية (English)](README.md)
+
+<br/><br/>
+
+<p align="center">
+  <img src="assets/hero-banner.png" alt="TidyFactor Doc Hero Banner" width="100%" />
+</p>
+
+</div>
+
+---
+
+> [!NOTE]
+> **TidyFactor Doc** هو محرك حتمي لبناء التوثيقات الفنية ومواقع Docsify التفاعلية مخصص لوكلاء البرمجة الذكية (*Google Antigravity, Claude Code, Cursor, Codex, Windsurf*). يقوم باستقراء قواعد الأكواد والمشاريع البرمجية بدقة عبر فحص شجرة التعليمات البرمجية، وتاريخ التعديلات في Git، ومتغيرات بيئة التشغيل، وأنماط معالجة الأخطاء، لينتج مراكز توثيق متكاملة تحت مجلد `/docs` بدون أي تسريب للبيانات الحساسة أو روابط محلية معطوبة.
+
+---
+
+## 🌟 القيمة المضافة ولماذا TidyFactor Doc؟
+
+| للمطورين وقادة الفرق التقنية | لوكلاء البرمجة الذكية (AI Agents) | للمشاريع البرمجية والشركات |
+|---|---|---|
+| **انعدام الكتابة اليدوية**: استخراج تلقائي لمعمارية المشروع، وتواقيع الـ API، وخطوات التثبيت مباشرة من الكود المصدري. | **توجيه موفر للرموز (Tokens)**: موجه `SKILL.md` ذكي (~350 رمزاً) يحمّل مسار العمل وسياق الذاكرة المطلوب فقط. | **موقع Docsify فوري**: أمر واحد يحول مجلد `/docs` إلى بوابة توثيق ويب تفاعلية سريعة ومزودة بمحرك بحث فوري. |
+| **منع تسريب البيانات السرية**: حجب وتنقيح تلقائي لمفاتيح API، وكلمات المرور، وبيانات قواعد البيانات، وعناوين IP. | **الاعتماد على الحقائق فقط**: منع اختلاق أي دوال أو معلمات غير موجودة؛ كل حقيقة موثقة مستندة لنتائج الفحص. | **دعم لغات متعددة (Polyglot)**: قوالب جاهزة لـ PHP 8+، وTypeScript، وJavaScript ES Modules، ومكونات React/Vue/Next. |
+| **روابط نسبية نظيفة**: إزالة تامة لروابط `file:///` والمسارات المطلقة (`C:\...`) لضمان عمل التوثيق في أي بيئة. | **تحقق حتمي صارم**: كل مسار عمل يمتلك قائمة تدقيق وتتبع آلي للحالة في `docs/.doc-manifest.json`. | **دعم أصيل للغة العربية**: اتجاه RTL مدمج وتوافق طباعي فاخر (خطوط Cairo وTajawal مع Inter). |
+
+---
+
+## 🔄 دورة حياة التوثيق ذات الـ 4 مراحل
+
+تتبع المهارة مساراً تسلسلياً حتمياً من 4 مراحل:
+
+```mermaid
+graph LR
+    P1["1. التجهيز (Init)"] --> P2["2. الاستقراء (Collect)"]
+    P2 --> P3["3. التوليد (Generate)"]
+    P3 --> P4["4. النشر (Docsify)"]
+```
+
+```
+[ المرحلة 1: init ] ───> إنشاء هيكل مجلد /docs وملف التتبع .doc-manifest.json
+         │
+[ المرحلة 2: collect ] ─> استقراء الأبعاد الـ 5 (الكود، تاريخ Git، بيئة التشغيل، الجمهور، الأخطاء) وحفظها في docs/.collected/
+         │
+[ المرحلة 3: generate ] ─> إنتاج مراجع API، الأدلة الفنية، التعليقات البرمجية، أو ملف README من الحقائق المستقرأة
+         │
+[ المرحلة 4: docsify ] ──> تجميع index.html و_sidebar.md للعرض المباشر في المتصفح والاستضافة الثابتة
+```
+
+---
+
+## 🏛️ سجل الأوامر ومسارات التوثيق الأربعة
+
+| نية المطور وطلب المستخدم | الأمر | مسارات العمل والذاكرة المحملة | المخرجات الناتجة |
+|---|---|---|---|
+| **"تجهيز وهيكلة مجلد التوثيق"** / "scaffold /docs" | `init` | `workflows/init-docs.md`<br>`memory/doc-tree.md` | مجلد `/docs`، ملف `docs/.doc-manifest.json`، وصفحة `docs/README.md` |
+| **"استقراء وفحص الكود والمشروع"** / "gather facts" | `collect` | `workflows/collect.md`<br>`memory/collection-sources.md` | تقرير `docs/.collected/<target>.md` (تحليل منظم بالأبعاد الخمسة) |
+| **"كتابة مرجع واجهة برمجة (API)"** / "API reference" | `generate` | `workflows/generate-api.md`<br>`memory/doc-templates.md`<br>`memory/stacks/*.md` | ملف `docs/api/<target>.md` (جداول المعاملات، القيم المرجعة، الأخطاء) |
+| **"كتابة دليل إعداد وتشغيل"** / "setup guide" | `generate` | `workflows/generate-guide.md`<br>`memory/doc-templates.md` | ملف `docs/guides/<purpose-slug>.md` (دليل متخصص محدد الغرض) |
+| **"توليد أو تحديث README الرئيسي"** / "generate readme" | `generate` | `workflows/generate-readme.md`<br>`memory/doc-templates.md` | ملف `README.md` في جذر المشروع (نظرة عامة، التثبيت، المتغيرات) |
+| **"إضافة تعليقات برمجية للكود"** / "inline docblocks" | `generate` | `workflows/generate-inline.md`<br>`memory/stacks/*.md` | تعديل مباشر للملفات المصدرية بتعليقات PHPDoc / JSDoc / TSDoc |
+| **"تحويل التوثيقات إلى موقع Docsify"** / "deploy portal" | `docsify` | `workflows/docsify.md`<br>`memory/docsify-config.md` | ملفات `docs/index.html` و`docs/_sidebar.md` (موقع تفاعلي متكامل) |
+
+---
+
+## 🛡️ ضمانات الأمان وحجب البيانات الحساسة
+
+أثناء تشغيل وكلاء الذكاء الاصطناعي، قد تتسرب مفاتيح سرية أو عناوين خوادم حقيقية إلى ملفات التوثيق العامة. تفرض `tidyfactor-doc` قواعد حجب صارمة وغير قابلة للتجاوز (**القاعدة الإلزامية 6**):
+
+| نوع البيانات الحساسة | المحظور منعه تماماً | البديل الآمن الإلزامي |
+|---|---|---|
+| **مفاتيح API والرموز السرية** | `sk_live_948f98a7c1b2...` | `EXAMPLE_TOKEN_1234567890ABCDEFGH` أو `YOUR_API_KEY` |
+| **كلمات المرور وقواعد البيانات** | `RootP@ssw0rd2026!` | `your_secret_password` |
+| **عناوين IP الخاصة بالخوادم** | `192.168.1.50`, `45.33.21.99` | `203.0.113.1` (نطاق RFC 5737 المخصص للتوثيق) |
+| **روابط الملفات المحلية** | `file:///C:/path/to/project/...` | `./docs/guides/` أو `project-root/` |
+| **روابط بيئة التطوير الداخلية** | `http://localhost:8080/admin` | `https://api.example.com` أو `http://localhost:PORT` |
+| **مسارات مجلدات المستخدم** | `/home/developer/workspace/...` | `~/project` أو `/path/to/project` |
+
+---
+
+## 🌐 معايير الروابط النسبية والتصفح النظيف
+
+لضمان عرض التوثيق بشكل سليم على GitHub، وGitLab، وDocsify، وبرامج قراءة الماركداون، تطبق المهارة **القاعدة الإلزامية 7**:
+
+- ❌ **منع المسارات المطلقة لمحطة العمل**: حظر تام لروابط `file:///` أو مسارات محركات الأقراص المحلية (`C:\...` أو `/Users/...`).
+- ✅ **روابط نسبية نظيفة**: جميع الروابط الداخلية للمستندات تعتمد على المسارات النسبية القياسية (مثل `[دليل المعمارية](./guides/architecture.md)`).
+- ✅ **توجيه مستقر ومستمر للقوائم في Docsify**: تكوين `alias: { '/.*/_sidebar.md': '/_sidebar.md' }` مع شرطة مائلة جذرية `/` لمنع اختفاء القائمة الجانبية أو ظهور أخطاء 404 في المسارات المتداخلة.
+- ✅ **صفحات التوثيق العربية داخل المجلد الرئيسي**: حفظ النسخ العربية داخل `/docs` مباشرة (مثل `docs/README.ar.md`) دون الربط بملفات خارجية خارج نطاق `/docs`.
+
+---
+
+## 📁 الهيكل المعياري لمجلد `/docs`
+
+تلتزم جميع المشاريع المدارة بواسطة `tidyfactor-doc` بالهيكل النظيف الخالي من المجلدات الفارغة:
+
+```
+project-root/
+├── README.md                  # نظرة عامة والبدء السريع للمشروع (الجذر)
+└── docs/                      # مجلد التوثيق الموحد
+    ├── README.md              # الصفحة الرئيسية لمركز التوثيق
+    ├── README.ar.md           # النظرة العامة بالعربية
+    ├── index.html             # بوابة Docsify التفاعلية
+    ├── _sidebar.md            # شجرة التنقل والقائمة الجانبية المولدة آلياً
+    ├── .doc-manifest.json     # ملف تتبع الحالة والمزامنة
+    ├── .collected/            # نتائج الاستقراء والفحص الأولي (ملف وسيط)
+    │   ├── core.md
+    │   └── auth-module.md
+    ├── api/                   # مواصفات ومراجع واجهات البرمجة (API)
+    │   ├── authentication.md
+    │   └── billing.md
+    └── guides/                # الأدلة الفنية وأدلة المطورين والمستخدمين
+        ├── architecture.md
+        ├── developer-setup.md
+        └── deployment-runbook.md
+```
+
+---
+
+## 🚀 التثبيت والتشغيل السريع
+
+### 1. تثبيت المهارة عبر NPM
+لإضافة مهارة `tidyfactor-doc` إلى مشروعك أو سجل الوكلاء لديك:
+
+```bash
+npx @tidyfactor/cli-doc add-skill
+```
+
+### 2. التوافق الشامل مع وكلاء الذكاء الاصطناعي
+يمكنك استدعاء المهارة في بيئة التطوير المفضلة لديك:
+
+| الوكيل أو المحرر | مثال الاستدعاء |
+|---|---|
+| **Google Antigravity** | `/tidyfactor-doc` أو "وثق هذا المشروع وأنشئ موقع Docsify" |
+| **Claude Code** | `/tidyfactor-doc init` أو "Generate API docs for src/Core" |
+| **Cursor & Windsurf** | `@tidyfactor-doc جهز مجلد التوثيق وافحص مسار الكود` |
+| **Codex CLI** | `tidyfactor-doc generate API reference` |
+
+### 3. المعاينة المحلية الفورية
+لمعاينة موقع Docsify محلياً في المتصفح:
+
+```bash
+# باستخدام خادم PHP المدمج
+php -S localhost:3001 -t docs
+
+# أو باستخدام أداة Docsify CLI أو بايثون
+npx docsify-cli serve docs
+python -m http.server 3001 -d docs
+```
+
+---
+
+## 👨‍💻 المنظمة والتواصل والدعم
+
+- 🌐 **الموقع الرسمي للمنظومة:** [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).

package/README.de.md

@@ -0,0 +1,44 @@
+<div align="center">
+
+# tidyfactor-doc `v1.3.0`
+
+**Codebase Documentation Builder & Dual-Engine Publishing Platform (MkDocs & Docsify) für KI-Coding-Agenten**
+
+[![npm version](https://img.shields.io/npm/v/@tidyfactor/doc.svg?style=for-the-badge&color=0284C7)](https://www.npmjs.com/package/@tidyfactor/doc)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg?style=for-the-badge)](LICENSE)
+
+[ 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)
+
+</div>
+
+---
+
+## ⚡ Schnellstart (Quickstart)
+
+```bash
+# Installation & Direktaufruf via NPX
+npx @tidyfactor/cli-doc
+```
+
+Oder direkt in Ihrem KI-Assistenten aufrufen (*Google Antigravity, Claude Code, Cursor, Codex*):
+```text
+/tidyfactor-doc
+```
+
+---
+
+## 📋 Befehls- & Workflow-Matrix
+
+| Befehl | Ziel & Ergebnis | Workflow-Referenz |
+|---|---|---|
+| `/init` | Inicialización de estructura de documentación | `workflows/init.md` |
+| `/collect` | Entrevista y análisis de código fuente | `workflows/collect.md` |
+| `/generate` | Generación de especificaciones API y READMEs | `workflows/generate.md` |
+| `/mkdocs` | Compilación de portal estático MkDocs Material | `workflows/mkdocs.md` |
+| `/docsify` | Despliegue de SPA ligera Docsify sin compilación | `workflows/docsify.md` |
+
+---
+
+## 📖 Vollständige Technische Dokumentation
+
+Ausführliche Spezifikationen, Architekturguides und Tools finden Sie im [Offiziellen Technischen README auf Englisch (README.md)](README.md).

package/README.es.md

@@ -0,0 +1,44 @@
+<div align="center">
+
+# tidyfactor-doc `v1.3.0`
+
+**Constructor de Documentación de Código y Motor de Publicación Dual (MkDocs & Docsify) para Agentes de IA**
+
+[![npm version](https://img.shields.io/npm/v/@tidyfactor/doc.svg?style=for-the-badge&color=0284C7)](https://www.npmjs.com/package/@tidyfactor/doc)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg?style=for-the-badge)](LICENSE)
+
+[ 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)
+
+</div>
+
+---
+
+## ⚡ Inicio Rápido (Quickstart)
+
+```bash
+# Instalación e invocación vía NPX
+npx @tidyfactor/cli-doc
+```
+
+O invócalo directamente dentro de tu asistente de IA (*Google Antigravity, Claude Code, Cursor, Codex*):
+```text
+/tidyfactor-doc
+```
+
+---
+
+## 📋 Matriz de Comandos Principales
+
+| Comando | Objetivo y Resultado | Flujo de Trabajo |
+|---|---|---|
+| `/init` | Inicialización de estructura de documentación | `workflows/init.md` |
+| `/collect` | Entrevista y análisis de código fuente | `workflows/collect.md` |
+| `/generate` | Generación de especificaciones API y READMEs | `workflows/generate.md` |
+| `/mkdocs` | Compilación de portal estático MkDocs Material | `workflows/mkdocs.md` |
+| `/docsify` | Despliegue de SPA ligera Docsify sin compilación | `workflows/docsify.md` |
+
+---
+
+## 📖 Especificación Técnica Completa
+
+Para la arquitectura profunda, esquemas JSON y documentación de herramientas nativas, consulta el [README Técnico en Inglés (README.md)](README.md).

package/README.fa.md

@@ -0,0 +1,44 @@
+<div align="center" dir="rtl">
+
+# tidyfactor-doc `v1.3.0`
+
+**موتور ساخت مستندات کد و انتشار دوگانه پورتال‌های مستندات (MkDocs و Docsify) برای ایجنت‌های هوش مصنوعی**
+
+[![npm version](https://img.shields.io/npm/v/@tidyfactor/doc.svg?style=for-the-badge&color=0284C7)](https://www.npmjs.com/package/@tidyfactor/doc)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg?style=for-the-badge)](LICENSE)
+
+[ 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)
+
+</div>
+
+---
+
+## ⚡ راه‌اندازی سریع (Quickstart)
+
+```bash
+# نصب و اجرای مستقیم از طریق NPX
+npx @tidyfactor/cli-doc
+```
+
+یا فراخوانی مستقیم در دستیار برنامه‌نویسی (*Google Antigravity, Claude Code, Cursor, Codex*):
+```text
+/tidyfactor-doc
+```
+
+---
+
+## 📋 ماتریس دستورات اصلی
+
+| دستور | هدف و نتیجه | جریان کاری (Workflow) |
+|---|---|---|
+| `/init` | Inicialización de estructura de documentación | `workflows/init.md` |
+| `/collect` | Entrevista y análisis de código fuente | `workflows/collect.md` |
+| `/generate` | Generación de especificaciones API y READMEs | `workflows/generate.md` |
+| `/mkdocs` | Compilación de portal estático MkDocs Material | `workflows/mkdocs.md` |
+| `/docsify` | Despliegue de SPA ligera Docsify sin compilación | `workflows/docsify.md` |
+
+---
+
+## 📖 مستندات فنی کامل و رسمی
+
+برای دسترسی به اسکیماهای معماری، الگوهای کامل طراحی و ابزارهای بومی، به [مستندات فنی کامل به زبان انگلیسی (README.md)](README.md) مراجعه نمایید.

package/README.fr.md

@@ -0,0 +1,44 @@
+<div align="center">
+
+# tidyfactor-doc `v1.3.0`
+
+**Générateur de Documentation de Codebase et Plateforme de Publication Double (MkDocs & Docsify) pour Agents d'IA**
+
+[![npm version](https://img.shields.io/npm/v/@tidyfactor/doc.svg?style=for-the-badge&color=0284C7)](https://www.npmjs.com/package/@tidyfactor/doc)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg?style=for-the-badge)](LICENSE)
+
+[ 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)
+
+</div>
+
+---
+
+## ⚡ Démarrage Rapide (Quickstart)
+
+```bash
+# Installation et exécution via NPX
+npx @tidyfactor/cli-doc
+```
+
+Ou appelez-le directement depuis votre assistant IA (*Google Antigravity, Claude Code, Cursor, Codex*) :
+```text
+/tidyfactor-doc
+```
+
+---
+
+## 📋 Matrice des Commandes Principales
+
+| Commande | Objectif & Résultat | Référence de Workflow |
+|---|---|---|
+| `/init` | Inicialización de estructura de documentación | `workflows/init.md` |
+| `/collect` | Entrevista y análisis de código fuente | `workflows/collect.md` |
+| `/generate` | Generación de especificaciones API y READMEs | `workflows/generate.md` |
+| `/mkdocs` | Compilación de portal estático MkDocs Material | `workflows/mkdocs.md` |
+| `/docsify` | Despliegue de SPA ligera Docsify sin compilación | `workflows/docsify.md` |
+
+---
+
+## 📖 Documentation Technique Complète
+
+Pour consulter l'architecture approfondie et les spécifications complètes, veuillez vous référer au [README Technique Officiel en Anglais (README.md)](README.md).