Documentation

Markdown looks like one language until the same file renders differently on GitHub, Hugo, Obsidian, or Pandoc. And the problem is not that Markdown is unreliable.

AI coding agents ship features fast, but specs, tests, and code quietly drift apart. This guide covers a traceability model, spec-to-test and spec-to-code mapping, and the CI checks that catch drift before a merge.

An LLM Wiki fails when old facts remain plausible, contradictions become polished, and generated summaries drift from their sources.

Spec-Driven Development works when the specification is a workflow, not a document you file away after kickoff. The point is not to produce a large product requirements document.

Spec-Driven Development is one of those ideas that software engineers have reached for before and then set aside when the effort stopped paying.

Decision records are the missing memory layer in AI-assisted software development. They capture not just what was built, but why — and that distinction becomes critical when AI tools are writing your code.

The premise is simple: compiled knowledge is more reusable than retrieved fragments. RAG became the default answer to a straightforward question - how do I give an LLM access to external knowledge?

A practical hub for document creation, formatting, conversion, and printing workflows using Markdown, LaTeX, PDF tools, and automation.