Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Building with AI – Makechain
Skip to content

Building with AI

Makechain documentation is built with AI-first principles, providing multiple ways for LLMs and AI assistants to access protocol documentation.

llms.txt

The docs automatically generate llms.txt files for LLM consumption:

  • /llms.txt — a concise index of all pages with titles and descriptions
  • /llms-full.txt — complete documentation content in a single file

These files are generated at build time and served at the root of the site. Use llms-full.txt to give an AI assistant full context on the Makechain protocol in one shot.

Ask AI

Every documentation page includes an "Ask in ChatGPT" button that opens the current page context in ChatGPT with a Makechain-aware prompt. The dropdown also lets you copy the raw page content for pasting into any AI assistant.

Use ⌘ + I (macOS) or Ctrl + I (Windows/Linux) to quickly access the AI menu.

Using with Claude

Copy the page content (or the full llms-full.txt URL) and paste it into Claude:

Read the Makechain protocol documentation at https://makechain.pages.dev/llms-full.txt
and answer my questions about it.

Using with ChatGPT

Click the "Ask in ChatGPT" button on any page, or open ChatGPT and provide the docs URL:

Research this page: https://makechain.pages.dev/protocol/overview
and help me understand the message semantics.

Markdown access

Any documentation page can be accessed as raw Markdown by appending .md to the URL:

https://makechain.pages.dev/protocol/messages.md

This provides better token efficiency and easier parsing for LLMs compared to HTML.

Claude Code

Add the Makechain docs as context for Claude Code sessions:

# Add llms-full.txt as project context
claude context add https://makechain.pages.dev/llms-full.txt

Or reference the protocol specification directly:

# The full specification lives in the repo
cat protocol/SPECIFICATION.md

Example prompts

Here are effective prompts for working with Makechain using AI assistants:

Protocol understanding

What are the differences between 1P and 2P message semantics in Makechain?
How does the compare-and-swap mechanism work for REF_UPDATE?

Building on Makechain

Show me how to construct and sign a PROJECT_CREATE message using Ed25519.
How do I verify an Ethereum address claim signature?

Architecture questions

How does the two-phase execution model work? Why are some messages
processed serially in the account pre-pass?

Debugging

I'm getting a StorageLimitExceeded error when creating a project.
What are the storage limits and how do I check my capacity?

Protocol specification

The complete protocol specification is available in the repository at protocol/SPECIFICATION.md. This is the canonical reference — the documentation site is derived from it.

For AI assistants working with the codebase, the CLAUDE.md file provides build commands, architecture overview, module descriptions, and conventions.