architecture

Document architecture decisions using ADR templates and design checklists.

49|3|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/xiaobei930/claude-code-best-practices --skill architecture-xiaobei930
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/xiaobei930/claude-code-best-practices/tree/main/skills/architecture
Command: npx skills add https://github.com/xiaobei930/claude-code-best-practices --skill architecture-xiaobei930

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture decisions are often scattered and hard to trace, slowing system design and cross-team alignment.

Core Features & Use Cases

  • ADR templates and records for major decisions to ensure traceability.
  • System design checklists and scalability assessments to guide architecture choices.
  • Architecture pattern quick references to accelerate design decisions in common scenarios.

Quick Start

Create an ADR-001 template for a major technology decision and log the context, decision, and consequences in the ADR repository.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I document architecture decisions for better traceability?

To document architecture decisions for traceability, use ADR templates to log the context, decision, and consequences of major technology choices in a centralized ADR repository. This ensures cross-team alignment and tracks system design rationale.

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

An ADR, or Architecture Decision Record, is a structured document capturing major technology decisions. You need ADRs during system design when making scalable architecture choices that require cross-functional team alignment and historical traceability.

How do I run a design review and scalability assessment for large projects?

Run a design review and scalability assessment for large projects by applying structured checklists and scalable design templates. This workflow evaluates architecture patterns and guides complex system design choices across cross-functional teams.

Can I use architecture checklists for cross-functional team alignment?

Yes, you can use architecture checklists for cross-functional team alignment. They provide structured system design criteria and scalability assessments that streamline evaluation and ensure all teams follow consistent architecture patterns.

What's the best way to streamline complex system design across multiple teams?

The best way to streamline complex system design across multiple teams is applying ADR-driven practices alongside architecture pattern quick references. This accelerates design decisions and ensures cross-functional alignment through structured checklists.

Are there limitations to using ADR workflows for architecture choices?

ADR workflows focus on documenting major decisions and consequences but do not automatically resolve architecture conflicts. They require manual maintenance and team adoption to ensure scalability assessments and design review checklists remain effective.