comprehension-gate

Review code changes for comprehensibility, security, and blast radius.

2|1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/bigeasyfreeman/adlc --skill comprehension-gate-bigeasyfreeman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: comprehension-gate
Source: https://github.com/bigeasyfreeman/adlc/tree/main/skills/comprehension-gate
Command: npx skills add https://github.com/bigeasyfreeman/adlc --skill comprehension-gate-bigeasyfreeman

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

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.

Frequently Asked Questions about comprehension-gate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is a code review blast radius assessment?

A code review comprehension check identifies unclear implications in state, secrets, and assumptions, producing a blocking artifact to prevent merging unsafe or unexplainable code changes.

How do I check code changes for security risks and comprehensibility?

Run a comprehension gate review on your code changes to validate token handling, check state persistence impacts, and produce a blocking artifact if implications remain unexplainable.

Does this code review process block merges when implications are unclear?

Yes, the comprehension gate review produces a blocking artifact when code change implications are unclear, enforcing a strict verdict on whether the update is safe to proceed with.

When do I need to validate assumptions and state persistence during code review?

You need assumption validation and state checks during code review when changes risk mismatched production-state impacts, ensuring documented assumptions hold under various conditions.

Can I assess token and session management security within a code review?

Yes, you can assess token and session management during code review to evaluate handling security, check state persistence, and identify potential credential exposure risks.