Reference material fails when people can find it only after they already know the answer.
The practical check
Design internal documentation around the question a person has while doing the work.
Where AI fits
AI can group selected notes by the decision or task they support and flag gaps in the reader path.
The human decision
People decide what guidance is authoritative and maintain it as work changes.
The lesson
Documentation is useful when it helps someone act correctly at the moment they need it.
A Build Log companion follows the documentation path from a worker’s question to the authoritative guidance they need.
AI Skills
Use this lesson with the AI assistant you already use
Use this to prepare a reviewable next step without changing any system.
Paste the prompt, share only the context needed to answer it, and treat the result as a draft for your review. Do not include confidential information or let an AI assistant make changes without your approval.
Optional: for a visual report and saved memory, run /dxdev first.
Don’t have it? Get it at dxdev.com/skills/dxdev. The prompt works without it.
dxdev LESSON · paste into your AI agent
LESSON: Improve a documentation path
WHAT TO SHARE:
A de-identified description of the work, current evidence, and the decision you are considering.
ASK YOUR AGENT TO:
1. Separate confirmed facts from assumptions and unanswered questions.
2. Design internal documentation around the question a person has while doing the work.
3. Identify the narrowest useful next review step.
RETURN:
A short table with the evidence, uncertainty, human-owned decision, and next action.
BOUNDARY: Do not change records, contact anyone, route work, publish content, or act in an external system. A person must review the evidence and approve every consequential step.
