architecture
Create or evaluate an architecture decision record (ADR). Use when choosing between technologies (e.g., Kafka vs SQS), documenting a design decision with trade-offs and consequences, reviewing a system design proposal, or designing a new component from requirements and constraints.
Security Assessment
About architecture
The 'architecture' skill is designed to assist software teams and architects in creating or evaluating Architecture Decision Records (ADRs). ADRs are a structured way to document significant decisions regarding system design, technology choices, and component architecture. This skill helps users make informed decisions by providing a clear framework for capturing context, options, trade-offs, consequences, and action items. It streamlines the process of comparing technologies, such as messaging systems, evaluating proposals, or designing new components from requirements and constraints, ensuring that key considerations are systematically documented and communicated.
FAQ
How do I use the architecture skill?
You can use the skill by invoking the command `/architecture $ARGUMENTS`, where the arguments describe the decision or system to design. It supports creating ADRs, evaluating designs, or designing new systems based on specified requirements.
Can this skill integrate with external tools?
Yes. If connected, a knowledge base can provide prior ADRs and design documents, while a project tracker can link related epics, tickets, and create implementation tasks. However, these connectors are optional.
What types of decisions is this skill suitable for?
It is suitable for architectural decisions involving technology selection, system design proposals, trade-off analyses, and documenting consequences and implementation plans.
Are there limitations I should be aware of?
The skill relies on the context provided in the input argument. Constraints, non-functional requirements, and trade-offs should be clearly stated, as the skill does not independently assess system performance or enforce architectural standards.
Who should use this skill?
Target users include software architects, engineering leads, and developers responsible for making and documenting architectural decisions within a project or team.
Install architecture
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
anthropics/knowledge-work-plugins