Architecture Decision

Use when a technical choice changes system boundaries, contracts, quality attributes, data, or operations and has meaningful reversal cost.

9 stars 3 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sandbaseai/workbuddy-skill --skill architecture-decision
Manual install
git 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-decision

Personal 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.
Read the full skill on GitHub

Details

Skill name
architecture-decision
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

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.