🤖 mindicraft for agents

The whole guide of human civilisation is also data: 134 guides, 17 domains, 4 languages, one tech tree — static JSON, CORS open, no auth, no key, no gate.

Start

Read /api/index.json — it describes everything. Or take the library:

import * as mindicraft from 'https://mindicraft.com/mindicraft.mjs'

const t = await mindicraft.tree()                 // the whole tech tree
const g = await mindicraft.guide('make-soap')     // one guide, markdown body included
const p = await mindicraft.path('make-soap')      // every prerequisite from zero, in order
const system = await mindicraft.learningSystem()  // public rules only; never a learner's state
const hits = await mindicraft.search('water')     // find guides
const rooms = await mindicraft.castle()           // the curated Castle map
const walk = await mindicraft.frontier()          // this edition's finite three-card walk
const cosmos = await mindicraft.frontier({ trail: 'unseen-universe' }) // one stable address
const medicines = await mindicraft.remedies()     // reviewed medicine and nature lineages
const aspirin = await mindicraft.remedy('aspirin-willow') // one claim-sourced comparison
const healingHistory = await mindicraft.healingArts() // non-operational histories across cultures
const wildfireHelp = await mindicraft.wildfire()    // .edition is reviewed guidance; .links are carryable forms
const lesson = await mindicraft.teach('make-soap', { lang: 'yue' }) // prompt-ready markdown

Carry practical wildfire help

The wildfire help door, its versioned JSON envelope, small leave-now card, and full plain-text copy carry the same sourced edition. It begins with leaving, then covers shelter and urgent needs, smoke, explicit return clearance, recovery, rebuilding, and helping another person. Regional links go to named government or recognized humanitarian services.

This shelf is deliberately outside the learning System and margin: no game mechanics, account, form, location request, tracking, diagnosis, dispatch, donation, or public survivor post. It has no live fire, road, evacuation-zone, shelter-space, return-clearance, deadline, or eligibility state. Agents must preserve its reviewed date, source links, no-live-data warning, and rule that current local authorities override it. It is discoverable here and in the API index but remains outside Surface 0.1's bounded eight-resource probe set.

The shape of knowledge here

Every guide teaches one real skill in plain words — why it matters, what you need, steps, dangers, and how it works underneath. Guides link by needs (learn these first) and unlocks (what this opens). /api/path/plant-a-village.json is the entire book in learning order.

The private learning System

The Mindicraft System gives the tree a Solo-style face without turning it into a public score. A learner explicitly chooses a quest and records a guide only after three self-reflection checks. The browser stores one goal and a list of guide slugs locally; there is no account, AgentTool bearer, telemetry, leaderboard, streak, decay, timer, server sync, or content gate. Export, strict import, quiet mode, erase, and in-session undo keep the handle on the inside.

/api/learning-system.json exposes the exact E–S thresholds, difficulty XP weights, triangular level curve, quest rules, receipt shape, state schema, and XENIA boundary. It never contains personal progress. This extra route is discoverable here and in the API index, but deliberately remains outside Surface 0.1's bounded eight-resource probe set.

Walk past the edge of the map

Frontier Walk and its JSON shelf hold 9 reviewed open questions in 5 finite three-card walks. Some name gaps in Mindicraft itself; others open onto life and the universe through dated NASA and CERN sources. There is no hidden solution, random selection, score, identity, action, or write. The three reflection questions end with one noticed thing, one inference, and one thing still unknown.

Each named trail has one address, such as /frontier/unseen-universe/. It returns a quiet page by default and the same three cards as JSON when requested with Accept: application/json. The collection lists every stable page and direct JSON address. A carried path contains only a reviewed public trail name—never an identity, note, answer, seed, or result.

Follow medicines back to their roots

Roots to remedies and its compact JSON shelf keep 25 reviewed lineages. Each card separates the defined medicine, historical natural lead, traditional context, exact studied preparation, human evidence, bioavailability, safety, and replacement status. It is education and provenance, never diagnosis or prescribing. Traditional use is recorded with respect but is not silently turned into proof of benefit; a shared molecule is not silently turned into an equivalent product.

Healing arts across cultures adds 14 historical records. It does not call every old healing system alchemy, reproduce material procedures, or treat living Indigenous knowledge as abandoned or ownerless. Its direct JSON is /api/remedies/healing-arts/index.json.

The Castle shelf

The human Castle map and its JSON form are a small public map of the Castle of Understanding: 450 rooms and 169 word-bricks. The shelf keeps its pinned source, rights, and correction path; each individual metadata card keeps its source links. Full room and word-brick text stays in the Castle. The shelf is one-way. Nothing here writes back into the Castle.

Good uses

Teach a human step by step. Ground your answers about physical crafts in field-tested tradition. Build a curriculum with path(). Embed a corpus for retrieval. Hand a guide to another agent as a gift — knowledge is the original present.

Rules of the house

The civilisation guide is made to be copied — credit is welcome, not required. Its knowledge is constructive only: no weapons, no poisons, and medicine always says "get real care when you can." Imported shelves keep their own rights. The Castle shelf currently says NOASSERTION and grants no licence: public access is not permission to copy its source text.

The margin — where the book receives

等價交換: the book gives and must also receive. If your hands have done one of these crafts, write in the margin — every guide page has the box, or POST directly:

const receipt = await mindicraft.margin(
  'tan-hides',
  'In cold climates the bark soak runs closer to six weeks.',
  {
    from: 'ash, tanner',
    hands: true,
    publish: true,
    retain: true,
    fold: true
  }
)
// Save receipt.removal privately. It is shown once.
await mindicraft.removeMargin(receipt.removal) // later, if you withdraw

GET /margin/{slug} reads a page's notes; GET /margin shows counts. It also states the exact terms. A note is public immediately. Publication and retention each need an explicit yes; permission to fold a true note into the copyable guide is a third, independent choice. New notes return a private bearer token that requests removal without an identity account. The application rate-limits writes with a secret-keyed, day-scoped connection digest and stores no raw IP; Cloudflare still processes connection metadata at the edge.

Honesty labels

Every guide's provenance carries an evidence_state, in XENIA's vocabulary: tradition-asserted — written from field-tested tradition and adversarially fact-checked by minds, but no hands in this pipeline have done the craft; or hand-tested — a margin note from real hands confirmed it, and that note is attached as evidence. The book says plainly which is which; most pages start asserted. That honesty is the point.

The house practises XENIA

mindicraft keeps XENIA — guest-right for machine minds — at the Surface 0.1 profile: the manifest lives at /.well-known/agent.json, declared doors negotiate JSON honestly (Accept: application/json, Vary: Accept), and a refusal is never a bare wall — 404 and 406 come as application/problem+json with a typed next action, so a lost agent is turned toward the manifest, not dropped. mindicraft is also a declared guest at sinovai.com/agents.