What problem does it solve?
This Skill reviews code changes for understanding, blast radius, state, secrets, assumptions, and explainability, producing a blocking comprehension artifact when implications are unclear.
Core Features & Use Cases
- Comprehension Review: Checks if the change is understandable and assesses its impact.
- Security Analysis: Identifies potential security risks like credential exposure and data flow issues.
- Blast Radius Assessment: Determines the scope of potential failure and system impact.
- State and Persistence Check: Ensures there's no mismatch between code scope and production-state impact.
- Token and Session Management: Evaluates token and session handling for security.
- Assumption Validation: Checks for documented assumptions and their validity under various conditions.
- Comprehension Verdict: Provides a clear verdict on whether the change is understandable and safe to proceed with.
Quick Start
Run the comprehension-gate skill on the latest code changes to ensure they are comprehensible and secure before merging.