Skip to main content

Standards System

25 standards across Core and Reference categories — quality gates, coding conventions, security, and project management.

Core

7

Reference

18

Accessibility standard

Reference

WCAG 2.1 AA for all UI work. Semantic HTML first, ARIA only when needed. Keyboard-navigate everything. Test with axe-core + real screen reader.

v1.0.0

Activity logging standards

Reference

Structured JSON activity log for audit trails. Schema, fields, and weekly retrospective process.

v1.2.0

AGENTS.md — [Project Name]

Reference

AGENTS.md template for child projects. Copy, customize, and maintain as the AI agent instruction file.

v1.0.0

Coding Conventions

Reference

TypeScript, React, and file naming conventions. No any, no console.log, Zod at edges.

v1.0.0

Document formatting

Reference

How to write and format standards documents. Covers structure, style, visual hierarchy, spacing, callouts, diagrams, and cross-references.

v1.1.0

Engineering Principles

Reference

Decision framework and anti-patterns. Simplicity over cleverness, composition over inheritance.

v1.0.0

Environments

Reference

Development, preview, and production environment configuration. Vercel + Supabase branching model.

v1.0.0

Layout patterns

Reference

Admin shell layout standards. Sidebar, breadcrumbs, content width constraints, responsive behavior.

v1.0.0

Linear formatting

Reference

Linear issue description and comment formatting for consistency and scannability.

v1.0.0

New project setup checklist

Reference

Step-by-step checklist for new project setup. Repo, deps, env, CI, standards inheritance.

v1.0.0

Organizational chart: agent routing reference

Reference

Agent routing reference. 9 agents across 3 model tiers with domain-to-agent mapping.

v3.0.0

Project management

Reference

Work tracking, prioritization, and completion workflow. Linear-centric project management.

v1.0.0

shadcn/ui component maintenance

Reference

shadcn/ui component inventory and sync process. 32 pre-installed components, update workflow.

v1.0.0

Shadcnblocks Premium

Reference

Shadcnblocks Premium-first policy. Use premium blocks before custom components. No exceptions without approval.

v1.0.0

Standards inheritance

Reference

How child projects consume framework standards via symlinks and plugin inheritance.

v1.0.0

Tech Stack

Reference

Locked technology choices. Next.js, TypeScript, Tailwind, shadcn/ui, Supabase, Vercel, pnpm.

v1.0.0

Theme system standard

Reference

43 oklch color themes via tweakcn. Theme switching, CSS variable architecture, dark mode.

v1.0.0

Workstation setup

Reference

Developer machine setup for macOS. Homebrew, Node, pnpm, Git, editor config.

v1.1.0

Search Framework Explorer

Search agents, skills, and standards