architecture

Capture and justify architectural decisions using ADR templates and decision records.

Updated Mar 3, 2025
One-click install
npx skills add https://github.com/cyhinverse/YiBu --skill architecture-cyhinverse
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/cyhinverse/YiBu/tree/main/.agents/skills/architecture
Command: npx skills add https://github.com/cyhinverse/YiBu --skill architecture-cyhinverse

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architectural decision-making framework that helps teams capture requirements, compare trade-offs, and document rationale through ADRs.

Core Features & Use Cases

  • ADR templates and decision records to standardize engineering choices.
  • Pattern references and knowledge base to guide design decisions.
  • Framework for requirements analysis, risk assessment, and documentation of trade-offs across projects.

Quick Start

Draft an Architecture Decision Record (ADR) outlining the chosen option, rationale, trade-offs, and consequences.

Frequently Asked Questions about architecture

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

FAQPage Schema
What is an Architecture Decision Record and when do I need one?

An Architecture Decision Record (ADR) captures and justifies architectural choices to prevent ad-hoc designs. You need ADR documentation when conducting requirements analysis, evaluating trade-offs, or standardizing engineering decisions across projects of any size.

How do I document trade-offs and rationale for architectural decisions?

You document trade-offs by drafting an Architecture Decision Record outlining the chosen option, rationale, and consequences. This framework enforces a consistent documentation structure, utilizing ADR templates and decision records to justify engineering choices.

Can I standardize architectural documentation across projects of different sizes?

Yes, you can standardize architectural documentation across projects of any size. The framework provides ADR templates, pattern references, and a knowledge base to guide design decisions, ensuring consistent requirements analysis and risk assessment.

What's the best way to avoid ad-hoc designs in software architecture?

The best way to avoid ad-hoc designs is applying an ADR-driven decision framework. By enforcing consistent documentation of requirements analysis, trade-off evaluation, and decision rationale, teams capture structural choices and prevent undocumented architectural drift.

How do I start writing an ADR for a new engineering requirement?

Start writing an ADR by drafting a decision record that outlines the chosen option, rationale, trade-offs, and consequences. This quick start approach captures architectural decisions systematically, supported by reference patterns and ADR templates for future decisions.

Does this architectural decision framework support risk management and requirements analysis?

Yes, the framework supports risk management and requirements analysis by providing a structured approach to evaluate trade-offs and document rationale. It applies ADR templates and decision records to systematically assess risks and capture architectural choices.