{"_id":"@alwkala/tidyfactor-skill-architect","_rev":"6-6a548f39c9743c827471440e5bb5cf61","name":"@alwkala/tidyfactor-skill-architect","dist-tags":{"latest":"2.1.0"},"versions":{"1.1.0":{"name":"@alwkala/tidyfactor-skill-architect","version":"1.1.0","keywords":["tidyfactor","skill-architect","governance","ai-agents","antigravity","claude-code","cursor","codex","skill-methodology"],"author":{"url":"https://alwkala.com","name":"TidyFactor & Alwkala","email":"hello@tidyfactor.com"},"license":"Apache-2.0","_id":"@alwkala/tidyfactor-skill-architect@1.1.0","maintainers":[{"name":"alwkala","email":"development@alwkala.com"}],"homepage":"https://github.com/TidyFactor/Skill-Architect#readme","bugs":{"url":"https://github.com/TidyFactor/Skill-Architect/issues"},"bin":{"add-architect-skill":"bin/add-skill.js","tidyfactor-skill-architect":"bin/add-skill.js"},"dist":{"shasum":"01c12e519607773bb584d98e01f7ae9704cd1596","tarball":"https://registry.npmjs.org/@alwkala/tidyfactor-skill-architect/-/tidyfactor-skill-architect-1.1.0.tgz","fileCount":23,"integrity":"sha512-GrFCQCWa2C2eCVWwbwRo93ZRobPSBBHO/xWOMetukyOIiISAIYUwY+6yOeEa4YQLL8L+7GkOl6thuSa4BLej5Q==","signatures":[{"sig":"MEUCIFJnTyz8GAxdEclkPyxjNt2GsKDBEUy8ku/yXZKZTgVXAiEAxkGKlx/OiecXhHQq/kuux1LcBBjLLwXB3TTzF4hDZAk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":39754},"main":"bin/add-skill.js","gitHead":"efe622c37cc34d5ca8e21c3dc200c5202b55940a","scripts":{"build":"node tools/build-skill.js","validate":"python tools/validate_skill.py"},"_npmUser":{"name":"alwkala","email":"development@alwkala.com"},"repository":{"url":"git+https://github.com/TidyFactor/Skill-Architect.git","type":"git"},"_npmVersion":"11.6.2","description":"TidyFactor Skill Architect — Governance Layer & Methodology Engine for AI Coding Agent Skills","directories":{},"_nodeVersion":"24.11.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/tidyfactor-skill-architect_1.1.0_1787436005989_0.7875444115228167","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@alwkala/tidyfactor-skill-architect","version":"1.1.1","keywords":["tidyfactor","skill-architect","governance","ai-agents","antigravity","claude-code","cursor","codex","skill-methodology"],"author":{"url":"https://alwkala.com","name":"TidyFactor & Alwkala","email":"hello@tidyfactor.com"},"license":"Apache-2.0","_id":"@alwkala/tidyfactor-skill-architect@1.1.1","maintainers":[{"name":"alwkala","email":"development@alwkala.com"}],"homepage":"https://github.com/TidyFactor/Skill-Architect#readme","bugs":{"url":"https://github.com/TidyFactor/Skill-Architect/issues"},"bin":{"add-skill":"bin/add-skill.js","add-architect-skill":"bin/add-skill.js","tidyfactor-skill-architect":"bin/add-skill.js"},"dist":{"shasum":"acc0ab3369cdf6f29588ded9eb8b6b8009f3385b","tarball":"https://registry.npmjs.org/@alwkala/tidyfactor-skill-architect/-/tidyfactor-skill-architect-1.1.1.tgz","fileCount":24,"integrity":"sha512-AuLFM+tGDUOA5bwVTxlgfCNDF9Uvfl4785l/quKlp3YlvbWgc+J7GBUeufvrW8+SWny9cDL0qJXSJFnEe62W1w==","signatures":[{"sig":"MEYCIQDTAvP62dtGS4GItc1SXKgYJ9d0e1jK50PSYxGVPbo/6wIhAPBVBxu/x+wsR9X3whSwcJF/PHMJFnBDMxpNLfeWzYRv","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":49322},"main":"SKILL.md","gitHead":"592a3db13de65c90a2381a76df2027f3a890ecbc","scripts":{"build":"node tools/build-skill.js","release":"python ../tools/release_skill.py .","validate":"python tools/validate_skill.py"},"_npmUser":{"name":"alwkala","email":"development@alwkala.com"},"repository":{"url":"git+https://github.com/TidyFactor/Skill-Architect.git","type":"git"},"_npmVersion":"11.6.2","description":"TidyFactor Skill Architect — Governance Layer & Methodology Engine for AI Coding Agent Skills","directories":{},"_nodeVersion":"24.11.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/tidyfactor-skill-architect_1.1.1_1787625785887_0.6776273211951696","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@alwkala/tidyfactor-skill-architect","version":"2.0.0","keywords":["tidyfactor","skill-architect","governance","ai-agents","antigravity","claude-code","cursor","codex","skill-methodology"],"author":{"url":"https://alwkala.com","name":"TidyFactor & Alwkala","email":"hello@tidyfactor.com"},"license":"Apache-2.0","_id":"@alwkala/tidyfactor-skill-architect@2.0.0","maintainers":[{"name":"alwkala","email":"development@alwkala.com"}],"homepage":"https://github.com/TidyFactor/Skill-Architect#readme","bugs":{"url":"https://github.com/TidyFactor/Skill-Architect/issues"},"bin":{"add-skill":"bin/add-skill.js","add-architect-skill":"bin/add-skill.js","tidyfactor-skill-architect":"bin/add-skill.js"},"dist":{"shasum":"b0698b3b550697b96396529af9528b394fa01704","tarball":"https://registry.npmjs.org/@alwkala/tidyfactor-skill-architect/-/tidyfactor-skill-architect-2.0.0.tgz","fileCount":27,"integrity":"sha512-Ws8EZC8PQ2iLc+JauYuW/OtdqUzHgh3dthCWinQbdDX6hoFB8n5KHbPT+diNgVjsoukp1JdFXMaTaSWcpFrqaA==","signatures":[{"sig":"MEQCIGZt+aYDDfKnycScB56nd0y+YGCFZJj6mjoK2sq/OgI7AiBbPM6sRCLBoP/tKvAj0Su3HBknkUiO2rHn7x3cooCLMw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":65541},"main":"SKILL.md","gitHead":"8d9253c9f16d071079fa33cf7d8d5953e1ff6768","scripts":{"build":"node tools/build-skill.js","release":"python ../tools/release_skill.py .","validate":"python tools/validate_skill.py"},"_npmUser":{"name":"alwkala","email":"development@alwkala.com"},"repository":{"url":"git+https://github.com/TidyFactor/Skill-Architect.git","type":"git"},"_npmVersion":"11.6.2","description":"TidyFactor Skill Architect — Governance Layer & Methodology Engine for AI Coding Agent Skills","directories":{},"_nodeVersion":"24.11.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/tidyfactor-skill-architect_2.0.0_1787630007453_0.37375278322992345","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"@alwkala/tidyfactor-skill-architect","version":"2.0.1","keywords":["tidyfactor","skill-architect","governance","ai-agents","antigravity","claude-code","cursor","codex","skill-methodology"],"author":{"url":"https://alwkala.com","name":"TidyFactor & Alwkala","email":"hello@tidyfactor.com"},"license":"Apache-2.0","_id":"@alwkala/tidyfactor-skill-architect@2.0.1","maintainers":[{"name":"alwkala","email":"development@alwkala.com"}],"homepage":"https://github.com/TidyFactor/Skill-Architect#readme","bugs":{"url":"https://github.com/TidyFactor/Skill-Architect/issues"},"bin":{"add-skill":"bin/add-skill.js","add-architect-skill":"bin/add-skill.js","tidyfactor-skill-architect":"bin/add-skill.js"},"dist":{"shasum":"0f4b0ec42e96282c1d999aed4bf991c70129df34","tarball":"https://registry.npmjs.org/@alwkala/tidyfactor-skill-architect/-/tidyfactor-skill-architect-2.0.1.tgz","fileCount":27,"integrity":"sha512-udctpo3Gd/KCIEwg6TiUHlXK1iaSw8aa8WpgtycrAMC0YYTEm4ZVFuQi12AC0DjXn4mvJ0CZHXSt0+RNR1FutQ==","signatures":[{"sig":"MEUCIBRTAbIYCOZatGcKaxg0eqJ1MRvncWD/hfMdgndjD15sAiEAigBgjkoqSNspukn4ONROABNhV3hl4UwMjZ3nOyYqVNM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":69829},"main":"SKILL.md","gitHead":"2938b211d6aac1b91ea8f76a93acf40834a6bb47","scripts":{"build":"node tools/build-skill.js","release":"python ../tools/release_skill.py .","validate":"python tools/validate_skill.py"},"_npmUser":{"name":"alwkala","email":"development@alwkala.com"},"repository":{"url":"git+https://github.com/TidyFactor/Skill-Architect.git","type":"git"},"_npmVersion":"11.6.2","description":"TidyFactor Skill Architect — Governance Layer & Methodology Engine for AI Coding Agent Skills","directories":{},"_nodeVersion":"24.11.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/tidyfactor-skill-architect_2.0.1_1787630707793_0.2369744268242493","host":"s3://npm-registry-packages-npm-production"}},"2.0.2":{"name":"@alwkala/tidyfactor-skill-architect","version":"2.0.2","keywords":["tidyfactor","skill-architect","governance","ai-agents","antigravity","claude-code","cursor","codex","skill-methodology"],"author":{"url":"https://alwkala.com","name":"TidyFactor & Alwkala","email":"hello@tidyfactor.com"},"license":"Apache-2.0","_id":"@alwkala/tidyfactor-skill-architect@2.0.2","maintainers":[{"name":"alwkala","email":"development@alwkala.com"}],"homepage":"https://github.com/TidyFactor/Skill-Architect#readme","bugs":{"url":"https://github.com/TidyFactor/Skill-Architect/issues"},"bin":{"add-skill":"bin/add-skill.js","add-architect-skill":"bin/add-skill.js","tidyfactor-skill-architect":"bin/add-skill.js"},"dist":{"shasum":"67d9e34d4bfa6bf8b6520adc309796529419ee05","tarball":"https://registry.npmjs.org/@alwkala/tidyfactor-skill-architect/-/tidyfactor-skill-architect-2.0.2.tgz","fileCount":27,"integrity":"sha512-QrWHWzLqhB787/xbymLiTjo8rzCK+QawHiR2+xX/RKS1/+5H9gnn/4jGMsQXKEElB+eJWZQVA3goapDNEMbWhA==","signatures":[{"sig":"MEQCID0Y5HFylfpNUSVjW0/34ktDFaa2T+ExsVMWIdl6x0s2AiALlqBlHOi9Z5867y+2g/BLmogJAxIsaMzFPN832s3SHQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":94939},"main":"SKILL.md","gitHead":"2938b211d6aac1b91ea8f76a93acf40834a6bb47","scripts":{"build":"node tools/build-skill.js","release":"python ../tools/release_skill.py .","validate":"python tools/validate_skill.py"},"_npmUser":{"name":"alwkala","email":"development@alwkala.com"},"repository":{"url":"git+https://github.com/TidyFactor/Skill-Architect.git","type":"git"},"_npmVersion":"11.6.2","description":"TidyFactor Skill Architect — Governance Layer & Methodology Engine for AI Coding Agent Skills","directories":{},"_nodeVersion":"24.11.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/tidyfactor-skill-architect_2.0.2_1787632553479_0.26283349433304015","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"@alwkala/tidyfactor-skill-architect","version":"2.1.0","description":"TidyFactor Skill Architect — Governance Layer & Methodology Engine for AI Coding Agent Skills","main":"SKILL.md","bin":{"tidyfactor-skill-architect":"bin/add-skill.js","add-skill":"bin/add-skill.js","add-architect-skill":"bin/add-skill.js"},"scripts":{"validate":"python tools/validate_skill.py","build":"node tools/build-skill.js","release":"python ../tools/release_skill.py ."},"keywords":["tidyfactor","skill-architect","governance","ai-agents","antigravity","claude-code","cursor","codex","skill-methodology"],"author":{"name":"TidyFactor & Alwkala","email":"hello@tidyfactor.com","url":"https://alwkala.com"},"license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/TidyFactor/Skill-Architect.git"},"publishConfig":{"access":"public"},"gitHead":"d38ebf096ab1210afc3420d5ada8dbaeb0630603","_id":"@alwkala/tidyfactor-skill-architect@2.1.0","bugs":{"url":"https://github.com/TidyFactor/Skill-Architect/issues"},"homepage":"https://github.com/TidyFactor/Skill-Architect#readme","_nodeVersion":"24.11.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-o5f0UGM0PNhjrvmolsb2e7iwvOnrm23/Io+knmYDSiSSldsl18+suvIdIFq/dZL8ySTyTNNIDy1Q3UZpOsBf0g==","shasum":"9461fb34d75e5970d09700165b11ea3ad40db52e","tarball":"https://registry.npmjs.org/@alwkala/tidyfactor-skill-architect/-/tidyfactor-skill-architect-2.1.0.tgz","fileCount":28,"unpackedSize":99077,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIELOY3m+KppCeLj2tlQbtCeslzNcRsI3SCP5D5fF6/kGAiAsAipVWtCQ+YvIF3FdTdkSeZo7lYGyhYbVlLYGYqdoxQ=="}]},"_npmUser":{"name":"alwkala","email":"development@alwkala.com"},"directories":{},"maintainers":[{"name":"alwkala","email":"development@alwkala.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/tidyfactor-skill-architect_2.1.0_1787788607063_0.8985862097257127"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-22T22:00:05.829Z","modified":"2026-08-26T23:56:47.330Z","1.1.0":"2026-08-22T22:00:06.129Z","1.1.1":"2026-08-25T02:43:06.037Z","2.0.0":"2026-08-25T03:53:27.586Z","2.0.1":"2026-08-25T04:05:07.953Z","2.0.2":"2026-08-25T04:35:53.694Z","2.1.0":"2026-08-26T23:56:47.204Z"},"bugs":{"url":"https://github.com/TidyFactor/Skill-Architect/issues"},"author":{"name":"TidyFactor & Alwkala","email":"hello@tidyfactor.com","url":"https://alwkala.com"},"license":"Apache-2.0","homepage":"https://github.com/TidyFactor/Skill-Architect#readme","keywords":["tidyfactor","skill-architect","governance","ai-agents","antigravity","claude-code","cursor","codex","skill-methodology"],"repository":{"type":"git","url":"git+https://github.com/TidyFactor/Skill-Architect.git"},"description":"TidyFactor Skill Architect — Governance Layer & Methodology Engine for AI Coding Agent Skills","maintainers":[{"name":"alwkala","email":"development@alwkala.com"}],"readme":"# 🏛️ TidyFactor Skill Architect `v2.1.0`\n\n> **The Canonical Governance Engine & Architecture Specification for AI Coding Agent Skills.**  \n> Enforces the **12 Structural Rules** of TidyFactor Skills across **Google Antigravity, Claude Code, Cursor, OpenAI Codex, and Windsurf**.\n\n[![Version](https://img.shields.io/badge/version-2.1.0-blue.svg)](CHANGELOG.md)\n[![License](https://img.shields.io/badge/license-Apache--2.0-green.svg)](LICENSE)\n[![Ecosystem](https://img.shields.io/badge/ecosystem-TidyFactor-orange.svg)](https://tidyfactor.com)\n[![Partner](https://img.shields.io/badge/partner-Alwkala-indigo.svg)](https://alwkala.com)\n\n---\n\n## 📖 Table of Contents\n\n- [Overview & Philosophy](#-overview--philosophy)\n- [The Architecture: Progressive Disclosure](#-the-architecture-progressive-disclosure)\n- [The 12 Structural Rules of TidyFactor Skills](#-the-12-structural-rules)\n- [Commands & Operational Workflows](#-commands--operational-workflows)\n- [The Contextual Decision Layer (CDL)](#-the-contextual-decision-layer-cdl)\n- [Tooling & Integrity Validation Suite](#-tooling--integrity-validation-suite)\n- [Cross-Agent Distribution & Synchronization](#-cross-agent-distribution--synchronization)\n- [Installation & Usage](#-installation--usage)\n- [License & Credits](#-license--credits)\n\n---\n\n## 🌟 Overview & Philosophy\n\n**`tidyfactor-skill-architect`** is the foundational governance layer that establishes standard operating procedures for creating, auditing, expanding, and packaging AI Coding Agent Skills.\n\n### The Problem It Solves\nTraditional AI skills often suffer from:\n1. **Context Window Pollution**: Massive, monolithic markdown files that dump thousands of tokens on startup.\n2. **Execution Hallucinations**: Prompt ambiguity where the agent attempts to \"guess\" rather than follow deterministic paths.\n3. **Multi-Agent Drift**: Divergent behaviors across different AI coding environments (Antigravity vs. Claude Code vs. Cursor).\n4. **Syntax & Frontmatter Failures**: Unquoted strings or malformed YAML breaking IDE autocomplete and discovery indexing.\n\n### The TidyFactor Solution\nA skill must behave as a **high-speed deterministic router**, loading only the minimal necessary context at the exact moment it is required.\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                 Session Discovery Layer                     │\n│        SKILL.md Frontmatter (name + description)            │\n└──────────────────────────────┬──────────────────────────────┘\n                               │ (Trigger Matched)\n                               ▼\n┌─────────────────────────────────────────────────────────────┐\n│                 Dispatcher Layer (Router)                   │\n│          SKILL.md (~350 tokens, Anti-triggers, Scope)       │\n└──────────────────────────────┬──────────────────────────────┘\n                               │ (Intent Identified)\n                               ▼\n┌─────────────────────────────────────────────────────────────┐\n│                 Command Layer (Router Link)                 │\n│              references/commands/<command>.md               │\n└──────────────┬───────────────────────────────┬──────────────┘\n               │ (Loads Workflow)              │ (Injects Memory)\n               ▼                               ▼\n┌──────────────────────────────┐ ┌────────────────────────────┐\n│        Workflow Layer        │ │        Memory Layer        │\n│   Ordered Execution Steps    │ │ Pure Technical Constraints │\n│    + Validation Checklist    │ │  Schemas, Patterns, Tables │\n└──────────────────────────────┘ └────────────────────────────┘\n```\n\n---\n\n## 📐 The 12 Structural Rules\n\nEvery skill created, audited, or packaged within the TidyFactor ecosystem strictly adheres to the **12 Structural Rules**:\n\n| # | Rule | Core Mandate | Failure Mode Prevented |\n|---|---|---|---|\n| **1** | **Dispatcher Discipline** | `SKILL.md` is strictly a router (~350 tokens). Zero in-line instructions. | Token bloat & memory exhaustion at session boot. |\n| **2** | **One Workflow = One Outcome** | 1 workflow produces exactly 1 tangible deliverable with a `## Validation checklist`. | Ambiguous multi-tasking and incomplete executions. |\n| **3** | **Operational Memory** | Pure technical facts, schemas, and schemas. Zero marketing narrative. | AI hallucinating promotional text into production code. |\n| **4** | **No Empty Structures** | Clean, flat file hierarchies. No single-file folders (`memory.md` vs `memory/`). | Deep directory nesting and navigation overhead. |\n| **5** | **Philosophy Isolation** | Brand philosophy and rationale live solely in `memory/philosophy.md` (unreferenced). | Agents outputting promotional fluff instead of code. |\n| **6** | **Trigger-Justified Growth** | Files are added strictly upon verifiable triggers (Size, Branch, Variant, CDL). | Premature folder explosion and architecture sprawl. |\n| **7** | **Quality Bar & Native Tooling** | Deterministic operations encapsulated in `tools/` wrapping native tools (`node`, `python`). | Unreliable LLM regex replacements & flaky bash scripts. |\n| **8** | **Cross-Platform Parity & SemVer SSOT** | 100% behavioral parity across all agent platforms; atomic metadata sync. | Agent version drift and silent breaking changes. |\n| **9** | **Platform Compatibility & YAML Invariants** | Valid YAML parsing (`yaml.safe_load()`), `description` ≤ 1024 chars, mandatory double quotes `\"...\"`. | Silent failure in IDE slash (`/`) command autocomplete. |\n| **10** | **Tool Permission Declaration** | Explicit declaration of tool languages, mutation abilities, and network scope in `SKILL.md`. | Security blind spots and unprompted file overwrites. |\n| **11** | **Memory Freshness** | Required `<!-- last-verified: YYYY-MM-DD -->` marker with $\\le 180$ days freshness gate. | Stale API references, deprecated flags, and broken specs. |\n| **12** | **Skill vs MCP Boundary** | Static decision logic lives in skills; dynamic APIs & databases delegate to MCP. | Skill bloat and duplicated live-data implementations. |\n\n---\n\n## ⚡ Commands & Operational Workflows\n\n`tidyfactor-skill-architect` exposes 4 core operational commands:\n\n### 1. `init` — Scaffold a New Skill\n- **Trigger**: `\"Build me a skill for X\"` / `\"Turn this workflow into a TidyFactor skill\"`\n- **Loads**: `references/workflows/create-skill.md` + `references/memory/spec.md` + `references/memory/growth-rule.md` + `assets/skill-md-skeleton.md`\n- **Output**: Fully scaffolded, compliant skill directory with valid YAML frontmatter, dispatcher `SKILL.md`, and initial workflow.\n\n### 2. `audit` — Audit & Score an Existing Skill\n- **Trigger**: `\"Audit this skill\"` / `\"Check if this skill follows TidyFactor rules\"`\n- **Loads**: `references/workflows/audit-skill.md` + `references/memory/spec.md`\n- **Output**: 12-rule compliance scorecard (`Score: X/12`), list of violations, and exact automated file-level remediations.\n\n### 3. `test` — Generate Test Scenarios\n- **Trigger**: `\"Test this skill\"` / `\"Generate test scenarios\"`\n- **Loads**: `references/workflows/test-skill.md` + `references/memory/spec.md`\n- **Output**: Populates `tests/scenarios.md` with $\\ge 3$ distinct evaluation prompts (happy-path, edge-case, anti-trigger rejection).\n\n### 4. `grow` — Evaluate Architecture Growth\n- **Trigger**: `\"Should I add a new file/folder to this skill?\"`\n- **Loads**: `references/memory/growth-rule.md`\n- **Output**: Deterministic decision (`SPLIT`, `EXPAND`, or `REJECT`) based on quantitative line count and lifecycle triggers.\n\n---\n\n## 🧠 The Contextual Decision Layer (CDL)\n\nFor complex skills where execution depends on interdependent architectural choices (e.g. `tidyfactor-styler`, `tidyfactor-next`), the Skill Architect codifies the **CDL Pattern**:\n\n1. **Thin Arbitration Protocol (`memory/decision-points.md`)**: Defines triggers, boolean skip conditions, and pointers to existing SSOT catalogs.\n2. **Pre-flight Brief & Cache (`brief` command / `.tidyfactor/<skill>-brief.md`)**: Gathers decisions once per project, saving them to disk so downstream commands execute silently without asking repetitive questions.\n3. **Single-Round Batching & Safe Defaults**: Unresolved ambiguities are batched into 1 single round (max 3 questions). Any overflow defaults to safe conventions.\n4. **Decision Alignment Axis**: Evaluates generated code against Axis 7 (`D` - Decision Alignment) during pre-emit self-critique.\n\n---\n\n## 🛠️ Tooling & Integrity Validation Suite\n\nThe skill includes a dedicated deterministic verification engine:\n\n```bash\n# Run the 11-point automated integrity validator\npython tools/validate_skill.py\n```\n\n### Automated Validation Matrix\n- `[1]` **SemVer Synchronization**: Verifies `package.json`, `.tidyfactor`, `brand.json`, and `CHANGELOG.md` share identical versions.\n- `[2]` **License Consistency**: Ensures standard Apache-2.0 license file exists.\n- `[3]` **Referenced File Integrity**: Checks that all paths referenced in `SKILL.md` exist on disk.\n- `[4]` **Validation Checklists**: Confirms every workflow file contains a `## Validation checklist`.\n- `[5]` **Leak Prevention**: Audits for leaked local machine absolute paths.\n- `[6]` **Token Budget Gate**: Asserts dispatcher `SKILL.md` is within ~350 token budget (max 500).\n- `[7]` **Memory Freshness Gate**: Enforces `<!-- last-verified: YYYY-MM-DD -->` marker within $\\le 180$ days.\n- `[8]` **Strict YAML Frontmatter Validation**: Executes `yaml.safe_load()` to ensure frontmatter is syntactically valid and `description` is properly quoted and $\\le 1024$ chars.\n- `[9]` **Tooling Scope Declaration**: Verifies Rule 10 declaration when `tools/` exist.\n- `[10]` **Test Scenario Suite**: Asserts `tests/scenarios.md` contains $\\ge 3$ test cases.\n- `[11]` **MCP Boundary**: Checks that skills interacting with MCP document boundary logic.\n\n---\n\n## 🔄 Cross-Agent Distribution & Synchronization\n\nWhen packaging or releasing with `node tools/build-skill.js`, the builder automatically compiles the distribution archive and synchronizes across all 5 target environments:\n\n```\nSkills-LAB/tidyfactor-skill-architect/ (SSOT)\n  ├── 📦 dist/tidyfactor-skill-architect.skill\n  ├── 📦 dist/tidyfactor-skill-architect-vX.Y.Z.skill\n  ├── 🔁 .agents/skills/tidyfactor-skill-architect/ (Local Agent Wrapper)\n  ├── 🔁 ~/.gemini/config/skills/tidyfactor-skill-architect/ (Global Gemini/Antigravity)\n  └── 🔁 /mnt/skills/user/tidyfactor-skill-architect/ (Claude / Unix Environment)\n```\n\n---\n\n## 📦 Installation & Usage\n\n### 1. Via NPM / NPX\n```bash\n# Add directly to your active agent workspace\nnpx @alwkala/tidyfactor-skill-architect\n\n# Or install globally\nnpm install -g @alwkala/tidyfactor-skill-architect\n```\n\n### 2. Manual Agent Registration\nClone or copy into your agent's skill root:\n```bash\n# Google Antigravity & Gemini IDE\ncp -r tidyfactor-skill-architect ~/.gemini/config/skills/\n\n# Local Project Agent Wrapper\ncp -r tidyfactor-skill-architect .agents/skills/\n```\n\n---\n\n## 📄 License & Credits\n\n- **License**: [Apache-2.0](LICENSE)\n- **Engineered by**: [TidyFactor Ecosystem](https://tidyfactor.com) & [Alwkala Digital Agency](https://alwkala.com)\n- **Contact**: `hello@tidyfactor.com` | `+201016656899`\n","readmeFilename":"README.md"}