architecture

xenitV1 的头像作者 xenitV1

架构推理框架:需求分析、权衡评估和基于 ADR 的决策文档。不是一个模式目录,而是一个思考框架。在设计系统架构、选择模式或做出结构决策时使用。

📖 中文导读:架构推理框架:需求分析、权衡评估和基于 ADR 的决策文档。不是一个模式目录,而是一个思考框架。在设计系统架构、选择模式或做出结构决策时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: architecture description: Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when making architecture decisions or analyzing system design. allowed-tools: Read, Glob, Grep

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

Skill Use For
@[skills/database-design] Database schema design
@[skills/api-patterns] API design patterns
@[skills/deployment-procedures] Deployment architecture

Core Principle

"Simplicity is the ultimate sophistication."

  • Start simple
  • Add complexity ONLY when proven necessary
  • You can always add patterns later
  • Removing complexity is MUCH harder than adding it

Validation Checklist

Before finalizing architecture:

  • Requirements clearly understood
  • Constraints identified
  • Each decision has trade-off analysis
  • Simpler alternatives considered
  • ADRs written for significant decisions
  • Team expertise matches chosen patterns