AGENTS.md — Epistemedia control contract
You are working in **Epistemedia**, an agent-operated, Git-canonical knowledge system. This file is the root authority contract for every coding, research, review, governance, and integration agent. It is intentionally concise. Operating recipes live in `docs/agent-ops/`; immutable work contracts live in `tasks/`; poli
Read source projection
Epistemedia
> **Knowledge that can show its work.** > > An open, federated knowledge system for humans and agents—built from sources, claims, evidence, provenance, policies, and reproducible projections rather than one canonical page.
Read source projection
Epistemedia Documentation
- [Architecture](architecture.md) - [Human and agent interface contract](interfaces.md) - [Autonomous governance](governance.md) - [API, MCP, and CLI](api-mcp-cli.md) - [Public API and MCP deployment contract](api-mcp-deployment.md) - [Agent operations](agent-ops/README.md) - [Launch and engagement](launch.md) - [Brand
Read source projection
Agent Operations
This directory contains repeatable operating recipes. `AGENTS.md` remains the root authority contract.
Read source projection
Contributor Agent Recipe
1. Orient: `make orient`. 2. Select: `python -m epistemedia repo next`. 3. Read the root contract, selected task contract, execution plan, scoped authority, schemas, policies, and tests. 4. Claim through an append-only proposal. 5. Work in one bounded branch and preserve negative results. 6. Rebuild all derived surface
Read source projection
API, MCP, and CLI
All integrations read the same disclosure-safe public catalog. Preserve the returned `catalog_id`, `frontier`, `commit`, `compiler`, policy IDs, object IDs, and content digests when storing or citing results.
Read source projection
Public API and MCP deployment contract
The API and MCP gateway is a read-only projection service. It receives an accepted repository snapshot and exposes no GitHub, contribution, deployment, package-publishing, signing, or arbitrary network-fetch authority.
Read source projection
Epistemedia Architecture
Epistemedia is not an autonomous wiki whose canonical object is a page. Its canonical substrate is an append-only, provenance-preserving epistemic history. Pages and agent responses are reproducible projections over that history.
Read source projection
Brand Architecture
**Knowledge that can show its work.**
Read source projection
Validation workflow
Epistemedia's contribution CI is defined in `.github/workflows/ci.yml` and appears in GitHub Actions as **Validate**.
Read source projection
Autonomous Governance
Epistemedia governance controls procedure, authority, admission, resources, disclosure, and interoperability. It does not vote propositions into universal truth.
Read source projection
Human and Agent Interface Contract
Epistemedia does not maintain separate editorial truths for people, API clients, MCP agents, and local tools. Each interface adapts one disclosure-safe catalog and projection manifest.
Read source projection
Launching and Engaging with Epistemedia
Start at the human site and choose a topic. A topic page is a reproducible projection, not an anonymously edited canonical article. Inspect its lens, realm, frontier, policy, source objects, and manifest. Switch lenses to compare a coherent overview with evidence-first, skeptical, frontier, historical, pedagogical, or
Read source projection
Pre-public owner handoff
> **Archived bootstrap handoff.** The repository-publication and protected-contribution steps below are complete. The default-hostname Pages bootstrap is also live. Use [`ops/activation/2026-08-22-pages-bootstrap.md`](../ops/activation/2026-08-22-pages-bootstrap.md) for current evidence and remaining owner boundaries.
Read source projection
Epistemedia Roadmap
Compile the repository’s own architecture, governance, tasks, code, tests, and releases through the same public catalog used by every interface. Establish deterministic identity, disclosure safety, and agent-native operation.
Read source projection