cli-architecturelisted

The single source of truth for what "production-grade" means for every CLI this plugin generates, in any of the 12 supported languages. Load this doctrine BEFORE any paradigm skill (cli-scaffold-compiled, cli-scaffold-interpreted, cli-scaffold-shell) generates a scaffold. Defines the five-pillar architecture, the frozen 0/1/2 exit-code contract, and the discoverability, composability, stability, and distribution requirements that the cli-scaffold-verifier checks. Never duplicate this doctrine into paradigm skills — reference it.
Anselmoo/werkstoff · ★ 1 · AI & Automation · score 67

Install: claude install-skill Anselmoo/werkstoff

# CLI Architecture Doctrine This is the **only** place the plugin defines "production-grade." Every paradigm skill loads this before generating anything, and the `cli-scaffold-verifier` agent checks generated scaffolds against it. Paradigm skills and per-language reference files **reference** these rules; they never restate them. (The repo self-check `scripts/check_doctrine_isolation.py` fails the build if a paradigm skill duplicates the contract or re-enumerates the pillars.) The numeric bounds and enumerations below are mirrored in `scripts/constants.py`, which asserts them at import time. That module — not this prose — is the enforcement. This document explains the intent; the scripts refuse violations. ## The Five Pillars Every generated CLI, regardless of language, must satisfy all five. The `cli-scaffold-verifier` maps each finding back to one pillar. 1. **UX / discoverability.** `--help` prints a structured help block, and the CLI ships shell completions through a first-party mechanism where one exists. 2. **Backend / core separation.** Business logic lives in a core module/library with **zero** CLI-framework imports; the entry point is a thin wrapper. 3. **Stability.** A frozen exit-code contract, NO_COLOR support, fail-fast non-interactive behavior, and a snapshot-tested `--help`. 4. **Idiomatic distribution.** Real packaging metadata for the one idiomatic distribution channel of that ecosystem — never a "zip the files" fallback. 5. **Unix composabil