Ousios
AI Documentation Sprint ยท Sample

Cadence infrastructure โ€” knowledge handoff

What's safe, what's still in one head โ€” told honestly, before the expert leaves.
PREPARED WITH CADENCE (SYNTHETIC) ยท EXPERT: DEPARTING SR. INFRA ENGINEER ยท 5-DAY SPRINT ยท OUSIOS LLC
Coverage Captured owner-independent, handoff-tested Partial documented, gaps flagged At-risk still in one head

The sprint & the decisionWhy we ran this

Cadence's senior infrastructure engineer is leaving in six weeks. Most of what they hold is in their head. Over five days we triaged their domains by risk ร— opacity, captured the highest-risk ones into runbooks a different engineer can run, and produced an honest map of what's safe and what's still a single point of failure. We deliberately did not try to document everything โ€” we targeted the red.

Coverage at a glance โ€” up top, by designThe bus-factor verdict

Verdict

Two of three critical systems are now owner-independent. The deploy pipeline and the incident response path are captured and handoff-tested. One remains a single point of failure: the legacy billing reconciliation job โ€” and we flagged it honestly rather than fabricate steps no one could confirm.

If the engineer left tomorrow: deploys and incidents are safe; billing reconciliation is not.

Coverage: 2 CAPTURED ยท 1 PARTIAL ยท 1 AT-RISK โ€” closing plan on the red below.

The bus-factor mapEvery system, rated honestly

SystemCoverageStatus โ€” and what it'd take to close
Deploy pipelineCapturedFull runbook; a second engineer ran a deploy unaided on Day 5. Owner-independent.
Incident responseCapturedOn-call runbook + escalation path documented and walked through. Handoff-tested.
Monitoring / alerts configPartialDocumented, but two alert thresholds are the engineer's judgment, not written rules โ€” flagged below.
Legacy billing reconciliationAt-riskA nightly cron only this engineer fully understands. Needs a dedicated half-day session to capture safely; we refused to guess the steps.

What got capturedThe durable runbooks

  • Deploy pipeline runbook โ€” prerequisites, steps in order, rollback path, the three decision points, and every dependency named.
  • Incident response runbook โ€” triage, escalation, the "who to wake and when" path, and the two failure modes that actually recur.
  • Forward spec: the queue migration โ€” the in-flight project, documented from day one so it never becomes next year's at-risk item.

The flagged gaps โ€” honest, not fabricatedWhat we deliberately did not invent

Still at risk โ€” flagged, not filled

An AI told to "just document it" would have written confident steps for all of these. We didn't โ€” because the engineer couldn't confirm them, and a guessed runbook is worse than a known gap.

  • Billing reconciliation cron: the failure-recovery procedure exists only as the engineer's intuition. Needs a half-day capture session before they leave โ€” booked for next week.
  • Two monitoring thresholds: set by feel, not rule. Flagged for the engineer to write down the actual logic, not for us to reverse-engineer a plausible number.
  • One vendor account: recovery access path unconfirmed. Listed as unknown, not assumed.

The flagged-gap list is part of the deliverable. Honest "we couldn't verify this" beats a confident guess that fails the day it's needed.

The discipline, made visibleHow this sprint works โ€” and why it isn't "ask AI to document it"

AI accelerates the drafting. It cannot know what it wasn't told โ€” so the discipline is verification and honest gaps, not speed.

  1. Triage by risk ร— opacity Target what hurts most if it walks and is least written down โ€” not the easy wins.
  2. Extract & structure Facilitated capture; AI drafts runbooks, marking anything inferred as a gap to confirm.
  3. Spec the forward work Document what's being built next, so it's never retro-captured later.
  4. Verify โ€” expert signs off, gaps flagged Every step confirmed by the person who holds it; nothing invented.
  5. Handoff + the bus-factor map A different engineer runs a green runbook unaided; red is shown as red.
Ask AI to document from a transcriptThis sprint
Invents the steps it wasn't toldFlags the gap, never fabricates it
Gaps look filled โ€” confidently wrongGaps shown honestly as at-risk
No idea what it doesn't knowExpert confirms every procedure
A doc only its author can followHandoff-tested by someone else
A clean-looking liabilityAn honest coverage verdict

A confident doc that fabricates the parts no one checked is worse than no doc. The product is knowing, honestly, what's still at risk.

SAMPLE / SYNTHETIC ยท The Cadence infrastructure handoff is invented to demonstrate the method; no real person, company, or system is referenced. Flagged gaps are illustrative of the discipline (flag, never fabricate). ยท Method: Ousios AI Documentation Sprint (spec 22 + SOP-12) ยท The Architect (secondary The Craftsman) ยท Aspen Grove brand ยท Ousios LLC ยท 2026-06-23