# Mejoras

Una mejora es una acción concreta que Bison recomienda para subir tu visibilidad: publicar un archivo, corregir un dato estructurado, escribir una página. Tu agente puede listarlas, pedir el brief de cada una y, con permiso de edición, marcarlas como hechas.

## Qué trae cada mejora

| Campo | Qué es |
| --- | --- |
| `id`, `title`, `description` | La mejora y por qué importa. |
| `status` | Su estado; ver abajo. |
| `impact` y `effort` | Cuánto se espera que mejore y cuánto cuesta hacerla, en `high`, `medium` o `low`. |
| `area` | El área a la que pertenece. |
| `steps` | Los pasos para hacerla, cada uno con `text` y `done`. |
| `competitors` | Competidores de referencia, si aplica. |

## Estados

| Estado | Significa | Quién lo pone |
| --- | --- | --- |
| `pending` | Pendiente de hacer. Es el estado de partida. | Bison |
| `done` | Hecha. Marca también todos sus pasos como hechos. | Tú o tu agente, con permiso de edición |
| `dismissed` | Descartada: no la vas a hacer. | Tú o tu agente, con permiso de edición |
| `resolved` | Ya no hace falta: el problema que la originó desapareció o la reemplazó otra mejora. | Bison |

`update_improvement` solo cambia entre `pending`, `done` y `dismissed`; reabrir una mejora la vuelve a `pending`. Queda registrado qué token hizo el cambio.

## Del listado al trabajo

1. [`list_improvements`](https://docs.bisonagents.com/mcp/herramientas/list_improvements/) da las mejoras ordenadas por prioridad, con filtros por estado y otros campos. `limit` va de 1 a 50 y por defecto devuelve 10.
2. [`get_task_brief`](https://docs.bisonagents.com/mcp/herramientas/get_task_brief/) da el brief completo de una: contexto, por qué importa, los pasos y cómo se da por terminada.
3. [`update_improvement`](https://docs.bisonagents.com/mcp/herramientas/update_improvement/) la marca como hecha o descartada, o marca pasos sueltos.
4. [`regenerate_improvements`](https://docs.bisonagents.com/mcp/herramientas/regenerate_improvements/) vuelve a calcular las mejoras con los últimos reportes. Tiene costo y un tope diario; ver [Límites y errores](https://docs.bisonagents.com/mcp/limites-y-errores/).

> **Campos que pueden venir vacíos:** Algunas mejoras traen campos adicionales, como nivel, cuadrante, plan por etapas, entregable y verificación. Solo los traen las mejoras que los incluyen; en las demás llegan `null` y no es un error.

## Herramientas que las devuelven

- [`list_improvements`](https://docs.bisonagents.com/mcp/herramientas/list_improvements/)
- [`get_task_brief`](https://docs.bisonagents.com/mcp/herramientas/get_task_brief/)
- [`update_improvement`](https://docs.bisonagents.com/mcp/herramientas/update_improvement/)