Tune up — improving your helpers with AI

The Tune up feature lets you improve a helper's instructions through a conversation with Margaret. Instead of editing sections manually, you describe what you want to change in plain English and Margaret suggests the edits.


When to use Tune up

Use it when:

  • A helper is producing output that's close but not quite right
  • You want to add a new section or constraint without writing it yourself
  • You're not sure exactly what to change but you know something isn't working
  • You want Margaret to suggest improvements based on what it knows about the task

Use direct editing (the edit icon on each section in the Definition panel) when:

  • You know exactly what you want to change
  • It's a small fix — a typo, a reworded sentence, an updated bullet point
  • You don't need a suggestion, you just need to make the change

How it works

  1. Open a helper and click Tune up in the top right
  2. A chat panel opens on the right side of the screen
  3. Describe what you want: "The output is too formal", "Add a section about competitor positioning", "It keeps missing the budget constraint — make sure it always asks about budget in the process"
  4. Margaret responds with proposed changes — you can see exactly what it wants to edit
  5. Click Apply to accept a change, or keep chatting to refine it further
  6. Changes are applied directly to the helper file and take effect immediately

Tips for good results

Be specific about what's wrong. "The output isn't very good" gives Margaret little to work with. "The summary section is too long and always repeats the same three points" gives it something concrete to fix.

Describe the problem, not the solution. You don't need to know what the right fix is — that's what Tune up is for. Tell Margaret what's going wrong and let it figure out the edit.

Test after each change. Apply one change at a time and run the helper with a real input to see if the change helped. It's easier to diagnose what's working if you change one thing at a time.

You can always undo. Applied changes are written directly to the helper file. If an edit makes things worse, you can use the edit icon on that section to change it back, or open Tune up again and ask Margaret to revert it.


What Tune up can and can't do

It can:

  • Rewrite any section of a helper's instructions
  • Add new sections
  • Make the Process more specific or add steps
  • Adjust the Output Format
  • Suggest a different approach based on your description of the problem

It can't:

  • Run the helper for you — you still need to use the Use panel for that
  • See your past run outputs unless you paste them in
  • Access the internet or external documents

The chat history

The Tune up conversation is stored in memory while the panel is open. If you close and reopen the panel, the conversation starts fresh. This is intentional — each Tune up session is a focused editing session, not an ongoing relationship.

If you want Margaret to reference a past run in the conversation, copy and paste the relevant output into the chat.