Skip to content

nddipiazza/robos / .agents/skills/kgraph-impact-analysis

kgraph-impact-analysis

Verified

Trace upstream and downstream blast radiuses and transitive dependencies before modifying any service, database, or contract.

FileKindSize
SKILL.mdskill md2.0 KB
---
name: kgraph-impact-analysis
description: Trace upstream and downstream blast radiuses and transitive dependencies before modifying any service, database, or contract.
---

# Knowledge Graph Impact Analysis & Blast Radius (`kgraph-impact-analysis`)

Trace all incoming and outgoing dependency edges recursively to determine the blast radius of changing an architectural node before writing code.

## When to Use
- Evaluating the ripple effect before altering a database schema or OpenAPI contract.
- Calculating which downstream client applications or microservices must be regression tested.
- Generating pre-PR blast radius summaries for code reviews.

## Execution
```bash
# Check blast radius of changing auth-service up to 3 hops
node packages/robos-graph/bin/kgraph-cli.js impact "urn:robos:service:forms-api" --depth 3

# Export impact graph as JSON
node packages/robos-graph/bin/kgraph-cli.js impact "urn:robos:service:forms-api" --json
```

## Dependency semantics

Use an explicit `--graph-root /absolute/workspace` for every command. Impact
returns both `dependents` (who relies on this node) and `dependencies` (what this
node relies on), with shortest-hop depth, predicate and available relationship
evidence. Dependency direction is dependent → prerequisite. Repository membership,
source derivation, ownership and generic reference links are not dependency edges.
Conditional evidence remains conditional; transitive results identify candidates
for review, not proof that every condition is active together.

`query --depends-on <id> --depth 1 --json` filters direct modeled dependents;
increase depth for transitive candidates. `query --path-from ... --path-to ...`
traces directed reference connectivity, which is broader than dependency impact.
Do not treat an undirected connection, a shared repository or a zero-result query
as proof of dependency correctness or safe change. Inspect the cited source and
report unmodeled external packages/types and unknown relationships explicitly.
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall