Structured claim

Type: kb/types/type-spec.md

Authoring Instructions

Use structured-claim for arguments where separating evidence from reasoning genuinely clarifies the case.

• The title should be a claim and should carry the title-as-claim trait.
• The opening paragraph should state the claim plainly and explain why it matters.
• Evidence is for observations, facts, citations, or examples.
• Reasoning is for the principle that connects the evidence to the claim.
• Caveats is for scope limits, assumptions, counterarguments, and failure cases.

Do not force this scaffold onto arguments it does not fit.

• Definitional or classification claims often work better as plain notes.
• If the evidence and reasoning are inseparable, splitting them can make the argument harder to follow rather than clearer.

Frontmatter

Field	Required	Use
description	Yes	Retrieval description for the claim, naming what the argument establishes.
type	Yes	Path to this type spec, usually ./types/structured-claim.md for notes at the collection root.
traits	Yes	Include title-as-claim; this is what makes the claim-title promise explicit to review gates.
tags	No	Navigation tags that help route the claim through the notes collection.
status	No	Lifecycle state such as seedling, current, speculative, or outdated.

Template

---
description: Template for developed arguments — claim-titled notes with explicit Evidence, Reasoning, and optional Caveats sections
type: ./types/structured-claim.md
traits: [title-as-claim]
tags: []
status: seedling
---

# {Claim as title — an assertion, not a topic label}

{Opening paragraph}

## Evidence

{Evidence}

## Reasoning

{Reasoning}

## Caveats

- {Scope limits}
- {Assumptions}
- {Counterarguments}