Skip to content
Docs / AI Brain

Build

AI Brain

The rule files your agent reads before it builds, so the screens it writes look like your design system and not like AI slop.

What it is

Each design system has an AI Brain: plain Markdown and scripts that live in your project. The Andromeda Pro AI Brain holds 93 files:

  • The system rules and the foundations: colour, type, spacing, layout and motion.
  • One rule file per component: when to use it, and how.
  • A building skill and a review skill, plus tools that check finished work.

Because they are plain files, any agent that reads files follows them, Claude Code, Cursor and Codex included.

Install and update

One command installs every file. Run it again to update them; --overwrite replaces the old rules in place.

npx shadcn@latest add --overwrite @aicanvas/andromeda-pro-brain

For Andromeda Legacy, the name is andromeda-brain. Files land in design-systems/<system>/ in your project. The AI Brain comes with Premium.

Use it with your agent

Point your agent at the rules before it builds, for example in your CLAUDE.md or AGENTS.md, or simply in the prompt:

Read design-systems/andromeda-pro/ before you build. Build the settings page from Andromeda Pro components and follow its rules.

When it is done, ask it to run the review skill on the result. With the MCP server connected, it can also check the props of every component it used.

Make it yours

The rules are yours to change. Edit a rule file when your project decides differently, and your agent follows the new rule from the next prompt on. Updating with --overwrite replaces the files, so keep your own changes in a separate file or under version control.