Software Design Reference Capstone · Overview

Capstone · Overview

The Worked Capstone

One initiative, documented twice — once by a lead who reasons from evidence, once by a lead who reasons from plausibility — with a reviewer's annotations explaining every difference in terms of forces, evidence and consequences.

Mission tie-in: the course's promise is judgment, and judgment is only visible in artifacts. This capstone is where the whole course becomes one thing you can show someone.

What the capstone is

Lessons 0039–0050 taught the initiative-leadership artifacts, one per lesson, using a single running case: a retailer's returns-resolution initiative. Lessons 0051–0060 then designed the system from scratch — subdomains, model, boundaries, state, invariants, components, contracts, data, style, release — on the same case.

Both sequences produce artifacts. Neither shows you the whole thing at once, with the reasoning that runs between the artifacts, the decisions that changed under evidence, and the numbers at the end. That is what the capstone is: the complete packet, worked end to end, with its costs and its misses visible.

It exists because the same fourteen artifacts can be produced at two completely different levels of quality, and the difference is not visible from a distance. Both packets here are professionally worded, internally consistent, and complete-looking. Only one of them could survive contact with evidence. Learning to tell them apart on sight — in your own work first — is the capability this course is for.

The case, in one paragraph

The brief: “Build a self-serve returns portal by Q3. It needs automated approvals, carrier labels, and status notifications.” The reality behind it: eligible domestic returns wait a median of 72 hours for an agent decision, and 41% of them produce a support contact. The initiative's outcome is to get resolution under 4 hours and cut contacts by a quarter, without raising fraud loss, without a manual review queue above 50/day, and with WCAG 2.2 AA on the critical flows — with a pilot open by 30 September. The order platform stays authoritative, the carrier contract is fixed, and no payment data enters the new module. Seven people, ten weeks.

How it joins Phase IV to Phase V

The two phases are usually taught as separate skills — “leading an initiative” and “designing a system”. They are not separate. Each initiative artifact is the input to a design decision, and each design artifact is only defensible because of the initiative evidence behind it. The capstone's job is to make those joints visible.

Where the two packets meet
Phase IV artifactFeedsPhase V artifactThe joint, in this case
Initiative frame (0039)→Subdomain classification (0051)“Eligibility is where the differentiation and the legal risk live” is a claim the frame's outcome and guardrails have to support — otherwise it is an opinion about which code is interesting.
Workflow / EventStorming map (0041)→Domain model and boundaries (0052, 0053)“Approved” meaning three different things to support, warehouse and finance is workshop evidence. It becomes three owners of three facts.
Acceptance examples (0042)→State machine and invariants (0054, 0055)“A retried label call must not buy a second label” is an example first and a uniqueness constraint second.
Architecture drivers (0043)→Architecture style (0059)D1 and D2 together make a synchronous carrier call impossible. The style is the consequence, not the starting point.
Data and contracts (0045)→Contracts and data model (0057, 0058)The idempotency key chosen in the initiative packet is the same key the API contract publishes and the store enforces.
Rollout contract (0049)→Deployment and release design (0060)The pilot's staged exposure becomes the pipeline's permanent canary and its rehearsed reversal path.
Closeout (0050)→All of itSuperseded ADRs, retained fitness functions, and a recorded debt with an interest rate are what the next initiative inherits.

How to use it

The order matters. Reading the strong packet before writing your own produces a good imitation of someone else's reasoning; writing first produces your own.

  1. Build yours first. Use your own initiative if you have one, or the returns case if you do not. Blank versions of all fourteen artifacts are in the template pack. Lesson 0050's capstone exercise gives a 90-minute working-session version if you want a first pass quickly; the full packet is a weekend.
  2. Self-review before the reveal. The capstone assessment has a self-review pass to run before you look at the worked version — that comparison is the most informative one you will get, and you only get it once.
  3. Read the strong packet. Read the connecting prose, not only the tables. Follow the “Traces to” line under each artifact.
  4. Read the weak packet. Then write down the three sentences in it you would have accepted without question a year ago. Almost everyone finds some.
  5. Read the reviewer notes, which put the two side by side per artifact and name the rubric dimension each difference touches. Finish with the ten-step comparison and the self-review checklist at the end.
  6. Score with the rubric, twice: once on your own reading, once after the annotations. The gap between the two scores is your next practice.
  7. Turn it into evidence. The portfolio guide covers anonymising a real initiative, the executive summary, the technical-review version, and how to narrate your own contribution in an interview.
A word on the numbers. The figures in both packets belong to the case. They are internally consistent and each one in the strong packet carries a source line, because a source line is the habit being taught — but they are a teaching fixture, not industry data, and the people are fictional. Do not cite them outside this course.

The strong packet

Read it → The complete initiative and system-design packet: fourteen artifacts, every one traced to an outcome, assumption, driver, risk or rollout decision. Two decisions change under evidence, two dissents are recorded with the conditions that would prove them right, three options are compared and two rejected in writing, and the closeout reports one outcome met, one missed by 0.6 points, and the packet's own weakest piece of evidence.

The fourteen artifacts · both versions
#ArtifactStrongWeakNotesTaught in
1Initiative frame, with version historyframeframenotes0039
2Assumption map with evidence and testsassumptionsassumptionsnotes0040
3Current-state and target workflowworkflowworkflownotes0041, 0052
4Story map and release slicesstory mapbacklognotes0042
5Acceptance examples for rules and failuresexamplescriterianotes0042
6Prioritized architecture driversdriversNFRsnotes0043
7C4 context, container and dynamic viewsviewsarchitecturenotes0044, 0059
8State machine and contract reviewstate & contractsdata & APInotes0045, 0054, 0057
9Option comparison and a completed ADRoptions & ADRdecisionnotes0046
10Walking skeleton and delivery/dependency mapskeletonsprint plannotes0047
11Team charter and decision rightscharterways of workingnotes0048
12Test, telemetry and staged rollout planrollouttest & releasenotes0049, 0060
13Weekly initiative review (week 3)reviewstatusnotes0050
14Closeout: outcome, ownership, removal, learningcloseoutlaunch summarynotes0050

The weak packet

Read it → The same initiative, documented as a competent-but-junior lead would: outputs framed as outcomes, assumptions stated as facts, a to-be flow with no current state, a flat backlog organised by layer, non-functional requirements that no design could fail, a C4 “container diagram” that is a technology inventory, a status column any caller can set, one option presented as a decision, a launch to 100% behind a flag, a weekly status reporting velocity, and a closeout that ships and moves on.

It is deliberately not a straw man. Every page in it would be approved in a great many organisations, and several of them contain things the strong packet also has — a feature flag, a dashboard, an accessibility item, an ADR. The differences are not presence and absence; they are whether each artifact can be wrong.

Comparing them

The reviewer notes → pair the two packets artifact by artifact. Each pairing quotes both versions, explains the difference in terms of the forces at play, the evidence available and the consequences that follow, and links to the rubric dimension it is scored on. Judgments about taste are excluded on purpose: if a criticism cannot be phrased as “this artifact does not let a reader make decision X, and here is what happens when the evidence changes”, it does not appear.

The page ends with a ten-step routine for comparing your own packet, and a 34-line self-review checklist you can run before anyone else sees your work.

Where to go from here
You want to…Go to
Score a packet on twelve dimensions with behaviourally anchored levelsassessments/rubric.html
Run the capstone assessment, including the self-review before the revealassessments/capstone.html
Start your own packet from blank artifactstemplates/index.html
Turn a real initiative into portfolio evidence, anonymisedportfolio/index.html
Re-read the method behind each artifactreference/initiative-playbook.html
Practise the same judgment on an inherited system instead of a new onecases/brownfield-modernization.html
Practise changing a decision when evidence arrivescases/decision-change-simulations.html
Before you start
  1. Name the last initiative you led or worked on. Which of the fourteen artifacts existed for it, in any form?
  2. Of the ones that existed, how many could have been wrong — that is, could have been falsified by something that actually happened?
  3. Which artifact's absence cost you the most, and how did you find out?