In the days that we wrote user stories on physical cards, we deliberately handed out small pieces of paper and large sharpies. We wanted fewer words on the card and set up the conditions to encourage that.
The card was intended to be the promise of a conversation, not a detailed requirements document.
People who write stories in systems like Jira often miss that point. Those tools allow us to write novels, and so we do.
Why does that really matter? We have to figure out the details at some point anyway, so why does it matter if we do it up front in a detailed document or later as we=E2=80=99re about to build it?
It=E2=80=99s a question of risk management. The risk in this case is that we=E2=80=99re building the wrong thing.
Back when agile was first starting, the Standish Report consistently reported that 30-50% of all features that were specified up front were never or rarely used. That=E2=80=99s 30-50% of our analysis work being complete waste. One of the goals of agile was to drop that percentage significantly. To only work on items that would be used by our customer and that would therefore be valuable.
We talk a lot about the flow of value through a system but a feature that doesn=E2=80=99t get used isn=E2=80=99t valuable. We don=E2=80=99t know if it=E2=80=99s valuable until it=E2=80=99s in the hands of customers and we discover if they even use it.
In the early stages of planning, we have so many ideas and while many of them will be valuable, some won=E2=80=99t. Given that we=E2=80=99re are constantly learning as we deliver more pieces of value, the longer we can wait before making the next decisions, the better we=E2=80=99ll able to predict if a thing really is valuable.
So we want to defer as many decisions as we can. That means deferring all the effort we put into all the specifics of the story for as long as we reasonably can. This means writing as little on the card up front as we can, and deferring all the details until the time that we absolutely need them.
The card is now =E2=80=9Cthe promise of a conversation=E2=80=9D, that we=E2=80=99ll have at the right time.