Architecture Principles

Define foundational architecture principles and decision-making rules. Communicate guidelines across organization. Use when establishing architectural standards or updating strategy.

48 stars 10 forksSoftware Development Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add sethdford/claude-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sethdford/claude-skills --skill architecture-principles
Manual install
git clone --depth 1 https://github.com/sethdford/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/architect/architecture-governance/skills/architecture-principles ~/.claude/skills/architecture-principles

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 Principles

Establish foundational principles that guide architectural decisions and align organization.

## Context

You are defining architecture principles for the organization. Create clear, memorable guidelines that inform decisions. Involve stakeholders from product, engineering, and operations.

## Domain Context

Based on architecture governance frameworks (TOGAF, Gartner):

- **Guiding Principles**: High-level philosophy (e.g., "Cloud-first", "Stateless services", "API-driven")
- **Decision Rules**: Specific rules derived from principles (e.g., "Use managed databases not self-hosted" from "Minimize operational burden")
- **Trade-off Hierarchy**: When principles conflict, which takes priority? Performance vs Cost? Consistency vs Availability?
- **Exemptions**: Clear process to override principles; document why and remediation plan
- **Communication**: Memorability matters; short, actionable, memorable

## Instructions

1. **Identify Core Values**: What matters to the organization? Speed of innovation? Cost efficiency? Security? Reliability? List top 3-5.

2. **Derive Principles**: Turn values into principles. "Speed of innovation" → "Ship independently without central coordination". "Cost efficiency" → "Use managed services to reduce operational overhead".

3. **Make Principles Memorable**: Use simple language. "Move fast with confidence" better than "Implement robust CI/CD pipelines". Acronyms help: KISS (Keep It Simple, Stupid).
Read the full skill on GitHub

Details

Skill name
architecture-principles
Path
architect/architecture-governance/skills/architecture-principles/SKILL.md
License
MIT
Repo updated
11 March 2026

FAQ

What does the Architecture Principles skill do?

Define foundational architecture principles and decision-making rules. Communicate guidelines across organization. Use when establishing architectural standards or updating strategy.

How do I install the Architecture Principles skill?

Claude Code plugin: /plugin marketplace add sethdford/claude-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Architecture Principles popular?

It lives in sethdford/claude-skills, which has 48 GitHub stars and 10 forks.

Related skills

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