Home/How we work/Architect
How we work

Scope creep is an architecture failure.

Most disputed change requests trace back to a boundary nobody drew. So we draw it — what gets built, what stays, and where each number comes from — and everybody signs it before a line is written.

Thirty minutes · no predetermined package

The boundary document
signed before the first commit
1page
DecisionWhich wayWhy
Lead record ownershipwe buildthe model is the constraint
Dialerstaysthe product is fine
Commission calculationwe buildnothing else can hold it
Accountingstaysintegrate, do not replace
Reportingwe buildreads the operational records
Document storagestaysno reason to move it
3 built, 3 stay, 0 ambiguousthis is the contract, not the estimate
6
Six decisions, no ambiguity
every one made before code
What gets drawn

Three documents, one page each.

Longer than that and nobody reads it, which defeats the point.

01

The current state — every system, what it holds, and which fields overlap.

02

The intended state — the same picture after the work, with the differences marked.

03

The boundary — what we build, what stays configured, and what nobody touches.

04

The ownership table — per field, which system wins when two disagree.

05

The first slice — what ships first, and why that piece rather than another.

06

What we are deliberately not solving, which is usually the longest list.

Why it matters

The document that makes change a decision.

01Who owns each field when two systems disagree?Answered here or discovered in production. Those are the only options.
02What are we deliberately not solving?The longest list, and the one that prevents the most arguments.
03Which piece ships first, and why that one?Usually the intake path, because being wrong there is cheapest to correct.
04What has to keep working throughout?Integration work happens on a running business. The rollback path matters more than the plan.
05What would make us stop and redraw?Named in advance, so nobody has to be brave about raising it.
06Who signs this, and did they read it?One page exists so the answer to the second part can be yes.
Questions

What people ask about the architecture stage.

What is the boundary document?

One page stating what gets built, what stays configured, and what nobody touches. Signed before any code, and referred to whenever scope is questioned.

Why draw before building?

Because a wrong data model is expensive to unwind and a wrong feature is not. The decisions made in this week are the ones that are hard to reverse.

What if the architecture turns out wrong?

It sometimes does, and the document says what would make us redraw. Changing the picture deliberately is cheaper than discovering it during delivery.

Does this slow the project down?

It moves a week from the end to the beginning. Projects without it spend that week arguing about scope in month three.

Who needs to sign it?

Whoever will be asked to approve a change later. If they did not read the picture, they will dispute the boundary.

Can we use this with a different developer?

Yes. It is a description of your systems and your decisions, not a proposal.

The method

Where this sits.