Capstone: Build a World Model Dossier

LESSON

World Modeling Foundations

008 25 min beginner CAPSTONE

Capstone: Build a World Model Dossier

By the end of this lesson, you will be able to...

  • Build a small world model dossier with a purpose, boundary, variables, proxies, feedback, uncertainty, and evidence.

  • Compare an initial model with an alternative and state what each one can and cannot explain.

  • Define update triggers, a review date, and a rubric for deciding whether the model should be repaired, narrowed, or retired.

Idea in one sentence: A world model dossier is a compact, inspectable argument about a situation, including the evidence and conditions that could change it.

Core Insight

The track began with a useful warning: a model is a purposeful simplification, not reality in a smaller box. The capstone turns that warning into an artifact another person can inspect.

Imagine an engineering team that has missed three delivery dates. A manager proposes adding two engineers. A product lead proposes freezing scope. A staff engineer points to review queues and rework. Each person has a plausible model. None is yet a dossier.

A dossier makes the disagreement concrete:

What decision are we making?
What part of the situation are we modeling?
Which variables and signals support the claim?
What is uncertain or hidden?
Which alternative model would change the decision?
What observation would make us revise or retire this model?

The goal is not to produce a perfect theory of delivery. The goal is to produce a small model that improves one decision and leaves its assumptions visible.

The Scenario

The team owns a service used by an internal operations group. It planned 12 work items for a six-week cycle. Seven shipped by the target date. The other five were delayed, and two of the seven required follow-up fixes.

The team has these observations:

Signal Recent observation What it might mean
Planned items 12 Scope may be too large, or planning may be stable.
Items on time 7 of 12 Delivery reliability is below the promise.
Median review wait 3.5 days Work may be waiting rather than being built.
Unplanned work 20% of team time Interruptions may change the flow.
Post-release fixes 2 of 7 items Rework may be feeding future delay.
Team size 6 engineers Capacity is visible, but not necessarily the constraint.

The decision is deliberately narrow:

For the next six-week cycle, should the team add capacity, reduce committed scope, or change the review and rework process?

This is enough pressure for a useful model. It is not enough evidence for certainty.

Constraints

Every dossier needs constraints. Without them, a model can quietly expand until it explains nothing.

For this scenario, use these constraints:

Constraints are not an inconvenience added after the “real” reasoning. They define what the model is allowed to claim.

Design Goal

Write the goal as a decision and an outcome, not as a wish to understand everything.

Decision: choose the smallest intervention for the next six-week cycle.
Desired outcome: increase on-time delivery without increasing harmful rework.
Success signals: on-time rate, review wait, unplanned-work share, and escaped fixes.
Review point: the end of the next cycle, with a weekly check for early drift.

The phrase “without increasing harmful rework” matters. A team can ship more items by skipping tests, then pay for that speed later. The model must keep the trade-off visible.

Proposed Model

Build the dossier in layers. Each layer should answer one question.

Purpose and boundary

Purpose: choose an intervention that improves reliable delivery in one cycle.
Inside: planned work, review flow, unplanned work, rework, and staffing.
Outside: market demand, individual motives, company politics, and long-term architecture.

The boundary does not say that outside forces are unimportant. It says they will not be modeled in detail for this decision.

Variables, signals, and proxies

Thing that matters Observable signal Proxy risk
Work entering the cycle committed items plus unplanned items A ticket count can hide effort differences.
Flow through the team cycle time and review wait Averages can hide a few very old items.
Reliable delivery on-time items without urgent follow-up “Shipped” can ignore rework.
Quality cost escaped defects and post-release fixes A short cycle may not reveal later defects.

The model does not pretend that a signal is the outcome itself. It records how the signal can mislead us.

Feedback and delayed consequences

The initial causal sketch is:

More committed work
  -> more parallel work
  -> longer review wait
  -> more context switching
  -> more defects and rework
  -> less capacity for planned work
  -> more pressure to commit too much

There is a delay between skipping review and seeing a production fix. That delay can make a bad intervention look successful during the first week.

Uncertainty and alternatives

Use ranges and competing models instead of one confident story.

Current on-time rate: about 50-70%, depending on how “on time” is counted.
Review-wait contribution: likely material, but not yet separated from item size.
Unplanned-work share: roughly 15-25% over recent cycles.

Keep three small models:

Model Main question Intervention it favors Blind spot
Flow and capacity Is too much work entering or waiting? Reduce scope or limit parallel work. It may miss why work arrives late.
Review and quality Is review delay and rework consuming capacity? Shorten review queues and protect test time. It may understate demand pressure.
Scope and incentives Are commitments rewarded more than reliable outcomes? Change planning rules and success measures. It is harder to test in one cycle.

The portfolio is disciplined because every model has a question, signal, decision, and blind spot.

Walkthrough: From Dossier to Decision

Start with the naive recommendation:

Add two engineers. More people create more delivery capacity.

Now trace what the dossier predicts.

Step Expected transition Intermediate signal Decision implication
1 Add two engineers to a six-person team. Team size rises, but onboarding consumes experienced time. Do not count new capacity as immediate.
2 More work is started. Work in progress and review wait rise. Capacity has not become flow.
3 Review remains a bottleneck. Median review wait stays above three days. Adding people may increase waiting.
4 Rework arrives after release. Escaped fixes rise in the next weeks. Early shipment numbers are incomplete.

The alternative intervention is narrower:

Commit 10 items instead of 12, limit work in progress,
assign a daily review owner, and reserve 15% capacity for fixes.

That intervention makes a different prediction:

If review wait is a main constraint, median review wait should fall below two days,
on-time delivery should rise, and escaped fixes should not rise after the cycle.

The model is now useful even if the prediction fails. A failure would tell us whether review wait was not the main constraint, whether the signal was poorly measured, or whether another model deserves more weight.

Evidence Review Meeting

Treat the dossier as a living handoff, not a document that is written once and filed away. The team reviews the same claims at three points.

Review point New evidence What the team should ask
Week 1 Review wait falls to 2.4 days, but one urgent request interrupts the plan. Is the flow change working, or is the sample too small?
Week 3 Eight of ten committed items are on track; unplanned work is 18%. Does the improved signal hold when demand changes?
Week 6 Ten items ship on time; one needs a follow-up fix; no dependency-blocked item is counted as a team miss. Did the intervention improve reliable outcomes, or only the visible count?

The dossier should record these updates rather than silently overwriting its first version. A short log might look like this:

Initial claim: review wait is a major constraint.
Week 1: plausible, but evidence is thin; keep the test running.
Week 3: prediction is holding; continue the flow intervention.
Week 6: on-time rate improved without a large quality penalty.
Next trigger: if review wait rises above three days for two weeks,
or escaped fixes exceed two items, reopen the model.

This log makes uncertainty operational. The team does not need to pretend that the first explanation was complete. It needs to show how observations changed confidence and action.

What the Dossier Is Not

The capstone artifact is not a project plan, a dashboard export, or a long explanation of every possible cause. It is also not a verdict about who is responsible for a failure.

A project plan tells people what to do. A dashboard displays selected signals. A dossier explains why selected signals support a bounded decision, where they can mislead, and what would cause an update. The same team may need all three, but they answer different questions.

Keep the artifact small enough to review. If a reader cannot locate the purpose, boundary, prediction, and update trigger in a few minutes, remove detail or move it to supporting evidence. The model should be compact; the evidence behind it can be larger.

Failure Review

Before accepting the dossier, try to break it.

Boundary challenge

What if a major dependency outside the team blocks two items? The dossier should mark those items as dependency-blocked instead of calling every delay a team-flow problem. If dependency failures are common, the boundary must be widened or the decision narrowed.

Proxy challenge

What if “on-time delivery” rises because the team splits large items into tiny tickets? Track item size, outcome completion, and follow-up fixes. A better-looking proxy can still hide a worse result.

Feedback challenge

What if the rework signal appears only after the cycle ends? Keep the weekly review, but do not declare success until the delayed signal arrives. A delayed consequence is still part of the model.

Assumption challenge

What if the team has no control over review ownership? Then the proposed intervention is not actionable. Replace it with a decision the team can actually make, or state the dependency as an explicit constraint.

Alternative-model challenge

What if the flow model predicts improvement but the scope-and-incentives model predicts repeated overcommitment? Do not average the models into a vague score. Run the smallest test that distinguishes them, such as comparing committed scope with completed outcomes for one cycle.

Trade-offs

A dossier improves judgment by making a model inspectable. It also creates work.

It helps when:

It costs:

It does not guarantee:

The boundary is visible when the dossier becomes a polished report no one uses, when its signals arrive too late for the decision, or when every failure produces an untestable new explanation.

Evidence and Readiness

Use this readiness rubric before sharing the dossier.

Criterion Ready when... Warning sign
Purpose One decision and one outcome are explicit. The dossier tries to explain the whole organization.
Boundary Included and excluded forces are named. Important actors disappear without explanation.
Variables Each central variable has a signal or evidence plan. Labels such as “culture” replace observations.
Proxies Each proxy has a known failure mode. A dashboard number is treated as the outcome.
Dynamics At least one feedback loop or delay is traced when relevant. Only first-order effects are considered.
Uncertainty Ranges, confidence, or missing evidence are visible. The language is certain while data is thin.
Alternatives At least one competing model could change the decision. One explanation is protected from challenge.
Update rule A time, prediction, and disconfirming signal are stated. The model cannot be proven wrong.
Trade-off Cost and remaining limits are explicit. The recommendation sounds free and universal.

Readiness does not mean “true.” It means another person can inspect the claim, challenge it, and help update it.

Final Challenge: Build Your Dossier

Choose a bounded question from work, study, health, a product, or a personal project. Avoid a question so broad that it has no decision owner. Then produce a one- to two-page dossier with these headings:

  1. Decision and purpose — What choice will this model support?
  2. Boundary — What is inside, outside, and temporarily ignored?
  3. Variables and signals — What matters, what can you observe, and what is only a proxy?
  4. Mechanism — What changes what? Include a feedback loop, delay, or state transition when relevant.
  5. Evidence and uncertainty — What do you know, how strongly, and what is missing?
  6. Alternative models — What other explanation could guide a different action?
  7. Prediction and update trigger — What should happen, by when, and what would force a revision?
  8. Trade-offs and limits — What becomes more expensive, and what remains unsolved?

Your dossier is ready when a skeptical reader can answer three questions without asking you to fill in the blanks:

What decision does this model support?
What observation could change it?
What should we do if that observation appears?

What Comes Next

This track stops at the point where a human model becomes explicit, revisable, and useful for a bounded decision. The next tracks deepen different parts of the practice:

The dossier is a handoff artifact. It lets those deeper tracks challenge a model without first having to guess what the model was.

Resources

Key Takeaways

PREVIOUS Model Failure and Repair