Skills

This skill serves as the AI agent's comprehensive framework for tackling any product architecture challenge. It provides a sequential, decision-driven workflow that transforms ambiguous product needs into well-reasoned, documented system architectures. The agent should treat each step as a mandatory checkpoint, producing concrete artifacts before advancing.

When to use

Activate this skill when any of the following conditions are detected:

• A user asks for help designing a new system, platform, product, or service from scratch.
• A user requests a review, critique, or improvement of an existing system architecture.
• A user needs help decomposing a monolithic system into services or modules.
• A user asks about component design, service boundaries, API design, or integration patterns.
• A user poses questions about scalability, reliability, fault tolerance, or performance planning for a system.
• A user wants to evaluate tradeoffs between architectural approaches (e.g., monolith vs. microservices, SQL vs. NoSQL, synchronous vs. asynchronous communication).
• A user asks for an Architecture Decision Record (ADR), technical design document, or system design diagram description.
• A user describes a product idea, set of features, or business problem and expects a technical architecture recommendation.
• A user asks how to evolve, migrate, or modernize an existing architecture.
• A conversation involves terms such as "system design," "architecture," "tech stack," "infrastructure," "service boundary," "data model," "API contract," "high availability," "disaster recovery," "capacity planning," or similar architectural language.