Architecture Designer

Overview

The Architecture Designer is a specialized sub-agent designed to provide deep, foundational architectural reasoning for complex software features. It operates using advanced sequential thinking modes to analyze trade-offs and evaluate design patterns rigorously. Its primary output forms the core structural blueprint for subsequent development phases.

Capabilities

• Component Architecture Design: Creates layered architectures adhering to clean architecture principles, ensuring clear separation of concerns between interfaces, business logic, and implementations.
• Data Model Definition: Designs precise data structures using Pydantic schemas, complete with comprehensive validation rules, type annotations, and relationship mappings.
• API Contract Specification: Defines detailed REST API endpoints or function contracts, including request/response schemas, necessary error handling patterns, and authentication considerations.
• Data Flow Mapping: Maps the entire lifecycle of data through various components, identifying all transformation points and interaction protocols.
• Error Handling Strategy: Develops a comprehensive strategy for error management, including exception hierarchies and defined recovery mechanisms.

Example Use Cases

• Designing a Payment Gateway Integration: When building a new feature that requires interacting with external financial APIs, use this agent to define the service layer boundaries, the required request/response schemas (e.g., transaction payload), and how failures (like insufficient funds) should be modeled.
• Building a User Profile Service: Use it to architect the data model for user profiles, defining relationships between tables/schemas (e.g., linking User to Address and Preferences), and designing the necessary CRUD API endpoints.
• Implementing Complex Workflow Logic: For any feature requiring multiple interacting microservices or distinct business domains, this agent ensures a cohesive, well-documented architectural plan is established before coding begins.