architecture

Document architectural decisions with ADRs to capture rationale and trade-offs.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/raccioly/coach-gravity --skill architecture-raccioly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/raccioly/coach-gravity/tree/main/content/starter-kit/skills/architecture
Command: npx skills add https://github.com/raccioly/coach-gravity --skill architecture-raccioly

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Document architectural decisions with ADRs to capture rationale and trade-offs.

Core Features & Use Cases

  • Architecture Decision Framework to standardize decision processes across projects
  • Context Discovery and ADR templates to log problems, constraints, and trade-offs
  • Pattern references, trade-off analysis, and ADR storage for governance and traceability
  • Related skills references and examples to guide teams in decision-making

Quick Start

Open the Architecture Decision Framework and start documenting your first ADR for the current design.

Frequently Asked Questions about architecture

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

FAQPage Schema
What are architecture decision records and how do they capture trade-offs?

Architecture decision records (ADRs) document architectural choices by capturing the problem context, constraints, and trade-off analysis. They provide traceable rationale for design decisions, ensuring teams understand why specific patterns were selected across software projects.

How do I document architectural decisions using ADR templates?

You document architectural decisions by applying ADR templates to log problems, constraints, and trade-offs. Using an architecture decision framework standardizes the process, enabling teams to create and store decision records for deliberate design choices.

When do I need to start logging architecture decision records for a project?

You need to log architecture decision records whenever a project requires deliberate structural choices and governance. ADRs apply to software architecture design across projects of any size, satisfying requirements for structured decision capture and traceable trade-offs.

Does this architecture decision framework work for small software projects?

Yes, the architecture decision framework applies to software architecture design across projects of any size. It enables teams to standardize decision processes, compare pattern references, and store decision records regardless of the project's scale.

What is the best way to standardize architecture governance and traceability?

The best way to standardize architecture governance is using an architecture decision framework with ADR templates. This approach captures pattern references, enables trade-off analysis, and provides ADR storage for consistent traceability across all design decisions.

Why should I use ADRs instead of informal documentation for trade-off analysis?

ADRs provide structured decision capture, traceable trade-offs, and pattern references that informal documentation lacks. By using ADR templates and storage, teams achieve governance and traceability, ensuring architectural rationale is preserved and comparable across projects.