# nnzqniuniu/fact-check architecture

> Architecture diagram of the GitHub repository nnzqniuniu/fact-check, 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/nnzqniuniu/fact-check
- Repository: https://github.com/nnzqniuniu/fact-check

## Overview

This repository packages an AI-agent fact-checking protocol as three skills: a core method and two document-oriented workflows. The documented flow decomposes claims, traces their evidence recursively, and reports a status for each claim. The document workflow creates a check file; the continuation workflow reads it and advances unticked or unresolved claims. The tree and README support these relationships, but no implementation excerpts are available.

Main entry points: [`SKILL.md`](https://github.com/nnzqniuniu/fact-check/blob/main/SKILL.md) (Fact-check method), [`skills/fact-check-by-docs/SKILL.md`](https://github.com/nnzqniuniu/fact-check/blob/main/skills/fact-check-by-docs/SKILL.md) (Continuation skill), [`skills/fact-check-with-docs/SKILL.md`](https://github.com/nnzqniuniu/fact-check/blob/main/skills/fact-check-with-docs/SKILL.md) (First-pass skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Core method"]
  node_fact_check["Fact-check method<br/>[SKILL.md]"]
  node_decomposition["Claim decomposition<br/>[SKILL.md]"]
  node_claim_report["Per-claim report<br/>[SKILL.md]"]
end

subgraph group_document_workflows["Document workflows"]
  node_with_docs["First-pass skill<br/>[SKILL.md]"]
  node_by_docs["Continuation skill<br/>[SKILL.md]"]
end

node_user(("User or orchestrator"))
node_passage["Passage to check"]
node_evidence["Evidence grounds"]
node_check_document["Check document"]

node_user -->|"invokes"| node_fact_check
node_passage -->|"provides"| node_fact_check
node_fact_check -->|"decomposes claims"| node_decomposition
node_decomposition -->|"traces grounds"| node_evidence
node_fact_check -->|"reports statuses"| node_claim_report
node_user -->|"invokes"| node_with_docs
node_with_docs -->|"uses method"| node_fact_check
node_with_docs -->|"writes"| node_check_document
node_user -->|"invokes"| node_by_docs
node_by_docs -->|"reads"| node_check_document
node_by_docs -->|"continues checking"| node_fact_check
node_by_docs -->|"updates"| node_check_document

click node_fact_check "https://github.com/nnzqniuniu/fact-check/blob/main/SKILL.md"
click node_decomposition "https://github.com/nnzqniuniu/fact-check/blob/main/SKILL.md"
click node_claim_report "https://github.com/nnzqniuniu/fact-check/blob/main/SKILL.md"
click node_with_docs "https://github.com/nnzqniuniu/fact-check/blob/main/skills/fact-check-with-docs/SKILL.md"
click node_by_docs "https://github.com/nnzqniuniu/fact-check/blob/main/skills/fact-check-by-docs/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_fact_check,node_decomposition,node_claim_report,node_user toneBlue
class node_with_docs,node_by_docs toneAmber
class node_passage,node_evidence,node_check_document toneIndigo
```

## Components

### Core method

- [Fact-check method](https://github.com/nnzqniuniu/fact-check/blob/main/SKILL.md): `SKILL.md`
- [Claim decomposition](https://github.com/nnzqniuniu/fact-check/blob/main/SKILL.md): `SKILL.md`
- [Per-claim report](https://github.com/nnzqniuniu/fact-check/blob/main/SKILL.md): `SKILL.md`

### Document workflows

- [First-pass skill](https://github.com/nnzqniuniu/fact-check/blob/main/skills/fact-check-with-docs/SKILL.md): `skills/fact-check-with-docs/SKILL.md`
- [Continuation skill](https://github.com/nnzqniuniu/fact-check/blob/main/skills/fact-check-by-docs/SKILL.md): `skills/fact-check-by-docs/SKILL.md`

### Other components

- **User or orchestrator**
- **Passage to check**
- **Evidence grounds**
- **Check document**

## Connections

- User or orchestrator → Fact-check method: invokes
- Passage to check → Fact-check method: provides
- Fact-check method → Claim decomposition: decomposes claims
- Claim decomposition → Evidence grounds: traces grounds
- Fact-check method → Per-claim report: reports statuses
- User or orchestrator → First-pass skill: invokes
- First-pass skill → Fact-check method: uses method
- First-pass skill → Check document: writes
- User or orchestrator → Continuation skill: invokes
- Continuation skill → Check document: reads
- Continuation skill → Fact-check method: continues checking
- Continuation skill → Check document: updates