architecture

Creates ADR-based decision records and provides pattern guidance for software architecture projects.

8.1k|1.5k|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/vudovn/antigravity-kit --skill architecture-vudovn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/vudovn/antigravity-kit/tree/main/.agent/skills/architecture
Command: npx skills add https://github.com/vudovn/antigravity-kit --skill architecture-vudovn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architectural decision-making is often ad-hoc and poorly documented. This skill provides a structured framework and ADR-driven guidance to capture rationale and decisions.

Core Features & Use Cases

  • ADR templates and decision records to document architecture choices
  • Trade-off analysis and pattern guidance for common architectural scenarios
  • Quick-start workflow to kick off an architecture study in new or existing projects

Quick Start

Activate the Architecture Decision Framework for a new service: start with context discovery, then pattern selection, and finally draft ADRs.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I document software architecture decisions to avoid ad-hoc choices?

Document software architecture decisions using ADR templates to capture rationale and trade-offs. This enforces a disciplined approach, replacing ad-hoc decision-making with structured records that justify architectural choices.

What is the best way to analyze architecture trade-offs for a new service?

The best way to analyze architecture trade-offs is through a structured framework providing pattern guidance. It evaluates common architectural scenarios, ensuring decision-making considers both the benefits and constraints of each pattern.

How do I start an architecture study for an existing project?

Start an architecture study for existing projects using a quick-start workflow. Begin with context discovery to understand current constraints, proceed to pattern selection, and finally draft ADRs to document decisions.

When do I need ADR documentation in software engineering?

You need ADR documentation when architectural decision-making becomes complex or poorly documented. It provides a structured framework to capture rationale, ensuring decisions are recorded across various project sizes for future reference.

Can I use pattern guidance for architecture projects of any size?

Yes, pattern guidance and ADR-based decision records support architecture projects across various project sizes. The framework scales from requirements discovery to ADR documentation, accommodating both new and existing projects.

Why does ad-hoc architectural decision-making cause problems?

Ad-hoc architectural decision-making causes problems because it is often poorly documented, losing the rationale behind choices. Using an ADR-driven framework solves this by providing structured templates and trade-off analysis for decisions.