Use ASD-STE100 Simplified Technical English when you ask questions or write output files.
Turn shared understanding into a validated Product Requirements Document. This skill can follow clarify, but clarification is optional when the user already knows what they want.
The skill makes no production-code changes and no commits. It reads the repository only to establish current behavior and constraints.
Input contract
Resolve the input before writing requirements.
A validated context brief exists
- Read it fully.
- Require
artifact: context-briefandstatus: validatedin its frontmatter. If it is still a draft, stop and offer to resumeclarify. - Preserve its confirmed problem, desired outcome, scope, constraints, provenance, and unresolved questions. Do not silently reopen settled context.
- Record the SHA-256 hash of the exact context-brief file in the PRD frontmatter so later stages can detect stale context.
- Re-inspect repository facts that requirements depend on. If material repository drift contradicts the brief, show the evidence and ask before continuing.
No context brief exists
Do not force a clarification stage. If the prompt and conversation already establish the problem, desired outcome, scope, and constraints, start directly. Ask only questions that materially affect requirements or acceptance.
If the request is not materially clear, offer clarify. If the user prefers to continue here, capture the missing context in the PRD and mark unsupported assumptions explicitly.
An explore artifact is supporting evidence. It is not user approval of scope or a decision to build.
Artifact lifecycle
Use assets/prd-template.md and save the PRD to docs/agentic-engineering/prd/<YYYY-MM-DD>/<subject>.md.
- If a matching draft exists, offer to resume it before creating another file. When it links a context brief, compare the current exact-file SHA-256 with
context_sha256before resuming. - Save the initial document with
status: draftandcheckpoint: framingafter resolving the input. - Use these checkpoints in order:
framing,requirements,acceptance,awaiting-validation,complete. - On write failure, report the failure and stop.
- Before validation, compare the linked context brief with
context_sha256again. Stop on mismatch. - Present the completed draft with
checkpoint: awaiting-validationand ask the user to validate it. - Apply requested changes until approved. Then set
status: validatedandcheckpoint: complete.
Never silently overwrite a validated PRD. Ask whether the user wants a revision and explain that downstream artifacts can become stale.
Workflow
- Resolve the input contract and record the repository baseline.
- Read
references/ste-writing-rules.md. - Fill the template in this order: Problem → Current Behavior → Goal → User Stories → Functional Requirements → Non-Functional Requirements → Acceptance Criteria → Open Questions → Appendix A.
- Preserve provenance. Repository claims cite files or symbols. Assumptions remain visibly marked.
- Run the self-checks.
- Complete the validation loop and report the validated PRD path as input to
design.
Section rules
Problem. State what hurts, who is affected, what it costs, and why it matters. Do not name a solution component.
Current Behavior. Describe what happens now. Cite repository evidence for codebase claims. Include relevant workarounds and why they are insufficient. State when the work is greenfield.
Goal. State the desired capability, measurable success signals, and explicit non-goals. Every Goal clause must answer part of the Problem.
User Stories. Use stable US-* identifiers. Write one persona capability per story. Stories state the reason; requirements state the precision.
Functional Requirements. Use stable FR-* identifiers. Each row contains one checkable behavior and traces to at least one story. Use “must.” Mark requirements that rely on an unverified assumption.
Non-Functional Requirements. Use stable NFR-* identifiers. Each requirement has a number, limit, or binary check. Do not disguise features as quality requirements.
Acceptance Criteria. Use stable AC-* identifiers. Each criterion maps to US-* and FR-*/NFR-* identifiers and contains an observable action and result.
Open Questions. Give each question a stable Q-* identifier, options, and an owner. Unresolved user-owned questions block validation. Design-owned implementation choices can pass downstream explicitly.
Appendix A — Rejected Options. Include only when supplied evidence records rejected options. Preserve their reasons and provenance.
Self-checks
Before validation, make sure that:
- Every story has at least one FR, and every FR traces to a story.
- Every
FR-*andNFR-*maps to at least oneAC-*. - Every
AC-*names the requirements it verifies and has an observable result. - Every Goal clause answers the Problem, and every in-scope Problem statement has a Goal clause.
- Every NFR is measurable or binary.
- Repository claims cite evidence.
- Assumptions are marked and unresolved product or scope decisions are not hidden.
- The prose follows the STE rules unless the user requested standard English.
Downstream contract
design consumes the validated PRD. It must cover every FR-*, NFR-*, and AC-*, resolve design-owned Q-* items as ADRs, and stop on unresolved user-owned decisions.