adinsights-scope-gatekeeper

Evaluate proposed changes for scope risk in the ADinsights project.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/cpowe-ADT/ADinsights --skill adinsights-scope-gatekeeper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adinsights-scope-gatekeeper
Source: https://github.com/cpowe-ADT/ADinsights/tree/main/docs/ops/skills/adinsights-scope-gatekeeper
Command: npx skills add https://github.com/cpowe-ADT/ADinsights --skill adinsights-scope-gatekeeper

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Evaluates scope and escalation risks for ADinsights AI coding sessions, helping teams avoid cross-folder changes and architecture-sensitive mistakes.

Core Features & Use Cases

  • Automatically assesses whether a proposed change spans multiple top-level folders and flags escalation needs.
  • Generates an advisory scope packet with touched folders, required reviewers, tests, and docs updates.
  • Routes to contract guard or release readiness when contract risk is detected, and maintains decision rationale for governance.

Quick Start

Run the gatekeeper on a prompt and optional path hints to receive a structured advisory packet.

Frequently Asked Questions about adinsights-scope-gatekeeper

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

FAQPage Schema
How do I assess scope risk for architecture-sensitive code changes?

Assess scope risk by evaluating proposed changes against governance rules to detect cross-folder modifications and architecture-sensitive edits. The gatekeeper analyzes git-changed files and explicit paths to produce a structured advisory packet with escalation routing and rationale.

How do I prevent cross-folder changes in an AI coding session?

Prevent cross-folder changes by applying a gatekeeper to requests spanning multiple top-level folders. It reads scope rules from YAML configuration, evaluates touched directories, and returns a structured packet with required reviewers and recommended actions.

When do I need to escalate API and data contract changes?

Escalate API and data contract changes when a gatekeeper detects contract risk during scope evaluation. It automatically routes the advisory packet to contract guard or release readiness workflows while maintaining decision rationale for governance tracking.

Can I use a YAML rules file to govern project scope and ownership?

Yes, you can govern project scope by defining rules in a YAML file. The gatekeeper reads these scope rules to identify touched folders, determine scope ownership signals, and generate advisory packets with tests and documentation updates.

How do I generate an advisory packet for required code reviewers?

Generate an advisory packet by running the gatekeeper on a prompt with optional path hints. It gathers evidence from git-changed files, produces rationale, tests, and recommended actions, and routes the structured packet to the appropriate reviewers.

Does pyyaml support reading custom governance rules for scope evaluation?

Yes, pyyaml supports reading custom governance rules for scope evaluation. The gatekeeper relies on it to parse scope-rules.yaml, applying those rules to evaluate architecture-sensitive edits and return structured escalation routing packets.