finding-discipline
FeaturedUse when about to record, claim, rate the severity of, or report any security finding — before marking anything [CONFIRMED] or writing it into the report
DevOps & Infrastructure 382 stars
66 forks Updated 5 days ago MIT
Install
Quality Score: 89/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# Finding Discipline
## Overview
**The Iron Law: No `[CONFIRMED]` without proof.** A finding is a claim about real, demonstrated
impact — not a status code, a reflected string, or a hunch. This is the offensive equivalent of
test-driven development: the proof is the test, and the finding does not exist until it passes.
**Violating the letter of this rule is violating its spirit.**
## The three tiers
- **`[CONFIRMED]`** — impact demonstrated AND grounded in an evidence artifact that exists on disk.
- **`[POSSIBLE]`** — reachable but the class proof bar is not yet met. Keep digging; do not report as real.
- **`[INFO]`** — true but no security impact at the claimed severity.
## The proof bar (per class)
A status code is not impact. See `skills/references/finding-evidence-standards.md`:
SSRF needs the internal response; IDOR needs *another principal's* data; RCE needs command output;
XSS needs script execution; open redirect needs an external destination.
## Required mechanical gate
Before any finding is recorded or reported:
1. Set the structured proof signal and run
`python skills/vulnerability-analysis/scripts/validate_findings.py --findings f.json --evidence ./evidence`
— it rejects ungrounded findings and per-class false positives.
2. Pass it through the **REQUIRED** `finding-validator` agent (PASS / KILL / DOWNGRADE).
3. Only a `[CONFIRMED]` survivor goes in the report. Severity must match what was demonstrated (CVSS honest).
See `skills/references/finding-...
Details
- Author
- hypnguyen1209
- Repository
- hypnguyen1209/offensive-claude
- Created
- 4 months ago
- Last Updated
- 5 days ago
- Language
- Python
- License
- MIT
Bundled in these plugins
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Listed
findings-spine
Record and advance every vulnerability finding through the tool-owned mantis_findings service instead of tracking findings in prose
504 Updated today
deonmenezes Code & Development Listed
verify-finding
Verify a reported finding against the real code, then move its card to the state the evidence justifies. Triggers: is this still an issue, verify these findings, triage the board.
1 Updated yesterday
samiraklf Data & Documents Listed
grounding-research
Use when exploring or investigating a codebase, tracing execution paths, mapping dependencies, or producing a sourced findings report. Distinct from grounding-review, which is for reviewing PRs.
0 Updated today
igorjs