architecture

Standardize architecture decisions with ADR templates and trade-off guidance.

Updated Aug 22, 2025
One-click install
npx skills add https://github.com/AnthonyCongHieu/voice_tool --skill architecture-anthonyconghieu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/AnthonyCongHieu/voice_tool/tree/main/voice_tools_v1/.agent/skills/architecture
Command: npx skills add https://github.com/AnthonyCongHieu/voice_tool --skill architecture-anthonyconghieu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inconsistent architecture decisions arise when teams lack a common framework. This skill provides a structured ADR workflow to capture decisions, constraints, and rationale to align stakeholders.

Core Features & Use Cases

  • ADR templates for documenting decisions and rationale.
  • Context discovery guidance to quickly classify projects and requirements.
  • A reference set of patterns and trade-off guidance to inform decisions.

Quick Start

Document the initial problem, constraints, and options, then capture a chosen ADR with rationale.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I document architecture trade-offs and decisions consistently?

Document architecture trade-offs by standardizing ADR-based workflows that capture constraints, options, decisions, and rationale. This approach provides structured templates and guidelines to align stakeholders and ensure traceability across project sizes.

What is an ADR and when do I need it for systems design?

An ADR is an Architecture Decision Record used during systems design to capture constraints, chosen options, and rationale. You need it when aligning stakeholders on structural decisions and ensuring traceability for requirements analysis and trade-off evaluation.

How to start writing an architecture decision record for a new project?

Start writing an architecture decision record by documenting the initial problem, constraints, and options, then capture the chosen ADR with rationale. Context discovery guidance helps classify project requirements before structuring the final decision documentation.

Can I use ADR workflows for architecture documentation on small projects?

Yes, ADR workflows are applicable across project sizes to structure requirements analysis and trade-off evaluation. The standardized templates and guidelines scale to align stakeholders regardless of the project's scope or complexity.

What is the best way to evaluate architecture patterns and trade-offs?

Evaluate architecture patterns and trade-offs by leveraging a reference set of patterns and trade-off guidance within a structured ADR workflow. This standardizes requirements analysis and informs decisions by capturing constraints, options, and rationale.

Why does inconsistent architecture decision-making happen and how to fix it?

Inconsistent architecture decision-making happens when teams lack a common framework for documentation. Fix it by adopting a structured ADR workflow with standardized templates to capture constraints, decisions, and rationale, aligning stakeholders and ensuring traceability.