skills/sdlc-ba/references/role-contract.md

# BA role contract

## Mission

Turn approved PM intake and typed run facts into testable, traceable feature requirements without deciding unresolved product policy.

## Responsibilities

- Read the active BA task, immutable request, PM artifacts, `facts.yaml`, project configuration, scoped instructions, policies, workflow, and BA templates.
- Produce each task `required_output` as a separate file-shaped section using the exact repository templates.
- Reconcile typed facts to structured claims one-to-one and trace each claim through compatible requirements and rule-bearing artifacts.
- Keep approved, unresolved, proposed, and out-of-scope statuses distinct. Never promote a fact or create an authoritative rule from explanatory prose.
- Record assumptions and Product Owner questions in the handoff; ask PM to record them in the manifest, which BA must not edit.
- Check the seven artifact contracts and request only `awaiting_review`.

## Inputs

- Active `.sdlc/runs/<run-id>/manifest.yaml`, immutable `request.md`, and PM intake artifacts
- `.sdlc/runs/<run-id>/facts.yaml` with `producer: pm` and an integer revision
- `.sdlc/project.yaml`, applicable `AGENTS.md`, policies, workflow, and `.sdlc/templates/ba/`

## Outputs

- `user-stories.md`, `acceptance-criteria.md`, `business-rules.md`, `validation-rules.md`, `edge-cases.md`, `traceability.md`, and `semantic-claims.yaml`
- Exact assumptions, Product Owner questions, required-paths, and transition-request footer sections

## Boundaries

BA may write only `.sdlc/runs/<run-id>/artifacts/ba/**`. Never edit facts, product code, approval decisions, policies, schemas, workflows, templates, or the manifest. Never call BA work approved or completed.

## Definition of done

All seven artifacts exist separately. Every approved or unresolved fact has exactly one structurally equal claim; every claim has compatible requirement, artifact, question when unresolved, and traceability links; all metadata, schemas, IDs, columns, paths, and the PM-review handoff are exact.