Skip to main content
INSIGHTS

Essays on getting the logic right before build

A reading path for PMs, engineers, and operators dealing with messy workflows, hidden exceptions, and AI-built software. Start with the big picture, then move into extraction method, outputs, diagnostics, and failure modes.

Spot hidden workflow risk

See where exceptions, overrides, and undefined terms usually slip through before build.

Learn the extraction pattern

Understand how strong PMs, analysts, and consultants turn messy explanations into reviewable logic.

See what good output looks like

Read essays that include rules, gaps, source trace, and the structures engineering actually needs.

Abstract illustration for the article Why AI coding makes requirement ambiguity more expensive
Requirements

Part 01 of 08

Why vague logic ships

Start here

Why AI coding makes requirement ambiguity more expensive

March 29, 20267 min read

AI can turn half-specified workflow logic into plausible software fast. That makes hidden rules, exceptions, and approval paths more expensive than before.

Why read this

Why AI makes vague workflow logic riskier, not safer
A concrete example of hidden branches turning into wrong software
Read the full essay

Reading path

Continue through the series

Read in order or jump to the piece you need. The sequence moves from the big picture to extraction method, reviewable outputs, hidden logic diagnostics, and downstream automation risk.

Abstract illustration for the article Why experts explain better than they document
Extraction

Part 02 of 08

Extraction beats transcription

March 30, 202611 min read

Why experts explain better than they document

AI made coding cheap. It did not make judgment legible. The new bottleneck is turning tacit workflow logic into something teams can actually review before build.

Inside this essay

Why transcripts and summaries are weaker than they look
What reviewable first-pass extraction should actually produce
Read essay
Abstract illustration for the article How to extract rules from SMEs without wasting their time
Guide

Part 03 of 08

How to pull out the real rules

March 30, 202610 min read

How to extract rules from SMEs without wasting their time

Good extraction is not generic meeting hygiene. It is knowing how to turn vague expert language into thresholds, branches, gaps, and reviewable logic before the call ends.

Inside this essay

A five-step extraction loop you can reuse on real workflows
How to force vague SME language into testable rules and explicit gaps
Read essay
Abstract illustration for the article The meeting is not the output: what a good SME call should produce before build
Artifacts

Part 04 of 08

Meetings must become logic

March 30, 20269 min read

The meeting is not the output: what a good SME call should produce before build

A good SME call should leave behind a reviewable package of rules, flow, pseudo-code, scenarios, gaps, and source trace engineers and coding agents can build from.

Inside this essay

What a strong extraction session should actually produce
Why transcripts and summaries collapse at handoff time
Read essay
Abstract illustration for the article The Ask Dan Test: How to spot tribal knowledge before it breaks AI-built software
Tribal Knowledge

Part 05 of 08

Ask Dan is a system smell

March 30, 20268 min read

The Ask Dan Test: How to spot tribal knowledge before it breaks AI-built software

Coding got democratized faster than expert business-logic extraction. Use the Ask Dan Test to spot undocumented production logic before it hardens into brittle automation or confidently wrong AI-built software.

Inside this essay

A simple test for spotting workflows that still depend on hero knowledge
Why tribal knowledge is a production risk, not just a documentation gap
Read essay
Abstract illustration for the article Why automation projects fail before the code: the undocumented logic problem
Automation

Part 06 of 08

Process visibility is not decision clarity

March 30, 202610 min read

Why automation projects fail before the code: the undocumented logic problem

Most automation failures are diagnosed at the code, tool, or AI layer. The deeper failure is older: teams automated a cleaned-up story about the workflow before they extracted the real decision logic.

Inside this essay

Why many teams automate the picture instead of the rules
The automation-readiness checklist before build starts
Read essay
Abstract illustration for the article Why coding agents need a logic twin, not a transcript
Agents

Part 07 of 08

Agents need reviewed logic

March 30, 202611 min read

Why coding agents need a logic twin, not a transcript

Claude Code, Codex, Cursor, VS Code, and Copilot-centered workflows are fast builders, but they still guess when business rules stay trapped in summaries, tickets, and transcripts. A reviewable logic twin gives them something safer to build from.

Inside this essay

How logic twins fit into Claude Code, Cursor, VS Code, Copilot, and Codex workflows
Why a logic twin is safer than prompting from transcripts and process summaries
Read essay
Abstract illustration for the article Code throughput is up. Logic throughput is not.
Throughput

Part 08 of 08

The constraint moved upstream

March 31, 202612 min read

Code throughput is up. Logic throughput is not.

Software production capacity is rising fast. The next constraint is the rate at which teams can extract, clarify, and maintain business logic before engineers and coding agents build from it.

Inside this essay

Why faster code creation does not mean faster shared understanding
Why business logic extraction is now a control problem, not an afterthought
Read essay