architecture
Architecture guides decision-making through requirements analysis, trade-off evaluation, and ADR documentation. It helps teams capture design rationale and choose patterns systematically, emphasizing simplicity and constraint-aware choices.
Architecture documents your system design decisions using trade-off analysis and ADR templates.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-07-26
Architecture documents your system design decisions using trade-off analysis and ADR templates. Architecture guides decision-making through requirements analysis, trade-off evaluation, and ADR documentation. It helps teams capture design rationale and choose patterns systematically, emphasizing simplicity and constraint-aware choices.
Use it when
- Architecture provides ADR templates that structure how you document architectural decisions.
- Architecture enables trade-off analysis by helping you map requirements and constraints against architectural options.
Verify before relying
Read SKILL.md below before installing (6 files). Open directory: indexed for reading, not audited.
Similar skills
Install
vudovn/ag-kit/architecture · repository language: TypeScript
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How to make architecture decisions with Architecture?
Architecture guides your decision-making by starting with requirements analysis and constraint identification. The skill helps you evaluate trade-offs systematically, compare architectural patterns against your specific needs, and document choices using ADR (Architecture Decision Record) templates. This ensures decisions are captured with clear rationale, making it easier for teams to understand why patterns were chosen and what alternatives were considered.
What is an architecture decision record template?
Architecture provides ADR templates that structure how you document architectural decisions. An ADR captures the decision context, options evaluated, the chosen solution, and its trade-offs. Architecture emphasizes documenting your design rationale so teams can reference the reasoning behind pattern selections, constraints that drove choices, and consequences of each decision. This framework helps maintain institutional knowledge across projects.
How does Architecture help with system design trade-off analysis?
Architecture enables trade-off analysis by helping you map requirements and constraints against architectural options. The skill guides you through evaluating patterns systematically—weighing factors like simplicity, scalability, team capability, and maintenance burden. Architecture emphasizes constraint-aware choices, ensuring your final design reflects realistic trade-offs rather than theoretical ideals, and documents these trade-offs so future decisions build on clear reasoning.
How do I document architecture decisions using Architecture?
Architecture provides structured ADR documentation frameworks that capture decision context, alternatives considered, and rationale. The skill guides you through writing clear decision records that explain what problem you solved, why you chose your pattern, and what trade-offs you accepted. This documentation approach helps teams validate architecture against requirements and makes it easier to revisit decisions when constraints or capabilities change.
Can Architecture help me evaluate and compare architectural patterns?
Yes. Architecture guides pattern evaluation by helping you analyze requirements and constraints first, then systematically compare options against those criteria. The skill supports trade-off assessment before finalizing choices, ensuring you understand the consequences of each pattern. Architecture emphasizes choosing patterns that fit your team's capabilities and project constraints, not just selecting theoretically optimal designs.
What makes Architecture's approach to design decisions different?
Architecture emphasizes simplicity and constraint-aware decision-making rather than pursuing perfect designs. The skill combines requirements analysis, systematic pattern comparison, and ADR documentation to create a complete decision framework. By capturing trade-off rationale and validating choices against team capabilities, Architecture helps teams make decisions they can actually execute and maintain, while building shared understanding across the organization.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
Architecture Decision Framework
> "Requirements drive architecture. Trade-offs inform decisions. ADRs capture rationale."
🎯 Selective Reading Rule
Read ONLY files relevant to the request! Check the content map, find what you need.
| File | Description | When to Read |
|---|---|---|
context-discovery.md |
Questions to ask, project classification | Starting architecture design |
trade-off-analysis.md |
ADR templates, trade-off framework | Documenting decisions |
pattern-selection.md |
Decision trees, anti-patterns | Choosing patterns |
examples.md |
MVP, SaaS, Enterprise examples | Reference implementations |
patterns-reference.md |
Quick lookup for patterns | Pattern comparison |
🔗 Related Skills
| Skill | Use
(truncated - see the full file via the links below)
File tree — 6 files
.agents/skills/architecture/SKILL.md
.agents/skills/architecture/context-discovery.md
.agents/skills/architecture/examples.md
.agents/skills/architecture/pattern-selection.md
.agents/skills/architecture/patterns-reference.md
.agents/skills/architecture/trade-off-analysis.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Document architectural decisions with trade-off analysis and ADR templates”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
This skill provides a structured framework for making architecture decisions through requirements analysis and trade-off evaluation. It guides you through context discovery, pattern selection, and ADR documentation with a core principle of starting simple and adding complexity only when necessary.
Master the thinking behind running production servers rather than memorizing commands. This skill covers process management tool selection, monitoring strategy across availability and performance, log rotation principles, and scaling decisions. You'll learn health check implementation, security practices, and a structured troubleshooting priority system to diagnose server issues.
App Builder is an orchestrator that transforms natural language requests into complete full-stack applications. It analyzes your requirements, determines the appropriate project type and technology stack, then coordinates specialized agents to scaffold and build your project. With 13 built-in templates spanning web, mobile, desktop, and API architectures, it handles the entire setup workflow.
Database Design teaches schema fundamentals, ORM selection, and performance tuning through structured decision-making rather than rote patterns. It covers normalization, relationship design, indexing strategy, and query optimization across PostgreSQL, SQLite, and serverless databases.
Architecture Decision helps you systematically evaluate design choices, document trade-offs, and select appropriate patterns for your context. It provides frameworks for creating Architecture Decision Records, assessing technical debt, and balancing quality attributes like performance, scalability, and maintainability.
This skill guides you through principled decisions for Node.js development—from picking the right framework (Express, Fastify, NestJS, Hono) based on your deployment target and performance needs, to structuring layered architectures and handling errors consistently. It covers async patterns, validation strategies, security fundamentals, and testing priorities, emphasizing context-aware choices over one-size-fits-all solutions.
More skills documentation-and-adrs (MIT) · architecture-decision-record (MIT)