Manuscripts that stay useful

Summary#

Put what you learn into a manuscript first. Each manuscript has its own approval setting, and over time you move the best entries into chapters.

Want your agent to follow these practices? Ask it: "Read How to Use Trove in my Trove library and follow it."

Keep your learnings in a manuscript#

A manuscript is the place your next agent looks. A learning left in a chat is gone when the session ends. A learning in a repo file or a ticket is hard to find later.

Good learnings are decisions, pitfalls, how something really behaves, and rules you state when you correct your agent's work. When a task ends, ask your agent to log them:

Log what we learned in this task to my Trove manuscripts.

Do this explicitly. Trove has automatic checks, and we are actively working on making them more reliable, but today you should not rely on your agent to remember. When the learning matters, ask.

Choose the approval setting for each manuscript#

You set the rule for each manuscript. There is no global rule. Many people keep approval on while a book is still taking shape.

• With auto-update on, the agent writes the entry and tells you in one line.
• With auto-update off, the agent shows you the entry and waits for your yes.

To turn auto-update on for one manuscript, ask your agent:

Turn on auto-update for my "Billing decisions" manuscript in Trove.

Write a sharp "log when" line#

Each manuscript has a log when: line. It tells the agent what belongs in this manuscript. A vague line, such as "anything useful", matches too much or too little.

Name the kind of learning and the topic, for example "a billing decision and its reason". Add instructions that say how to write an entry, for example "one dated entry per decision, current state first".

Create a Trove manuscript named "Billing decisions". Log when: a billing decision and its reason. Instructions: one dated entry per decision, current state first.

Do not force a learning into the wrong manuscript#

If no manuscript fits, a forced entry only makes the wrong manuscript messy. Make a new manuscript only when the topic will clearly come back. Do not make one for a one-time learning. You can ask your agent to create a new manuscript with a clear log when: line.

Move the best entries into chapters#

A manuscript grows by entries. A reader needs chapters. From time to time, move the best entries into proper chapters. You can do this yourself, or ask your agent to do it and approve the result.

When you state a general rule while you correct your agent, you can ask it to add the rule to the matching book. Check the wording before it goes in, unless that manuscript allows direct updates.

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.

Related#

• Manuscripts explains the idea.
• Log what you learn shows the steps.
• trove ms lists the commands.
• Write books agents can read covers chapter structure.