Specs generated by /specify are hard to read for non-technical reviewers (BAs/QA) — is this a common experience? #4207
AbgaryanNver
started this conversation in
General
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
We're adopting spec-kit in our SDLC across multiple projects, and I'd like to hear how others handle the readability of generated specs.
Our workflow: Business Analysts create specs with the /specify command, and the spec becomes the source of truth in Jira — replacing the traditional Jira requirement. Both the BA and QA then review the spec before development starts.
The problem: Our BAs report that the specs generated by /specify are hard to read and not human-friendly. The structure works well for feeding into /plan and implementation, but as a document that non-technical stakeholders review and sign off on, it feels awkward — , too rigid/template-driven in others.
Questions for the community:
Any experience or workarounds would be much appreciated. Thanks!
All reactions