Skip to content

Dragoon0x/meridian

Repository files navigation

MERIDIAN

Experimental · Built out of curiosity · Educational purposes · DYOR

Map your project's design DNA.

8-axis genome visualization. 62 commands across 5 tiers. Project-aware design intelligence that learns your codebase before making recommendations. The anti-slop operating system for every AI coding tool.

See your DNA →


What is MERIDIAN?

Design skills that don't know your project are useless. They say "use good typography" to a codebase that already has a considered type system. MERIDIAN learns your codebase first, then works within your aesthetic.

/m-scan

This reads your existing code and builds a design profile in .meridian.json. Every subsequent command respects what you've already built. If you chose Instrument Serif, MERIDIAN won't suggest replacing it. If your spacing is on a 4px grid, it maintains it.

The eight axes

Axis Weight What it measures
Typography 15% Font quality, scale ratio, hierarchy depth, line-height, weight variety
Color 15% Palette coherence, contrast ratios, anti-patterns, dark mode, variables
Layout 15% Grid alignment, spacing rhythm, responsive, nesting depth, max-width
Motion 8% Transitions, easing curves, keyframes, reduced-motion support
Accessibility 12% Focus styles, semantic HTML, ARIA, touch targets, screen reader
Tokens 15% CSS custom property adoption rate — system maintainability
Hierarchy 10% Visual depth, heading levels, weight differentiation, size ratios
Personality 10% Anti-slop distance — how far from AI defaults

The radar chart renders all eight as a polygon. The shape IS your design fingerprint.

Install

npx skills add dragoon0x/meridian

Works with Claude Code, Cursor, Gemini CLI, Codex CLI, Copilot, Kiro, OpenCode, and Antigravity.

62 commands, 5 tiers

Tier 1 — Foundation (12)

Command What it does
/m-scan Read codebase, build design profile
/m-score Full 8-axis DNA score
/m-audit Comprehensive quality report
/m-tokens Generate complete token set
/m-type-scale Mathematical type scale
/m-palette Full 50-950 shade palette
/m-spacing Spacing scale from base unit
/m-shadows Brand-tinted elevation system
/m-radii Border radius scale
/m-motion-tokens Duration + easing tokens
/m-breakpoints Responsive breakpoint tokens
/m-z-index Z-index layer system

Tier 2 — Composition (11)

Command What it does
/m-grid Snap spacing to base grid
/m-rhythm Vertical baseline rhythm
/m-density Whitespace balance audit
/m-responsive Breakpoint quality check
/m-layout-audit Map all layout patterns
/m-layout-fix Auto-fix off-grid spacing
/m-align Cross-section alignment
/m-hierarchy Visual depth audit
/m-flow Content reading order
/m-measure Line length check (45-75 chars)
/m-nesting Nesting depth audit (max 4)

Tier 3 — Expression (14)

Command What it does
/m-type-pair Font pairing recommendations
/m-type-audit Full typography audit
/m-type-fix Auto-fix scale inconsistencies
/m-type-set Complete type system
/m-color-audit Find off-system colors
/m-color-fix Replace with tokens
/m-contrast WCAG contrast matrix
/m-dark Generate dark mode
/m-harmonize Add complementary accent
/m-semantic Semantic color tokens
/m-animate Purposeful motion
/m-scroll-fx Scroll-triggered reveals
/m-overdrive WebGL, spring physics
/m-transition Timing function tuning

Tier 4 — Polish (13)

Command What it does
/m-a11y Full accessibility audit
/m-a11y-fix Auto-fix a11y issues
/m-focus Focus ring system
/m-touch 44×44px touch targets
/m-aria ARIA attribute audit
/m-reduced-motion prefers-reduced-motion
/m-screen-reader Screen reader traversal
/m-harden Error states, i18n, edges
/m-polish Final quality pass
/m-bolder Amplify safe designs
/m-quieter Soften aggressive designs
/m-distill Strip to essence
/m-delight Memorable moments

Tier 5 — DNA (12)

Command What it does
/m-profile View design profile
/m-drift Detect drift from baseline
/m-enforce Auto-fix drift violations
/m-compare Compare DNA across versions
/m-trend Track DNA over time
/m-certify Pass/fail for CI/CD
/m-report Shareable DNA score card
/m-normalize Full token normalization
/m-export-css CSS custom properties
/m-export-tw Tailwind config
/m-export-scss SCSS variables + mixins
/m-export-json W3C Design Tokens JSON

DNA hash

Every scan produces a 6-character hash derived from the 8-axis scores. Same design decisions = same hash. Use it to verify consistency across branches, track evolution across versions, or just flex your design quality.

MERIDIAN DNA: 78/100 [Considered]
Hash: M-4E8F2A

Web scanner

The landing page is a live DNA scanner. Paste any code and watch the radar chart render your design genome. The shape tells the whole story: a balanced octagon means considered design across all axes. A lopsided spike means investment in one area and neglect in others.

Development

git clone https://github.com/dragoon0x/meridian.git
cd meridian
node build.js          # 315 files across 5 providers
node test/test.js      # 587 checks

License

Apache 2.0.


Built by dragoon0x


Disclaimer

This project is experimental software, built out of curiosity and shared for educational purposes only.

This software is provided "AS IS" without warranty of any kind. The author makes no claims about the accuracy or reliability of design analysis, scoring, or recommendations. Design quality is subjective — scores are heuristic approximations, not definitive assessments. This is not a substitute for professional design review or accessibility auditing. Not affiliated with Anthropic, Cursor, Google, OpenAI, GitHub, Vercel, or any AI tool vendor.

DYOR — Do Your Own Research. See DISCLAIMER.md for full terms.

About

Map your project's design DNA. 62 commands, 8-axis genome, 5 tiers. Project-aware design intelligence.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors