// RECORDED: 2025-12-28

Why Clients and Contractors Prefer to Fight Later

There is a strange paradox in software. Everyone knows fixing a bug in production costs 10x more than fixing it on a whiteboard. Yet, in most projects, both client and contractor silently agree to skip the design document.

They don't say it out loud. They use code words like "Agile" or "Moving Fast." But the result is always the same: a vague plan, a rush to code, and a brutal, expensive conflict after delivery. Why do rational people prefer a post-delivery fight over a pre-delivery plan? Because of the Ambiguity Alliance.

1. The Client's Trap: "I'll Know It When I See It"

For a customer, a design document is terrifying because it requires Decisive Imagination.

• Fear of Commitment: Writing down "The button does X" feels final. Keeping it vague feels like keeping options open.
• The Illusion of Speed: To a non-technical founder, a week spent on a flow diagram looks like stalling. A week spent building a broken login screen looks like "momentum."

2. The Contractor's Trap: "Ambiguity is a Shield"

For the developer, the design document is often viewed as unpaid admin work.

• The "Agile" Excuse: Many devs use "Agile" as a synonym for "Cowboy Coding."
• Protection: If I build based on a vague chat and it fails, I can blame "changing requirements."
• The Billing Trap: It's hard to bill 20 hours for "thinking." It's easy to bill 20 hours for "implementation."

3. Why We "Prefer" the Fight

The fight that happens after delivery is painful, but it is tangible. When a client screams, "Why doesn't the report export to PDF?", that is a concrete problem with a concrete solution. Contrast this with a design phase where the question is abstract. Humans prefer solving concrete problems over abstract ones.

The Fix: The "Zero-Friction" Doc

The only way to stop this cycle is to make the design document so cheap to produce that there is no excuse to skip it. This is where the LLM + Diagram-as-Code stack becomes a negotiation tool.

• Don't ask the client to write specs. Interview them, record it, and feed the transcript to an AI.
• Generate the Visualization instantly using tools like Mermaid.
• Perform a "Pre-Mortem": Point to a box in the diagram and ask, "What happens here?"

Force the conflict to happen on the diagram, not in the code. A fight over a flowchart costs $10. A fight over a finished app costs the entire budget.