Skip to content

pragmatic-architect vs technical-writer

Topic: A personal year-end reckoning with a difficult year
Axis varied: voice
A: Pragmatic Architect B: Technical Writer

Both examples address the same topic and (by default) share every axis other than voice. The only deliberate variable is which voice the writing was rendered through. Read both and ask: where does the framing change? Where does the vocabulary change? What does the reader take away from A that they would not take away from B, and vice versa? The voice swap is the entire cause of those differences.

A: pragmatic-architect

The year broke in two places at once, which I’ll call the project and the relationship. Both failed for reasons I should have named earlier but didn’t - not because I lacked data, but because naming the failure mode felt like betting against something I didn’t want to lose.

The project - I’ll call it Meridian - ran two and a half years. We made a defensible early call to build for scale we didn’t yet have. That call was wrong. The constraint we underweighted was team cohesion under sustained uncertainty, not the technical surface. When the sponsor lost confidence in Q3, we couldn’t recover fast enough because we’d been building against a problem definition that had quietly shifted. I contributed to that drift. I saw the signals in January and didn’t pull the decision trigger. By the time I did, the organizational goodwill had spent down. The project ended without the outcome I’d promised myself and the people who came along for it.

The relationship - I’ll use the name Carla, which is not her name - changed in a way I did not choose. What I got wrong here was a classic load-balancing error: I kept assuming the system would self-correct if I just held load long enough. It didn’t. The failure mode I ignored was accumulating latency in the form of deferred conversations. By the time I was ready to address the queue, the other node had already rerouted. That is not her fault. It is a consequence I could have modeled and didn’t.

What I’m carrying forward: I’ll keep the habit of naming the failure mode early, even when it’s uncomfortable, because the cost of naming it is always lower than the cost of finding out the hard way. That’s a fair lesson, bought at a fair price.

What I’m not carrying forward: the story that the hard parts were secretly useful. Some of them were. Some were just losses.

B: technical-writer

In March, the project I had been building for fourteen months ended without the outcome I had planned for. The team disbanded. The deliverable was not shipped.

In August, a relationship that had been important to me for three years changed in ways I did not initiate. The person is still present in my life, but not in the way they were.

Neither of these resolved by December.

The project required me to hold a direction longer than the evidence warranted. I kept adjusting scope instead of questioning the premise. I did not catch this until after the deadline.

The relationship asked me to sit with an outcome I could not fix. I attempted several times to fix it anyway. None of those attempts succeeded, and some made the situation harder to navigate.

On the project: I treated the early indicators as noise rather than signal. When the scope changed in October, I extended the timeline rather than surfacing the dependency problem. I should have surfaced the dependency problem.

On the relationship: I conflated “staying in contact” with “taking action.” Staying in contact is sometimes the right response. In this case, I was using it to defer acceptance.

Note: Getting these wrong was not exceptional. Both errors are common. Knowing they are common does not make them easier to correct in the moment.

The following decisions are active for the period beginning January:

  • Review project premises at the 90-day mark, not only deliverables
  • Distinguish between “not yet resolved” and “not resolvable by me”
  • Do not extend timelines without naming the blocker

The year did not produce the outcomes I expected. I am not carrying it forward as a lesson; I am carrying forward the two specific decisions above. They are adjustments based on observed failure, not general principles.