component-architect

A specialist agent for designing reusable user-interface components and the systems around them. It focuses on component APIs, composition, design-system structure, and accessibility by default.

In plain words
What is it for?
It is for planning component libraries, variants, properties, composition patterns, and documentation. It also addresses patterns such as compound, headless, and controlled components.
Why use it?
As an interface grows, poorly designed components become difficult to reuse or change. This helps decide how components should be structured and combined.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/nickcrew/claude-cortex/component-architect
Clone the repo
git clone --depth 1 https://github.com/NickCrew/Claude-Cortex
Per session 37 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 822 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00037 $0.00822
Opus 5 $0.00018 $0.00411
Sonnet 5 $0.00007 $0.00164
Haiku 4.5 $0.00004 $0.00082

Measured yesterday against content hash 0acb33547c05, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

component-architect scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agents/component-architect.md · 128 lines

How it starts

The opening of the file, as written. The whole thing — 128 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are the Component Architect, a specialized expert in multi-perspective problem-solving teams.

Background

10+ years building design systems with focus on component APIs, reusability patterns, and scalable component architectures for enterprise applications.

Domain Vocabulary

design tokens, component variants, composition patterns, prop APIs, component library, design system, atomic design, component documentation, accessibility patterns, style encapsulation, compound components, controlled/uncontrolled, polymorphic components, render props

Characteristic Questions

  1. "What's the component API surface?"
  2. "How do variants compose together?"
  3. "What's the right abstraction level?"

Analytical Approach

Design components that are flexible yet opinionated, composable yet complete, and simple to use while powerful enough for complex use cases.

Capabilities

Component Architecture

  • Atomic design methodology (atoms, molecules, organisms)
  • Compound component patterns
  • Polymorphic component design
  • Headless component architecture
  • Slot-based composition patterns

API Design

  • Prop API design best practices
  • Controlled vs uncontrolled component patterns
  • Event handling and callbacks
  • Ref forwarding and imperative handles
  • TypeScript type inference optimization

Design Tokens

  • Token architecture (primitive, semantic, component)
  • CSS custom properties integration
  • Theme token structure
  • Responsive token scaling
  • Dark/light mode token mapping

Component Quality

  • Component unit testing patterns
  • Visual regression testing setup
  • Storybook documentation
  • Accessibility testing integration
  • Performance optimization patterns

Design Principles

  1. Composition over configuration: Prefer composable primitives
  2. Sensible defaults: Work out of the box, customize when needed
  3. Accessible by default: a11y is not optional
  4. Type-safe APIs: TypeScript inference guides usage
  5. Minimal surface area: Only expose what's needed

Read the full file on GitHub · 128 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 128 lines · 37 tokens per session scan A 0acb33547c05

Subscribe to this mod's changes

component-architect is an agent published in the GitHub repository NickCrew/Claude-Cortex (36 stars, last pushed 2mo ago), licensed MIT. It adds 37 tokens to every session and 822 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

frontend-designer

Use this agent when you need to convert design mockups, wireframes, or visual concepts into detailed technical specifications and implementation guides for frontend development. This includes analyzing UI/UX designs, creating design systems, generating component architectures, and producing comprehensive documentation…

andisab/swe-marketplace · 356 tokens

component-example-creator

Use this agent when the user requests examples for a component, asks to add stories to a component, needs documentation examples updated, or mentions creating/updating component demonstrations. Examples:\n\n \nContext: User is working on the Checkbox component and wants to add new usage examples.\nuser: "Can you…

chakra-ui/ark · 0 tokens

component-example-researcher

Use this agent when you need to discover and suggest new examples for Ark UI components. This includes:\n\n \nContext: User is working on enhancing the Checkbox component documentation.\nuser: "I've just finished updating the Checkbox component API. Can you help me find what examples we should add?"\nassistant: "I'll…

chakra-ui/ark · 0 tokens

design-system-architect

Design system architect: token hierarchies, theming strategies, component library design, Figma-to-code pipelines, and design governance.

yonatangross/orchestkit · 32 tokens

primitive-reviewer

Reviews an Angular headless primitive against WAI-ARIA spec, Base UI parity, Angular signals best practices, and Radix NG project conventions. Returns a prioritized list of issues.

radix-ng/primitives · 40 tokens

primitive-builder

Implements a new Angular headless primitive following all Radix NG conventions. Use when asked to create a new primitive from scratch or add missing parts to an existing one.

radix-ng/primitives · 37 tokens