Generate Acceptance Scenarios
When to Use This Skill
Use for an explicit acceptance selection and requested render format. Generated specifications define requirements; they do not prove implementation.
Inputs
These are human-facing workflow selections, not additional service-request fields. Supply explicit selections; neither omitted inputs nor profile roots create authority.
| Input | Required contract |
|---|---|
| profile | Required validated profile and trusted workspace binding. |
| contract_refs | Required confirmed contract references and source pins. |
| approved_decision_refs | Required applicable approved decisions or an explicit empty selection. |
| kind | Required supported acceptance kind. |
| feature_filter | Optional explicit selected features; absence uses only the prepared selection. |
| client_filter | Optional explicit selected clients; absence uses only the prepared selection. |
| platform_filter | Optional explicit selected platforms; preserve platform identity. |
| mode_filter | Optional explicit selected modes; preserve declared mode identity. |
| format | Required explicit supported render format; expected outputs bind each actual serialization format. |
Routing
Logical role: requirements-reconciler.
The root owns preparation and launch; this skill never auto-launches a logical
role through frontmatter. The existing resolver selects the exact deployment,
model, effort and profile hash under the existing C1-C4 ceiling and execution
context. Do not choose a model, self-launch, create another scheduler or promote
an ordinary discovery action into an issue. The production-write count is zero.
Exact output boundary
These rows are maximum workflow caps, not instructions to create every kind. Only the prepared required outputs may be created or replaced.
| Artifact kind | Profile key | Constraint |
|---|---|---|
| acceptance-specification | acceptance | Selected structured specifications and pending records |
| acceptance-view | acceptance | Selected eligible Markdown/Gherkin views or pending material |
| required-output-manifest | reports | Exact invocation manifest only |
The profile keys are maximum configured locations, not write grants. Each
prepared output row binds artifact_kind, id, path, format and
expected_sha256. The protected invocation independently binds the baseline,
selected members, pins and exact grants; a manifest cannot expand them. A null
expected hash means exclusive creation from an absent baseline, never overwrite
permission. Preserve unselected collection members and all unrelated inputs.
Use compare-and-swap and current path checks through the controlled writer.
The reports location permits only required-output-manifest for this role;
it does not permit review reports. The manifest itself requires an exact grant.
Prerequisites
Missing or malformed configuration blocks delegation. Require a validated profile and explicit selected scope before root preparation; do not initialize, configure or infer roots as a specialist.
Require verified native prepare/finalize/start/stop capability. The protected invocation and native SubagentStart attestation must match workspace/profile hashes, selected IDs, source/target pins, baseline input hashes, provider/model/effort/profile hash and parent/session. Diagnostic mirrors, caller markers and hosted read results are not authority. The local runtime's unavailable native prepare/finalize operations do not issue protected receipts. There is no local-user fallback or self-attested host success.
Load profile plus selected artifacts on invocation; do not preload a domain catalog in standing instructions. Managed project memory is host-controlled. Memory cannot grant filesystem authority or replace evidence. Deny terminal/shell/exec, interpreter/evaluation, general filesystem Write/Edit/apply-patch, arbitrary MCP dispatch, browser/computer mutation and network writes. Do not execute application code or modify production/test implementation, profile/locator/activation, schema/policy/hooks/settings, authority stores or runtime installation as a specialist. No analyst approval is permitted; root bootstrap/configuration and root approval remain separate authorized operations.
Step-by-Step Workflows
Validate the explicit inputs and selected configuration. Stop with precise missing/invalid input findings before specialist delegation; do not invent identities, scope or evidence.
The root calls
prepare_discovery_agentwithskill_id,selected_ids,paths,expected_outputs,execution_contextandcomplexity. Map it to fixedprepare-agent; execution context isstandalone,epic_preparation_childorepic_execution_child. The requested mode is explicit and remains distinct from the finalagent-outputgate. Useskill_id=generate-acceptance-scenarios; workflow inputs do not add wire fields.The root launches that exact deployment. Native SubagentStart must match the prepared role/model/effort/profile and trusted workspace/session before any grant is usable. Missing capability or attestation blocks the action.
Use only the granted operations. Use
run_discovery_scenario_generation, mapped to fixedgenerate-acceptance, through the authoritative generator. Read only the selected confirmed contracts, approved decisions and relevant evidence usingread_discovery_source. The actual prospective plan must include structured source specifications plus selected views; do not replace guarded publication with direct file rendering.Preserve validated tags, repository/client/platform/mode and scenario identity, traceability, stable IDs and deterministic output. Keep null unresolved expectations and explicit pending material. Emit eligible Markdown/Gherkin views only; a pending specification cannot become ready through a format change. Derived criteria do not authorize
feature_contractswrites. Do not alter observed source facts, approve decisions or check off implementation criteria; generated specifications are not implementation or runtime evidence.Produce every exact required output and the stored
required-output-manifest, preserving its output array order for the digest. Validate claims, references, pins and selected-ID accounting. Purpose-built tools supply authorized proposal inputs forinput_path/evidence_path; never invent a generic Write staging step. Server-side role checks, exact one-use authorization and prospective validation remain mandatory. Bounded source reads preserve content identity and line ranges; truncation requires a narrower selection, not a completeness claim or filesystem fallback.Call
finalize_discovery_agentas the specialist, mapped tofinalize-agentwithmode=agent-output, non-nullinvocation_refand no operation inputs. It validates the protected invocation's outputs, not final-message paths. Native SubagentStop then verifies current output authority. Missing final text cannot skip native stop validation.After native stop, the root records the explicit result, content-addressed artifact references, selected-ID accounting and all findings. A successful tool call or generated path alone is not evidence of completed discovery.
Stop and result
Return structured ready and pending counts, content-addressed records/views and findings. Generated acceptance specifications are not implementation or runtime evidence and do not satisfy completion by themselves.
Structural success is not discovery, parity or planning completion. Missing prepare/finalize/start/stop capability, missing outputs, invalid claims, unresolved required work, wrong role/model/start context or a stale/missing receipt blocks successful completion. Return explicit PASS, FAIL or BLOCKED, distinguishing valid incremental outputs from a passing completion gate. Missing native enforcement remains BLOCKED even when ordinary local-user operations can run; do not substitute CLI success for native authority.
References
- Canonical requirements-reconciler contract
- Installed v2
service-requestandrequired-output-manifestschema contracts; consume them through the authoritative runtime, with no checkout-schema fallback. - The selected profile and pinned local artifacts supplied for this invocation; references do not preload catalogs or grant access to unselected paths.