best-practice
Best Practice — Cross-Cutting Quality Enforcement
Concept of the skill
Portable final-pass quality enforcement across code, templates, skills, prompts, scripts, documentation, pages, and design. This is the enforcement layer that catches violations any single specialist might miss — the net for issues that fall between specialist boundaries, where no one domain owner is watching.
The mental model is a cross-domain gate with three jobs:
- Verify the artifact against public, current standards and local project evidence.
- Catch high-severity boundary failures quickly.
- Route deep questions to the specialist skill instead of pretending the breadth pass is enough.
Coverage
Code quality (SOLID, strict TypeScript, DRY/KISS, pure functions, immutability), documentation (ADRs, self-documenting names, TSDoc/OpenAPI), security (OWASP Top 10:2025, secret management, input validation, software-supply-chain integrity, CSP), accessibility (WCAG 2.2, semantic HTML, keyboard operability, focus-not-obscured, target size, accessible authentication), performance (Core Web Vitals, main-thread yielding, code splitting, image optimization, React Compiler memoization model), design systems (token hierarchy, dark mode, composable APIs, DTCG interchange), testing (pyramid shape, behavior-not-implementation, coverage guardrails, no tautological tests), DevOps (trunk-based development, progressive delivery, pipeline-as-code, least-privilege CI), AI/LLM skill design (RCCF structure, eval methodology, structured outputs, instruction/data boundary, scope boundaries), Next.js App Router patterns (Server Components default, Server Action security, explicit opt-in caching, server-only data boundaries), UX & UI composition (F-pattern for data surfaces, one L1 focal point per zone, density-first spacing), visual hierarchy (surface layering, card/banner depth, information density vs whitespace), typographic hierarchy (6-level heading contract, Minor Third scale, 4 canonical weights, h6 micro-labels), and color hierarchy (greyscale chrome, status/semantic color reserved for meaning, triple encoding for colorblind safety).
Authority: Cross-domain quality gate. Does not override specialist skills — catches violations that fall between specialist boundaries. Use specialist skills for depth. Scope: "Small focused changes" means scope discipline, NOT code reduction.