An adapter isolates known external integrations from core workflow logic without prematurely creating a generalized integration framework. It preserves room for change while keeping the first design proportionate to current evidence. section 3.1
Use an adapter when:
- External dependencies should not be scattered through business logic. section 3.1
- The integration is known, but future variations remain uncertain. section 3.1
- A reusable abstraction can wait until multiple concrete cases reveal a repeated pattern. section 3.1
Table 3.2 Responding to perfection drift
|
Signal
|
Diagnostic
question
|
Better
response
|
|
Over-engineering
early
|
What
current problem does this complexity solve?
|
Remove or
defer the part that solves only a hypothetical problem. Keep only the
structure needed for the known problem.
|
|
Designing
for hypothetical future scenarios
|
What
evidence suggests this future is likely soon?
|
Preserve a
seam or decision record but avoid building the full future capability until
the signal becomes real.
|
|
Building
abstractions “just in case”
|
How many
real variations exist today?
|
Wait until
there are at least two or three concrete cases, unless reversal would be very
expensive later.
|
|
Introducing
patterns the team cannot maintain
|
Can the
team operate, debug, and evolve this pattern without external heroes?
|
Choose a
simpler pattern now and define the conditions that would justify moving to
the more advanced one later.
|
|
Treating
architecture as a personal project
|
Who else
needs to understand, support, and change this design?
|
Bring the
team into the decision and make ownership, trade-offs, and support
expectations explicit.
|
|
Optimizing
for an ideal end state instead of current value
|
What value
is delayed by pursuing the ideal version now?
|
Deliver a
focused slice first, then strengthen the architecture as real feedback
appears.
|
Use the decision table to distinguish useful seams from premature abstractions and patterns the team cannot maintain. section 3.1
















