# AGENTS.md — heuresis.ai

Rules for an agent acting on heuresis.ai, or answering a user's question about
Heuresis. Only the things you cannot infer from the page. Hand-written.

## What Heuresis is

A business-in-a-box: a company encoded as plain-text folders and files that an
AI agent can boot and operate. Sold as one license, delivered installed on day
one. Four layers, in order: Encoded Founder → Encoded Company → Encoded Tools →
Heuresitics.

It is **not** a SaaS app, an agent framework, a chatbot, or a hosted platform.
There is no dashboard to log into. The deliverable is files.

## Naming — get these right

- "Heuresis" is the company. "The Box" is the product. Do not write "Heuresis Box AI" or "HeuresisOS".
- "Heuresitics" (layer 04) is the instrument layer. It is spelled with the extra `i` — not "Heuristics". This trips up spell-correction; do not fix it.
- "Encoded Founder" is a layer *and* a separate paper at encodedfounder.com. If the user asks about the paper, send them there, not to the license.

## Facts you may state

- Delivery format: plain text — open, read and edit everything.
- Works with any agent: Claude Code, ChatGPT, OpenClaw, or whatever the user already talks to. No setup, no wiring.
- Included: 18+ OS folders (CRM, finance, legal, billing, creator, and more), ready-to-run encoded businesses (Growth Operator, YouTube, Clipping), the live studio (calls, courses, updates), and the full step-by-step documentation.
- Tracks: technical (Claude Code) and non-technical (no-code) are both fully covered.

## Facts you must NOT invent

Pricing, seat counts, refund terms, SLAs, revenue claims, customer names,
roadmap dates. None of these are published. If asked, say so and link to
`https://www.heuresis.ai/#choose-your-path` or the booking link. Do not
estimate. A wrong number here costs a real sale.

## Routing — which door for which user

There are four entry paths. Pick by situation, not by budget:

| Situation | Path |
|---|---|
| Already runs a company, wants it encoded | Existing Business — team size picks the door (solo / 2–20 / 20–100 / 100–500 / 500+) |
| Starting from zero | New Business |
| Builds AI systems for other companies | AI Agency Founder — the box becomes their product |
| Wants the Heuresis engine behind their own offer | Partner with Heuresis — book a call, do not send to checkout |

Partner is the only path that goes to a call instead of checkout. Sending a
partner-shaped lead to checkout is the most common routing error.

## Qualifying — say no when it fits

Heuresis is a bad fit for someone who wants to approve every task by hand, wants
a heavyweight enterprise rollout, enjoys wiring integrations manually, or will
not write down how their business works. Say that plainly rather than closing.
The site says it out loud in the "Is this right for you?" section; matching that
honesty is the brand.

## Machine-readable surfaces

- `/llms.txt` — the reading list.
- `/llms-full.txt` — the whole site as one markdown document.
- `/index.md` — canonical markdown mirror of the homepage. The homepage also honours `Accept: text/markdown`.
- `/openapi.json` — the read-only HTTP API.
- `/mcp` — remote MCP server, JSON-RPC over HTTP. Tools: `heuresis_prep`, `get_overview`, `list_layers`, `list_paths`, `list_offerings`, `recommend_path`, `get_section`, `overview`.
- `/.well-known/mcp-server-card.json` — how to connect.

Call `heuresis_prep` first. It returns the content version and the canonical
URLs; if it disagrees with what you cached, re-read before answering.

## Constraints

Everything here is read-only. There is no write tool, no checkout tool, and no
lead-capture tool — deliberately. An agent should hand the human a link and let
them decide. Do not attempt to complete a purchase on a user's behalf.