§ Tools

Improve menu.

One-shot AI rewrites on text fields.

"Improve" is the small AI-rewrite menu attached to most editable text fields. Look for the sparkle icon next to a field while it's being edited.

What it does #

Click Improve to open a short menu of one-shot transformations applied to the field's current text:

  • Shorten — same idea, fewer words.
  • Expand — add detail; useful when a single sentence needs to become a paragraph.
  • Clarify — restructure for readability without changing meaning.
  • Fix grammar — pure copy-edit, no semantic changes.
  • Make formal — shift register up (toward audit-grade prose).

Pick one, the rewrite streams in over the existing text. You then either:

  • Accept — the rewrite replaces the field's content. The change is treated like any other edit (logged, can be reverted).
  • Discard — restore the original text. Nothing is saved.

When it's available #

The menu appears on most freeform text fields:

  • Project name and description
  • Vision phase: problem, users, value prop, scope
  • Feature stories and acceptance criteria
  • Architecture sections
  • Brief content
  • Any other long-form Markdown field

It's not available on:

  • Structured/typed fields (numbers, picks, dates)
  • Tables (each cell individually is too small to be worth rewriting)
  • Locked phases — every field is read-only
  • Empty fields — there's nothing to improve

What model it uses #

The enhance AI tier — a small, cheap model. Improve transformations are short input → short output, so spending much per call would be waste. See AI & models.

If you need higher-quality rewriting (e.g. consolidating the brief), use the interview panel on the relevant phase instead. That uses the content tier — a bigger model.

Costs and limits #

Each Improve call counts against your workspace's AI usage. There's no per-user rate limit, but workspace-wide limits apply if your admin has set them. Hitting the limit returns a small error in the menu and the original text is preserved.

Provenance #

If a field was last modified by an Improve transformation, the audit log entry says so — the action type is field.improve rather than field.edit. This lets reviewers tell hand-written content from AI-rewritten content.