🏗️
WritingPython

Architecture Decision

by softspark

Architecture Decision is a Writing skill for Claude Code, published by softspark in ai-toolkit.

170 stars20 forkson softspark/ai-toolkitAdded 2026/09/08+2% in starsRepository updated 2026/09/07
ai-agentsai-skillsanthropicclaudeclaude-codeclinecodexcopilotcursorgeminimcpopencodetoolkitwindsurf
Install in seconds
Install Architecture Decision
Copy Architecture Decision into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/softspark/ai-toolkit/tree/main/app/skills/architecture-decision ~/.claude/skills/architecture-decision

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/softspark/ai-toolkit.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
app/skills/architecture-decision/SKILL.md in softspark/ai-toolkit
Installs to
~/.claude/skills/architecture-decision
Collection
One of 25 skills cataloged from this repository
Category
Writing1361 skills

What Architecture Decision does

Architecture Decision documents ADR, RFC, or RFD choices with context, constraints, options, trade-offs, recommendation, and consequences. Use it when deciding between architectural approaches or recording why a choice was made.

Architecture Decision is cataloged under Writing on DirSkills. Architecture Decision comes from a repository tagged ai-agents, ai-skills, anthropic, claude and claude-code.

Documentation

README

Architecture Decision Skill

Core Philosophy: "Everything is a Trade-off"

There are no "best solutions", only solutions with the right set of trade-offs for the specific context.

Decision Making Process (RFD / RFC)

  1. Context: What is the problem? Why now?
  2. Constraints: Budget, Time, Skillset, Legacy.
  3. Options: Propose at least 3 viable options.
  4. Trade-off Analysis: Compare constraints vs options.
  5. Recommendation: Choose one and justify.

Trade-off Analysis Matrix (Template)

This is the opening of the README. Read the full README on GitHub.

Commands Architecture Decision provides

Slash commands named in this skill’s SKILL.md, listed in the order they first appear.

  • /plan
  • /refactor-plan
  • /architecture-audit
  • /design-an-interface

Frequently asked about Architecture Decision

  • What else does softspark publish alongside Architecture Decision?

    Architecture Decision is one of 25 skills that DirSkills catalogs from softspark/ai-toolkit, the repository it ships in. Its siblings there include API Patterns, Accessibility Validator and Agent Creator. Each one is a separate skill with its own page in this directory, installs the same way Architecture Decision does, and is maintained by softspark in that same repository. The rest of the collection is listed on the softspark/ai-toolkit page.

  • How does Architecture Decision compare to other Writing skills?

    Architecture Decision ranks #1175 by stars among the 1361 Writing skills in this catalog. The most-starred ones next to it are Article Writing, Social Media Content Calendar and Knowledge Comic Creator. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Architecture Decision against them. Open each page to compare what they document and how they install.

More from softspark/ai-toolkit

Architecture Decision is one of 25 skills cataloged on DirSkills from softspark/ai-toolkit.

See all 25 skills
🔌
1h ago

API Patterns

API Patterns covers REST and GraphQL API design, including resource naming, versioning, pagination, idempotency, OpenAPI, error contracts, and safe retries. Use it when designing or reviewing API endpoints and failure responses.
AI Engineering
17020
1h ago

Accessibility Validator

Accessibility Validator scans a codebase for WCAG 2.1 AA, EN 301 549, and EAA issues without changing files. Use it to check contrast, keyboard support, ARIA, media, forms, and accessibility-statement compliance.
Quality
17020
🤖
1h ago

Agent Creator

Agent Creator creates new specialized agents with frontmatter, tools, model choice, and delegated skills. Use it when defining a new agent, routing triggers, or validating an agent scaffold.
AI Engineering
17020
🧩
1h ago

App Builder

App Builder scaffolds new projects for web, mobile, API, CLI, and AI apps using stacks like Next.js, Vite, Nuxt, Astro, FastAPI, Django, Laravel, React Native, and Flutter. Use it when starting a new app or choosing a starter architecture.
Automation
17020
🏗️
1h ago

Architecture Audit

Architecture Audit explores a codebase for architectural friction, shallow modules, and tight coupling. It surfaces candidates, compares interface designs, and files an RFC issue when you need to deepen a module boundary.
Quality
17020
📊
1h ago

Biz Scan

Biz Scan analyzes a codebase for business opportunities, KPI coverage, monetization gaps, and missing data exposure. Use it when you need an advisory report on analytics instrumentation and revenue-related surfaces.
Data
17020