architecture

Capture architectural decisions with ADR templates and rationale.

1|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/boomNDS/soop-discoard-bot --skill architecture-boomnds
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/boomNDS/soop-discoard-bot/tree/main/.agents/skills/architecture
Command: npx skills add https://github.com/boomNDS/soop-discoard-bot --skill architecture-boomnds

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured approach to capturing architectural decisions and their rationale via Architecture Decision Records (ADRs), enabling traceable design choices across projects.

Core Features & Use Cases

  • ADR templates to record context, options, decisions, consequences, and rationale.
  • Trade-off analysis guidance to compare alternatives and justify choices.
  • Pattern and architecture guidance for modularization, technology selection, and system design.
  • Collaboration & traceability to align teams and maintain a design history.

Quick Start

Create your first ADR-001 describing the problem, constraints, and the chosen approach. Then document options and expected 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 for software design?

An Architecture Decision Record (ADR) documents context, options, decisions, and consequences for software design. You need ADRs to establish traceability and structured rationale when capturing architectural choices across a project lifecycle.

How do I document architecture trade-offs and compare design patterns effectively?

To document architecture trade-offs, use structured ADR templates to record context and compare design patterns. This framework provides trade-off analysis guidance to compare alternatives, justify technology selection, and capture expected consequences.

What's the best way to start writing my first ADR for system design decisions?

The best way to start writing an ADR is to create ADR-001 describing the problem, constraints, and chosen approach. Document the design options analyzed and expected consequences to enforce context recording and traceability.

Can I use ADRs to align teams and maintain a design history for modularization?

Yes, you can use ADRs to align teams and maintain a design history for modularization. This framework enforces collaboration and traceability by applying ADR templates to record rationale for technology selection and system design.

Does this architecture framework work for projects needing structured decision documentation without external dependencies?

Yes, this architecture framework works standalone without external dependencies. It enforces ADR templates and pattern selection guidance directly, providing structured decision documentation for software projects needing traceable design choices.

Why should I not use informal documentation instead of ADRs for capturing architectural decisions?

You should not use informal documentation because it lacks traceability and structured rationale. ADRs enforce context recording, trade-off analysis, and pattern selection guidance, ensuring architectural decisions remain aligned and traceable across the project lifecycle.