ADG Repair Loop Skill

Guide users through a 4-question litmus test before code edits using ADG artifacts.

Updated Oct 9, 2025
One-click install
npx skills add https://github.com/Siamese001/Agentic-Workflow --skill adg-repair-loop-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ADG Repair Loop Skill
Source: https://github.com/Siamese001/Agentic-Workflow/tree/main/.windsurf/skills/adg-repair-loop
Command: npx skills add https://github.com/Siamese001/Agentic-Workflow --skill adg-repair-loop-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill enforces a strict pre-edit gate for code modifications within a scoped repair session, ensuring adherence to the ADG repair discipline and preventing unintended consequences.

Core Features & Use Cases

  • Pre-Edit Gate: Guides the user through a 4-question litmus test before any code edit.
  • Artifact Validation: Leverages ADG artifacts (JSON files) to identify the relevant ADG cluster, root module, scoped tests, and blast radius.
  • Guided Repair: Provides specific commands for rebuilding ADG artifacts and running scoped tests.
  • Use Case: When a test fails in the agentic_core/L0_routing/scripts/execute_ssot.py module, this skill ensures you first identify the correct ADG cluster, pinpoint the exact root module, gather the precise test IDs, and justify the blast radius before making any changes.

Quick Start

Before editing code, answer the four ADG questions using the provided artifacts.

Frequently Asked Questions about ADG Repair Loop Skill

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

FAQPage Schema
How do I enforce a pre-edit gate for scoped code repair sessions?

To enforce a pre-edit gate for code repair sessions, you can use a 4-question litmus test based on ADG artifacts. This process identifies the correct ADG cluster, root module, scoped tests, and blast radius justifications before allowing any code modifications.

What is an ADG cluster and how does it relate to code modification discipline?

An ADG cluster is a structural grouping identified within ADG JSON artifacts used to guide code modifications. It helps pinpoint the exact root module and determine the blast radius of changes, ensuring deterministic and auditable code repair discipline.

How do I validate blast radius and scoped tests before editing code?

You validate blast radius and scoped tests by answering a 4-question litmus test using ADG artifacts. This requires identifying the specific ADG cluster, gathering precise test IDs, and justifying the blast radius before making any code changes.

Do I need existing ADG artifacts to run a repair discipline litmus test?

Yes, you need existing ADG artifacts in JSON format to run the repair discipline litmus test. If artifacts are missing or outdated, the skill provides specific commands for rebuilding them so you can accurately identify the root module and blast radius.

What's the best way to ensure deterministic and auditable code modifications?

The best way to ensure deterministic and auditable code modifications is to enforce a strict pre-edit gate using ADG artifacts. This involves validating the ADG cluster, root module, and scoped tests, then executing those scoped tests after rebuilding artifacts.

Why does my scoped test fail when modifying root modules without ADG validation?

Scoped tests fail when modifying root modules without ADG validation because the blast radius and cluster dependencies are not properly justified. Enforcing a pre-edit gate with ADG artifacts ensures you pinpoint the exact root module and gather precise test IDs before changes.