# interroai/interro-awesome-agent-incidents architecture

> Architecture diagram of the GitHub repository interroai/interro-awesome-agent-incidents, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/interroai/interro-awesome-agent-incidents
- Repository: https://github.com/interroai/interro-awesome-agent-incidents

## Overview

This repository is a curated incident knowledge base, not an implementation of an agent system. An engineer starts at the README’s incident index, selects a production failure, and uses the incident’s symptoms, evidence, root cause, code path, fix, and validation to guide prevention. The README also describes regression-test execution through the separately named prevention-scanner. The tree and README support the catalog and prevention resources shown here; source excerpts were unavailable, so internal document links and scanner behavior are not inferred.

Main entry points: [`README.md`](https://github.com/interroai/interro-awesome-agent-incidents/blob/main/README.md) (Incident index), [`INC-001-goal-loop.md`](https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-001-goal-loop.md) (Goal tool loop), [`INC-002-context-explosion.md`](https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-002-context-explosion.md) (Context explosion), [`INC-003-empty-bedrock-response.md`](https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-003-empty-bedrock-response.md) (Empty response)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Incident catalog"]
  node_readme["Incident index<br/>[README.md]"]
  node_inc001["Goal tool loop"]
  node_inc002["Context explosion"]
  node_inc003["Empty response"]
  node_inc004["ToolResult ordering"]
  node_inc005["Tool replay"]
  node_inc006["Checkpoint isolation"]
  node_inc007["MCP drift"]
  node_inc008["Prompt injection"]
  node_inc009["Retry storm"]
  node_inc010["State divergence"]
end

subgraph group_prevention["Prevention resources"]
  node_checklist["Prevention checklist"]
  node_prompts["Copilot prompts<br/>[combined.md]"]
end

subgraph group_validation["Regression validation"]
  node_scanner["Prevention scanner"]
end

node_engineer(("Engineer"))

node_engineer -->|"consults"| node_readme
node_readme -->|"indexes"| node_inc001
node_readme -->|"indexes"| node_inc002
node_readme -->|"indexes"| node_inc003
node_readme -->|"indexes"| node_inc004
node_readme -->|"indexes"| node_inc005
node_readme -->|"indexes"| node_inc006
node_readme -->|"indexes"| node_inc007
node_readme -->|"indexes"| node_inc008
node_readme -->|"indexes"| node_inc009
node_readme -->|"indexes"| node_inc010
node_engineer -->|"consults"| node_checklist
node_engineer -->|"consults"| node_prompts
node_engineer -->|"runs tests via"| node_scanner
node_scanner -.->|"tests"| node_inc001
node_scanner -.->|"tests"| node_inc002
node_scanner -.->|"tests"| node_inc003
node_scanner -.->|"tests"| node_inc004
node_scanner -.->|"tests"| node_inc005
node_scanner -.->|"tests"| node_inc006
node_scanner -.->|"tests"| node_inc007
node_scanner -.->|"tests"| node_inc008
node_scanner -.->|"tests"| node_inc009
node_scanner -.->|"tests"| node_inc010

click node_readme "https://github.com/interroai/interro-awesome-agent-incidents/blob/main/README.md"
click node_inc001 "https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-001-goal-loop.md"
click node_inc002 "https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-002-context-explosion.md"
click node_inc003 "https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-003-empty-bedrock-response.md"
click node_inc004 "https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-004-toolresult-ordering.md"
click node_inc005 "https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-005-tool-replay.md"
click node_inc006 "https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-006-checkpoint-isolation.md"
click node_inc007 "https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-007-mcp-capability-drift.md"
click node_inc008 "https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-008-prompt-injection.md"
click node_inc009 "https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-009-retry-storm.md"
click node_inc010 "https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-010-state-divergence.md"
click node_checklist "https://github.com/interroai/interro-awesome-agent-incidents/blob/main/prevention-checklist.md"
click node_prompts "https://github.com/interroai/interro-awesome-agent-incidents/blob/main/copilot-prompts/combined.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_readme,node_inc001,node_inc002,node_inc003,node_inc004,node_inc005,node_inc006,node_inc007,node_inc008,node_inc009,node_inc010 toneBlue
class node_checklist,node_prompts toneAmber
class node_scanner toneMint
class node_engineer toneIndigo
```

## Components

### Incident catalog

- [Incident index](https://github.com/interroai/interro-awesome-agent-incidents/blob/main/README.md): `README.md`
- [Goal tool loop](https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-001-goal-loop.md): `INC-001-goal-loop.md`
- [Context explosion](https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-002-context-explosion.md): `INC-002-context-explosion.md`
- [Empty response](https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-003-empty-bedrock-response.md): `INC-003-empty-bedrock-response.md`
- [ToolResult ordering](https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-004-toolresult-ordering.md): `INC-004-toolresult-ordering.md`
- [Tool replay](https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-005-tool-replay.md): `INC-005-tool-replay.md`
- [Checkpoint isolation](https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-006-checkpoint-isolation.md): `INC-006-checkpoint-isolation.md`
- [MCP drift](https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-007-mcp-capability-drift.md): `INC-007-mcp-capability-drift.md`
- [Prompt injection](https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-008-prompt-injection.md): `INC-008-prompt-injection.md`
- [Retry storm](https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-009-retry-storm.md): `INC-009-retry-storm.md`
- [State divergence](https://github.com/interroai/interro-awesome-agent-incidents/blob/main/INC-010-state-divergence.md): `INC-010-state-divergence.md`

### Prevention resources

- [Prevention checklist](https://github.com/interroai/interro-awesome-agent-incidents/blob/main/prevention-checklist.md): `prevention-checklist.md`
- [Copilot prompts](https://github.com/interroai/interro-awesome-agent-incidents/blob/main/copilot-prompts/combined.md): `copilot-prompts/combined.md`

### Regression validation

- **Prevention scanner**

### Other components

- **Engineer**

## Connections

- Engineer → Incident index: consults
- Incident index → Goal tool loop: indexes
- Incident index → Context explosion: indexes
- Incident index → Empty response: indexes
- Incident index → ToolResult ordering: indexes
- Incident index → Tool replay: indexes
- Incident index → Checkpoint isolation: indexes
- Incident index → MCP drift: indexes
- Incident index → Prompt injection: indexes
- Incident index → Retry storm: indexes
- Incident index → State divergence: indexes
- Engineer → Prevention checklist: consults
- Engineer → Copilot prompts: consults
- Engineer → Prevention scanner: runs tests via
- Prevention scanner → Goal tool loop: tests
- Prevention scanner → Context explosion: tests
- Prevention scanner → Empty response: tests
- Prevention scanner → ToolResult ordering: tests
- Prevention scanner → Tool replay: tests
- Prevention scanner → Checkpoint isolation: tests
- Prevention scanner → MCP drift: tests
- Prevention scanner → Prompt injection: tests
- Prevention scanner → Retry storm: tests
- Prevention scanner → State divergence: tests