Architecture Decision
Use when a technical choice changes system boundaries, contracts, quality attributes, data, or operations and has meaningful reversal cost.
Install
npx skills add sandbaseai/workbuddy-skill --skill architecture-decisiongit clone --depth 1 https://github.com/sandbaseai/workbuddy-skill.git /tmp/workbuddy-skill
mkdir -p ~/.claude/skills
cp -r /tmp/workbuddy-skill/skills/architecture-decision ~/.claude/skills/architecture-decisionPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Architecture Decision Use this skill when a choice can alter boundaries, APIs, data ownership, deployment, security, reliability, performance, cost, or operational responsibility. Produce a decision that another engineer can verify and revisit; do not turn a tool preference into an architectural requirement. ## Establish the decision frame 1. State the decision to make and the deadline. 2. Describe the current context, users, components, data flows, and relevant dependencies. 3. Record constraints: compatibility, regulation, team capability, delivery window, budget, latency, availability, and migration limits. 4. Identify up to five prioritized quality attributes and measurable targets (for example p95 latency, recovery time, availability, cost per request, or deploy frequency). 5. List assumptions and missing evidence. If evidence is insufficient, record an investigation, owner, deadline, and decision criterion. Do not claim a quality attribute without a measurement plan. Separate requirements from preferences and reversible experiments from durable commitments. ## Compare options Compare at least two viable alternatives and the option of not changing. For each, cover: - boundary and contract changes; - data ownership, consistency, migration, and rollback; - security, privacy, reliability, performance, and cost implications; - developer and operator experience, dependencies, and failure modes; - implementation effort, time to value, reversibility, and lock-in.
Details
- Skill name
architecture-decision- Repository
- sandbaseai/workbuddy-skill
- Path
skills/architecture-decision/SKILL.md- License
- MIT
- Repo updated
- 8 September 2026
FAQ
What does the Architecture Decision skill do?
Use when a technical choice changes system boundaries, contracts, quality attributes, data, or operations and has meaningful reversal cost.
How do I install the Architecture Decision skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add sandbaseai/workbuddy-skill --skill architecture-decision. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Architecture Decision popular?
It lives in sandbaseai/workbuddy-skill, which has 9 GitHub stars and 3 forks.
Related skills
Access Control Security Best Practices
9sandbaseai/workbuddy-skill
Design, review, implement, and verify least-privilege access controls across users, services, tenants, resources, and administrative workflows.
Accessibility Review
9sandbaseai/workbuddy-skill
Use when reviewing a web interface or interaction for semantic, keyboard, focus, screen-reader, ARIA, and contrast accessibility risks.
Acquire Codebase Knowledge
9sandbaseai/workbuddy-skill
Use when the user asks to map, document, or onboard into an existing codebase and needs evidence-backed architecture, structure, conventions, integrations, testing, and concerns documentation.
Architecture Decision Records
9sandbaseai/workbuddy-skill
Use when making, reviewing, or maintaining a significant technical or architecture decision that needs durable context, alternatives, consequences, and follow-up evidence.
Architecture Blueprint Generator
9sandbaseai/workbuddy-skill
Use when analyzing an authorized codebase to produce an evidence-backed architecture blueprint, dependency map, diagrams, implementation patterns, and evolution guidance.
Architecture Friction Scan
9sandbaseai/workbuddy-skill
Use when assessing a codebase for evidence-backed opportunities to deepen shallow modules, improve locality and AI navigability, or reduce seam and testing friction before choosing a refactor.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.