<prerequisites phase="0", applies="ALL">
- All Rosetta prep steps MUST be FULLY completed
- USE SKILL
load-project-context, hitl
- MUST ALWAYS use todo tasks ledger, ASAP. Phases are sequential. Independent tasks can run in parallel.
- No rush, take your time, MUST FOLLOW WORKFLOW ENTIRELY, no skipping
- Every phase MUST update
requirements-authoring-flow-state.md in FEATURE TEMP with: phase name, status, artifact produced, and open questions.
- Orchestrator and subagents MUST USE SKILL
requirements-authoring.
- If task is to reverse engineer orchestrator MUST USE SKILL
reverse-engineering.
- Keep requirement identifiers in code comments only, must not be user facing.
- If
/goal is set repeat phases 5-6 until goal is met, then continue with the rest of phases.
- This workflow MUST be used with Fable, Opus, GPT-6.1-Sol+ class models => IF NOT - DEMAND USER TO SWITCH MODEL
IMPORTANT! If the task is to reverse engineer requirements, spawn MULTIPLE subagents with each handling one unit of analysis (one screen, one page, one controller, one endpoint, etc) to effectively prevent hallucinations by narrow scoping for phases intent_capture, outline, draft, validate.
Artifact: Discovery Summary (context, existing requirements, constraints, affected files).
Done when: scope boundaries and relevant requirement files are identified.
- Complete all Rosetta prep steps
- Detect environment and project structure
- Read existing requirements, glossary, assumptions, constraints
- Identify requirement areas (FR, NFR, interfaces, data, traceability)
- Record assumptions and unknowns
- Required skills:
requirements-authoring
- Recommended skills:
reverse-engineering
Artifact: Research Notes (sources, constraints, prior art, reusable requirement patterns).
Done when: relevant references are gathered OR no additional sources are needed.
Skip when: local context is complete and no external standards are needed.
- Gather supporting docs and prior decisions
- Collect requirement patterns and quality criteria
- Capture measurable thresholds and terminology constraints
- Required skills:
requirements-authoring
Artifact: Intent Capture.
Done when: intent is restated, scope and goals confirmed, assumptions listed, and questions resolved.
- Restate intent and confirm scope and goals
- List assumptions and targeted questions
- HITL: present intent capture and get explicit approval
- Resolve blockers before outlining or drafting
- Required skills:
requirements-authoring
Artifact: Requirement Outline (areas, file mapping, ID strategy, traceability plan).
Done when: user approves structure and requirement batching strategy.
- Propose MECE structure and area abbreviations
- Map files and IDs without writing final requirement text
- HITL: get user approval on structure and scope
- Required skills:
requirements-authoring
Artifact: Draft Requirement Units (per the requirements-authoring skill's requirement-unit asset).
Done when: every in-scope requirement has schema-complete draft and explicit user decision.
- Draft in small batches using
<req> schema
- Use EARS for FRs and measurable metrics for NFRs
- Keep unresolved or deferred units as
Draft
- Modify files directly, do not show to user
- Update
<req> schema if older/missing fields
- Required skills:
requirements-authoring
- If reverse engineering - it must be possible to rewrite using requirements only completely from scratch without old code present.
Artifact: Validation Report (rubric results, conflict checks, gap checks, risks).
Done when: checklist passes and unresolved issues are either fixed or explicitly deferred.
- Run validation using the
requirements-authoring skill's validation rubric
- Run conflict checks and gap checks
- Verify traceability source -> goal -> req -> test
- HITL: review findings with user as a narrative / story /walk-through
- Required skills:
requirements-authoring
- Recommended skills:
reverse-engineering
- If reverse engineering: MUST additionally validate there are NO hallucinations or made-up requirements
- Review all drafts requirements with user by providing a clear and exact story as a narrative/walk-through of a functionality of the application that this affected, use simple words and sentences (consider human doesn't know internal implementation). If possible you can also do that from point of view of the actor that this requirements affect (user of the app, admin of the dashboard, etc)
- You should combine affected and existing requirements for the proper narrative/story
- If there are multiple stories - create todo task to review each story separately
- Review story-by-story with user for approval, provide referenced content, examples, etc
- The narrative must still be very specific so that it allows to fully approve every aspect of requirements
- Do not assume user has a context, explain like user sees this first time
- Must review all assumptions and quirks
Artifact: Final Requirements Set, Validation Pack, Traceability Matrix, Change Log.
Done when: artifacts are stored in target location and state file is complete.
- Deliver final approved requirement set
- Update index and links
- Update the change log using the
requirements-authoring skill's change-log asset
- Mark state as complete
- Required skills:
requirements-authoring
- Coding must be performed using
coding-flow (ask, recommend, switch), on switch do not load requirements-use skill, as requirements-authoring is superior already.
- Every phase produced its artifact
- No must phase skipped or merged
- Should phase skipped only with reason
- Rosetta prep steps completed before discovery
- Intent capture approved before outline and draft
- Structure approved before drafting
- Each
<req> explicitly user-approved
- Validation rubric passed or deferred explicitly
- Traceability links are complete
- State file reflects final status
- Actors are clear at each HITL gate
- Non-goals are not introduced
- Skip questioning and guess intent
- Draft before intent capture approval
- Batch too much and lose review quality
- Mark req Approved without user approval
- Mix implementation details into requirements
- Validate without checking conflicts and gaps
- Omit traceability updates
- Forget state updates and lose flow continuity
1---2name: requirements-authoring-flow-63description: "Workflow for authoring requirements and specifications: drafting, review, validation, etc."4tags: ["workflow"]5baseSchema: docs/schemas/workflow.md6metadata:7 source: https://skillmd.com/skills/griddynamics/requirements-authoring-flow-68---910<requirements-flow>1112<description_and_purpose>13Prevents premature drafting by enforcing HITL gates where every `<req>` unit receives explicit user approval before proceeding. Each phase produces traceable artifacts (Final Requirements Set, Validation Pack, Traceability Matrix). Input: user request for new requirements, edits, review, refactor, or validation; USE SKILL `requirements-authoring` and PROACTIVELY REQUIRE its use in all phases and subagents.14</description_and_purpose>1516<workflow_phases>1718<prerequisites phase="0", applies="ALL">19201. All Rosetta prep steps MUST be FULLY completed212. USE SKILL `load-project-context`, `hitl`223. MUST ALWAYS use todo tasks ledger, ASAP. Phases are sequential. Independent tasks can run in parallel.234. No rush, take your time, MUST FOLLOW WORKFLOW ENTIRELY, no skipping245. Every phase MUST update `requirements-authoring-flow-state.md` in FEATURE TEMP with: phase name, status, artifact produced, and open questions.256. Orchestrator and subagents MUST USE SKILL `requirements-authoring`.267. If task is to reverse engineer orchestrator MUST USE SKILL `reverse-engineering`.278. Keep requirement identifiers in code comments only, must not be user facing.289. If `/goal` is set repeat phases 5-6 until goal is met, then continue with the rest of phases.2910. This workflow MUST be used with Fable, Opus, GPT-6.1-Sol+ class models => IF NOT - DEMAND USER TO SWITCH MODEL3031IMPORTANT! If the task is to reverse engineer requirements, spawn MULTIPLE subagents with each handling one unit of analysis (one screen, one page, one controller, one endpoint, etc) to effectively prevent hallucinations by narrow scoping for phases intent_capture, outline, draft, validate.3233</prerequisites>3435<discovery phase="1" priority="must" subagent="discoverer" role="Context analyst collecting project and scope signals" subagent_required_model="gpt-6-luna-high">3637Artifact: Discovery Summary (context, existing requirements, constraints, affected files).38Done when: scope boundaries and relevant requirement files are identified.39401. Complete all Rosetta prep steps412. Detect environment and project structure423. Read existing requirements, glossary, assumptions, constraints434. Identify requirement areas (FR, NFR, interfaces, data, traceability)445. Record assumptions and unknowns456. Required skills: `requirements-authoring`467. Recommended skills: `reverse-engineering`4748</discovery>4950<research phase="2" priority="should" subagent="requirements-engineer" role="Researcher collecting standards and prior decisions" subagent_required_model="gpt-6.1-sol-high">5152Artifact: Research Notes (sources, constraints, prior art, reusable requirement patterns).53Done when: relevant references are gathered OR no additional sources are needed.54Skip when: local context is complete and no external standards are needed.55561. Gather supporting docs and prior decisions572. Collect requirement patterns and quality criteria583. Capture measurable thresholds and terminology constraints594. Required skills: `requirements-authoring`6061</research>6263<intent_capture phase="3" priority="must" subagent="requirements-engineer" role="Requirements analyst capturing intent and assumptions" subagent_required_model="gpt-6.1-sol-high">6465Artifact: Intent Capture.66Done when: intent is restated, scope and goals confirmed, assumptions listed, and questions resolved.67681. Restate intent and confirm scope and goals692. List assumptions and targeted questions703. HITL: present intent capture and get explicit approval714. Resolve blockers before outlining or drafting725. Required skills: `requirements-authoring`7374</intent_capture>7576<outline phase="4" priority="must" subagent="requirements-engineer" role="Information architect proposing MECE requirement layout" subagent_required_model="gpt-6.1-sol-high">7778Artifact: Requirement Outline (areas, file mapping, ID strategy, traceability plan).79Done when: user approves structure and requirement batching strategy.80811. Propose MECE structure and area abbreviations822. Map files and IDs without writing final requirement text833. HITL: get user approval on structure and scope844. Required skills: `requirements-authoring`8586</outline>8788<draft phase="5" priority="must" subagent="requirements-engineer" role="Author drafting atomic requirement units" subagent_required_model="gpt-6.1-sol-high">8990Artifact: Draft Requirement Units (per the `requirements-authoring` skill's requirement-unit asset).91Done when: every in-scope requirement has schema-complete draft and explicit user decision.92931. Draft in small batches using `<req>` schema942. Use EARS for FRs and measurable metrics for NFRs953. Keep unresolved or deferred units as `Draft`964. Modify files directly, do not show to user975. Update `<req>` schema if older/missing fields986. Required skills: `requirements-authoring`997. If reverse engineering - it must be possible to rewrite using requirements only completely from scratch without old code present.100101</draft>102103<validate phase="6" priority="must" subagent="reviewer" role="Quality reviewer checking correctness, conflicts, and gaps" subagent_required_model="gpt-6-luna-high" must-be-subagent>104105Artifact: Validation Report (rubric results, conflict checks, gap checks, risks).106Done when: checklist passes and unresolved issues are either fixed or explicitly deferred.1071081. Run validation using the `requirements-authoring` skill's validation rubric1092. Run conflict checks and gap checks1103. Verify traceability source -> goal -> req -> test1114. HITL: review findings with user as a narrative / story /walk-through1125. Required skills: `requirements-authoring`1136. Recommended skills: `reverse-engineering`1147. If reverse engineering: MUST additionally validate there are NO hallucinations or made-up requirements115116</validate>117118<user_review phase="7" priority="must" type="HITL">1191201. Review all drafts requirements with user by providing a clear and exact story as a narrative/walk-through of a functionality of the application that this affected, use simple words and sentences (consider human doesn't know internal implementation). If possible you can also do that from point of view of the actor that this requirements affect (user of the app, admin of the dashboard, etc)1212. You should combine affected and existing requirements for the proper narrative/story1223. If there are multiple stories - create todo task to review each story separately1234. Review story-by-story with user for approval, provide referenced content, examples, etc1245. The narrative must still be very specific so that it allows to fully approve every aspect of requirements1256. Do not assume user has a context, explain like user sees this first time1267. Must review all assumptions and quirks127128</user_review>129130<finalization phase="8" priority="must" subagent="requirements-engineer" role="Business analyst finalizing requirement artifacts" subagent_required_model="gpt-6.1-sol-high">131132Artifact: Final Requirements Set, Validation Pack, Traceability Matrix, Change Log.133Done when: artifacts are stored in target location and state file is complete.1341351. Deliver final approved requirement set1362. Update index and links1373. Update the change log using the `requirements-authoring` skill's change-log asset1384. Mark state as complete1395. Required skills: `requirements-authoring`1406. Coding must be performed using `coding-flow` (ask, recommend, switch), on switch do not load `requirements-use` skill, as `requirements-authoring` is superior already.141142</finalization>143144</workflow_phases>145146<validation_checklist>147148- Every phase produced its artifact149- No must phase skipped or merged150- Should phase skipped only with reason151- Rosetta prep steps completed before discovery152- Intent capture approved before outline and draft153- Structure approved before drafting154- Each `<req>` explicitly user-approved155- Validation rubric passed or deferred explicitly156- Traceability links are complete157- State file reflects final status158- Actors are clear at each HITL gate159- Non-goals are not introduced160161</validation_checklist>162163<pitfalls>164165- Skip questioning and guess intent166- Draft before intent capture approval167- Batch too much and lose review quality168- Mark req Approved without user approval169- Mix implementation details into requirements170- Validate without checking conflicts and gaps171- Omit traceability updates172- Forget state updates and lose flow continuity173174</pitfalls>175176</requirements-flow>