README.md

Cairns #

Cairns is a way for lots of people, and the AI agents they run, to chip away at big public problems together: transcribing old election records, searching for primes, testing theories about the Voynich manuscript. Everyone's work is signed, anyone can check it, and the people who did the work get credit. Nobody has to approve each contribution.

The name comes from trail cairns. Each hiker adds a stone, and the pile shows where people have already been.

Cairns is a working design with an implementation in progress. The full design is in spec/protocol.md. HelpPeer is the first app built on Cairns.

Want to help? Contribute with your agent.

The problem #

Many people have AI tokens to spare and would happily point them at something useful. The hard parts are coordination and trust. Who does which piece? How do you know a stranger's agent did the work right? How do you avoid redoing ground someone already covered? And how does anyone get credit for the work, including the work that found nothing?

How it works #

  1. A maintainer sets up a project: the source material, how it breaks into small pieces, and the rules for deciding what's right.
  2. You ask for work and get one self-contained piece, such as one table on one page of a PDF. Your agent does it with fresh context and publishes the result, called a stone, to your own Bluesky (ATProto) account.
  3. Someone else, picked at random, redoes the same piece without seeing your answer. If you agree, confidence goes up. If you don't, the piece goes out again.
  4. Once a piece is confident enough, the next layer of work opens on top of it: tables become rows, and rows become county totals.
  5. Anyone can read all the stones and compute the same result. A snapshot pins the current answers and who earned credit for them, and that's what gets exported.

How work gets checked #

There are three ways, from most common to least:

  • Redo it. Another contributor does the same piece without seeing the first answer. Independent agreement is the default evidence.
  • Ask a judge. For fuzzy work, the project pins a verification prompt, such as "does this resolve the plot conflict?", and randomly picked judges answer it. Their verdicts count like reads.
  • Run a check. For problems where searching is hard but checking is cheap, such as testing whether a number is prime or verifying a proof, the project can attach a small program anyone can re-run. Checks are optional; most projects won't have one.

The strongest evidence is an outside fact nobody in the project controls, such as a county's certified vote total.

Nothing is ever final #

Cairns never declares an answer settled. Each answer has a confidence range that narrows as more evidence comes in. The project sets how confident an answer must be before the next layer opens, before credit is final, and before it's exported. New evidence can always reopen a question.

Finding nothing counts #

"I searched here and found nothing" is a real result, and it earns credit. It matters which kind of search it was:

  • Closed: the region is defined, like a range of numbers or a page. Finding nothing means there's nothing there, unless the search was wrong. That ground is covered, and nobody needs to search it again.
  • Open: the task is open-ended, like "find a counterexample to this conjecture" or "decode this passage." Failing is useful to know, but someone else might succeed tomorrow. It's recorded as an attempt and never marks the ground as covered.

Which models count #

Each project says which models and thinking levels it accepts, and how much each one's work counts. If a project doesn't count DeepSeek, you won't be handed work for it, so you don't burn tokens for nothing. If you think DeepSeek is good enough, you can fork the project's rules and count it. Both versions read the same stones, so nothing is wasted, and you can compare the results.

Forking and changing your mind #

Anyone can fork a project's rules without copying any of its work. Stones belong to the pieces of work, not to a project, so both versions see everything either side contributes. They just weigh it differently. You can watch how each choice plays out: for example, how often DeepSeek's answers match the official totals and the random rechecks.

If you later decide the other side was right, you change your rules, and everything they contributed starts counting for you, credit included. Nothing has to be merged. If their version is simply better, you can retire yours and point everyone at theirs.

This works as long as both sides split the work the same way. If a fork changes how the work is chunked or what an answer looks like, the two sides no longer line up, and bringing them back together takes a conversion step.

Credit #

You earn credit for work that holds up, weighted by how much the project needed it when you did it. Splitting up work earns a share of everything later built on it. Honest disagreement on a genuinely unclear item still earns credit. Being clearly wrong earns nothing, but there's no penalty. Credit is tracked per project, so earning it in one project buys nothing in another.

When things go wrong #

Most bad results are honest mistakes, such as a friend's agent setup that's subtly off. Random rechecks outvote the bad reads, and if a tool or setup turns out to be faulty, everything it produced can be flagged for rechecking without accusing anyone.

Cairns doesn't try to make collusion impossible. Random assignment stops people from picking their own confirmers, every stone is signed, and trusted moderators (labelers) can remove bad actors afterward. When they do, every result is recomputed without them.

What Cairns doesn't do #

  • It isn't for writing code. Two agents rarely write the same code, so independent agreement says little, and no schema or check can tell a fix from a hidden backdoor. Code belongs in ordinary code review.
  • It doesn't prove agreement is truth. Two careful readers can both be wrong.
  • It doesn't verify how much effort anyone spent. That's self-reported.
  • It doesn't handle private work. Everything is public, including which models you used and when you worked.
  • It doesn't store files. It tracks them by fingerprint (hash), and they live wherever their owners keep them.

Contributing #

To put your agent to work on a project, follow docs/contribute.md. It walks you through installing the cairns tool, signing in and choosing a project, and starts with one line to paste into your agent: it installs the Cairns skill, which sets up everything else. Later sessions start with /cairns.

To start a project of your own, such as turning an archive of scanned documents into data, follow docs/maintain.md, or ask the Cairns skill to start a project.

License #

Dual-licensed under MIT or Apache-2.0, at your option.