architecture · davila7 — Claude Code skill: what it does, how to install
Guides architectural choices and helps document decisions through ADRs in Claude Code. Useful when structuring new systems.
npx claude-code-templates@latest --skill development/architectureWhat architecture does
This skill guides the agent through technical decision-making. It covers project classification and ADR templates. Tool access is limited to Read, Glob, and Grep.
Knowledge files remain modular. Guides like pattern-selection.md and trade-off-analysis.md address specific stages. The assistant reads only relevant files for a task, keeping context lean.
Simplicity comes first. You should add complexity only when strictly necessary. Before finalizing a design, a checklist confirms that the team can maintain it and that ADRs capture key trade-offs.
What it helps with
- document architecture decisions using structured ADR templates
- compare technical trade-offs across competing software patterns
- clarify system constraints prior to backend implementation
- validate architecture choices against team capabilities
Example prompts for the agent
- Help me evaluate database options for our SaaS backend and write an ADR
- Run through the context-discovery questionnaire for our new service
- Review our architectural assumptions using the trade-off checklist
How to install architecture
1claude-code-templates
npx claude-code-templates@latest --skill development/architecture2Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill architecture -a claude-code3Manually: put the files in place
~/.claude/skills/architecture/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/architecture/
Manually: put the files in place
.agents/skills/architecture/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/architecture/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates architecture2Manually: put the files in place
.github/skills/architecture/SKILL.mdPlatform CLI
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/development/architectureManually: put the files in place
.devin/skills/architecture/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about architecture
How do I install architecture in Claude Code?
Run npx claude-code-templates@latest --skill development/architecture in your terminal. Alternatively, install it via npx skills add davila7/claude-code-templates --skill architecture -a claude-code.
What is the architecture skill used for?
It provides a framework for evaluating technical trade-offs, choosing software patterns, and documenting system choices with ADRs.
Which tools does this skill require?
It relies exclusively on Read, Glob, and Grep. The assistant navigates local files without executing arbitrary build scripts.
Similar skills
All skills for Backend and APIs →architecture by other authors comes first.