comprehension-gate

A pre-merge code comprehension review analyzes changes across seven dimensions to prevent dark-code risk. It ensures modifications to shared resources or authentication flows are explainable, auditable, and safe before deployment.

Run the comprehension gate against your current diff to perform multi-dimensional pre-merge review on AI-generated code. It guides context gathering, analyzes credential exposure and side effects, then generates a COMPREHENSION_ARTIFACT.md with a final verdict.

Yes, pre-merge comprehension analysis explicitly handles changes touching authentication flows and token TTL management. It evaluates these specific areas during its seven-dimension review to identify implicit assumptions and verify safe state persistence.

The COMPREHENSION_ARTIFACT.md contains a detailed findings table from the seven-dimension analysis and a final deployment verdict. The verdict is either CLEAR, REVIEW REQUIRED, or HOLD to support safe deployment decisions.

Seven-dimension code review detects dark-code risk by analyzing blast radius, cross-service side effects, and explainability for changes in shared resources. This structured analysis exposes hidden implicit assumptions that automated tests often miss.

Use a comprehension gate instead of standard code review when evaluating complex changes across modules, especially AI-generated code or modifications to shared resources. It provides a rigorous seven-dimension analysis to prevent unexplainable dark-code from reaching production.