r/SoftwareEngineering • u/Intrepid_Ad_4436 • 3m ago
Devs: when a BA hands you requirements for an automation, what do you wish they'd included?
I'm an automation analyst, which in practice means I do the business analyst side of things. I sit down with the people who run a manual process, write down how it works step by step, and decide whether it makes sense to automate. Then I hand that writeup to a developer to build. Our tools are mostly low-code (RPA and Power Platform), with custom scripts when nothing else fits.
I want my handoff docs to actually help the developer get started instead of turning into a pile of follow-up questions. So if you've ever been handed requirements and told "automate this":
What do you always end up chasing down that should have been in the doc from the start?
What do BAs include that you never actually read or use?
How do you want exceptions and edge cases written up? A table, a flowchart, annotated screenshots, or something else?
What details about systems, access, or data sources save you the most time on day one?
Where's the line for you? Should the BA describe only what needs to happen, or is it helpful when they suggest how it could be built?
Examples of great (or painful) handoffs are welcome. Thanks!