ensure-canonical

Plans multi-layer enforcement pipelines for design system rules from trigger phrases.

5|9|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/ajenchen/design-system --skill ensure-canonical-ajenchen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ensure-canonical
Source: https://github.com/ajenchen/design-system/tree/main/.agents/skills/ensure-canonical
Command: npx skills add https://github.com/ajenchen/design-system --skill ensure-canonical-ajenchen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a user states that a rule must always be enforced (e.g., "ensure X always happens", "never bypass Y"), teams often rely on repeated manual corrections or AI self-discipline, which leads to silent drift. This Skill converts such trigger phrases into a structured defense-in-depth plan with at least three concrete enforcement layers. ## Core Features & Use Cases - Trigger Phrase Recognition: Automatically activates on phrases like "ensure", "always", "never bypass", or their Chinese equivalents (確保, 不可繞過, 永不漂移), or via manual invocation with /ensure-canonical. - 8-Phase Enforcement Pipeline: Parses the rule, benchmarks against 3+ world-class design systems (Polaris, Material, Carbon, Backstage), identifies the single source of truth, checks downstream redundancy, and plans 5+1 enforcement layers (canonical rule, hook, hook test, skill workflow, audit dimension, verification). - Authority Classification: Distinguishes engineering-auto decisions from product/UI/UX decisions requiring human input, with self-improvement capture feeding new trigger patterns back into the Skill. - Use Case: A user says "ensure story splitting always merges start and end icons into one story." The Skill benchmarks the rule, places it in the canonical rules directory, writes a blocking hook with 8 test scenarios, adds an audit dimension, and verifies with tsc and build checks. ## Quick Start Tell the AI "ensure all icon buttons always use the WithIcon pattern and never split into two stories" to trigger the full enforcement planning pipeline.

Frequently Asked Questions about ensure-canonical

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce a design system rule so it never gets bypassed?

State the rule with a trigger phrase like "ensure X always" or invoke /ensure-canonical. The Skill plans at least three enforcement layers such as a canonical rule entry, a blocking hook with tests, and an audit dimension, then executes and verifies each layer.

What trigger phrases activate the ensure-canonical workflow?

It activates on English phrases like "ensure", "always", "must", "never bypass", and "no silent", plus Chinese equivalents such as 確保, 一定要, 不可繞過, and 永不漂移. You can also invoke it manually with /ensure-canonical followed by a rule description.

When should I not use this enforcement pipeline?

Skip it for pure information requests, one-off ad-hoc bug fixes, and rules already codified that only need batch verification through the design-system-audit skill. It is designed for new rules requiring multi-layer enforcement, not single-file refactors.

How does the skill decide which enforcement layers to add?

Mechanically checkable high-frequency rules get hooks, multi-step or platform-dependent rules get skill workflows, existing components needing verification get audit dimensions, and every rule gets a canonical source-of-truth entry. Layers without user-reported pain are skipped to avoid vanity work.

Does the pipeline stop for human approval before executing?

Only when the plan exposes genuine product, UI, or UX trade-offs or platform-level actions like credentials and paid accounts. Pure engineering and governance changes proceed automatically with evidence, review, and rollback bindings.