How it works
From raw need to sprint-ready ticket
- 01 / 04
Install
Copy the pack into your Claude Code project. The CLAUDE.md and skills are picked up automatically.
- 02 / 04
Frame
Describe the need or paste workshop notes. ba-clarification-gate asks the questions that are missing.
- 03 / 04
Produce
Run ba-specification then ba-gherkin-zephyr, or ba-epic-pipeline to chain the whole epic.
- 04 / 04
Check and publish
ba-checklist-predelivery flags gaps. You approve, then ba-jira-confluence-sync publishes to Jira and Confluence.
Before / after
A full example, from raw message to ready story
Needs rarely arrive clean. BA Forge spots what is implied, the missing edge cases and the unmade trade-offs, then structures everything to your conventions.
Before · the need as it arrives
Hi, customers should be able to change their address themselves in their account. It should be checked somewhere1, and they should get an email. For everyone2, of course. It’s urgent, next sprint if possible.3 Thanks!
- 1Implicit rule: what check, by which system?
- 2Missing edge case: addresses abroad
- 3Priority claimed, never arbitrated
After · what BA Forge produces
US-14Update postal addressRG-31Address checked against the postal reference1RG-32Address abroad: free entry, manual check2RG-33Confirmation email after savingCA-52 → 554 Gherkin scenarios, including 2 edge casesDEP-07Postal reference API availability1Q-03Priority to arbitrate with the PO3
7 traced items · 3 points from the message resolvedDoR ✓ sprint-ready
Traceability
Every business rule is linked to its test. Gaps show up before UAT.
ba-registre-ids numbers and tracks every ID. ba-checklist-predelivery crosses business rules, acceptance criteria and Zephyr test cases: gaps show up before the sprint, not in production.
| Requirement | CA-52 | CA-53 | CA-54 | CA-55 | CA-56to create | TC-201 | TC-202 |
|---|---|---|---|---|---|---|---|
US-14Update postal address |
|||||||
RG-31Postal reference check |
|||||||
RG-32Address abroad |
! | ||||||
RG-33Confirmation email |
|||||||
DEP-07Postal reference API |
- Covered
- Gap detected
- No link
Gap detected by ba-checklist-predelivery
RG-32 is not covered by any acceptance criterion. Suggestion: create CA-56 “Address outside Switzerland” and its test case.
Principles
Built in the field, not in theory
BA Forge was born in a web product team, across real epics. Each skill encodes a practice used sprint after sprint: ask the right questions before writing, trace every rule to its test, deliver nothing unchecked. The kit does not replace the Business Analyst’s judgement. It takes formatting off their plate and gives them time back for analysis.
- Frame before producing — two rounds of questions, no silent assumptions.
- Trace every decision — an ID for every rule, question and test.
- Check before delivering — automatic checks at every step.
Less formatting. More analysis.
Install BA Forge today and write your next story to your own method.