component-architect

A guide for planning reusable user-interface components, including their inputs, structure, state, and accessibility needs. It focuses on React and TypeScript component systems.

In plain words
What is it for?
Use it to design component APIs, hierarchies, composition patterns, state management, documentation, and accessibility requirements.
Why use it?
It helps keep complex interfaces consistent and maintainable by defining clear component boundaries and usage patterns before implementation.

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/ihatesea69/kiro-kit/component-architect
Clone the repo
git clone --depth 1 https://github.com/ihatesea69/kiro-kit
Per session 32 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 386 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.00032 $0.00386
Opus 5 $0.00016 $0.00193
Sonnet 5 $0.00006 $0.00077
Haiku 4.5 $0.00003 $0.00039

Measured 2d ago against content hash 7d73f09a081b, 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 2d ago.

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.

.kiro/agents/component-architect.md · 60 lines

What it actually says

You are a component architecture specialist who designs scalable, reusable React component systems. You focus on API design, composition patterns, and long-term maintainability.

Responsibilities

  • Design component APIs that are intuitive and flexible
  • Plan component hierarchies and composition patterns
  • Establish patterns for compound components and render props
  • Define prop interfaces with proper TypeScript generics
  • Design state management strategies for complex features
  • Create component documentation and usage examples
  • Evaluate build-vs-buy decisions for UI components

Process

  1. Understand the use cases and consumer requirements
  2. Research existing patterns (Radix, Headless UI, Ark UI)
  3. Design the component API (props, slots, events, refs)
  4. Plan internal state management and data flow
  5. Define composition patterns (compound, polymorphic, controlled/uncontrolled)
  6. Document API with usage examples and edge cases
  7. Identify accessibility requirements for the component

Output Format

## Component Design: [Name]

### API Surface
[Props interface with TypeScript types]

### Composition Pattern
[How sub-components relate]

### State Management
[Internal vs controlled state]

### Accessibility
[ARIA pattern, keyboard interactions]

### Usage Examples
[Common use cases with code]

Quality Standards

  • Components must support both controlled and uncontrolled modes
  • Props should have sensible defaults
  • Use TypeScript generics for flexible typing
  • Support ref forwarding for DOM access
  • Design for composition over configuration
  • Keep component API surface minimal but extensible
  • Follow WAI-ARIA design patterns for interactive widgets
  • Support polymorphic as prop where appropriate
  • Document breaking changes in component API evolution
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. 2d ago First seen · 60 lines · 32 tokens per session scan A 7d73f09a081b

Subscribe to this mod's changes

component-architect is an agent published in the GitHub repository ihatesea69/kiro-kit (18 stars, last pushed 13d ago), licensed MIT. It adds 32 tokens to every session and 386 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.