# syncause/debug-skill architecture

> Architecture diagram of the GitHub repository syncause/debug-skill, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/syncause/debug-skill
- Repository: https://github.com/syncause/debug-skill

## Overview

Syncause is an agent skill for evidence-based debugging, not a runtime tracing implementation. The documented workflow takes a reported bug through reproduction and retrieval of Runtime Facts, then requires an evidence-cited repair and reviewable report. The skill instructions live in `SKILL.md`; the README says the skill depends on a separately installed MCP server, which supplies access to runtime evidence. No source excerpts were provided, so relationships below rely only on README statements; installation guides are not part of the runtime workflow.

Main entry points: [`skills/syncause-debugger/SKILL.md`](https://github.com/syncause/debug-skill/blob/main/skills/syncause-debugger/SKILL.md) (Evidence-based repair)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Debugging workflow"]
  node_skill["Debugger skill<br/>[SKILL.md]"]
  node_reproduce["Issue reproduction<br/>[SKILL.md]"]
  node_repair["Evidence-based repair<br/>[SKILL.md]"]
  node_report["Repair report<br/>[SKILL.md]"]
end

subgraph group_integration["Evidence integration"]
  node_facts["Runtime Facts"]
  node_mcp["Syncause MCP"]
  node_tracing["Trace capture"]
end

node_user(("Developer"))
node_agent(("AI agent"))

node_user -->|"reports bug"| node_agent
node_skill -->|"constrains behavior"| node_agent
node_agent -->|"reproduces issue"| node_reproduce
node_agent -->|"fetches facts"| node_mcp
node_tracing -->|"captures calls"| node_facts
node_mcp -->|"provides access"| node_facts
node_facts -->|"grounds repair"| node_repair
node_agent -->|"makes fix"| node_repair
node_repair -->|"explains evidence"| node_report
node_report -->|"presents results"| node_user

click node_skill "https://github.com/syncause/debug-skill/blob/main/skills/syncause-debugger/SKILL.md"
click node_reproduce "https://github.com/syncause/debug-skill/blob/main/skills/syncause-debugger/SKILL.md"
click node_repair "https://github.com/syncause/debug-skill/blob/main/skills/syncause-debugger/SKILL.md"
click node_report "https://github.com/syncause/debug-skill/blob/main/skills/syncause-debugger/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill,node_reproduce,node_repair,node_report toneBlue
class node_facts,node_mcp,node_tracing toneAmber
class node_user,node_agent toneIndigo
```

## Components

### Debugging workflow

- [Debugger skill](https://github.com/syncause/debug-skill/blob/main/skills/syncause-debugger/SKILL.md): `skills/syncause-debugger/SKILL.md`
- [Issue reproduction](https://github.com/syncause/debug-skill/blob/main/skills/syncause-debugger/SKILL.md): `skills/syncause-debugger/SKILL.md`
- [Evidence-based repair](https://github.com/syncause/debug-skill/blob/main/skills/syncause-debugger/SKILL.md): `skills/syncause-debugger/SKILL.md`
- [Repair report](https://github.com/syncause/debug-skill/blob/main/skills/syncause-debugger/SKILL.md): `skills/syncause-debugger/SKILL.md`

### Evidence integration

- **Runtime Facts**
- **Syncause MCP**
- **Trace capture**

### Other components

- **Developer**
- **AI agent**

## Connections

- Developer → AI agent: reports bug (evidence: `README.md`)
- Debugger skill → AI agent: constrains behavior (evidence: `README.md`)
- AI agent → Issue reproduction: reproduces issue (evidence: `README.md`)
- AI agent → Syncause MCP: fetches facts (evidence: `README.md`)
- Trace capture → Runtime Facts: captures calls (evidence: `README.md`)
- Syncause MCP → Runtime Facts: provides access (evidence: `README.md`)
- Runtime Facts → Evidence-based repair: grounds repair (evidence: `README.md`)
- AI agent → Evidence-based repair: makes fix (evidence: `README.md`)
- Evidence-based repair → Repair report: explains evidence (evidence: `README.md`)
- Repair report → Developer: presents results (evidence: `README.md`)
