Building with context For engineers
How we use the context of building Shifu to write about Shifu
We used Shifu to recover relevant product history, checked it against current project evidence, and turned the results into article briefs. The useful part was the connection between a source, an editorial choice, and a claim we could support.
The writing task started with a concrete request.
The request was to suggest blog topics about what we are building and why it matters. That could have produced a generic list about AI memory. We instead needed to recover the actual product direction, the engineering problems behind it, and work that could support a distinctive explanation.
The relevant history was not only a feature list. It included positioning choices, accepted tradeoffs, experiment results, and limits on what those experiments established. Those are inputs to writing because they change which story is credible and what the reader can take from it.
What the context retrieval contributed.
Shifu returned earlier positioning material about making decisions, constraints, and reasoning available for the next engineering task. Its coverage was partial and concentrated on positioning. It did not establish the recent implementation details or verified customer outcomes we would need for every possible article.
That result was useful, but incomplete. We checked the current editorial plan and repository reports directly. The current plan sharpened the audience and useful-guide direction. The evaluation reports supplied concrete stories about lost qualifications and an optimization that did not meet its release gates.
The workflow therefore used both retrieval and current inspection. A returned summary did not become the final authority merely because it was available. We kept the source date, distinguished intent from demonstrated behavior, and left gaps visible.
Trace a source into an editorial choice.
| Evidence available | Editorial choice | Claim boundary |
|---|---|---|
| Earlier product positioning about relevant recall | Explain why we are building a context engine | Describe product intent; do not infer measured productivity gains. |
| A controlled retention experiment found lost pending-state information | Write about important details a good summary can lose | Keep the experiment boundary and correlated-case limits visible. |
| A retrieval candidate improved some metrics but failed release gates | Explain an optimization we held back | Report the measured comparison, not the quality of later deployments. |
| The present topic-selection workflow | Show context applied to writing | Claim demonstrated topic selection and drafting, not automated editorial success. |
Carry the evidence into the draft.
For each article, we define the reader’s question, the artifact it should provide, the source-supported statements, and the unknowns. The writer works from that packet. An independent reviewer checks the claims against the sources rather than judging fluency alone.
For example, a study about model-rated planning quality can support an explanation of how we evaluated plans. It cannot support a sentence saying that customers shipped faster. A record of a rejected approach can explain the tradeoff without claiming that every alternative fails.
The same distinction applies to the writing workflow itself. During this launch work we have selected topics, prepared briefs, and drafted articles using build context. That is an actual application. Whether the articles help readers, earn citations, or lead to useful product use needs observation after publication.
Try the method on one explanation you need to write.
Choose a product update, technical article, release note, or retrospective. Start with the reader’s question rather than a request for a polished essay. Recover only the earlier context that changes the answer, then inspect the evidence behind the important claims.
Keep private source material out of the public draft. A useful explanation may need an anonymized aggregate, a synthetic example, or a concise methodology note rather than a screenshot of somebody’s work. Preserve limitations instead of trying to make every paragraph sound conclusive.
Reader question: what will this help someone do or decide?
Relevant history: decisions, alternatives, constraints, experiments.
Current state: what is implemented or verified now?
Source-to-claim map: which evidence supports each factual statement?
Unknowns: what would require another source or a real outcome?
Useful artifact: example, checklist, diagram, or decision table.
Review: can a reader use the result without the hidden history?The same understanding can support a different task.
The broader application is straightforward: the reason behind an engineering choice can help someone implement it, review it, explain it, or reflect on it. Those tasks need different selections and presentations of the same background.
That does not make a context engine an automatic writing system. The reader problem, editorial judgment, verification, and author responsibility remain. What can carry forward is the understanding that makes those decisions better informed.
Next time you need to explain a feature, try tracing three sentences back to the decisions or evidence behind them. The exercise quickly separates what you know, what you are interpreting, and what you still need to find out.
Sources and further reading
Prepared with AI assistance and reviewed for source fidelity and practical usefulness. Examples marked fictional are illustrations, not customer results.