Chapter BCapstone roadmapPage 1 of 8

Capstone roadmap

Start with the job to be done

Frame the outcome, evidence, and human decision before asking the model to produce anything.

~12 minJob framing

1Try it yourself

Playground

Capstone roadmap

Tap each layer — one Personal Knowledge Assistant, built across existing labs.

Before you start

Why this matters

Without opening an AI tool, write the acceptance test for this job: plan and ship a personal knowledge assistant in staged, testable layers. Name one fact that must be exact, one judgment a person must make, and one condition that should stop the workflow. Compare your answer with the professional standard below; the gap is what you should practice.

2Learn the idea

Read

Define the professional job

The working assignment is to plan and ship a personal knowledge assistant in staged, testable layers for a mentor or hiring manager reviewing engineering judgment. That sentence is narrower than “use Capstone roadmap.” It identifies a deliverable and a reviewer. Write a definition of done with three layers: the output must satisfy the audience's need; factual or functional claims must be traceable; and a named person must own the final decision. One evolving codebase tells a stronger story than twelve unrelated labs. Every layer must improve a user outcome and leave evidence that the improvement is real.

Start by separating tasks. The model may draft, classify, transform, compare, or suggest. It may not silently approve, publish, grade, deploy, cite, or consent on someone's behalf. For this assignment the authoritative material is one user problem, success metric, constraints, architecture sketch, milestone dependencies, evaluation set, risk register, and weekly capacity. Anything absent from those inputs is either an explicit assumption or an unanswered question.

Read

Convert the job into a contract

Use this prompt as a realistic starting contract:

Turn this capstone goal into six two-week milestones: an assistant answers questions from my approved notes with citations. Sequence API, structured output, retrieval, citations, tools, memory, evals, injection defense, tracing, retries, deploy, and monitoring. For each milestone define a demo, test, dependency, risk, and stop rule. Do not pretend all layers fit at once.

Notice what the prompt does: it states the setting, limits the output, names forbidden behavior, and requests evidence that can be reviewed. It does not ask the model to “make it amazing.” If a constraint matters, make it testable. Replace “be accurate” with a source boundary, formula check, test command, rights ledger, or approval step.

A useful response would look like this: A dependency-aware roadmap that ships a narrow cited-answer slice early, then adds quality and operational layers behind explicit gates. That description is intentionally observable. “Looks good” is not acceptance. The operator must demo each milestone against golden tasks, inspect citations, run eval gates, test hostile inputs, review traces, exercise retries, and rehearse rollback. Keep the source material beside the draft so review means comparison, not memory.

Read

Scope and stop rules

Run the work through scope → vertical slice → ground → evaluate → harden → deploy → monitor. Stop when an authoritative input is missing, a high-risk claim lacks evidence, private material cannot be safely removed, or the proposed action exceeds the permission granted. Escalation is successful workflow behavior, not model failure.

Common framing mistakes are building twelve disconnected demos; adding memory before correctness; no eval baseline; hidden infrastructure work; deploying without tracing or rollback. Prevent them by writing a one-paragraph job card: user, decision, deliverable, source of truth, constraints, reviewer, and stop condition. This card becomes the anchor for every later prompt.

Checking tutor…

Continue learning · glossary & guides
  • Can the job be completed and reviewed without guessing its purpose?
  • Which action remains owned by a person, and what evidence will that person inspect?
  • Reference · Related concept
  • Next