Journal
13 articles1 series
Featured series / 8 parts
RAG, without the magic
A non-technical path from deciding whether retrieval belongs in the system to measuring which half failed.
Read the seriesAll articles
13
Article8 MIN readthe flat model could not hold a journal entry
i started monday trying to add a content type. by lunch i was rewriting the schema. an architecture pressure-test, in six phases, with one live smoke test that caught what static review didn't.
Read article
RAG without the magic / 0110 MIN readShould this be RAG?
A simple way to decide whether an application needs access to changing knowledge, more consistent model behavior, or both — without pretending retrieval or fine-tuning is magic.
Read article
RAG without the magic / 0215 MIN readWhat happens before the answer?
One common RAG path, explained without the product catalogue: how sources become searchable, how a question retrieves authorized evidence, and where either half can fail.
Read article
RAG without the magic / 0315 MIN readThe boundary becomes part of the answer
Chunking is not housekeeping. Where one passage ends changes what retrieval can find, what context survives, and which answer the system can support.
Read article
RAG without the magic / 049 MIN readHow does a search find the same idea in different words?
Embeddings can recover related phrasing, but related is not the same as relevant. A corrected mental model for representations, comparison functions, indexes, and compatibility.
Read article
RAG without the magic / 0510 MIN readSimilar is not relevant
Related passages are only candidates. A failure-led guide to eligibility, complementary retrieval, rank fusion, reranking, and returning enough context.
Read article
RAG without the magic / 0611 MIN readThe retriever got the wrong question
Clarify, rewrite, split, or chain before retrieval. A practical guide to query transformation that preserves intent, authorization, provenance, and stopping rules.
Read article
RAG without the magic / 0712 MIN readThe pipeline is part of the answer
Start with the fixed path. Add correction, durable routing, bounded tools, or graph retrieval only when a measured failure earns the additional mechanism.
Read article
RAG without the magic / 0817 MIN readThe answer failed. Which half broke?
Evaluate retrieval and generation separately, keep every failure replayable, and carry the result through experiments, monitoring, canaries, rollback, and incident review.
Read article
Article5 MIN readWork-state, not transcript
A cross-harness portability contract built from explicit work state: brief, phase, claim, instance, supersession, working tree, and decision log.
Read article
Article7 MIN readRules the agent runs into, not reads
What changed when IGRIS guardrails moved from prompt prose into write, phase, role, and commit boundaries, including where those boundaries still soften.
Read article
Article6 MIN readGrow the OS by declaring, not editing
IGRIS has declared doors for surfaces, modules, document types, cognition, and harnesses, with a different proof for each extension path.
Read article
Article7 MIN readSeven instances that propose. You approve.
A field note on separating autonomous inference from reviewed memory, and on the configuration paths that keep that boundary honest.
Read article