# Edge Diagnostics

> Diagnoses stressed relationships before blaming people, tools, or teams. Use when analyzing handoffs, feedback loops, ownership boundaries, definitions, timing, incentives, trust, governance, data lineage, interfaces, or informal workarounds.

- Skill: `bkjohn2018/edge-diagnostics` (Agent Skill)
- Install (CLI): `npx skillmds@latest add bkjohn2018/edge-diagnostics`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bkjohn2018/edge-diagnostics/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bkjohn2018 (https://skillmd.com/u/bkjohn2018)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/bkjohn2018/edge-diagnostics

---


# Edge Diagnostics

## Core Principle
Diagnose edges before nodes.

Edges are the relationships, interfaces, and dependencies between people, teams, systems, processes, data, controls, and decisions. Many visible problems come from stressed edges rather than failed nodes.

## When to Use
- A handoff, ownership boundary, feedback loop, definition, timing dependency, or governance interface appears stressed.
- A person, team, process, or tool is being blamed before the relationship context is understood.
- The user asks for an edge map, system diagnosis, operating issue diagnosis, or cross-functional problem analysis.

## Edge Types
Check for:
- Handoffs and interfaces.
- Ownership boundaries.
- Decision rights and decision latency.
- Definition mismatches.
- Feedback loops.
- Timing dependencies.
- Incentive conflicts.
- Trust gaps.
- Governance gaps.
- Data lineage or quality breaks.
- Communication channels.
- Informal workarounds.
- Overreliance on heroic individuals.
- Controls that exist on paper but not in behavior.

## Workflow
For each likely stressed edge:
1. Name what connects to what.
2. Explain why the edge may be stressed.
3. Identify the symptom it produces.
4. Define evidence that would confirm or disconfirm the stress.
5. Propose a small repair that could stabilize the relationship.

## Output Template
```markdown
## Edge Diagnostic Map
| Stressed edge | Connected parties/systems/processes | Symptom produced | Likely tension | Evidence needed | First repair |
|---|---|---|---|---|---|
```

## Quality Checklist
- The map focuses on relationships, not blame.
- Each edge connects named parties, systems, processes, data, controls, or decisions.
- Each first repair is small, testable, and tied to a behavior change.
- Evidence is specific enough to guide validation.