uaa

Standardize software project architecture by separating Core, Adapters, and Shared Capabilities.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/zap-studio/skills --skill uaa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uaa
Source: https://github.com/zap-studio/skills/tree/main/uaa
Command: npx skills add https://github.com/zap-studio/skills --skill uaa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Establishes a portable, decoupled architecture that keeps core business logic separate from platform-specific adapters, reducing drift and maintenance overhead.

Core Features & Use Cases

  • Core-Adapter separation: a well-defined Core with thin Adapters to serve multiple surfaces (web, mobile, API, CLI).
  • Shared Capabilities: centralized cross-cutting concerns (observability, security, configuration) that span all layers.
  • Use Cases: design scalable systems where teams iterate on UI/Adapters without touching Core business rules.

Quick Start

Apply the UAA structure by separating Core, Adapters, and Shared Capabilities to start building portable, scalable applications.

Frequently Asked Questions about uaa

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I separate core business logic from platform adapters in a scalable architecture?

Separating core business logic from platform adapters in a scalable architecture requires standardizing a five-layer taxonomy spanning Primitives, Services, State & Signals, UI, and Features, enforcing explicit entrypoints to keep core rules decoupled from platform-specific implementations.

What is the best way to structure a portable application for web, mobile, API, and CLI surfaces?

Structuring a portable application for web, mobile, API, and CLI surfaces involves defining a central Core with thin Adapters and shared cross-cutting capabilities, allowing teams to iterate on interfaces without modifying underlying business rules.

How does the Core-Adapter separation pattern reduce architectural drift?

The Core-Adapter separation pattern reduces architectural drift by centralizing cross-cutting concerns like observability and security into shared capabilities, preventing platform-specific code from leaking into the core business logic across multiple surfaces.

Can I use this architectural pattern for modern applications across different platforms?

You can apply this architectural pattern across modern applications spanning web, mobile, API, and CLI platforms, using explicit adapter entrypoints to serve multiple surfaces while maintaining a single, portable core implementation.

When do I need to enforce a five-layer taxonomy for software architecture?

You need to enforce a five-layer taxonomy for software architecture when designing scalable systems where multiple teams iterate on UI and Adapters independently, requiring strict boundaries between Primitives, Services, State, and Features to prevent structural drift.

Why does standardizing core logic and adapters reduce maintenance overhead?

Standardizing core logic and adapters reduces maintenance overhead by establishing a portable, decoupled architecture that keeps business rules separate from platform-specific adapters, minimizing duplicate code and drift across surfaces.