# AI use cases for Pi Book (antinomie-lab/pi-book)

Repo: [antinomie-lab/pi-book](https://github.com/antinomie-lab/pi-book) | Use cases: 3 | Page: https://dedupedai.com/use-cases/antinomie-lab-pi-book/

A Chinese architecture book, with English and Spanish translations, that explains how the @earendil-works/pi-agent-core agent loop library is built, citing the pi source code.

This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL.

- Have an agent verify the book's code citations: https://dedupedai.com/use-cases/antinomie-lab-pi-book/check-book-claims-against-pi-source/
- Run the book's web reader on your own machine: https://dedupedai.com/use-cases/antinomie-lab-pi-book/run-book-reader-locally/
- Compare the Chinese, English and Spanish editions: https://dedupedai.com/use-cases/antinomie-lab-pi-book/compare-book-language-editions/

## How to have an agent verify the book's code citations with Pi Book

Repo: [antinomie-lab/pi-book](https://github.com/antinomie-lab/pi-book) | Difficulty: Intermediate | Time: US30 | Basis: From the README

Use an AI agent to check each file:line quote in a chapter against the pi source at the stated commit.

**Who it is for:** A developer who wants to trust an architecture claim before relying on it, and who has the pi repo and an AI coding tool at hand.

**The problem:** Architecture writing is only useful if the code it cites says what the text claims. Checking each citation by hand takes a long time.

**The outcome:** A list of each file:line reference in one chapter, marked as matching or not matching the quoted excerpt in pi at commit cd20a8d2e.

### Steps

1. Clone the Pi Book repo with git and open the agent/ folder, which holds the Chinese original. (inferred, check the README)
2. Check out the pi repo at commit cd20a8d2e so the line numbers match the book. (inferred, check the README)
3. Open the chapter you want to check and list every file:line reference with its quoted excerpt.
4. Ask the agent to open each referenced file and line range and compare it to the quote.
5. Note any mismatch and re-read that passage in the book before relying on it.

### Prompt to paste into your agent

```text
In the antinomie-lab/pi-book repo, open <chapter-file> under agent/. For every file:line reference and its quoted excerpt, open <pi-repo-path> at commit cd20a8d2e and check that the excerpt matches the cited lines. Output a table with each reference, MATCH or MISMATCH, and the actual text if it differs; verify that the count of references equals the count you found in the chapter.
```

### Caveat

The book pins one commit of the pi repo, so citations will drift if you check against a newer version of pi.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/antinomie-lab-pi-book/check-book-claims-against-pi-source/

## How to run the book's web reader on your own machine with Pi Book

Repo: [antinomie-lab/pi-book](https://github.com/antinomie-lab/pi-book) | Difficulty: Intermediate | Time: US15 | Basis: From the README

Start the Vite and Vue reader locally to browse the architecture book without the hosted site.

**Who it is for:** A developer who wants to read or modify the book's reader offline, or to work on the book in a local setup.

**The problem:** The hosted reader is the easiest way to read, but a developer may want a local copy of the reader that renders the same Chinese source.

**The outcome:** A local dev server showing the book from the agent/ source files, started with two commands.

### Steps

1. Clone the Pi Book repo and change into its folder. (inferred, check the README)
2. Run `cd web && npm install && npm run dev`.
3. Open the local address that the dev server prints in the terminal.
4. Switch between the Chinese original and the translations using the reader language control.

### Prompt to paste into your agent

```text
In the antinomie-lab/pi-book repo, go to the web/ folder and run the install and dev commands from its README. Report the local URL the dev server prints and confirm that the Chinese chapter text renders from agent/ without errors.
```

### Caveat

The reader only renders content from agent/, so editing the web/ folder does not change the book text itself.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/antinomie-lab-pi-book/run-book-reader-locally/

## How to compare the Chinese, English and Spanish editions with Pi Book

Repo: [antinomie-lab/pi-book](https://github.com/antinomie-lab/pi-book) | Difficulty: Intermediate | Time: US30 | Basis: From the README

Read the same chapter in its three language versions to check translation consistency.

**Who it is for:** A bilingual reader or translator who wants to confirm that a term or claim reads the same across the book's editions.

**The problem:** The book has one Chinese source and two translations, so a claim could drift in translation without anyone noticing.

**The outcome:** A short list of places where the English or Spanish version differs in meaning from the Chinese original.

### Steps

1. Clone the Pi Book repo to get the Markdown files. (inferred, check the README)
2. Open the same chapter in agent/, agent/en/ and agent/es/.
3. Read the workspace translation notes in agent/TRANSLATION.md to see how the translations are maintained.
4. Compare key technical terms and code citations across the three versions.

### Prompt to paste into your agent

```text
In the antinomie-lab/pi-book repo, open the same chapter from agent/, agent/en/ and agent/es/. Output a list of statements where the English or Spanish text differs in meaning from the Chinese original, with the section name for each. Verify that all code citations appear unchanged in all three versions.
```

### Caveat

The Chinese original is the only content source, so translation differences are fixes to the translated files, not reasons to change the original.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/antinomie-lab-pi-book/compare-book-language-editions/
