product-architecture

Guide multi-phase product architecture design and document ADRs.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/Emmraan/agent-skills --skill product-architecture-emmraan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: product-architecture
Source: https://github.com/Emmraan/agent-skills/tree/main/skills/product-architecture
Command: npx skills add https://github.com/Emmraan/agent-skills --skill product-architecture-emmraan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a comprehensive framework for designing, documenting, and evaluating system architectures, transforming product requirements into actionable technical blueprints.

Core Features & Use Cases

  • End-to-End Architecture Design: Guides users through requirement discovery, high-level design, interface definition, and operational planning.
  • Architectural Tradeoff Analysis: Facilitates informed decision-making by evaluating different architectural styles and patterns.
  • Documentation Generation: Produces structured Architecture Decision Records (ADRs) and comprehensive architecture documents.
  • Use Case: When tasked with designing a new e-commerce platform, this Skill will help define functional and non-functional requirements, select an appropriate architectural style (e.g., microservices), design component interactions, plan for scalability and reliability, and document all decisions.

Quick Start

Use the product-architecture skill to design a new system architecture based on the provided product requirements.

Frequently Asked Questions about product-architecture

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

FAQPage Schema
How do I design and document a system architecture from product requirements?

Design and document system architecture by guiding the AI agent through requirement discovery, system decomposition, interface design, and operational planning to produce comprehensive technical blueprints.

What is the best way to evaluate architectural tradeoffs during system design?

Evaluating architectural tradeoffs involves analyzing different architectural styles and patterns to facilitate informed decision-making, ensuring the selected system design balances scalability and reliability.

How do I generate Architecture Decision Records for a new product development project?

Generate Architecture Decision Records by documenting the structured decision-making process, capturing the rationale behind interface designs, scalability plans, and reliability tradeoffs for the product architecture.

Can I use this framework to plan scalability and reliability for a microservices architecture?

Yes, you can plan scalability and reliability for a microservices architecture by using the structured process to design component interactions, define interfaces, and document operational planning decisions.

What steps are involved in system decomposition for product architecture?

System decomposition involves breaking down product requirements into manageable components, defining component interactions, designing interfaces, and planning operational aspects like scalability and reliability.

When do I need to create comprehensive architecture documents for my software project?

You need to create comprehensive architecture documents when translating product requirements into actionable technical blueprints, ensuring all functional, non-functional, and tradeoff decisions are formally recorded.