/audit-waiver Managing Findings Create a waiver for a checklist item that doesn't apply. Documents why and sets a review date.
Audit Waiver
You are creating a waiver for a checklist item.
Usage
/audit-waiver AUTH-003
/audit-waiver AUTH-003 --project internal-tools
Flow
Step 1: Identify Item
Find the item in checklist/checklist/*/items.yaml and confirm:
Creating waiver for: [ITEM-ID] - [Title] Section: [section name] Severity: [critical/recommended]
Is this correct? (y/n)
Step 2: Scope
Does this waiver apply to:
- All projects (global waiver)
- Specific projects (select which)
If specific, show project list from projects/ and let them select.
Step 3: Reason
Why doesn't this item apply?
- Using alternative approach
- Not applicable to our architecture
- Covered by another control
- Risk accepted
- Other (specify)
Please explain:
Step 4: Conditions
Under what conditions would this waiver be void? (Enter conditions, or skip)
Step 5: Approval
Who is approving this waiver?
Name and title:
Step 6: Review Date
When should this waiver be reviewed?
- 3 months
- 6 months
- 1 year
- Custom date
Generate Waiver
Create file based on scope:
- Global:
waivers/[ITEM-ID].md - Project-specific:
waivers/[project]/[ITEM-ID].md
---
item_id: [ID]
title: [Title]
status: not-applicable
applies_to:
- [project list or "all"]
approved_by: [Name (Title)]
approved_at: [ISO date]
review_date: [ISO date]
---
## Reason
[Detailed reason]
## Alternative Controls
[If applicable - what they're doing instead]
## Conditions
This waiver is void if:
- [condition 1]
- [condition 2]
## Review History
| Date | Reviewer | Decision |
|------|----------|----------|
| [date] | [name] | Created |
After Creation
Waiver created: waivers/[path]/[ITEM-ID].md
This item will be excluded from future audits for:
- [project list or "all projects"]
Review scheduled for: [date]
To edit: open waivers/[path]/[ITEM-ID].md To delete: remove the file
Listing Existing Waivers
If invoked without an item ID:
Existing waivers:
Item Applies To Approved Review Date AUTH-003 internal-tools 2026-01-15 2026-07-15 SEC-002 all 2026-02-01 2027-02-01 Create new waiver:
/audit-waiver <ITEM-ID>
Waiver Expiry Warning
When a waiver's review date has passed or is within 30 days, warn:
Warning: Waiver for [ITEM-ID] is due for review ([date]). Please review and either renew or remove it.