Skip to main content
The Hard Parts.dev
EP-38 Team EP Engineering Playbook
Difficulty medium-high Owner · decision owner

Facilitate a difficult technical disagreement

Turn argument into decision quality by clarifying the actual choice, separating evidence from identity, and designing a process where trade-offs are compared explicitly rather than won socially.

Difficulty
medium-high
Time horizon
hours to days depending on importance
Primary owner
decision owner
Confidence
high
At a glanceEP-38
Situation
A technical disagreement is blocking progress or damaging team alignment.
Goal
Reach a credible decision without suppressing disagreement or letting status dynamics decide the outcome.
Do not use when
the issue is not actually technical but a hidden ownership or priority problem
Primary owner
decision owner
Roles involved

facilitatordecision ownerrelevant technical expertsstakeholders affected by the choiceoptional architect or manager when authority needs support

Context

The situation

Deciding whether to reach for this playbook: when it fits, and when it doesn't.

Use when

Conditions where this playbook is the right tool.

  • A technical choice is stuck between strong competing views
  • The argument has started to damage trust or delivery speed
  • People are repeating positions instead of learning from each other
  • The same issue keeps reopening because the decision never actually settled

Stakes

Why this matters

What this playbook protects against, and why skipping or half-running it tends to be expensive.

Bad disagreement handling does two kinds of damage: the wrong technical decision and the wrong social lesson. People either learn that force wins, or that silence is safer than clarity.

Quality bar

What good looks like

The observable qualities of a team or system that is actually doing this well. Not just going through the motions.

Signs of the playbook done well

  • The actual decision is framed clearly
  • Participants understand the trade-off, not only their preferred option
  • Evidence and constraints are visible
  • The final call is legible even to people who preferred another option
  • The disagreement reduces future confusion rather than generating resentment

Preparation

Before you start

What you need available and true before running the procedure. Skipping this is the most common reason playbooks fail.

Inputs

Material you'll want to gather first.

  • Decision statement
  • Constraints and goals
  • Options under consideration
  • Known risks and dependencies
  • Decision owner or approving authority

Prerequisites

Conditions that should be true for this to work.

  • The choice can be stated clearly
  • Participants are willing to compare trade-offs rather than only defend identity
  • Someone can actually decide or ratify the decision

Procedure

The procedure

Each step carries its purpose (why it exists), its actions (what you do), and its outputs (what you produce). Read the purpose. It's what keeps the step from degenerating into checklist theatre.

  1. State the decision in one sentence

    Stop the room arguing three different questions at once.

    Actions

    • Write the exact decision to be made
    • Name the constraints that matter most
    • Separate this decision from adjacent but separate debates

    Outputs

    • Decision frame
  2. Surface the real trade-offs

    Move from preference to comparison.

    Actions

    • List the options and what each optimizes for
    • Capture hidden costs, dependencies, and second-order effects
    • Ask what would have to be true for each option to be good

    Outputs

    • Trade-off matrix
  3. Separate evidence from status

    Reduce social distortion in the room.

    Actions

    • Require claims to be tied to examples, constraints, or prior evidence
    • Draw out quieter voices before converging
    • Call out when authority or confidence is replacing argument quality

    Outputs

    • Evidence-backed option notes
  4. Choose with explicit reasoning

    Make the decision legible and durable.

    Actions

    • Record the chosen option and why it won under current conditions
    • Note what was accepted as downside
    • Document what would cause the decision to be revisited

    Outputs

    • Decision record
  5. Close the argument productively

    Prevent social residue from undermining execution.

    Actions

    • Summarize what was learned from the disagreement
    • Clarify who owns execution and follow-up
    • Invite future evidence, not repeated personality conflict

    Outputs

    • Execution and review plan

Judgment

Judgment calls and pitfalls

The places where execution actually diverges: decisions that need thought, questions worth asking, and mistakes that recur regardless of good intent.

Decision points

Moments where judgment and trade-offs matter more than procedure.

  • What exact choice are we making?
  • Which constraints actually matter most here?
  • What evidence is strong enough to change minds?
  • Who owns the final call if the room does not converge?

Questions worth asking

Prompts to use on yourself, the team, or an AI assistant while running the procedure.

  • What exact decision are we making right now?
  • What does each option optimize for, and what does it make worse?
  • What evidence would actually change the outcome?

Common mistakes

Patterns that surface across teams running this playbook.

  • Letting the debate expand into adjacent unresolved topics
  • Treating consensus as mandatory when a real owner exists
  • Allowing loudness or seniority to end the discussion
  • Failing to record why a choice was made

Warning signs you are doing it wrong

Signals that the playbook is being executed but not landing.

  • The same people are defending identity, not comparing trade-offs
  • Quieter participants stop contributing early
  • The final answer is a vague compromise nobody believes in
  • The issue reopens immediately because the reasoning was never made explicit

Outcomes

Outcomes and signals

What should exist after the playbook runs, how you'll know it worked, and what to watch for over time.

Artifacts to produce

Durable outputs the playbook should leave behind.

  • Decision frame
  • Trade-off matrix
  • Decision record
  • Execution and review plan

Success signals

Observable changes that mean the playbook landed.

  • The decision can be explained clearly after the meeting
  • Participants understand why the chosen option won
  • Dissent is reduced by clarity rather than by silence
  • The decision does not immediately reopen without new evidence

Follow-up actions

Moves that keep the playbook's effects compounding after it finishes.

  • Review whether the decision held up after implementation begins
  • Capture repeated disagreement patterns as process improvements
  • Update related architecture or team guidance if this pattern recurs

Metrics or signals to watch

Longer-horizon indicators that the underlying problem is receding.

  • Time to decision
  • Decision reopen rate
  • Participant understanding of trade-offs
  • Execution friction after the decision

AI impact

AI effects on this playbook

How AI-assisted and AI-driven workflows help execution, and the ways they can make it worse.

AI can help with

Where AI tooling genuinely reduces the cost of running this playbook well.

  • Drafting option comparisons and trade-off tables
  • Summarizing prior incidents or evidence relevant to the choice
  • Extracting repeated arguments from previous docs or threads

AI can make worse by

Distortions AI introduces that make the underlying problem harder to see.

  • Arming dominant participants with more persuasive but shallow rhetoric
  • Flattening the disagreement into generic summaries
  • Creating false symmetry between weak and strong arguments

Relationships

Connected playbooks

Failure modes this playbook tends to address, decisions behind the situation, red flags that motivate running it, and neighboring playbooks.