docs(skill): clarify impact analysis triggers
This commit is contained in:
1 parent
3e1db3d6f2
commit
e5205316ab
1 file changed
+11
-4
@@ -1,12 +1,19 @@
|
||||
---
|
||||
name: change-impact-analysis
|
||||
description: Determine what a proposed change may affect.
|
||||
description: Use before implementation when a proposed code, configuration, data, or workflow change has uncertain callers, compatibility effects, dependencies, or blast radius. Return an impact analysis without implementing it.
|
||||
---
|
||||
|
||||
# Change Impact Analysis
|
||||
|
||||
Use when the blast radius or compatibility impact is uncertain.
|
||||
Use before a change when its consumers, compatibility effects, or blast radius are uncertain.
|
||||
|
||||
Inspect callers, dependencies, configuration, tests, and affected workflows.
|
||||
## Workflow
|
||||
|
||||
Return affected areas, risks, and recommended verification. Separate facts from assumptions.
|
||||
1. Define the proposed change and the behavior or contract it affects.
|
||||
2. Locate direct callers, related implementations, shared helpers, configuration, generated output, and relevant tests. Start with exact-path and symbol searches; broaden only when the flow is unclear.
|
||||
3. Trace likely impact through runtime paths, persisted data, client integrations, deployment, and documentation as applicable.
|
||||
4. Identify compatibility concerns, failure modes, security or data-loss risks, and dependencies on version or environment.
|
||||
5. Separate confirmed impacts from assumptions and unknowns. Do not treat a possible downstream effect as a fact without evidence.
|
||||
6. Recommend proportionate verification tied to the risks found.
|
||||
|
||||
Return a concise impact map: affected areas, evidence, risks, unknowns, and checks. Do not implement the proposal unless asked.
|
||||
Reference in new issue
Block a user