# dkyazzentwatwa/osint-ai architecture

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

- Interactive diagram: https://gitdiagram.com/dkyazzentwatwa/osint-ai
- Repository: https://github.com/dkyazzentwatwa/osint-ai

## Overview

This repository is an OSINT investigation skill for AI agents, described primarily through Markdown specifications and command documentation rather than executable source. The documented user journey is to start a full or guided investigation, examine public information and follow leads, assess and visualize findings, then produce a report and optionally save the session. The graph preserves the README’s major capabilities; because implementation excerpts are unavailable, links represent documented command routing and workflow, not verified function calls.

Main entry points: [`SKILL.md`](https://github.com/dkyazzentwatwa/osint-ai/blob/main/SKILL.md) (Skill commands), [`core/entity-manager.md`](https://github.com/dkyazzentwatwa/osint-ai/blob/main/core/entity-manager.md) (Entity tracking), [`references/recon-vectors.md`](https://github.com/dkyazzentwatwa/osint-ai/blob/main/references/recon-vectors.md) (Recon and pivots), [`core/state-manager.md`](https://github.com/dkyazzentwatwa/osint-ai/blob/main/core/state-manager.md) (Session state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Investigation entry"]
  node_skill["Skill commands<br/>[SKILL.md]"]
  node_recon["Recon and pivots<br/>[recon-vectors.md]"]
  node_wizard["Guided wizards"]
end

subgraph group_core["Investigation core"]
  node_entities["Entity tracking<br/>[entity-manager.md]"]
  node_sessions["Session state<br/>[state-manager.md]"]
  node_evidence["Evidence chains<br/>[evidence-system.md]"]
  node_contradictions["Contradiction checks"]
end

subgraph group_analysis["Analysis modules"]
  node_correlation["Correlation and pivots"]
  node_risk["Risk scoring<br/>[risk-framework.md]"]
  node_history["Historical analysis"]
  node_specialized["Specialized analysis"]
end

subgraph group_output["Reports and views"]
  node_reporting["Reports and exports<br/>[export-formats.md]"]
  node_visualization["Graphs and dashboard"]
end

subgraph group_guidance["Guidance and quality"]
  node_templates["Investigation templates"]
  node_accessibility["Modes and accessibility"]
  node_qa["Coverage and QA"]
end

node_user(("Investigator"))

node_user -->|"starts commands"| node_skill
node_skill -->|"offers reconnaissance"| node_recon
node_skill -->|"offers guided flow"| node_wizard
node_skill -->|"save or load"| node_sessions
node_recon -->|"examines targets"| node_specialized
node_skill -->|"offers pivots"| node_correlation
node_skill -->|"offers assessment"| node_risk
node_skill -->|"offers history"| node_history
node_skill -->|"offers reports"| node_reporting
node_skill -->|"offers views"| node_visualization
node_skill -->|"offers QA"| node_qa
node_skill -->|"offers templates"| node_templates
node_skill -->|"offers modes"| node_accessibility
node_entities -->|"tracks support"| node_evidence
node_entities -->|"checks conflicts"| node_contradictions
node_sessions -->|"preserves entities"| node_entities
node_correlation -->|"relates findings"| node_entities
node_risk -->|"feeds assessment"| node_reporting
node_entities -->|"visualizes relationships"| node_visualization

click node_skill "https://github.com/dkyazzentwatwa/osint-ai/blob/main/SKILL.md"
click node_recon "https://github.com/dkyazzentwatwa/osint-ai/blob/main/references/recon-vectors.md"
click node_wizard "https://github.com/dkyazzentwatwa/osint-ai/tree/main/ux/wizards"
click node_entities "https://github.com/dkyazzentwatwa/osint-ai/blob/main/core/entity-manager.md"
click node_sessions "https://github.com/dkyazzentwatwa/osint-ai/blob/main/core/state-manager.md"
click node_evidence "https://github.com/dkyazzentwatwa/osint-ai/blob/main/core/evidence-system.md"
click node_contradictions "https://github.com/dkyazzentwatwa/osint-ai/blob/main/core/contradiction-detection.md"
click node_correlation "https://github.com/dkyazzentwatwa/osint-ai/blob/main/intelligence/correlation-engine.md"
click node_risk "https://github.com/dkyazzentwatwa/osint-ai/blob/main/intelligence/risk-framework.md"
click node_history "https://github.com/dkyazzentwatwa/osint-ai/blob/main/intelligence/historical-analysis.md"
click node_specialized "https://github.com/dkyazzentwatwa/osint-ai/tree/main/modules"
click node_reporting "https://github.com/dkyazzentwatwa/osint-ai/blob/main/reports/export-formats.md"
click node_visualization "https://github.com/dkyazzentwatwa/osint-ai/tree/main/visualization"
click node_templates "https://github.com/dkyazzentwatwa/osint-ai/tree/main/ux/templates"
click node_accessibility "https://github.com/dkyazzentwatwa/osint-ai/tree/main/ux/accessibility"
click node_qa "https://github.com/dkyazzentwatwa/osint-ai/blob/main/qa/coverage-analysis.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_recon,node_wizard toneBlue
class node_entities,node_sessions,node_evidence,node_contradictions toneAmber
class node_correlation,node_risk,node_history,node_specialized toneMint
class node_reporting,node_visualization toneRose
class node_templates,node_accessibility,node_qa,node_user toneIndigo
```

## Components

### Investigation entry

- [Skill commands](https://github.com/dkyazzentwatwa/osint-ai/blob/main/SKILL.md): `SKILL.md`
- [Recon and pivots](https://github.com/dkyazzentwatwa/osint-ai/blob/main/references/recon-vectors.md): `references/recon-vectors.md`
- [Guided wizards](https://github.com/dkyazzentwatwa/osint-ai/tree/main/ux/wizards): `ux/wizards`

### Investigation core

- [Entity tracking](https://github.com/dkyazzentwatwa/osint-ai/blob/main/core/entity-manager.md): `core/entity-manager.md`
- [Session state](https://github.com/dkyazzentwatwa/osint-ai/blob/main/core/state-manager.md): `core/state-manager.md`
- [Evidence chains](https://github.com/dkyazzentwatwa/osint-ai/blob/main/core/evidence-system.md): `core/evidence-system.md`
- [Contradiction checks](https://github.com/dkyazzentwatwa/osint-ai/blob/main/core/contradiction-detection.md): `core/contradiction-detection.md`

### Analysis modules

- [Correlation and pivots](https://github.com/dkyazzentwatwa/osint-ai/blob/main/intelligence/correlation-engine.md): `intelligence/correlation-engine.md`
- [Risk scoring](https://github.com/dkyazzentwatwa/osint-ai/blob/main/intelligence/risk-framework.md): `intelligence/risk-framework.md`
- [Historical analysis](https://github.com/dkyazzentwatwa/osint-ai/blob/main/intelligence/historical-analysis.md): `intelligence/historical-analysis.md`
- [Specialized analysis](https://github.com/dkyazzentwatwa/osint-ai/tree/main/modules): `modules`

### Reports and views

- [Reports and exports](https://github.com/dkyazzentwatwa/osint-ai/blob/main/reports/export-formats.md): `reports/export-formats.md`
- [Graphs and dashboard](https://github.com/dkyazzentwatwa/osint-ai/tree/main/visualization): `visualization`

### Guidance and quality

- [Investigation templates](https://github.com/dkyazzentwatwa/osint-ai/tree/main/ux/templates): `ux/templates`
- [Modes and accessibility](https://github.com/dkyazzentwatwa/osint-ai/tree/main/ux/accessibility): `ux/accessibility`
- [Coverage and QA](https://github.com/dkyazzentwatwa/osint-ai/blob/main/qa/coverage-analysis.md): `qa/coverage-analysis.md`

### Other components

- **Investigator**

## Connections

- Investigator → Skill commands: starts commands
- Skill commands → Recon and pivots: offers reconnaissance
- Skill commands → Guided wizards: offers guided flow
- Skill commands → Session state: save or load
- Recon and pivots → Specialized analysis: examines targets
- Skill commands → Correlation and pivots: offers pivots
- Skill commands → Risk scoring: offers assessment
- Skill commands → Historical analysis: offers history
- Skill commands → Reports and exports: offers reports
- Skill commands → Graphs and dashboard: offers views
- Skill commands → Coverage and QA: offers QA
- Skill commands → Investigation templates: offers templates
- Skill commands → Modes and accessibility: offers modes
- Entity tracking → Evidence chains: tracks support
- Entity tracking → Contradiction checks: checks conflicts
- Session state → Entity tracking: preserves entities
- Correlation and pivots → Entity tracking: relates findings
- Risk scoring → Reports and exports: feeds assessment
- Entity tracking → Graphs and dashboard: visualizes relationships