# UI system architecture

Clarify which responsibilities belong to visual foundations, controls, interaction behaviors, patterns, and feature adapters. Justify contracts and state ownership through actual consumers and supported operations, preserving consequential design intent in the contracts it depends on. The skill uses the host framework and proposes a bounded migration where needed; conditional guidance does not require additional infrastructure.

Package version: 0.1.0-beta.6.

Included with [Faye UI System Engineer](/plugins/faye-ui-system-engineer/).

## When to use

Use this before restructuring shared components, introducing reusable controls, or untangling state shared across views.

## What to provide

- The affected repository areas and examples of real consumers.
- Current component APIs, state mechanisms, compatibility requirements, and the behavior that must remain stable.

## Expected results

- A proposed ownership model and component or state contracts.
- A bounded migration sequence with compatibility decisions and verification criteria.

## Example requests

### Try this request

#### Codex

```
$ui-system-architecture Plan a shared filter control for our React search and reporting screens. Keep the current state library and show which state belongs in the URL, feature, and control.
```

#### Grok

```
/ui-system-architecture Plan a shared filter control for our React search and reporting screens. Keep the current state library and show which state belongs in the URL, feature, and control.
```

#### Antigravity

```
/ui-system-architecture Plan a shared filter control for our React search and reporting screens. Keep the current state library and show which state belongs in the URL, feature, and control.
```

## Requirements

- Access to the relevant UI source is needed to substantiate a repository architecture proposal.
- Identify any permitted dependency or framework changes explicitly.

## Scope and limitations

- Architecture proposals do not change files unless implementation is also requested.
- An individual screen does not automatically require a reusable system.
- Application chrome and authored content, such as an editor canvas, remain separate ownership decisions.

## Related guides and supporting files

- [Faye UI System Engineer](/plugins/faye-ui-system-engineer/) — Design, build, and review browser interfaces with purposeful visuals, interaction feel, and rendered evidence.

## Technical source

[Open original source](/marketplace/plugins/faye-ui-system-engineer/skills/ui-system-architecture/SKILL.md)

Source path: plugins/faye-ui-system-engineer/skills/ui-system-architecture