Claude · Coding

Architecture

Get real design options and honest trade-offs, settle the interface in plan mode, and record the decision before it's lost.

Claude for architecture

From question to written decision

These cards form a sequence. Generate real options, each built around a different priority. Compare them in a table against criteria you've ranked. Design the interface of the winner before any code exists. Then write the decision down in your repo, so the reasoning outlives the session. You won't need all four every time. A small choice might only need the table, and a choice nobody will question doesn't need a record.

What Claude can and can't judge

Claude can read your code and reason about how an option fits it. It can't know your load next year, your team's skills or what you'd accept as a downside, so those have to come from you. It may also be out of date on libraries and prices, since Anthropic lists a reliable knowledge cutoff of June 2026 for its current models. Ask it to mark which claims come from your code, which from a source it checked, and which are assumptions. In Claude Code, use plan mode for this work, so edits stay blocked while you decide.

Frequently asked
Can Claude help with software architecture?

Yes, particularly at laying out options and consequences against your real code. Treat its answer as input. You have to supply the constraints and make the call, because Claude can't see your team or your future load.

How do I stop Claude writing code during a design discussion?

In Claude Code, use plan mode, which blocks edits until you approve. Press Shift+Tab or start your prompt with /plan. In the Claude app, say you want options only, and that it shouldn't build anything until you choose.

Which Claude model should I use for design work?

Try your default model with /effort high first. Anthropic's docs suggest Fable 5.1 for demanding reasoning, or when Opus 5.5 at higher effort still falls short. The opusplan setting uses Opus while planning and Sonnet while executing.

What is an ADR?

An Architecture Decision Record is a short file in your repo with a decision's context, the decision itself, its status and its consequences. The format comes from Michael Nygard's 2011 post. Claude can draft one from your discussion.