> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withmethod.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Improve and proposals

> Ask Method for a better version, review the proposal, and apply it to your file.

An improvement reads a Method, its runs, and your correction, and returns a **proposal**: a changed Method, a new case, a rubric fix, a script change, or no change. A proposal never publishes itself and never changes the current version. Only a person accepts it.

## 1. Ask for an improvement

```sh theme={null}
method improve support-triage.method --step draft_reply --note 'Name the customer in the first sentence.'
```

* `--note`: the correction, in your words. It is about the newest run of the Method on this computer. The improvement reads that run, and a suggested case records it.
* `--step`: improve only this step.
* `--case`: a [case](/guides/review-and-test) that the change must pass.

The file needs its `id:` line (run it once while signed in). Where the improvement runs depends on `run_data`:

| `run_data` | Where it runs | Result |
| - | - | - |
| `account` (default) | In your Method account. The dashboard shows the progress. | A proposal in your account. |
| `device`, or the organization setting **Keep run content on devices** | On this computer, so the run content stays here. | A local proposal in `.method/proposals/`. |

## 2. Review the proposal

```sh theme={null}
method proposals support-triage.method
```

This lists the proposals in your account and the local ones beside the file, with their status, kind, cause, and steps. It also shows the newest improvement that has no proposal yet: its status, and its error if it failed.

An improvement usually takes a few minutes. To wait for it:

```sh theme={null}
method proposals support-triage.method --wait
```

`--wait` prints each step that the improvement reaches, and stops when the improvement ends. On the dashboard, a Method with an open proposal shows **Proposal ready to review**. Accept or reject it there.

## 3. Apply it

```sh theme={null}
method apply support-triage.method
```

`apply` merges the newest accepted proposal (or else the newest local proposal) into your file, step by step. A part that only the proposal changed takes the change. A part that both you and the proposal changed is a conflict: `apply` lists the base, your value, and the proposed value, changes nothing, and exits 1. Merge it by hand, then run `method apply FILE PROPOSAL_ID --resolved`.

Commands that take a signed-in file apply an accepted proposal first and print one line. Nothing is published: run the Method, then [publish](/guides/publish) the new version.

## Automatic suggestions

With the Startup plan, Method checks each Method with account run data once a day. When its newest runs fail more often, or give more unclear or low-confidence answers, than the week before, it starts an improvement. One email a day lists the new proposals.

Improvements in your account and automatic suggestions are in the Startup plan. See [Pricing](/guides/pricing).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.