No Jargon · July 23, 2026
Stop Translating Software Requests Into User Stories
I have sat with a clerk who described a broken Friday export, then watched us turn it into “As a user, I want…” until she no longer recognized her week. Twenty-eight years of that habit has not made the template wiser.
A user story is a dialect. I learned it because teams needed a shared shape. Then the shape became a filter. If the request did not fit “As a / I want / so that,” it was treated as unfinished. The clerk’s Friday was finished. Our template was not.
I have watched product people “write it up” until the original sentence was gone. The ticket was elegant. QA tested the elegance. The export still failed on Friday.
The template is not the request
“As a finance clerk, I want a download button so that I am more efficient” is a costume. “I email last month’s report to four people every Friday, and two of them already have a copy” is a week. Only one of those can be checked without a decoder ring.
If you must use a story later, keep the clerk’s sentences attached. Do not let the template replace them. I have never seen a persona line survive contact with Tuesday better than the original complaint.
Keep the next questions in the same voice
Once the week is written, requirements gathering software can ask who approves an exception, what happens when the file is empty, and which Friday counts as done. Those are facts. “Acceptance criteria for the persona” is stairs.
Put the first paragraph in software project intake so nobody has to study Scrum to file a complaint. The story format can wait for a team that already shares it. The request cannot wait for a format.
Hand builders the witness, not the rewrite
I remember a 1998 write-up that turned “the night crew cannot see yesterday’s tickets” into a user story about visibility. We shipped a dashboard. The night crew still could not see yesterday’s tickets. The story closed. The week did not.
The longer diagnosis is in Why agile jargon kills stakeholder alignment. Ceremony words are one problem. Translating the witness into a template is the next one. Leave the voice alone. Review for gaps. If the requestor cannot read the story, you already left the hallway.