Capstone roadmap
Use prompt moves that transfer
Strong prompts coordinate work: they assign a role, bound evidence, shape output, and invite correction.
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.
1Learn the idea
Read
Four moves that transfer
First, orient the model with the real audience and decision. Second, ground it in supplied sources. Third, constrain scope, format, and forbidden actions. Fourth, inspect by asking for assumptions, unsupported claims, or tests. Applied to this topic, those moves support plan and ship a personal knowledge assistant in staged, testable layers, not vague content generation.
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.
The likely useful output is: A dependency-aware roadmap that ships a narrow cited-answer slice early, then adds quality and operational layers behind explicit gates. Follow with a critic pass, not a request to “improve it”:
Audit the draft against the original contract. Return a table:
criterion | pass/fail | exact evidence | smallest correction.
Do not introduce new facts. List unresolved questions separately.
This second prompt changes the mode from creation to inspection. For alternatives, request deliberately different options and specify the axis of difference. For revision, name one defect and freeze everything else. For extraction, require a schema and define unknown/null behavior. For decisions, ask for criteria, evidence, assumptions, and sensitivity—not hidden private reasoning.
Read
Read the response as work
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.
Do not confuse fluent explanations with evidence. 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. The prompt is successful only when the resulting artifact survives an external check.
Read
Failure repair
Watch for building twelve disconnected demos; adding memory before correctness; no eval baseline; hidden infrastructure work; deploying without tracing or rollback. If the answer is too broad, shrink the deliverable. If it invents, tighten “use only” boundaries and require source labels. If formatting drifts, provide a short valid example and validate mechanically. If every option sounds alike, define meaningful axes. If revision damages good sections, quote the exact passage to preserve.
Keep prompt versions with short notes: what changed, why, and what happened. That creates transferable knowledge. Copying a “perfect prompt” without its data, risk level, and reviewer rarely does.
Continue learning · glossary & guides
- Which phrase in your prompt creates a verifiable source boundary?
- What external check remains necessary after the critic pass?
- Reference · Related concept
- Previous
- Next