Architecture & Systems

Architecture & Systems skills for your AI agent.

Six skills for decisions that are expensive to reverse — where the boundaries go, what the data does under concurrency, what happens when a dependency degrades. Clean Architecture enforces the Dependency Rule so business logic survives a framework change. Domain-Driven Design finds the bounded contexts the business actually has. System Design sizes a system that doesn’t exist yet with back-of-the-envelope math. Data-Intensive Apps supplies the internals — isolation levels, replication lag, partitioning. Release It! covers the hostile half of a system’s life. High Perf Browser covers the last hop, from your server to a painted pixel.

An agent without these will happily propose a three-tier diagram and a database it has heard of. With them it names the failure mode it’s accepting when it picks a consistency model, tells you the partition key will hot-spot, puts a timeout on every outbound call because a call without one is an outage waiting for a slow afternoon, and says when layering would cost more than the complexity it removes.

6 skills · Updated · Free & MIT-licensed

02 Choosing

Which architecture skill do I need?

Route by what breaks, and when. Six symptoms, six answers.

Domain-Driven Design and Clean Architecture compound: one finds where the boundaries belong, the other decides which way dependencies cross them. Release It! is the one people install a week too late.

Find where the boundaries belong, then decide which way dependencies cross them.

04 Used by

Where these six
get sequenced.

Guides and guided journeys that run Architecture & Systems skills alongside the rest of the library — in the order that stops you fixing the wrong thing first.

01 How to Create a New App with AI Skills Go from concept to a well-architected, well-built app — validation, architecture, domain modeling, and clean code — with AI agent skills from Lean Startup, Clean Architecture, DDD, and more. 10 skills
3 architecture
02 How to Improve an Existing Website with AI Skills Diagnose and fix an underperforming website — conversion, usability, messaging, speed, and polish — with AI agent skills from Making Websites Win, Don't Make Me Think, Refactoring UI, and more. 8 skills
1 architecture
03 How to Improve an Existing App with AI Skills Fix how a shipped app feels — product fit, UX friction, visual hierarchy, microinteractions, in-app copy, and honest persuasion — with AI agent skills from Competing Against Luck, Don't Make Me Think, Refactoring UI, Influence, and more. 9 skills
1 architecture
04 From Vibe-Coded Prototype to Production-Ready Product A hands-on engineering playbook for turning an AI-generated prototype into something you can ship and operate — tests, structure, resilience, and scale — using AI agent skills from Clean Code, Refactoring, Release It!, and more. 9 skills
4 architecture
05 How to Refactor a Codebase Buried in Technical Debt A safe, incremental plan for taming a legacy codebase — characterization tests, seams, named refactorings, and boundaries — using AI agent skills from Working Effectively with Legacy Code, Refactoring, Clean Architecture, and more. 8 skills
3 architecture
06 How to Design the Best Possible Architecture for a New App Make the high-leverage architecture decisions right the first time — boundaries, domain model, data, and resilience — using AI agent skills from Clean Architecture, Domain-Driven Design, Designing Data-Intensive Applications, and more. 8 skills
5 architecture
07 Make a Slow App Measurably Faster An engineering playbook for a codebase that ships and earns but has grown slow and tangled — baseline, boundaries, hot paths, the real bottleneck, and the query layer — using AI agent skills from Working Effectively with Legacy Code, Clean Architecture, A Philosophy of Software Design, Refactoring, Release It!, and Designing Data-Intensive Applications. 8 skills
4 architecture
08 Create an App Idea → validated, well-architected app 10 skills
3 architecture
09 Improve a Website Diagnose, fix, and prove website improvements 8 skills
1 architecture
10 Improve an App Product, UX, copy, and in-app persuasion — fix what users feel 9 skills
1 architecture
11 Improve Code Quality Vibe-coded prototype → production-ready code 9 skills
4 architecture
12 Remove Technical Debt Pay down debt in place without stopping shipping 8 skills
3 architecture
13 Design Code Architecture Deliberate architecture for a new system 8 skills
5 architecture
14 Architecture Optimization Slow, tangled codebase → fast and cleanly bounded 8 skills
4 architecture

05 Questions

Before you install.

The four we get asked most about this stack. The generic ones — pricing, licence, agents — live on the library page.

01

Do System Design and Data-Intensive Apps cover the same ground?

They sit at different altitudes and are often installed together. System Design works at the level of boxes and numbers: which components, how many, how much traffic each absorbs, what the trade-off is. Data-Intensive Apps works inside the boxes — how a storage engine writes, what replication lag does to a read, why one isolation level permits a lost update. Use System Design to shape a proposal, Data-Intensive Apps to know what you just agreed to.

02

Do I need any of this for a straightforward CRUD app?

Probably less than you think, and Domain-Driven Design is the one to skip. Its own guidance says a genuinely simple domain makes the modelling ceremony rather than clarity. Clean Architecture also costs more than it returns on a small app. What still earns its place early is Release It! — every app calls something over a network, and timeouts and sensible failure behavior are cheap before launch and painful afterwards.

03

Why is High Perf Browser in the architecture category rather than design?

Because the decisions it governs are infrastructural, not visual. It’s about DNS, TCP and TLS round trips, HTTP/2 and HTTP/3 behavior, connection reuse and what actually blocks the critical rendering path — protocol-level choices that get baked into how you serve and cache. The visual side of perceived speed, like skeleton states and layout stability, belongs to Refactoring UI and Web Typography instead.

04

How does this compare to the Design Code Architecture journey?

The journey is for a new system, and sequences these skills in an order that stops later decisions being foreclosed by earlier ones — model, then boundaries, then capacity, then failure behavior. This category is for a system that exists and has a specific symptom: a hot shard, a thread pool exhausted by one slow vendor, a class nobody can place in a layer. One framework, aimed at the thing that’s hurting.

Every skill installs alone. The library installs together.

Install all six, or just one.

npx skills add wondelai/skills --all --global

MIT licensed · Claude, Claude Code, Codex, Cursor, OpenClaw, Hermes · No account

  We build the skills you already use. Now we’ll build yours. See what we build  ·  Book a 15-min call