Aurelius: A React Framework Built with 48 Claude Code Agents and Figma-to-React Pipeline

What Aurelius Does

Aurelius is a React framework that uses Claude Code agents organized in a hierarchy to build React apps from Figma designs autonomously. Instead of a single AI agent generating code, it uses multiple agents that enforce iteration on each other for full app builds.

Agent Architecture and Pipeline

The framework has 48 agents total across engineering, design, testing, product, marketing, and ops. These agents are auto-selected by Claude Code based on what you're doing, and all agent definitions are stored in .claude/ so you can read, modify, or reuse them for your own projects.

Overseer agents gate the pipeline with specific requirements:

• Tests must be written before components (TDD is mandatory, not optional)
• Visual QA uses pixel-diff comparison with a 2% threshold
• Quality gate checks coverage, TypeScript, Lighthouse scores, and design token compliance before anything passes

The pipeline has 10 phases:

1. Figma discovery
2. Design token extraction
3. TDD gate
4. Component build
5. Pixel-diff visual QA (up to 5 iteration loops)
6. Playwright E2E tests
7. Cross-browser screenshots
8. Quality gate
9. Responsive checks
10. Build report

Technical Implementation

Some technical details from the source:

• Uses Vitest + React Testing Library for unit/component tests
• Playwright for E2E and cross-browser testing
• Pixelmatch for visual diffing
• Design tokens are locked in a lockfile so hardcoded values can't leak into components
• Everything is configurable in .claude/pipeline.config.json

The framework has app-type awareness and can detect whether you're building a standard web app, a Chrome extension (reads manifest.json), or a PWA, adjusting the E2E strategy accordingly. The creator used it to port an app from Webflow to a Chrome extension without reconfiguring the pipeline.

Project Status

Aurelius is MIT licensed with 118 commits. The entire framework was built in about two weeks using Claude Code, which demonstrates the workflow it automates. Milestones are planned through v2.0.0.