/fact-check-report

Workflow Diagram

Generate a fact-checking report with traceable bibliography, actionable findings, optional clarity-mode glossary injection, and learning trajectory persistence for future sessions.

flowchart TD
  Start([Start: Verdicts complete]) --> BuildReport[Build report sections]

  style Start fill:#4CAF50,color:#fff
  style BuildReport fill:#2196F3,color:#fff

  BuildReport --> Header[Generate header/summary]
  BuildReport --> Findings[Group findings by category]
  BuildReport --> Biblio[Format bibliography]
  BuildReport --> ImplPlan[Create implementation plan]

  style Header fill:#2196F3,color:#fff
  style Findings fill:#2196F3,color:#fff
  style Biblio fill:#2196F3,color:#fff
  style ImplPlan fill:#2196F3,color:#fff

  Header --> BiblioGate{Every finding has citation?}
  Findings --> BiblioGate
  Biblio --> BiblioGate

  style BiblioGate fill:#f44336,color:#fff

  BiblioGate -->|No| FixCite[Add missing citations]
  BiblioGate -->|Yes| CheckClarity{Clarity mode enabled?}

  style FixCite fill:#2196F3,color:#fff
  style CheckClarity fill:#FF9800,color:#000

  FixCite --> BiblioGate

  CheckClarity -->|Yes| FilterConf{Confidence > 0.7?}
  CheckClarity -->|No| SaveReport[Save report to artifacts]

  style FilterConf fill:#FF9800,color:#000

  FilterConf -->|Yes| GenGloss[Generate glossary entries]
  FilterConf -->|No| SaveReport

  style GenGloss fill:#2196F3,color:#fff

  GenGloss --> GenFacts[Generate key facts]

  style GenFacts fill:#2196F3,color:#fff

  GenFacts --> FindTargets[Find config target files]

  style FindTargets fill:#2196F3,color:#fff

  FindTargets --> UpdateConfigs[Update CLAUDE.md / AGENTS.md]

  style UpdateConfigs fill:#2196F3,color:#fff

  UpdateConfigs --> SaveReport

  style SaveReport fill:#2196F3,color:#fff

  ImplPlan --> SaveReport

  SaveReport --> Learning[Store in ReasoningBank]

  style Learning fill:#4CAF50,color:#fff

  Learning --> StoreTrajectory[Store verification trajectories]

  style StoreTrajectory fill:#2196F3,color:#fff

  StoreTrajectory --> Applications[Depth prediction / Strategy selection]

  style Applications fill:#2196F3,color:#fff

  Applications --> End([End: Report saved])

  style End fill:#4CAF50,color:#fff

Legend

Color	Meaning
Green (#4CAF50)	Skill invocation
Blue (#2196F3)	Command/action
Orange (#FF9800)	Decision point
Red (#f44336)	Quality gate

Command Content

# Fact-Check: Report and Learning (Phases 6-7)

## Invariant Principles

1. **Traceability through bibliography** - Every finding must link to its verification evidence with proper citation format
2. **Actionable over comprehensive** - Report prioritizes findings that require code changes over informational items
3. **Learning feeds forward** - Verified facts and patterns are persisted for future sessions, not discarded after reporting

## Phase 6: Report

Sections: Header, Summary, Findings by Category, Bibliography, Implementation Plan

**Bibliography Formats**:
| Type | Format |
|------|--------|
| Code trace | `file:lines - finding` |
| Test | `command - result` |
| Web source | `Title - URL - "excerpt"` |
| Git history | `commit/issue - finding` |
| Documentation | `Docs: source section - URL` |
| Benchmark | `Benchmark: method - results` |
| Paper/RFC | `Citation - section - URL` |

## Phase 6.5: Clarity Mode (if enabled)

Generate glossaries/key facts from verified claims (confidence > 0.7).

**Targets**: `CLAUDE.md`, `GEMINI.md`, `AGENTS.md`, `*_AGENT.md`, `*_AI.md`

**Glossary Entry**: `- **[Term]**: [1-2 sentence definition]. [Usage context.]`

**Key Fact Categories**: Architecture, Behavior, Integration, Error Handling, Performance

Update existing sections or append before `---` separators.

## Phase 7: Learning

Store trajectories in ReasoningBank:
```typescript
await reasoningBank.insertPattern({
  type: 'verification-trajectory',
  domain: 'fact-checking-learning',
  pattern: { claimText, claimType, depthUsed, verdict, timeSpent, evidenceQuality }
});
```

Applications: depth prediction, strategy selection, ordering optimization, false positive reduction.