Page 6 of 8~116 min topic

Capstone Roadmap

Scope → vertical slice → ground → evaluate → harden → deploy → monitor

This page advances one continuous project: a personal knowledge assistant that answers questions from approved notes with citations.

~14 min this pageWorkflow loop

1Learn the idea

Read

Create a loop with a human gate

Run a visible loop for a personal knowledge assistant that answers questions from approved notes with citations: prepare the approved inputs, request a bounded output, validate it against the evidence, revise one issue, and send it to the named human gate. Each pass should leave a small record: input version, prompt version, output, reviewer decision, and unresolved question.

Do not turn a draft step into an irreversible action. The workflow stops when a citation cannot point to a source span, the evaluation set is missing, or a proposed feature has no user need. A stop is useful information: it tells you which approval, source, or test is missing. Once the gate approves, archive only what policy permits and note what should be monitored after release.

Read

A decision record for this scenario

Write a short record before you move on. For a personal knowledge assistant that answers questions from approved notes with citations, state the claim or choice under review, then name the evidence that supports it: a source-linked answer, a small held-out question set, trace records, and a milestone demo. Next, name what the evidence does not establish. This last line prevents a narrow test from becoming a broad promise. If another team member opened your record next month, they should be able to reproduce the review without trusting your memory.

Now make the trade-off visible. A mentor reviewing whether a learner can make sound engineering trade-offs may value speed, clarity, cost, control, or reassurance differently. Explain which of those mattered in the current version and why. Do not let a model choose the trade-off simply because it can produce a confident answer. The responsible owner decides whether the upside justifies the remaining uncertainty.

Finally, connect the decision to a next action. If the current evidence is enough, identify the smallest safe step forward. If it is not, request a specific source, approval, or test. The stop condition remains concrete: a citation cannot point to a source span, the evaluation set is missing, or a proposed feature has no user need. A documented pause is a successful outcome when it keeps a weak result from becoming a consequential one.

Go deeper

Before you start

Why this matters

Picture the moment before you begin work on a personal knowledge assistant that answers questions from approved notes with citations. The person depending on it is a mentor reviewing whether a learner can make sound engineering trade-offs. Write down one fact that must remain exact, one choice a person—not a model—must make, and one condition that would make you pause. Your three notes are a better starting point than a broad request for “something good.” In this topic, the result is a gated roadmap, a working vertical slice, and evidence from each milestone; it earns trust only when another person can see how it was made and where its limits are.

In the wild

See how this idea shows up as a product and a company — then come back to the lesson. Skills transfer across vendors.

Check your understanding

Page assessment

Answer from memory. Completion is saved from this evidence, not from opening the next page.

1. Can you name the user, artifact, and accountable reviewer?
2. Which supplied fact would most change the result if it were wrong?
3. What evidence makes the output reviewable?
4. What permission or risk boundary is specific to this job?
5. What does the workflow do when it cannot safely continue?

All responses are required.