Architecture Agent Skill
Architecture design skill with ADR records, system design checklists, scalability assessment, and architecture patterns
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/davepoon/buildwithclaude --skill architectureThe instruction itself
3 sections, as written by the authorArchitecture 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 phasearchitectagent — System architecture decisionsplanneragent — Task breakdown and complexity analysis
Key Principles
- Simplicity first — Choose the simplest architecture that meets requirements
- Document decisions — Every significant choice gets an ADR
- Separation of concerns — Clear boundaries between components
- Design for failure — Graceful degradation and circuit breakers
Other skills for the same job
different authors, same section of the catalogue
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.
Intelligently organizes your files and folders across your computer by understanding context, finding duplicates, suggesting better structures, and automating cleanup tasks. Reduces cognitive load and keeps your digital workspace tidy without manual effort.
Generates creative domain name ideas for your project and checks availability across multiple TLDs (.com, .io, .dev, .ai, etc.). Saves hours of brainstorming and manual checking.
You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.
Implements Manus-style file-based planning for complex tasks. Creates task_plan.md, findings.md, and progress.md. Use when starting complex multi-step tasks, research projects, or any task requiring >5 tool calls.
Creative research ideation and exploration. Use for open-ended brainstorming sessions, exploring interdisciplinary connections, challenging assumptions, or identifying research gaps. Best for early-stage research planning when you do not have specific observations yet. For formulating testable hypotheses from data use hypothesis-generation.
Comprehensive GitHub project management with swarm-coordinated issue tracking, project board automation, and sprint planning
Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
How to use it
Take davepoon/architecture from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.