Evidence Claim Graph
Use When
- Use when a project needs reusable, auditable knowledge rather than a one-off narrative.
- Use before synthesis, report generation, claim verification, or productization.
- Use when multiple agents contribute evidence and the orchestrator must merge without losing provenance.
Do Not Use When
- The task is a single fact lookup with no downstream reuse.
- The corpus is too immature; run source collection and evaluation first.
Required Inputs
| Input |
Source/provider |
If absent |
| Source registry, extracted quotes, notes, claims, hypotheses, and gaps |
Research project |
Stop and record a provenance gap |
| Intended output family and audience |
Research brief |
Narrow the graph scope |
| Evidence discipline from source evaluation |
Source-evaluation skill |
Stop claim promotion |
Workflow
- Atomize sources into evidence items: one quote, statistic, observation, dataset field, or document fact per item.
- Convert prose notes into explicit claims with scope, status, and source IDs.
- Add warrants: why the evidence supports the claim.
- Mark inferences and synthesis explicitly; never store them as raw facts.
- Link contradictions and rival claims instead of smoothing them away.
- Promote only verified, warranted claims into findings.
- Preserve gaps as first-class nodes with owner, next search path, and decision impact.
- Export registry-ready entries for source, claim, quote, and synthesis registries.
- Stop promotion when provenance, support, or relationship validation is missing.
- Recover by demoting unsupported propositions to explicit gaps and retaining the failed evidence trail.
Learning and experiment nodes
For a process or product improvement, add explicit hypothesis, experiment, measurement, and learning records linked to the affected source, claim, gap, or finding. A learning record must state the baseline, guardrail, result, uncertainty, failed-path result, and standardisation decision. Do not promote an experiment result to a general claim without a source or a clearly labelled inference.
Quality Standards
- Every finding traces to claims, and every claim traces to source IDs.
- Claims carry status: untested, supported, contested, contradicted, synthesis, inference, retired.
- Contradictions survive into synthesis until resolved.
- The graph is useful for both verification and reuse.
Anti-Patterns
- Paragraph-level source dumps with no claim extraction.
- Findings with no warrant.
- Synthesis that hides which claims were combined.
- Deleting contradictory evidence because it complicates the story.
- Treating gaps as failures instead of research objects.
Evidence Claim Graph Core Deliverables
- Evidence-claim graph table.
- Claim register rows.
- Contradiction map.
- Gap register.
- Finding promotion log.
Evidence Produced
| Category |
Artifact |
Format |
Example |
| Correctness |
Claim graph |
Markdown/YAML |
Claim IDs linked to source IDs and warrants |
| Release evidence |
Promotion log |
Markdown table |
Claim promoted to finding with verifier/date |
References
- Load
references/graph-schema.md for node and edge types.
- Load
references/claim-promotion-gate.md before synthesis or final drafting.
Graph storage inputs
| Artefact |
Source or provider |
Requirement |
If absent |
| Verified source register |
source-evaluation and source-verification |
required |
Stop and record a gap if provenance is absent |
Capability contract
Read and graph-search access are required to resolve node provenance. Graph mutation needs explicit authority; source records remain immutable, and publication waits for relationship validation.
Degraded mode
If graph storage or validation is unavailable, return a qualified node-and-edge draft, mark integrity checks unassessed, and retain unsupported propositions as gaps.
Decision rules
| Choice |
Action |
Failure avoided |
| Evidence supports wording directly |
Link evidence to claim |
Unsupported promotion |
Outputs
| Artefact |
Consumer |
Observable acceptance condition |
| Evidence-claim graph |
synthesis and report builders |
Every claim node has source or explicit inference/synthesis status |
Evidence Claim Graph Evidence Notes 1
- Preserve node identifiers, source locators, promotion decisions, contradictions, and the graph-integrity result.
Worked example
A paragraph that combines two verified sources becomes a synthesis node linked to both evidence nodes; an unresolved discrepancy becomes a contradiction node, not a finding.
Companion Skills
source-evaluation supplies source tier and verification trail.critical-reasoning-and-argument supplies warrants and inference tests.research-techniques supplies gap analysis and synthesis methods.knowledge-productization reuses graph assets in monetizable outputs.
Graph export workflow
- Register sources and evidence before creating claims.
- Link warrants, inference, synthesis, gaps, and contradictions explicitly.
- Stop claim promotion when provenance or support is absent.
- Validate graph integrity; recover by demoting unsupported claims to gaps.
Evidence Claim Graph Evidence Notes 2
| Evidence |
Consumer |
Acceptance |
| Graph validation record |
Synthesis and release review |
Provenance, gap status, and relationship checks are recorded |
Reference Index
- Graph schema
- Claim promotion gate
1---2name: evidence-claim-graph3description: Use when research must become a traceable evidence-to-claim knowledge graph rather than loose notes. Encodes source, evidence, claim, warrant, inference, synthesis, gap, contradiction, and finding nodes with registry-ready relationships.4---56# Evidence Claim Graph78<!-- dual-compat-start -->910## Use When1112- Use when a project needs reusable, auditable knowledge rather than a one-off narrative.13- Use before synthesis, report generation, claim verification, or productization.14- Use when multiple agents contribute evidence and the orchestrator must merge without losing provenance.1516## Do Not Use When1718- The task is a single fact lookup with no downstream reuse.19- The corpus is too immature; run source collection and evaluation first.202122## Required Inputs2324| Input | Source/provider | If absent |25|---|---|---|26| Source registry, extracted quotes, notes, claims, hypotheses, and gaps | Research project | Stop and record a provenance gap |27| Intended output family and audience | Research brief | Narrow the graph scope |28| Evidence discipline from source evaluation | Source-evaluation skill | Stop claim promotion |293031## Workflow321. Atomize sources into evidence items: one quote, statistic, observation, dataset field, or document fact per item.332. Convert prose notes into explicit claims with scope, status, and source IDs.343. Add warrants: why the evidence supports the claim.354. Mark inferences and synthesis explicitly; never store them as raw facts.365. Link contradictions and rival claims instead of smoothing them away.376. Promote only verified, warranted claims into findings.387. Preserve gaps as first-class nodes with owner, next search path, and decision impact.398. Export registry-ready entries for source, claim, quote, and synthesis registries.409. Stop promotion when provenance, support, or relationship validation is missing.4110. Recover by demoting unsupported propositions to explicit gaps and retaining the failed evidence trail.4243## Learning and experiment nodes4445For a process or product improvement, add explicit `hypothesis`, `experiment`, `measurement`, and `learning` records linked to the affected source, claim, gap, or finding. A learning record must state the baseline, guardrail, result, uncertainty, failed-path result, and standardisation decision. Do not promote an experiment result to a general claim without a source or a clearly labelled inference.4647## Quality Standards4849- Every finding traces to claims, and every claim traces to source IDs.50- Claims carry status: untested, supported, contested, contradicted, synthesis, inference, retired.51- Contradictions survive into synthesis until resolved.52- The graph is useful for both verification and reuse.5354## Anti-Patterns5556- Paragraph-level source dumps with no claim extraction.57- Findings with no warrant.58- Synthesis that hides which claims were combined.59- Deleting contradictory evidence because it complicates the story.60- Treating gaps as failures instead of research objects.616263## Evidence Claim Graph Core Deliverables64- Evidence-claim graph table.65- Claim register rows.66- Contradiction map.67- Gap register.68- Finding promotion log.6970## Evidence Produced7172| Category | Artifact | Format | Example |73|---|---|---|---|74| Correctness | Claim graph | Markdown/YAML | Claim IDs linked to source IDs and warrants |75| Release evidence | Promotion log | Markdown table | Claim promoted to finding with verifier/date |7677## References7879- Load `references/graph-schema.md` for node and edge types.80- Load `references/claim-promotion-gate.md` before synthesis or final drafting.8182## Graph storage inputs8384| Artefact | Source or provider | Requirement | If absent |85|---|---|---|---|86| Verified source register | source-evaluation and source-verification | required | Stop and record a gap if provenance is absent |8788## Capability contract8990Read and graph-search access are required to resolve node provenance. Graph mutation needs explicit authority; source records remain immutable, and publication waits for relationship validation.9192## Degraded mode9394If graph storage or validation is unavailable, return a qualified node-and-edge draft, mark integrity checks unassessed, and retain unsupported propositions as gaps.9596## Decision rules9798| Choice | Action | Failure avoided |99|---|---|---|100| Evidence supports wording directly | Link evidence to claim | Unsupported promotion |101102103## Outputs104| Artefact | Consumer | Observable acceptance condition |105|---|---|---|106| Evidence-claim graph | synthesis and report builders | Every claim node has source or explicit inference/synthesis status |107108109## Evidence Claim Graph Evidence Notes 1110- Preserve node identifiers, source locators, promotion decisions, contradictions, and the graph-integrity result.111112## Worked example113114A paragraph that combines two verified sources becomes a synthesis node linked to both evidence nodes; an unresolved discrepancy becomes a contradiction node, not a finding.115116<!-- dual-compat-end -->117118## Companion Skills119120- `source-evaluation` supplies source tier and verification trail.121- `critical-reasoning-and-argument` supplies warrants and inference tests.122- `research-techniques` supplies gap analysis and synthesis methods.123- `knowledge-productization` reuses graph assets in monetizable outputs.124125126## Graph export workflow1271. Register sources and evidence before creating claims.1282. Link warrants, inference, synthesis, gaps, and contradictions explicitly.1293. Stop claim promotion when provenance or support is absent.1304. Validate graph integrity; recover by demoting unsupported claims to gaps.131132133## Evidence Claim Graph Evidence Notes 2134| Evidence | Consumer | Acceptance |135|---|---|---|136| Graph validation record | Synthesis and release review | Provenance, gap status, and relationship checks are recorded |137138## Reference Index139140- [Graph schema](references/graph-schema.md)141- [Claim promotion gate](references/claim-promotion-gate.md)
peterbamuhigire