Skip to main content
Generaldavepoon

architecture

Architecture design skill with ADR records, system design checklists, scalability assessment, and architecture patterns

Stars
2,987
Source
davepoon/buildwithclaude
Updated
2026-05-26
Slug
davepoon--buildwithclaude--architecture
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/davepoon/buildwithclaude/HEAD/plugins/cc-best/skills/architecture/SKILL.md -o .claude/skills/architecture.md

Drops the SKILL.md into .claude/skills/architecture.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Architecture Skill

Provides architectural guidance for system design decisions, including:

  • ADR (Architecture Decision Records): Structured format for recording design decisions with context, options, and rationale
  • System Design Checklist: Scalability, reliability, observability, security considerations
  • Architecture Patterns: Microservices, event-driven, layered, hexagonal
  • API Design: RESTful conventions, versioning, pagination, error handling

When Loaded

This skill is automatically injected when working with:

  • /cc-best:lead — Technical design phase
  • architect agent — System architecture decisions
  • planner agent — Task breakdown and complexity analysis

Key Principles

  1. Simplicity first — Choose the simplest architecture that meets requirements
  2. Document decisions — Every significant choice gets an ADR
  3. Separation of concerns — Clear boundaries between components
  4. Design for failure — Graceful degradation and circuit breakers