Kofi E. Ampaabeng

Selected Work

20 systems I have architected, built and run: enterprise platforms, consumer apps, and the tools and infrastructure behind them. 20+ years across regulated banking, data platforms and applied ML.

20
systems
6
enterprise
7
ML · LLM
20+
years

20 · ADRs, contracts, runbooks

Architecture governance

Every decision recorded, every tool specified, before it is built.

Decisions, tool contracts, state machines and an operations runbook that needs no AI live in the repos beside the code, each with its status and the commit it was checked against.

  • Infrastructure

Surfaces

  • Docs
  1. 01Decisions as ADRs — each with status, date, scope, decision and consequences.
  2. 02A contract per tool — each stamped with the commit it was verified against.
  3. 03State machines before code — every entity's states drawn and linted, with a conformance verdict.
  4. 04A runbook that needs no AI — eighteen sections of exact commands, each with its verification.
  5. 05Tickets in the repo — follow-ups filed beside the code they change.
  • 24 ADRs
  • 22 tool contracts
  • 18 runbook sections
SurfacesDocs
DECIDESPECIFYBUILDOPERATEADRsstatus · scopeState machineslintedTool contractsTools and manifestsTicketsOperations runbookDocs site
Architecture, drawn from the codeServiceStoreModel usedModel trained hereFeedback
  • Markdown
  • Mermaid
  • ADRs
  • State-machine linter
  • GitLab