Skip to content

maxwellokumu/okaudit-claude-skills / lead-it-auditor/artefact-gap-analyzer

artefact-gap-analyzer

Verified

Compare expected audit evidence artefacts from an audit program JSON against provided files and report gaps with coverage percentage. Use this skill for evidence coverage review and missing artefact analysis.

# artefact-gap-analyzer

Compare expected audit evidence artefacts from an audit program against files you have
collected, and report exactly what is still missing — with coverage percentage.

---

## Purpose

After generating an audit program with `audit-scope-checklist`, use this skill to:
- Track which required artefacts have been collected
- Identify gaps with their control IDs, details, and acceptance criteria
- Report overall evidence coverage as a percentage

---

## Requirements

```bash
pip install python-dotenv
```

---

## Usage

```bash
# Compare against a comma-separated list of file names
python main.py \
  --program audit_program.json \
  --provided "iam_policy.pdf,user_access_report.csv,firewall_rules.xlsx"

# Compare against an entire directory of evidence files
python main.py \
  --program audit_program.json \
  --provided ./evidence/

# Using sample input files
python main.py \
  --program sample_input/sample_audit_program.json \
  --provided sample_input/sample_evidence/
```

---

## Sample Output (truncated)

```markdown
# Artefact Gap Analysis Report
**Date:** 2025-07-01  
**Controls reviewed:** 12 | **Matched:** 7 | **Missing:** 5 | **Coverage:** 58.3%

## ✅ Matched Artefacts
| ID | Artefact | Matched File |
|----|----------|-------------|
| IAM-001 | user_access_report.csv | user_access_report.csv |

## ❌ Missing Artefacts
| ID | Artefact | Details | Acceptance Criteria |
|----|----------|---------|---------------------|
| IAM-002 | mfa_status_report.csv | Confirm MFA enabled for all users | 100% of users enrolled... |
```

---

## Notes

- Artefact matching is **case-insensitive**
- If `--provided` is a directory, all files in that directory (non-recursive) are checked
- Partial name matches are not used — the artefact filename must appear in the provided list
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall