finding-review

What problem does it solve?

Provides a structured, standards-driven review of existing security findings to improve clarity, correctness, and actionable guidance so maintainers can assess and remediate issues confidently.

Core Features & Use Cases

• Structural validation: Parses finding frontmatter and sections and reports schema violations.
• Quality assessment: Evaluates title clarity, description completeness, recommendation objectivity, severity accuracy, and precondition specification.
• Cross-checking: Invokes a familiar agent for impact and feasibility triangulation and a librarian agent to verify and locate authoritative references.
• Interactive fixes: Presents passes, warnings, failures, and recommendations and can apply approved edits and re-run validation.
• Use case: Run on a repository finding file to harden a draft finding before publishing or triaging in a security audit.

Quick Start

Review the specified finding file, run the validation checks, include the familiar and librarian assessments, and apply the recommended edits when prompted.