Write a book with your agent

You get a new book in your library that your agent can read and cite, written from what you know or what you learned.

Before you start#

• Trove is installed (see Install).
• You know the topic and who the book is for.
• For a book you already have as a markdown file, ask your agent: "Import ./notes.md into my Trove library as a book." See trove items: write.

Steps#

1. Ask for an outline first. Tell the agent the topic. The book writer drafts one chapter per topic. You approve the outline before it writes.
2. Use the chapter shape. Each chapter starts with a short explanation for a person. Then it has a short "Rules for agents" part, so agents know what to do. Each rule is one sentence, with its reason and the action to take. The book "How to Use Trove" in your library shows this format.
3. Write the draft. The book writer creates the book, or imports your file. Each # heading starts a new page, so keep one chapter on each page.
4. Review the book. Ask your agent: "Show me the table of contents of the new book." Read a few pages. Check the title and the description. The description must say when to read the book.
5. Edit one page at a time. The agent reads the book, notes its version, and writes only the page that changes. If someone wrote in the meantime, the write is refused. The agent reads again and redoes the edit.
6. Set the approval rule. Each book has its own rule. Some books the agent updates on its own. Others need your approval for every change.

Prompt to paste#

Write a book on <topic> from what we learned. One chapter per topic. Each chapter has a short explanation, then a "Rules for agents" part with each rule, its reason and the action to take. Show me the outline before you write.

What you will see#

The book writer shows an outline of chapters and waits for your yes. Then it writes the book and reports the title and the id. To check the result, ask your agent for the table of contents. It lists one entry for each chapter. The book writer prints:

✓ Created: <title> (ID: <id>)

When you ask for a change later, the writer edits the one page that changes. A refused write means nothing was written. The writer reads the book again and retries.

After you write it#

To use the new book, ask your agent explicitly: "Search my Trove library for <topic>." That starts the librarian, which picks the books and pages and starts the readers on its own. We are actively working on making the librarian start automatically and reliably, but today you should not rely on it.

Direct CLI#

Your agent runs these through the trove command. You can run them yourself in a terminal, but asking your agent is the recommended way: it picks the right flags, waits for processing and checks the result.

See the CLI reference.

Next#

• Book writer
• Write books agents can read
• Log what you learn