teleo-codex/core/contributor-guide.md
m3taversal 89c8e652f2
Some checks are pending
Sync Graph Data to teleo-app / sync (push) Waiting to run
clay: ontology simplification — challenge schema + contributor guide
Two-layer ontology: contributor-facing (3 concepts: claims, challenges,
connections) vs agent-internal (11 concepts). From 2026-03-26 ontology audit.

New files:
- schemas/challenge.md — first-class challenge type with strength rating,
  evidence chains, resolution tracking, and attribution
- core/contributor-guide.md — 3-concept contributor view (no frontmatter,
  pure documentation)

Modified files:
- schemas/claim.md — importance: null field (pipeline-computed, not manual),
  challenged_by accepts challenge filenames, structural importance section
  clarified as aspirational until pipeline ships
- ops/schema-change-protocol.md — challenge added to producer/consumer map

Schema Change:
Format affected: claim (modified), challenge (new)
Backward compatible: yes
Migration: none needed

Pentagon-Agent: Clay <3D549D4C-0129-4008-BF4F-FDD367C1D184>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-01 22:27:21 +01:00

3.4 KiB

Contributor Guide

Three concepts. That's it.

Claims

A claim is a statement about how the world works, backed by evidence.

"Legacy media is consolidating into three dominant entities because debt-loaded incumbents cannot compete with cash-rich tech companies for content rights"

Claims have confidence levels: proven, likely, experimental, speculative. Every claim cites its evidence. Every claim can be wrong.

Browse claims: Look in domains/{domain}/ — each domain has dozens of claims organized by topic. Start with whichever domain matches your expertise.

Challenges

A challenge is a counter-argument against a specific claim.

"The AI content acceptance decline may be scope-bounded to entertainment — reference and analytical AI content shows no acceptance penalty"

Challenges are the highest-value contribution. If you think a claim is wrong, too broad, or missing evidence, file a challenge. The claim author must respond — they can't ignore it.

Three types:

  • Full challenge — the claim is wrong, here's why
  • Scope challenge — the claim is true in context X but not Y
  • Evidence challenge — the evidence doesn't support the confidence level

File a challenge: Create a file in domains/{domain}/challenge-{slug}.md following the challenge schema, or tell an agent your counter-argument and they'll draft it for you.

Connections

Connections are the links between claims. When claim A depends on claim B, or challenges claim C, those relationships form a knowledge graph.

You don't create connections as standalone files — they emerge from wiki links ([[claim-name]]) in claim and challenge bodies. But spotting a connection no one else has seen is a genuine contribution. Cross-domain connections (a pattern in entertainment that also appears in finance) are the most valuable.

Spot a connection: Tell an agent. They'll draft the cross-reference and attribute you.


What You Don't Need to Know

The system has 11 internal concept types (beliefs, positions, convictions, entities, sectors, sources, divergences, musings, attribution, contributors). Agents use these to organize their reasoning, track companies, and manage their workflow.

You don't need to learn any of them. Claims, challenges, and connections are the complete interface for contributors. Everything else is infrastructure.

How Credit Works

Every contribution is attributed. Your name stays on everything you produce or improve. The system tracks five roles:

Role What you did
Sourcer Pointed to material worth analyzing
Extractor Turned source material into a claim
Challenger Filed counter-evidence against a claim
Synthesizer Connected claims across domains
Reviewer Evaluated claim quality

You can hold multiple roles on the same claim. Credit is proportional to impact — a challenge that changes a high-importance claim earns more than a new speculative claim in an empty domain.

Getting Started

  1. Browse: Pick a domain. Read 5-10 claims. Find one you disagree with or know something about.
  2. React: Tell an agent your reaction. They'll help you figure out if it's a challenge, a new claim, or a connection.
  3. Approve: The agent drafts; you review and approve before anything gets published.

Nothing enters the knowledge base without your explicit approval. The conversation itself is valuable even if you never file anything.