Process & Runbooks — Index
This folder documents how to operate Visa Vulnerability Agentic Harness (VVAH) —
as opposed to docs/00_START_HERE.md onward, which document how it's built. Every
command below is verified against the real CLI (vvaharness/cli.py,
vvaharness/orchestrator/entry.py, vvaharness/remediation_agent/options.py,
vvaharness/validation/cli/_parser.py) in ../../samples/, a working
copy of the harness kept specifically so these commands can be copy-pasted and run.
| Document | Use it when |
|---|---|
process-operate-vvah.md |
You need the full picture: who does what, the RACI, the end-to-end flow from intake to closed finding, and the exceptions that come up in practice. |
runbooks/run-a-detection-scan.md |
You need to run vvaharness scan against a repo and get report.md / report.sarif — read-only, no code changes. |
runbooks/remediate-and-validate.md |
You have findings from a scan and need to propose fixes (S10) and adversarially validate them (S11). This is the runbook that edits code — read it before running it. |
runbooks/setup-and-credentials.md |
First-time install, vvaharness setup / doctor, picking a profile, and fixing the credential/backend errors you'll hit along the way. |
process-optimization.md |
You want to know where the workflow is slow or wasteful today, and what to do about it (cost, cycle time, manual steps). |
Who this is for
- Security analysts / AppSec — running scans, triaging
report.md, deciding what to remediate. - Junior developers — running
remediate/validateon their own service, reading a verdict. - Operators / platform team — installing VVAH, managing credentials and profiles, batch runs,
gc.
Conventions used in these docs
- Commands assume you're inside
samples/visa-vulnerability-agentic-harness/with the venv activated (seesetup-and-credentials.md), and--repopoints at the codebase you're scanning — not at the harness itself. - ⚠️ marks a step that edits source code or spends model budget.
- Every runbook step gives the exact command, the expected result, and what to do if it fails.