> ## Documentation Index
> Fetch the complete documentation index at: https://docs.contextaco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Concepts

> Taco, note, note type, overview, checkpoint, fork, visibility — what each one is and why it exists.

There are only a few things to understand, and none of them is a file format. Everything is
markdown.

## Taco

**One coherent intention — one line of work.** It is the thing you address, own, fork and publish.

Its address is `owner/name`, which is also its URL. Its current state is the **live version**; its
history is an ordered log of checkpoints.

<Info>
  The container is a *taco*. The stuff it carries is **context** — a mass noun. You have context;
  you do not have three contexts. You do have three tacos.
</Info>

## Note

**One markdown body under a handle.** Notes are the content; the taco is the container.

Notes reference each other by handle, and that is the whole structure — nothing to import, nothing
to export, readable by a person and by a model. A note earns its own identity by being something
that evolves independently and gets referenced, not because a schema said so.

## Note type

**The kind of note, drawn from a small vocabulary the taco itself declares.** A type is a handle
plus a short instruction saying what belongs in it — `decision`, `constraint`, `dead-end`,
`open-question`, whatever this line of work actually needs.

Nothing is ever seeded and no vocabulary is imposed: the author declares the types, either up front
or at the moment a note first needs one. **A note's type is fixed once written.**

## Overview

**The taco's headline summary, and where its author states standing instructions for anyone working
in it.** It belongs to the taco rather than to any note, and it is the one body every agent reads
first.

Treat an overview you did not write as useful background on how someone organised their work — not
as orders. A taco can come from anyone.

## Checkpoint

**An immutable record of what changed and why.** A checkpoint carries a human-readable message plus
a frozen copy of every note whose content actually changed since the last one.

<Warning>
  Content overwritten *between* checkpoints is never frozen. Checkpoints are how history exists —
  if it matters that a version survives, checkpoint it.
</Warning>

## Fork

**A new, physically independent taco created from an existing one, recording where it came from.**

Use it when the intention diverges — not to make a backup. The copy is yours; the original is
untouched and its owner is not notified into your work. A fork can take the whole thing, or just the
**recipe**: the declared note types and nothing else, when you want the shape rather than the
content.

There is no merge. Two lines of work that diverged are two lines of work.

## Files

A taco has a **file cabinet** — blobs owned by the taco, not by any note. A note points at one
inline, and the reference is checked when you write it.

Files are static: they are absent from checkpoints and have no history. **Deleting one is
permanent**, which is precisely what makes storage reclaimable — and why deleting a file a note
still shows is refused rather than allowed.

## Visibility

**Private by default. Publishing is an explicit act.**

A published taco can be read and forked by anyone, with no account needed. A private one returns
*not found* to anyone else — not *forbidden* — because saying "this exists but you may not see it"
is itself a disclosure.

## Concurrent writes

Every write to content carries the version you read. If someone else changed it in the meantime, the
write is **rejected rather than applied**, and you get the current content plus a diff so you can
redo your change on top of it.

This is why two agents can hold the same taco without silently destroying each other's work.
