Design Code Architecture
Deliberate architecture for a new system
Takes you from an app idea to a deliberate architecture: boundaries, domain model, data decisions, and resilience, making only the expensive-to-reverse decisions and deferring the rest. It orchestrates its eight skills phase by phase, asking you the decision questions at every step and recording every result in your project's docs/ folder so the journey resumes across sessions.
What is the Design Code Architecture journey?
Architecture is the set of decisions that are expensive to reverse, so this journey makes only those — deliberately, before a first sprint sets them by accident. Eight phases cover boundaries, the domain model, honest sizing, data and consistency, failure handling and scope, writing each choice and its alternatives into docs/.
One prompt runs it
npx skills add wondelai/skills/design-code-architecture --global This skill is compatible with Claude, Claude Code, Claude Cowork, Codex, Cursor, OpenClaw, Hermes Agent, and other agentskills.io-compatible agents.
Example prompts for the Design Code Architecture journey
We're starting a new service — design the architecture with me, decision by decision. using design-code-architecture skill
New service kickoffRun the architecture journey for this system; default to a modular monolith. using design-code-architecture skill
Modular monolith defaultResume the architecture design from the decision log. using design-code-architecture skill
Resume journeyWhen to use Design Code Architecture — and when not to
Reach for it when
- Design a new system's structure before the first sprint locks it in
- Draw boundaries and model the domain so the code speaks the business language
- Size the system honestly and skip the scaling machinery you don't need
- Make data, consistency, and failure-handling decisions explicitly
- Cut speculative abstractions with an appetite-bounded review
Reach for something else when
- You want one storage or consistency question settled — Data-Intensive Apps answers it directly, no journey required.
- The product idea is still unvalidated — Create an App tests the riskiest assumption before committing to any structure.
- A weekend prototype needs hardening before launch — Improve Code Quality starts from a safety net, not a blank page.
- Boundaries need drawing inside a system already in production — Remove Technical Debt does that without a rewrite.
Frequently asked questions
How do I install the Design Code Architecture journey?
Run npx skills add wondelai/skills/design-code-architecture --global. It takes about 30 seconds and needs no account. The Design Code Architecture skill then works in Claude, Claude Code, Claude Cowork, Codex, Cursor, OpenClaw and Hermes Agent — anything that reads the open agentskills.io format — and your agent loads it on its own when a task calls for it. It is free and MIT-licensed, and the source is at https://github.com/wondelai/skills.
Which skills does the Design Code Architecture journey run, and what does it produce?
It orchestrates 8 skills across 8 phases — Clean Architecture, Domain-Driven Design, System Design, Data-Intensive Apps, Software Design, Release It!, Pragmatic Programmer, The 37signals Way — asking you one decision question per phase. Each answer is written to your project's docs/ folder (docs/ARCHITECTURE.md, docs/TECH-DEBT.md, docs/RELIABILITY.md, docs/TESTING.md, docs/DESIGN-CODE-ARCHITECTURE-PLAN.md), so the journey survives across sessions and you keep the reasoning, not just the output.
How do I know I need a whole journey rather than one decision?
Count the open questions. If you can already name the boundaries, the domain language, the real load and the storage model, you have an architecture and need only the phase that closes the one gap — Data-Intensive Apps for storage, Release It! for failure behaviour. The journey earns its cost when several of those are still assumptions, because each phase’s answer constrains the next one’s options.
Does this always end in a modular monolith?
Often, but not by rule. The System Design phase asks how little system your real load actually needs, and for most products the honest answer is one deployable with firm internal boundaries. If load, team topology or compliance say otherwise, the phase says so, and docs/ARCHITECTURE.md records the reasoning along with the alternatives you rejected. What the journey resists is distributing a system for reasons of fashion.
The last phase cuts things. What does it cut?
Speculative abstraction — the plugin system for the one plugin, the repository interface over the one database, the queue for traffic you do not have. The 37signals phase asks what is essential for v1 and reviews everything the previous seven phases proposed against an appetite. Cuts and their reasoning go to docs/ARCHITECTURE.md and docs/TECH-DEBT.md, so a later session can reopen a decision instead of rediscovering it.
How much existing code is too much for this journey?
A tracer bullet is fine — the Pragmatic Programmer phase actively wants a thin slice through every layer to prove the boundaries hold. A few weeks of feature work is fine too. Once the structure is load-bearing and people are working around it, you are past the point where choosing is cheap, and Remove Technical Debt is the journey that changes boundaries in a running system.
Install Design Code Architecture
Free, open-source, and ready in 30 seconds.
npx skills add wondelai/skills/design-code-architecture --global MIT Licensed · Works with Claude, Claude Code, Claude Cowork, Codex, Cursor, OpenClaw, Hermes Agent & other agentskills.io agents · No account needed
Don’t guess your AI engineering level.
Measure it.
AI Developer Scorecard
How production-grade is your AI engineering?
Twenty-five questions across the practices that separate vibe-coding from production-grade engineering. Instant score, per-section breakdown, and a 30/60/90-day playbook.
Score 0–75 · 30/60/90-day playbook Score yourself For CTOs & foundersCTO Scorecard
Is your engineering team ready for AI at scale?
Twenty-five questions on how your org adopts AI — adoption, governance, automation, and ROI. See where you sit on the path from Reactive to Strategic Leader.
Score 0–75 · Reactive → Strategic Leader Score your orgWe build the skills you already use. Now we’ll build yours.
Sprints from $3K · shipped to production, or you don’t pay the final milestone.