Architecture Kata

Practice architectural design with structured problems. Time-limited design challenges. Use for skill development, interviews, team exercises.

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-kata
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/architect-toolkit/skills/architecture-kata ~/.claude/skills/architecture-kata

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 Kata

Practice architectural design through structured, time-limited design challenges.

## Context

You are working on architecture kata. Design a system within constraints (time, technology, team). Iterate on design, gather feedback, refine. Read problem statement and constraints carefully.

## Domain Context

Based on architecture kata format (similar to code kata, but for design):

- **Problem Statement**: Requirements, constraints, scale, non-functional requirements
- **Time Box**: 30 minutes to 2 hours. Forces focus and trade-off decisions.
- **Constraints**: Limited technology choices, team size, deployment options. Realistic constraints teach design skill.
- **Feedback**: After kata, discuss solution with peers/mentor. Learn from different approaches.

## Instructions

1. **Read Problem**: Understand requirements. What's the core business problem? What's the scale? What's non-negotiable?

2. **Identify Constraints**: Technology choices? Team size? Deployment platform? Time-to-market? These shape design.

3. **Quick Design** (15-30 min):
   - Sketch components/services
   - Identify data model
   - Show communication patterns
   - Call out risks/trade-offs

4. **Document Decisions**: Why this architecture? What trade-offs made? What would you do differently at 10x scale?

5. **Discuss & Refine**: Present to peer or mentor. What would they do differently? Why? Learn from different perspectives.

## Anti-Patterns
Read the full skill on GitHub

Details

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

FAQ

What does the Architecture Kata skill do?

Practice architectural design with structured problems. Time-limited design challenges. Use for skill development, interviews, team exercises.

How do I install the Architecture Kata 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 Kata 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.