majiayu000 Requirements Triage Extension
Provides decision-making knowledge for triaging requirements-related findings during the finalize phase.
Purpose
This skill is a triage extension loaded by the plan-finalize workflow skill when processing requirements documentation findings. It provides domain-specific knowledge for deciding whether to fix, suppress, or accept findings.
Key Principle: This skill provides knowledge, not workflow control. The finalize skill owns the process.
When This Skill is Loaded
Loaded via resolve-workflow-skill-extension --domain requirements --type triage during finalize phase when:
- AsciiDoc validation errors occur in requirements documents
- Requirements structure issues are detected
- Traceability gaps are identified
- Acceptance criteria format issues are found
Standards
| Document | Purpose |
|---|---|
| suppression.md | AsciiDoc comment syntax for suppression |
| severity.md | Requirements-specific severity guidelines |
Extension Registration
Registered in marshal.json under the requirements domain:
"requirements": {
"workflow_skill_extensions": {
"triage": "pm-requirements:ext-triage-reqs"
}
}
Quick Reference
Suppression Methods
| Finding Type | Syntax |
|---|---|
| AsciiDoc lint | // asciidoc-lint-disable comment |
| Link validation | // skip-link-check comment |
| Structure issue | Document exception in requirements metadata |
Decision Guidelines
| Severity | Default Action |
|---|---|
| Structure error | Fix (requirements must be well-formed) |
| Missing traceability | Fix or document exception |
| Format inconsistency | Fix for consistency |
| Style warning | Accept or fix |
Acceptable to Accept
- Draft requirements pending review
- Placeholder acceptance criteria in early stages
- Legacy requirements pending migration
- External reference format differences
Related Documents
- workflow-extension-api:triage-extension - Triage extension contract
- pm-requirements:requirements-authoring - Requirements authoring standards