A decade of requirements gathering taught me the real spec lives in the argument nobody wants to have

I've spent about ten years as a business analyst, which mostly means I write the document everyone nods at and nobody reads.

For a long time I thought the job was the document. Get the requirements clean, get sign-off, hand it to the builders. I got good at making the doc look finished.

Then I watched a project go out completely wrong even though every box was signed. Turned out ops and finance had quietly assumed two different things about the same process, and the tidy spec papered right over it. Nobody lied. They just never had to say the uncomfortable thing to each other's face, because the document let everyone agree in private and mean different things.

That was the moment it clicked. Requirements gathering isn't collecting answers, it's forcing the argument that people are avoiding. The real spec was sitting inside a disagreement two managers were too polite to have in the same room.

Now most of my actual value is engineering that fight early, when it's cheap, instead of finding it in QA when it isn't. It feels less productive than typing up a neat doc, and it saves the whole build.

For anyone doing solo consulting or fractional work around process and delivery: how do you get stakeholders to disagree out loud early without it turning into a turf war you get blamed for?

reddit.com
u/Comfortable-Many2661 — 2 days ago

The tidy requirements doc is where projects go to die, and an ai writing tool made it worse

Spent years as a business analyst and here is the thing nobody wants to hear. The real requirements never live in the clean document. They live in the disagreements between the people who signed off on it. Sales thinks the feature does one thing, ops assumes another, the founder has a third version in his head, and the tidy doc papers over all three because writing it down felt like agreement.

Now that anyone can feed rough notes into an ai writing tool and get a polished spec back in seconds, the problem got quieter, not smaller. The document looks more finished than ever. It reads like everyone agrees. Then you build it and the fight you skipped shows up as a rebuild.

I've started running the kickoff backwards. Before anything gets written, I get the three people who secretly disagree into the same room and make them argue it out loud. The spec is whatever survives that. Ugly, but it holds.

Anyone else find the cleanest doc is usually the most dangerous one? Curious how you surface the disagreement before the build instead of after.

reddit.com
u/Comfortable-Many2661 — 7 days ago

Spent a week polishing a pitch deck template for launch. The messy version that left the holes in is what got my first users talking.

Quick lesson from my launch. I come from a business analyst background, and the thing that job drills into you is that the real requirements never live in the tidy document, they live in the arguments people have about it. The doc nobody fights over is usually the one that sinks the project.

I forgot my own lesson when I built my pitch deck template for launch. Spent a week making it airtight. Every objection pre-answered, every gap smoothed over. I showed it to the first people I wanted as users and they nodded politely and left. No traction.

So I tore the polish off and left the open questions in. Literally a slide that said here's the part I haven't figured out. Suddenly people argued with me. They told me which assumption was wrong, which feature they'd actually pay for, which one they didn't care about. Those arguments turned into my first real conversations and my first handful of users.

Turns out a deck that looks finished gives people nothing to grab onto. Anyone else find the messy version of your pitch pulled more people in than the clean one?

reddit.com
u/Comfortable-Many2661 — 10 days ago

After months building solo, the cleanest requirements document I wrote turned out to be the least useful thing I made.

Spent fifteen years as a business analyst before I started building my own thing after hours, and I brought a bad habit with me. I love a tidy document. Clean requirements, everything numbered, no loose ends. It feels like progress.

Building solo taught me the tidy document is where the real problem goes to hide. When I wrote the spec for my first feature, everything looked settled because I was the only one in the room. No disagreement, no friction, so I assumed I understood it. I built it. Nobody used it the way I'd written it down.

The stuff that actually shipped well came from the opposite. I'd get two potential users on a call and steer them into disagreeing with each other about how the thing should work. The argument is the requirement. The tidy version I'd written was just the conflict I hadn't surfaced yet, papered over.

In my day job the real requirements always lived in the gap between what two stakeholders each quietly assumed. Same thing solo, except now I'm both stakeholders, so I have to manufacture the disagreement on purpose or I'll just agree with myself into a useless feature.

So my rule now: before I write a line of the spec, I find someone who'll push back and I let them. Messier notes, better product.

Anyone else find the neat plan was the thing that fooled you?

reddit.com
u/Comfortable-Many2661 — 10 days ago

How do you stop a growing team from making the same decision three times? A boring board meeting agenda template did it for us

Years as a business analyst and the pattern follows every growing company. You make a decision in a meeting, everyone nods, and six weeks later you're having the exact same argument because nobody wrote down what was decided or why.

At small scale you get away with it. The founder remembers. Past a certain size the founder is the bottleneck and their memory doesn't scale, so settled things quietly get reopened and momentum leaks out the side.

The fix was embarrassingly boring. A one page board meeting agenda template for our weekly sync. Three columns, the decision, who owns it, and the tradeoff we accepted. If it's not on the page it didn't happen. Next time someone reopens it, we point at the row.

It won't go viral and it isn't clever, but re-deciding things we'd already settled was costing us more growth than whatever channel we were busy arguing about.

For those a bit further along, how do you keep a growing team from making the same call three times? Curious what actually worked versus what just added process for the sake of it.

reddit.com
u/Comfortable-Many2661 — 25 days ago

I tried every notion alternative and still built the wrong thing for two months solo

My old job was business analysis. Strip away the title and the actual work was this: get three stakeholders who quietly disagree into one room and force the disagreement out before anyone wrote a line of code. The clean requirements doc was never the point. The fight was the point.

Then I went solo and became my own product owner, engineer, and QA. And here is the trap nobody warns you about. I agreed with myself on everything. Every feature I proposed, I also signed off on. It felt fantastic and it was quietly poisonous, because there was no one in the room to say "that is not the real problem."

I spent weeks reorganizing my thinking instead. Tried one notion alternative, then another, then a third, convinced the right workspace would give me clarity. It never did. A tool cannot manufacture a second opinion. It just makes your one opinion look more organized.

What actually saved me was dragging five real potential users into calls and letting them be the stakeholders who push back. First honest conversation and my two months of confident building fell apart in a good way.

Solo founders, how do you create disagreement for yourself when there is no one whose job it is to tell you you are wrong?

reddit.com
u/Comfortable-Many2661 — 27 days ago

The cleanest requirements doc I ever wrote killed the project. No google docs ai would have saved it. I will not promote

I'm a business analyst. My job, officially, is to write the requirements everyone builds from. For a long time I thought a good doc meant a clean doc. No open questions, every stakeholder signed off, nothing ambiguous.

The best-looking doc I ever produced was for a project that failed. Nine months, a real team, dead on arrival.

Here's what I missed. Everyone agreed because nobody actually disagreed out loud. Two of the directors had completely different ideas about what the product was for, and instead of fighting about it in the room, they both nodded at my tidy document and read into it whatever they already believed. The agreement wasn't alignment. It was everyone quietly assuming they'd won.

I've come to think the real requirements never live in the document. They live in the disagreement between the people who have to fund it, use it, and maintain it. My actual job isn't writing the spec. It's getting that fight to happen early, while it's still cheap, before anyone has written code around the wrong assumption.

No writing tool changes this. You could hand me a perfect google docs ai setup that drafts flawless specs in seconds and it would make the problem worse, because now the tidy document arrives even faster and the argument gets buried even deeper.

For the founders here who've shipped the wrong thing after everyone "agreed": how do you force the real disagreement into the open before the build starts? That's the part I still find hard.

I will not promote.

reddit.com
u/Comfortable-Many2661 — 28 days ago

No flowchart maker, free or paid, fixes a team that won't say what it actually wants. I will not promote

I'm a business analyst. On paper my job is to write the requirements. In practice the document is the easy part. I could write a clean spec in an afternoon. The hard part is that the spec is usually a polite fiction, because the people who signed off on it never actually agreed on anything.

Here is how it really goes. Sales wants the thing that closes deals. Ops wants the thing that doesn't break at 2am. The founder wants both, plus a timeline that assumes neither has a cost. In the kickoff everyone nods, because nodding is easier than fighting, and the disagreement just goes underground. Then you build for three months and it surfaces anyway, except now it costs a quarter of your runway instead of an awkward meeting.

The requirements don't live in the document. They live in the arguments people are avoiding. My actual job, the part nobody writes on a job description, is getting those arguments to happen out loud, early, in front of each other, before a line of code exists. A tidy diagram makes everyone feel aligned when they are not. No flowchart maker, free or paid, does that for you. The alignment is a conversation, usually an uncomfortable one, and someone has to be willing to sit in the room and force it.

I've watched teams skip that conversation because the doc looked done. It is the most expensive corner you can cut and it never shows up on the invoice.

For the founders here: if a build is going sideways, I'd bet the requirements were never really agreed, they were just written down. Has anyone found a way to get stakeholders to actually fight it out before the build instead of after?

reddit.com
u/Comfortable-Many2661 — 30 days ago

How do you check a handed-off task is done right without hovering over the person?

Getting to the point where I have to hand things off or I'll never grow, but every time I do, I catch myself checking the work so closely that I might as well have done it myself. The person can feel it too, and it kills whatever ownership they were supposed to take.

I don't want to be the bottleneck and I don't want to be the guy breathing down someone's neck. There has to be a middle setting between blind trust and micromanaging.

For those of you further along on this, what does the check-in actually look like once a task is off your plate? How often do you look, what do you look at, and at what point do you stop looking?

reddit.com
u/Comfortable-Many2661 — 1 month ago

What's the boring recurring task you finally wrote down, and did it actually help?

I do operations for a small events-rental business, tables, chairs, tents, that kind of thing. Everything runs in my head or in scattered notes. It works because I'm always there. But we had a bad week recently where I was out with the flu and the whole thing wobbled, because nobody else knew the order that things had to happen in for a delivery to go smoothly.

I've decided to actually write our processes down, and I've started with the delivery-day checklist. It's tedious and I keep wondering if I'm just making a document nobody will read.

So I'm asking the people who've done this: which single process did you write down first, and did writing it actually change anything, or did it just sit in a folder? I'm trying to figure out whether to keep going or whether documentation is one of those things that sounds responsible but doesn't do much in practice. What made yours actually get used by the team?

reddit.com
u/Comfortable-Many2661 — 1 month ago

the requirements are never in the requirements document. they're in the argument two stakeholders are having.

early in my BA work i treated requirements gathering like collecting a shopping list. ask people what they want, write it down, hand it to the devs. the projects that went sideways all went sideways because the list was technically complete and completely missed the point.

the real requirements live in the disagreements. two departments want the same field to mean two different things and neither has said so out loud. the person who controls the budget wants one outcome, the people who'll use the thing daily want another, and the document records a polite average that satisfies nobody. if i just write down what each person tells me in their own meeting, i produce a spec that looks done and ships a system everyone quietly hates.

so the job i actually get paid for isn't documentation, it's getting the conflicts into the same room before the build, not after. the most useful thing i do is notice when two stakeholders are describing the same process with different words, or the same word for different processes, and make them hash it out while it's still cheap to change. the document is the output. the surfaced argument is the work.

how do the rest of you draw out the disagreements people are avoiding? half my stakeholders would rather ship a broken thing than have the awkward conversation about who's right.

reddit.com
u/Comfortable-Many2661 — 2 months ago

the BA skill that actually got me promoted wasn't analysis, it was turning requirements into a presentation execs would sit through

Been a BA for about 8 years. The thing that moved my career wasn't getting better at requirements gathering or SQL. It was learning to turn dense analysis into a stakeholder presentation execs would actually engage with.

early on i'd bring the full requirements doc to the steering committee. 40 pages, every edge case, traceability matrix and all. technically thorough, completely unreadable for the people who needed to decide. they'd glaze over and defer, and nothing would move.

what changed things was building a short presentation on top of the analysis. the decision they need to make, the 2-3 options, the tradeoffs, the recommendation, on a handful of slides. the 40-page doc still exists, it's just not what i walk into the room with.

the analysis was never the bottleneck. getting it into a form a busy exec could act on was. and weirdly nobody in BA training teaches the presentation side, it's all elicitation and documentation.

for other BAs: same experience, that communicating the analysis up the chain mattered more than the depth? and where did you actually learn the presentation skills, on the job or somewhere structured?

reddit.com
u/Comfortable-Many2661 — 2 months ago

the always-on part of social management is the thing slowly wrecking me, not the work itself

the actual job is fine. i like making the content, i like the planning, i even like the analytics on a good week.

what's hollowing me out is that there's no off. a comment comes in saturday night and the unspoken rule is someone catches it before monday. a competitor does something sunday and by 9am i'm expected to have a take. brand goes quiet for 48 hours and someone asks if "we're still active." the platform never closes so neither do i.

i've started getting a little spike of dread every time my phone lights up, even when it's a friend texting, because my body now associates a notification with "something needs handling." that's not a healthy thing to have trained into yourself for a mid salary.

i don't want to hear "set boundaries." the boundary is the thing they hired around. the role is defined as being reachable. that's the product.

for people who've done social management for years and didn't burn out, what actually changed for you? did you find a setup that works or did you just leave for a role with an off switch?

reddit.com
u/Comfortable-Many2661 — 2 months ago

Took over my father's business and fixed quoting with a standard business proposal template

Second-generation operator, small manufacturing and services hybrid, eight staff, six years since I took the reins from my old man. He ran it on instinct and handshakes. That worked for him. It nearly sank me, because instinct does not scale past the person who has it.

The thing that was quietly bleeding us was quoting. Every quote was a custom effort, half a day of someone senior pulling numbers together, and they looked different every time depending on who built them. Clients noticed the inconsistency even when the price was fair.

I standardized it. Built a proper quoting process off a reusable business proposal template so every quote follows the same logic and looks like it came from the same company, then the estimator just fills the specifics. Quote turnaround went from days to hours. Win rate actually went up, and I think a chunk of that is just looking organized.

The lesson I keep relearning from my father's era is that "we've always done it by feel" is not a system, it is a single point of failure wearing a hat.

For those who inherited or took over an established business, what was the first informal thing you had to turn into an actual process, and did the old guard fight you on it?

reddit.com
u/Comfortable-Many2661 — 2 months ago

Took over from my old man six years ago. The thing he was right about that I dismissed.

Second-generation operator, manufacturing and services hybrid in Brisbane, eight staff, six years since I took over from my father. When I came in, I had a list of things he did "wrong" that I was going to fix with my modern thinking. Six years on, the one I most regret dismissing was his approach to staff.

Dad kept people for years, paid a bit over the odds, and tolerated the occasional slow patch from someone going through a hard time. I came in thinking that was sentimental and inefficient, and I tightened things up, more performance focus, less tolerance, a more "professional" approach. And I lost good people, and the ones who stayed trusted me less, and the place lost something that turned out to be load-bearing: loyalty that you can't buy and can't rush.

What dad understood, that I had to learn the expensive way, is that in a small business your people are not interchangeable units, they're the business, and the loyalty you extend in the slow patches is what you draw on when you need someone to go above and beyond in the busy ones.

I've gone back to more of his way, and the place runs better for it.

For others who took over a family business, what did the previous generation get right that you had to fail at before you respected?

reddit.com
u/Comfortable-Many2661 — 2 months ago

[Feedback] a competitor's bad google review response went viral locally. the contrast made me look better without doing anything.

tradesman. a local competitor received a 1-star review. his response: "this review is fake. the customer is a liar. we did excellent work and he refused to pay."

the response went viral in the local facebook group. 400+ comments. most critical of the competitor. "this is how you treat customers?" "ill never hire this company."

meanwhile: my google reviews (now 112, 4.8 stars) and my standard response to the 1 negative review (professional, inviting direct contact) were shared in the comments as a contrast. "look at how [Graham's company] handles criticism."

i did nothing. the competitor's emotional response created a marketing moment i couldnt have manufactured.

the video documentation on the youtube channel (filmed with my phone, edited with nothing) got referenced too: "this tradesman shows his work publicly. the other one hides behind angry review responses."

the free presentation tool i use for visual quotes played no role in this. the reputation did. the public behavior during criticism is the marketing. the portfolio, the videos, the reviews — all visible evidence that compounds during moments of competitor comparison.

reddit.com
u/Comfortable-Many2661 — 3 months ago

[Feedback] the youtube channel hit 1,200 subscribers. 4 clients directly attributed. the channel pays for itself now.

tradesman. started a youtube channel documenting jobs 8 months ago. 52 videos. 1,200 subscribers. 42,000 total views.

4 clients came directly from youtube. combined revenue: £18,400.

the content: 2-3 minute unedited phone videos. before, during, after. narration explaining what im doing and why.

the video that performed best (6,200 views): "what we found behind the bathroom tiles." the discovery element. people love seeing whats hidden inside their walls.

no presentation maker or fancy editing. the raw phone footage outperforms because it looks real. the 2 times i tried "professional" editing, engagement dropped. the audience wants authenticity, not production quality.

the subscriber profile: 72% homeowners in the UK. these are future clients researching tradesmen before they need one. the youtube channel is a trust reservoir.

for service businesses: 2-3 minute phone videos of your work require zero production budget. the content is the work itself. the marketing is showing it.

reddit.com
u/Comfortable-Many2661 — 3 months ago

Had a customer complaint go viral on a local Facebook group. 340 comments. Instead of defending ourselves, I posted the resolution. The thread became our best marketing.

One-star situation. Customer posted in a local Facebook group with 8,000 members: "Used [our business]. They left a mess and overcharged me." 340 comments. Most taking her side.

My instinct: defend ourselves. Post our version. Show the signed quote.

What I did instead: nothing for 24 hours. Then posted a single comment: "We spoke with [name] directly. The mess has been cleaned, a partial refund has been issued, and we've changed our process to prevent this. Thank you for holding us accountable."

No defense. No counter-narrative. No blame. Just resolution.

The comments shifted within hours. "This is how businesses should respond." "Respect for not making excuses." "Just booked them based on how they handled this."

3 new customers in the following week who specifically mentioned the Facebook thread. One said: "I saw the complaint and your response. The response is why I called you."

The complaint was embarrassing. The resolution was marketing. Not because I planned it as marketing. Because genuinely fixing a problem publicly is more persuasive than any advertisement.

If a complaint goes public: fix it publicly. Don't defend. Don't explain. Fix, acknowledge, and let the resolution speak.

reddit.com
u/Comfortable-Many2661 — 3 months ago

A customer left us a bad Google review. Called him directly. Fixed the issue. He updated the review to 5 stars. The phone call took 7 minutes.

One-star review. "Arrived late, didn't clean up properly, charged more than the quote."

Gut reaction: anger. We were 15 minutes late because the previous job ran over. We cleaned up. The charge was exactly the quote plus the additional work he requested on-site.

Called him instead of responding publicly. 7 minutes.

Turns out: he was frustrated about the lateness because he'd taken time off work to be home. Fair. The "didn't clean up" was about sawdust in his garage that we missed. Fair. The "charged more" was the on-site addition, which he'd agreed to verbally but didn't remember agreeing to. Also fair from his perspective.

Apologized for the lateness. Sent a team member back to clean the garage the next morning. Sent a photo of the verbal addition on our job sheet with his initials. All resolved.

He updated the review to 5 stars. Added: "Had an issue but the owner called me personally and sorted everything. Very rare for tradesmen to follow up like this."

The updated review now converts better than any of our 5-star reviews because it shows how we handle problems. 3 customers have mentioned the review specifically when booking.

A 1-star review isn't a disaster. It's a 7-minute phone call away from being your best marketing asset.

reddit.com
u/Comfortable-Many2661 — 3 months ago