/plugadvpl:impacto

Trace downstream impact chains of SX3 fields across ADVPL sources and Protheus dictionaries.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/JoniPraia/plugadvpl --skill plugadvpl-impacto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: /plugadvpl:impacto
Source: https://github.com/JoniPraia/plugadvpl/tree/main/skills/impacto
Command: npx skills add https://github.com/JoniPraia/plugadvpl --skill plugadvpl-impacto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a specific ADVPL field (from SX3) changes or breaks behavior, it’s hard to know which validations, triggers, and questions across your Protheus codebase are impacted. This Skill identifies every downstream usage chain so you can assess impact without manually hunting through thousands of lines.

Core Features & Use Cases

  • SX3 impact graph: Finds all sources that mention an SX3 field, including .prw/.tlpp references.
  • Validation + UI dependencies: Detects SX3 rules that depend on the field (X3_VALID, X3_WHEN, X3_VLDUSER, X3_RELACAO).
  • Trigger and question reachability: Lists SX7 triggers where the field appears as origin/destination and SX1 questions referencing it (X1_VALID, X1_DEF01..X1_DEF99), enabling a complete chain-of-impact view.
  • Encoding-safe workflow guidance: Assumes UTF-8-only Claude read/edit behavior and supports the index flow where you must run ingest before analysis.
  • Use Case: If you need to understand how changing A1_COD affects customer-related behavior, you can discover every .prw usage plus related SX3 validations, SX7 trigger wiring, and SX1 questions that reference it.
  • Practical output for triage: Produces rows with tipo, local, contexto, and severidade so you can quickly prioritize where to investigate.

Quick Start

Run impacto for the field you’re investigating (for example, A1_COD) after ingesting SX metadata so you get the full chain of impacted sources, validations, triggers, and questions.

Frequently Asked Questions about /plugadvpl:impacto

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

FAQPage Schema
How do I trace the full impact of an SX3 field change in Protheus?

Tracing the impact of an SX3 field change in Protheus requires identifying all dependent validations, triggers, and questions. This analysis computes downstream matches with boundary rules per row type and outputs structured rows with context and severity.

What does an SX3 field impact analysis include in an ADVPL codebase?

An SX3 field impact analysis includes all `.prw` and `.tlpp` source references, SX3 validation rules like X3_VALID and X3_VLDUSER, SX7 trigger wiring, and SX1 questions referencing the field to provide a complete chain-of-impact view.

Do I need to run a local index before analyzing Protheus SX3 dependencies?

Yes, you must run the ingest-sx process to build a local index before analyzing Protheus SX3 dependencies. The impact analysis requires this existing local index to compute matches and output structured rows with severity.

How do I find SX7 triggers and SX1 questions affected by an ADVPL field edit?

To find affected SX7 triggers and SX1 questions after an ADVPL field edit, run an impact analysis. It lists all SX7 triggers where the field appears as origin or destination and SX1 questions referencing it via X1_VALID or X1_DEF01..X1_DEF99.

Can I assess the blast radius of a Protheus dictionary change before refactoring?

You can assess the blast radius of a Protheus dictionary change by computing the complete downstream impact chain across ADVPL sources and dictionaries. The analysis outputs structured rows with tipo, local, contexto, and severidade for quick triage.

Why does my ADVPL field impact analysis assume UTF-8 encoding only?

Your ADVPL field impact analysis assumes UTF-8 encoding only because it follows an encoding-safe workflow guidance. This approach supports the index flow where you must run ingest before analysis to ensure accurate static indexing.