Skip to content

Commit ae27429

Browse files
authored
Merge pull request #96 from EdDev/clarify-risk-section-none-handling
agents: clarify risk section rules for no-risk entries and optional Other category
2 parents 9035358 + e5eaec5 commit ae27429

1 file changed

Lines changed: 15 additions & 5 deletions

File tree

AGENTS.md

Lines changed: 15 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -199,16 +199,26 @@ Assisted-by: Claude <noreply@anthropic.com>
199199

200200
### II.5 — Risks
201201

202-
- [ ] ALL 7 risk categories are addressed (even if N/A with justification):
202+
- [ ] ALL 6 standard risk categories are addressed (even if no risk, include Mitigation with brief justification):
203203
Timeline/Schedule, Test Coverage, Test Environment, Untestable Aspects,
204-
Resource Constraints, Dependencies, Other
205-
- [ ] Each risk has: Risk description, Mitigation strategy, Sign-off
206-
- [ ] N/A risks have brief justification (not just "N/A")
204+
Resource Constraints, Dependencies
205+
- [ ] "Other" category is included only if risks exist that don't fit the 6 standard categories above
206+
- [ ] When a risk exists: full entry required — Risk description, Mitigation strategy, Sign-off,
207+
and the category-specific supplemental field:
208+
*Estimated impact on schedule* (Timeline/Schedule),
209+
*Areas with reduced coverage* (Test Coverage),
210+
*Missing or unavailable environments* (Test Environment),
211+
*Missing resources or infrastructure* (Resource Constraints),
212+
*Third-party services or blockers* (Dependencies),
213+
*Reason untestable and mitigation approach* (Untestable Aspects)
214+
- [ ] When no risk exists: only a short justification in the Mitigation field is needed
215+
(not just "N/A"); no Sign-off or category-specific supplemental fields are required
207216
- [ ] Mitigations are specific and actionable (not "we will address this")
208217

209218
**Common rejection reasons:**
210219
- All risks marked N/A (unrealistic — every feature has some risk)
211-
- Missing sign-off fields on risk entries
220+
- Missing sign-off on risk entries where a real risk is described
221+
- Mitigation says "N/A" without explaining why no mitigation is needed
212222
- Vague mitigations without specific actions
213223
- Missing risk categories entirely
214224

0 commit comments

Comments
 (0)