┌ pillar /code-quality13 rules · 20 skills ┐

Pillar · code-quality

Code quality.

Clean code, surgical edits, component boundaries. Below: every rule the AI cites and every skill that fires inside this pillar — versioned, dated, cross-referenced.

13 rules 20 skills

01/05auto-trigger

Path-scoped. Loaded only when relevant.

Open a matching file → the right rules attach. Zero token cost the rest of the time.

Clean Code

Project Core

Execution Discipline

Quality Tooling

Frontend Accessibility

Frontend Performance

02/05how it works

What this pillar does for you.

Component boundaries enforced

When a file approaches 1500 lines, the AI proposes an extraction plan before adding more.

Domain-driven folder layout

New files land where they belong. No tangled spaghetti, no "utils.ts grew to 4000 lines".

Surgical edits only

Working code is left alone. Edits are scoped to the smallest blast radius - no rewrites disguised as refactors.

03/05rules in this pillar

13 rules.

Each rule is a markdown file the AI loads when it edits a matching path. Click any to see related skills and where it's referenced.

Code qualityruleClean Coderules/common/clean-code.md

Language-agnostic baseline: KISS/DRY/YAGNI, immutability, naming, ~200-400 line files, single-responsibility functions. Stack rules layer on top.

Code qualityruleProject Corerules/core.md

TypeScript strict baseline, monorepo layout, zod-at-the-boundary, Gitflow. The framework-agnostic floor every other rule sits on.

Code qualityruleExecution Disciplinerules/common/execution-discipline.md

Behavioral rules that block silent assumptions, speculative architecture, unrelated edits, and invisible failure - think before coding, simplest first, surgical changes.

Code qualityruleQuality Toolingrules/common/quality-tooling.md

Required root scripts (format, lint, typecheck, test, build), repo-owned tooling only, lint-staged + Husky pre-commit gates - deterministic and hard to bypass.

Code qualityruleFrontend Accessibilityrules/frontend/accessibility.md

WCAG 2.2 AA floor: semantic HTML, localized labels, keyboard reachability, visible focus, real-time region usage. EU Accessibility Act treated as launch risk.

Code qualityruleFrontend Performancerules/frontend/performance.md

Lighthouse mobile >=90 against production preview, Web Vitals budgets (LCP<=2.5s, INP<=200ms, CLS<=0.1), web-vitals wired to observability, regressions alerted per route.

Code qualityruleTypographyrules/frontend/typography.md

Curly quotes, em/en dashes, ellipsis, multiplication signs - the punctuation LLMs get wrong. Applied silently across every UI artifact.

Code qualityruleUI Qualityrules/frontend/ui-quality.md

Central design gate before any UI change: purpose, primary action, 2-3 competitor references, state coverage, material honesty. No generic template-looking output.

Code qualityruleReact Performancerules/frontend/react/performance.md

Every page React.lazy + Suspense, dynamic-import heavy libs at usage site, narrow selectors, virtualize lists >100, derive expensive work in selectors not render.

Code qualityruleIonic Accessibilityrules/frontend/ionic/accessibility.md

44x44 touch targets, WebView-visible focus, Android-back closes topmost layer, prefers-reduced-motion respected, icon-only buttons have translated labels.

Code qualityruleIonic Performancerules/frontend/ionic/performance.md

Lighthouse mobile still required against production preview, lazy-load page code and heavy plugins, real device smoke check before release, batch high-rate updates with rAF.

Code qualityruleReact Native Accessibilityrules/frontend/react-native/accessibility.md

VoiceOver/TalkBack for critical journeys, accessibilityRole/Label/state, 44pt touch targets with hitSlop, dynamic type respected, focus managed after modals/redirects.

Code qualityruleReact Native Performancerules/frontend/react-native/performance.md

Hermes + New Architecture default, FlatList/SectionList with stable keys, flash-list only after measuring, lazy-load heavy modules at route boundaries, batch real-time at 30fps.

04/05skills in this pillar

20 skills.

Skills are intent-triggered workflows. The AI router loads them by description; bodies on demand.

Code qualityskillAccessibility (WCAG 2.2)skills/accessibility

WCAG 2.2 Level AA implementation and audit. Maps component intent to semantic ARIA on web and accessibility traits on iOS/Android - focus order, target size, labels, hints.

Code qualityskillCoding Standardsskills/coding-standards

Baseline cross-project coding conventions for naming, readability, immutability, and code-quality review - framework-agnostic floor below the language skills.

Code qualityskillC++ Coding Standardsskills/cpp-coding-standards

C++ Core Guidelines-based standards for modern, safe, idiomatic C++ when writing, reviewing, or refactoring.

Code qualityskillCreate Componentskills/create-component

Scaffold a typed React component with shadcn primitives, i18n keys, explicit loading/error/empty states, and tests - only after onboarding is resolved.

Code qualityskillCreate Featureskills/create-feature

Scaffold a full React feature slice (pages, services, slices, hooks, tests) following the forced stack and folder layout.

Code qualityskillCreate Native Componentskills/create-native-component

Scaffold a typed RN component with NativeWind, RNR primitives, accessibility, and tests baked in - only after onboarding is resolved.

Code qualityskillCreate Native Featureskills/create-native-feature

Full RN feature scaffold (screens, navigation, slices, RTK Query, types, tests) on the forced Expo + Expo Router stack.

Code qualityskillCreate Native Screenskills/create-native-screen

Scaffold an Expo Router route/screen with typed params, safe-area boundaries, loading/error/empty states, and auth-gated layout when relevant.

Code qualityskillCreate Native Serviceskills/create-native-service

Scaffold an RN service or RTK Query endpoint with zod validation, expo-secure-store token handling, and typed AppError mapping.

Code qualityskillCreate Pageskills/create-page

Scaffold a React route/page with lazy loading, SEO metadata, i18n keys, and a typed feature shell.

Code qualityskillCreate Serviceskills/create-service

Scaffold an RTK Query endpoint or plain axios service with zod-parsed responses, typed AppError, and shared api-client wiring.

Code qualityskillDesign Auditskills/design-audit

Structured visual UI/UX audit that produces a phased, implementation-ready plan and waits for approval before touching code. Purely visual - never edits logic or state.

Code qualityskillDesign Systemskills/design-system

Generate or audit a design system, check visual consistency, and review PRs that touch styling.

Code qualityskillExecution Disciplineskills/execution-discipline

Surgical edits, simpler implementation, no overengineering, explicit assumptions, success criteria, fail-loud checkpoints, cost-aware reasoning/model routing.

Code qualityskillFrontend Designskills/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality when visual direction matters as much as code quality - only after onboarding is resolved.

Code qualityskilli18n Textskills/i18n-text

Audit and rewrite user-facing copy in React/RN to use translation keys. Extends the existing i18n module, never creates a parallel one. <Trans> for rich copy, t() for scalars.

Code qualityskillJava Coding Standardsskills/java-coding-standards

Java standards for Spring Boot services: naming, immutability, Optional usage, streams, exceptions, generics, and project layout.

Code qualityskillRefactorskills/refactor

Refactor existing React code with surgical edits. Splits fat components along clean seams, keeps imports/tests green, never rewrites working code.

Code qualityskillSEOskills/seo

Audit, plan, and implement SEO across technical SEO, on-page optimization, structured data, Core Web Vitals, and content strategy.

Code qualityskillUI Demoskills/ui-demo

Record polished UI demo videos using Playwright - WebM with visible cursor, natural pacing, and professional feel for tutorials and product walkthroughs.

05/05related pillars