GROUND
Problem
What becomes confusing, fragile, or impossible without understanding teach every earned layer? This lesson answers that through explanation, a worked example, two runnable exercises, and a reference solution. No teacher-supplied worksheet is required.
Distributed architectures address concrete capacity, reliability, and coordination limits—but often arrive before those limits do.
LEARN
Concept explanation
Teach every earned layer belongs to “Capstone: rebuild and teach”. teach every earned layer is retrieval day: rebuild core behavior without notes, then compare evidence and teach corrections.
For teach every earned layer, trace concrete input, state transition, output, and failure through an architecture decision tied to explicit requirements, estimates, state ownership, failure modes, and measured limits.
Start with requirements and estimates, choose the smallest architecture, locate its first bottleneck, then evolve one measured constraint at a time. Apply that model to supplied normal, boundary, and failure cases; each case below names its input and expected evidence.
Evidence produced by the teach every earned layer experiment: output, state, trace, bytes, timing, or diagnostics.
Condition that must remain true while inputs or implementation of teach every earned layer change.
Point where teach every earned layer crosses ownership, representation, time, process, network, or trust.
Example bank
Compare normal, boundary, failure, and cross-layer cases. Predict each observation before revealing the explanation.
SETUPClose notes and recreate teach every earned layer from blank starting state using: Rebuild semantic HTML/CSS, JavaScript behavior, local storage, server persistence, profiling, and hardening.
OBSERVERebuilt version reproduces Published artifact works, is inspectable, measured, accessible, recoverable, and teachable without hidden AI output.; correction log names every memory gap.
WHY IT MATTERSThis isolates the normal contract of teach every earned layer; preserve its raw evidence as the control for every later comparison.
SETUPWithout rereading, predict and handle: Run without framework, network, script, or server where each fallback applies.
OBSERVERecord what remains invariant and the first representation, owner, size, or timing value that changes in Architecture notebook · load tests · traces · Git history.
WHY IT MATTERSA boundary example is useful only when one named dimension changes and everything else stays comparable.
SETUPDiagnose from memory, then consult reference only after capturing evidence: Inject one failure at every earned boundary and document recovery.
OBSERVECapture the first divergence from the baseline, including exact input, diagnostic, state, and recovery result. Expected recovery: Rebuilt version reproduces Published artifact works, is inspectable, measured, accessible, recoverable, and teachable without hidden AI output.; correction log names every memory gap.
WHY IT MATTERSThe diagnostic is part of the interface. Repair the proven cause, not the most visible symptom.
SETUPTrace teach every earned layer one layer below its usual abstraction through an architecture decision tied to explicit requirements, estimates, state ownership, failure modes, and measured limits.
OBSERVETrace requests, state ownership, capacity, queues, caches, replication, failure domains, recovery, operational load, and cost.
WHY IT MATTERSThe lower layer is earned when it explains evidence the current layer cannot. Otherwise keep teach every earned layer at the simpler boundary.
SEE
Worked example
Start from supplied design.md. Focus: Close notes and recreate teach every earned layer from blank starting state using: Rebuild semantic HTML/CSS, JavaScript behavior, local storage, server persistence, profiling, and hardening.
- Run: Fill design.md, then verify every component traces to one stated requirement or measured constraint.
- Save baseline evidence. Trace requests, state ownership, capacity, queues, caches, replication, failure domains, recovery, operational load, and cost.
- Boundary case: Without rereading, predict and handle: Run without framework, network, script, or server where each fallback applies.
- Failure case: Diagnose from memory, then consult reference only after capturing evidence: Inject one failure at every earned boundary and document recovery.
RESULT
Rebuilt version reproduces Published artifact works, is inspectable, measured, accessible, recoverable, and teachable without hidden AI output.; correction log names every memory gap. Starter-level baseline: Document names one action, target, non-goal, numeric estimate, state owner, request path, bottleneck, and recovery procedure.
START HERE
Starter material
PREREQUISITESA plain-text editor, Git, and tools named by the weekly slice. Start from a blank directory.
ONE-TIME SETUPmkdir reforging-capstone && cd reforging-capstone && git init
Create design.md, paste this exact content, then run the command below.
# teach every earned layer
## Requirements
- One primary user action:
- One reliability target:
- One explicit non-goal:
## Estimate
- Requests/second:
- Stored bytes/day:
- Peak concurrent work:
## Smallest design
- State owner:
- Request path:
- First bottleneck:
- Recovery procedure:
Fill design.md, then verify every component traces to one stated requirement or measured constraint.STOP / CLEANUPStop any process started by your slice with Ctrl+C; run git status before leaving.
DO WITH GUIDANCE
Guided exercise
Rebuild from memory: teach every earned layer
- Normal case: Close notes and recreate teach every earned layer from blank starting state using: Rebuild semantic HTML/CSS, JavaScript behavior, local storage, server persistence, profiling, and hardening.
- Write predicted evidence from this named case before running starter.
- Close notes, recreate core example, compare with reference, then explain corrections.
- Run exact normal case. Save commands, inputs, outputs, and diagnostics in notebook.
- Explain changed evidence using lesson mental model in no more than five sentences.
Concrete guided solution
- Copy the supplied design.md unchanged and run: Fill design.md, then verify every component traces to one stated requirement or measured constraint.
- Write this prediction before inspecting output: Rebuilt version reproduces Published artifact works, is inspectable, measured, accessible, recoverable, and teachable without hidden AI output.; correction log names every memory gap.
- Perform only the named normal case: Close notes and recreate teach every earned layer from blank starting state using: Rebuild semantic HTML/CSS, JavaScript behavior, local storage, server persistence, profiling, and hardening.
- Save the raw output, then annotate input → transition → evidence. Use Architecture notebook · load tests · traces · Git history to confirm the transition rather than inferring it.
- Compare prediction with evidence; if they differ, keep both and write the rule that explains the difference. Reference baseline: Document names one action, target, non-goal, numeric estimate, state owner, request path, bottleneck, and recovery procedure.
DO ALONE
Independent exercise
Teach at three depths: teach every earned layer
- Create second case from blank file: Without rereading, predict and handle: Run without framework, network, script, or server where each fallback applies.
- Then create controlled failure: Diagnose from memory, then consult reference only after capturing evidence: Inject one failure at every earned boundary and document recovery.
- Use Architecture notebook · load tests · traces · Git history to prove behavior, then repair controlled failure.
- Compare result against supplied acceptance checks and reference approach before marking complete.
Concrete independent solution
- Duplicate the starter into a clean comparison case; change only this boundary: Without rereading, predict and handle: Run without framework, network, script, or server where each fallback applies.
- Save its evidence beside the baseline and identify the first changed value. Trace requests, state ownership, capacity, queues, caches, replication, failure domains, recovery, operational load, and cost.
- Create the exact controlled failure: Diagnose from memory, then consult reference only after capturing evidence: Inject one failure at every earned boundary and document recovery.
- Write interface and expected evidence for teach every earned layer from memory before creating implementation.
- Rebuild smallest baseline and run: Rebuild semantic HTML/CSS, JavaScript behavior, local storage, server persistence, profiling, and hardening.
- Add boundary and failure cases without notes: Run without framework, network, script, or server where each fallback applies. / Inject one failure at every earned boundary and document recovery.
- Compare against prior week artifact; record omissions and wrong assumptions.
- Correct, rerun until Published artifact works, is inspectable, measured, accessible, recoverable, and teachable without hidden AI output., then teach cause-and-effect at three depths.
- Rerun baseline, boundary, and repaired failure together. Accept only if all reproduce: Rebuilt version reproduces Published artifact works, is inspectable, measured, accessible, recoverable, and teachable without hidden AI output.; correction log names every memory gap.
COMPARE
Expected result
- Rebuilt version reproduces Published artifact works, is inspectable, measured, accessible, recoverable, and teachable without hidden AI output.; correction log names every memory gap.
- Document names one action, target, non-goal, numeric estimate, state owner, request path, bottleneck, and recovery procedure.
- Controlled teach every earned layer failure produces captured evidence; repair restores stated invariant without hiding error.
PROVE
Acceptance checks
Lesson is complete only when every check is true. Each check is stored locally and travels with your JSON backup.
0/5 complete · saved on this device
UNSTICK
Hints
Reveal hints
- Start with supplied normal case exactly as written: Close notes and recreate teach every earned layer from blank starting state using: Rebuild semantic HTML/CSS, JavaScript behavior, local storage, server persistence, profiling, and hardening.
- For boundary case, change only named dimension: Without rereading, predict and handle: Run without framework, network, script, or server where each fallback applies.
- If result is confusing, diff raw inputs and evidence before editing implementation.
- If tool shows nothing useful, move observation one boundary lower: representation, runtime, OS, or network.
VERIFY
Solution
Attempt both exercises before opening reference approach.
Reveal reference solution
- Run unmodified starter and preserve baseline evidence: Document names one action, target, non-goal, numeric estimate, state owner, request path, bottleneck, and recovery procedure.
- Write interface and expected evidence for teach every earned layer from memory before creating implementation.
- Rebuild smallest baseline and run: Rebuild semantic HTML/CSS, JavaScript behavior, local storage, server persistence, profiling, and hardening.
- Add boundary and failure cases without notes: Run without framework, network, script, or server where each fallback applies. / Inject one failure at every earned boundary and document recovery.
- Compare against prior week artifact; record omissions and wrong assumptions.
- Correct, rerun until Published artifact works, is inspectable, measured, accessible, recoverable, and teachable without hidden AI output., then teach cause-and-effect at three depths.
PREDICT · INSPECT · BREAK · DEBUG · MEASURE
Interrogate reality
Prediction: write expected output, state transition, ordering, and failure evidence before running either exercise.
Inspection: Trace requests, state ownership, queues, caches, replication lag, failure domains, cost, and recovery procedures.
Measurement: Estimate traffic, storage, latency, throughput, availability, consistency windows, operational load, and cost.
Capture raw evidence before explaining.
Change one assumption and force controlled failure.
Find cause with Architecture notebook · load tests · traces · Git history before editing fix.
MASTERY + FRONTIER + BOUNDARY
Own the knowledge
Explain teach every earned layer at beginner, intermediate, and senior depth.
Recreate smallest useful example from blank file without notes or AI.
Schedule recall for day 1, 7, 30, and 90.
Creative frontier lab
Try first without opening the solutions. The constraints invite invention; the reference gives one concrete direction, never the only valid answer.
Re-solve teach every earned layer by removing the most convenient abstraction. delete one service and recover the requirement with the smallest capable layer.
CONSTRAINTKeep the same inputs, observable result, and failure evidence; change the means, not the contract.
ORIGINAL IDEATurn subtraction into a design tool: the missing abstraction should reveal which responsibility it used to hide.
Reveal frontier solution
- Freeze the contract as three fixtures: Close notes and recreate teach every earned layer from blank starting state using: Rebuild semantic HTML/CSS, JavaScript behavior, local storage, server persistence, profiling, and hardening. / Without rereading, predict and handle: Run without framework, network, script, or server where each fallback applies. / Diagnose from memory, then consult reference only after capturing evidence: Inject one failure at every earned boundary and document recovery.
- List every convenience used by the starter; remove the highest-level one while preserving Fill design.md, then verify every component traces to one stated requirement or measured constraint..
- Implement the smallest replacement using delete one service and recover the requirement with the smallest capable layer.
- Run all fixtures and compare raw evidence. Keep the simpler version unless the removed abstraction has a demonstrated benefit.
Build an explanation artifact for teach every earned layer: trace each component to a requirement, estimate, owner, failure domain, and observable signal.
CONSTRAINTA peer must be able to locate the first divergence without reading implementation code.
ORIGINAL IDEATreat the explanation itself as a product: make invisible transitions visible, replayable, and diffable.
Reveal frontier solution
- Create one row or timestamped event for each transition in: Close notes and recreate teach every earned layer from blank starting state using: Rebuild semantic HTML/CSS, JavaScript behavior, local storage, server persistence, profiling, and hardening.
- For every row record input, representation, owner, operation, output, and tool evidence from Architecture notebook · load tests · traces · Git history.
- Replay Without rereading, predict and handle: Run without framework, network, script, or server where each fallback applies.; highlight only changed rows.
- Replay Diagnose from memory, then consult reference only after capturing evidence: Inject one failure at every earned boundary and document recovery.; stop at the first divergent row and attach its recovery action.
Combine the boundary and failure into a new user-visible scenario for teach every earned layer. turn a failure drill into a user-visible recovery story with explicit invariants.
CONSTRAINTDo not merely add more input. Invent a recovery interaction, alternate representation, or self-checking behavior.
ORIGINAL IDEAMake the system teach its own limits: the artifact should expose the invariant and offer a safe next action when it breaks.
Reveal frontier solution
- Combine these two pressures without changing them: Without rereading, predict and handle: Run without framework, network, script, or server where each fallback applies. AND Diagnose from memory, then consult reference only after capturing evidence: Inject one failure at every earned boundary and document recovery.
- Name the invariant that must survive and the user-visible evidence when it cannot: Rebuilt version reproduces Published artifact works, is inspectable, measured, accessible, recoverable, and teachable without hidden AI output.; correction log names every memory gap.
- Implement this original direction: turn a failure drill into a user-visible recovery story with explicit invariants.
- Demonstrate baseline, combined failure, recovery, then baseline again; save the sequence as a regression fixture.
Capability frontier
Push teach every earned layer until another layer becomes justified. Record one robust technique, one contextual trade-off, and one labeled hack or historical curiosity.
CORE · PRACTICAL · CONTEXTUAL · HACK · FRAGILE · HISTORICAL · GOLF
Boundary
No diagram removes physics, coordination, product ambiguity, or operational responsibility.
If this vanished tomorrow…
Collapse toward one process, one machine, files, SQLite, explicit protocols, and manual recovery until the true minimum appears.
Why next layer is earned
The next layer is another year of rebuilding, publishing, source reading, and measured production work.