architecture

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

2,707 stars

Best use case

architecture is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

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

Teams using architecture should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/architecture/SKILL.md --create-dirs "https://raw.githubusercontent.com/davepoon/buildwithclaude/main/plugins/cc-best/skills/architecture/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/architecture/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How architecture Compares

Feature / AgentarchitectureStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

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

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# 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

Related Skills

pagerduty-automation

2707
from davepoon/buildwithclaude

Automate PagerDuty tasks via Rube MCP (Composio): manage incidents, services, schedules, escalation policies, and on-call rotations. Always search tools first for current schemas.

outlook-calendar-automation

2707
from davepoon/buildwithclaude

Automate Outlook Calendar tasks via Rube MCP (Composio): create events, manage attendees, find meeting times, and handle invitations. Always search tools first for current schemas.

outlook-automation

2707
from davepoon/buildwithclaude

Automate Outlook tasks via Rube MCP (Composio): emails, calendar, contacts, folders, attachments. Always search tools first for current schemas.

one-drive-automation

2707
from davepoon/buildwithclaude

Automate OneDrive file management, search, uploads, downloads, sharing, permissions, and folder operations via Rube MCP (Composio). Always search tools first for current schemas.

oiloil-ui-ux-guide

2707
from davepoon/buildwithclaude

Modern, clean UI/UX guidance + review skill. Use when you need actionable UX/UI recommendations, design principles, or a design review checklist for new features or existing systems (web/app). Focus on CRAP (Contrast/Repetition/Alignment/Proximity) plus task-first UX, information architecture, feedback & system status, consistency, affordances, error prevention/recovery, and cognitive load. Enforce a modern minimal style (clean, spacious, typography-led), reduce unnecessary copy, forbid emoji as icons, and recommend intuitive refined icons from a consistent icon set.

obsidian-markdown

2707
from davepoon/buildwithclaude

Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.

obsidian-bases

2707
from davepoon/buildwithclaude

Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries. Use when working with .base files, creating database-like views of notes, or when the user mentions Bases, table views, card views, filters, or formulas in Obsidian.

notion-automation

2707
from davepoon/buildwithclaude

Automate Notion tasks via Rube MCP (Composio): pages, databases, blocks, comments, users. Always search tools first for current schemas.

monday-automation

2707
from davepoon/buildwithclaude

Automate Monday.com work management including boards, items, columns, groups, subitems, and updates via Rube MCP (Composio). Always search tools first for current schemas.

mixpanel-automation

2707
from davepoon/buildwithclaude

Automate Mixpanel tasks via Rube MCP (Composio): events, segmentation, funnels, cohorts, user profiles, JQL queries. Always search tools first for current schemas.

miro-automation

2707
from davepoon/buildwithclaude

Automate Miro tasks via Rube MCP (Composio): boards, items, sticky notes, frames, sharing, connectors. Always search tools first for current schemas.

microsoft-teams-automation

2707
from davepoon/buildwithclaude

Automate Microsoft Teams tasks via Rube MCP (Composio): send messages, manage channels, create meetings, handle chats, and search messages. Always search tools first for current schemas.