- name
- agile-v-risk-classifier
- description
- Risk level classification guidance (L0-L4) for Agile-V tasks.
# Agile-V Risk Classification
## Risk Levels
### L0: Trivial
- Documentation changes, comments, README updates
- No change to code execution, no change to any test
- Examples: fix a typo, update a diagram, add a comment
### L1: Low Risk
- Small bug fixes in non-critical paths
- Internal refactors with no API or interface change
- New unit tests added to existing coverage
- Logging additions with no business logic change
- Examples: rename a variable, fix an off-by-one error, add a log statement
### L2: Moderate Risk
- New features (internal, non-security-sensitive)
- Non-breaking API or interface changes
- Additive database schema changes (new column, new table)
- New validated dependencies
- Changes to shared utilities or common modules
- Examples: add a new REST endpoint, add a search filter, add a new DB column
### L3: High Risk
- Breaking API or interface changes (existing callers affected)
- Authentication, authorization, or permission changes
- Cryptography or secret-handling changes
- Destructive or migrating database schema changes
- Infrastructure or deployment changes in production environments
- Security-sensitive configuration changes
- Examples: change auth token format, drop a database column, change CORS policy
### L4: Critical Risk
- Safety-critical system changes (hardware, firmware, medical, aviation, automotive)
- Financial transaction integrity (payment processing, ledger changes)
- Bulk customer data deletion or migration
- Cryptographic key rotation or algorithm change in regulated systems
- Changes requiring formal verification, HIL testing, or regulatory sign-off
## Evidence Requirements
| Level | Tests | Verifier | Approval | Special |
|-------|-------|----------|----------|---------|
| L0 | Optional | No | No | - |
| L1 | Required or rationale | No | No | - |
| L2 | Passing | Yes | Reviewer | - |
| L3 | Passing | Yes | Domain owner | Rollback path documented |
| L4 | Passing | Yes | Formal | Simulation/HIL/formal verification + traceability matrix |
## Classification Rules
**When unsure, default to the higher risk level.**
If a change touches multiple categories, use the highest level that applies.
L3/L4 classification requires an explicit risk assessment written into the evidence bundle before work begins.
A change initially classified as L1 must be re-classified if it unexpectedly touches an auth path, security control, or shared interface.
Ver no GitHub