agent-architecture-designer

Validate architecture patterns for agent-based systems and generate ADRs.

1|1|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/penghang1223/niannian-workspace --skill agent-architecture-designer-penghang1223
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-architecture-designer
Source: https://github.com/penghang1223/niannian-workspace/tree/main/skills/agent-architecture-designer
Command: npx skills add https://github.com/penghang1223/niannian-workspace --skill agent-architecture-designer-penghang1223

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture designers often guess at patterns; this skill provides a structured framework to evaluate and validate patterns for agent-based architectures, reducing risk and debt.

Core Features & Use Cases

  • Pattern selection framework with decision trees for Monolith, Modular Monolith, and Microservices.
  • ADR (Architectural Decision Record) generation with validation evidence and rationale.
  • Prototype-driven validation, load tests, and performance metrics to accompany recommendations.

Quick Start

Provide a project goal and ask the agent to select a pattern, validate it with a prototype, and generate an ADR.

Frequently Asked Questions about agent-architecture-designer

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

FAQPage Schema
How do I select an architecture pattern for agent-based systems?

To select an architecture pattern for agent-based systems, use a structured decision tree framework to evaluate Monolith, Modular Monolith, and Microservices styles. This reduces technical debt by validating the chosen pattern against your specific project requirements before implementation.

How do I generate an Architectural Decision Record with validation evidence?

Generate an Architectural Decision Record (ADR) by documenting the selected architecture pattern alongside validation evidence and rationale. This is achieved through prototype-driven validation and load tests that produce performance metrics to accompany your design recommendations.

What is the best way to validate architecture designs before implementation?

The best way to validate architecture designs is through prototype-driven validation. This approach uses executable prototypes and load tests to generate performance metrics and validation reports, ensuring your architecture pattern meets requirements and reduces technical risk.

Do I need a prototype to document architecture patterns for an ADR?

Yes, a prototype is needed to document architecture patterns effectively. Prototype validation generates the necessary performance metrics and validation evidence required to substantiate the rationale in your Architectural Decision Records and operational runbooks.

How do I reduce technical debt when choosing between microservices and monoliths?

Reduce technical debt when choosing between microservices and monoliths by applying a pattern selection framework. This framework uses decision trees and prototype validation to evaluate architectural styles against your requirements, ensuring a verified choice rather than guessing.