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

# Memoria del proyecto

> Guarde y apruebe preferencias del proyecto para futuras sesiones locales.

export const ScreenshotCrop = ({src, alt, width, height, x = 0, y = 0, cropWidth = width, cropHeight = height, maxWidth = "100%"}) => <div className="not-prose" style={{
  position: "relative",
  overflow: "hidden",
  width: "100%",
  maxWidth,
  margin: "0 auto",
  aspectRatio: `${cropWidth} / ${cropHeight}`
}}>
    <img src={src} alt={alt} width={width} height={height} style={{
  position: "absolute",
  display: "block",
  margin: 0,
  maxWidth: "none",
  width: `${width / cropWidth * 100}%`,
  height: "auto",
  left: `${-x / cropWidth * 100}%`,
  top: `${-y / cropHeight * 100}%`
}} />
  </div>;

La memoria del proyecto guarda instrucciones para futuras sesiones de un proyecto local. Está desactivada de forma predeterminada y usted escribe y aprueba cada preferencia. Por ejemplo, puede guardar una instrucción para incluir una prueba de regresión cada vez que el agente corrija un error.

## Elija qué recordar

Guarde instrucciones válidas entre tareas del mismo proyecto: un comando de pruebas, una restricción de compatibilidad o una convención de revisión. Deje los errores concretos y las investigaciones temporales en su sesión. Activar memoria no extrae preferencias de conversaciones anteriores; usted escribe y aprueba cada texto.

| Preferencia | Utilidad |
| - | - |
| «Use el framework de pruebas existente; no añada otro para corregir un error». | Mantiene las convenciones de pruebas. |
| «Explique los cambios en firmas públicas antes de editarlas». | Hace explícitos los cambios de interfaz. |
| «Si no puede ejecutar una comprobación, indique el comando y el motivo sin marcarla como superada». | Define el contenido del informe de verificación. |

Guarde solo instrucciones aplicables al proyecto. No incluya contraseñas ni claves API: las preferencias activadas se envían con las solicitudes al modelo.

## Guarde una preferencia del proyecto

Con una cuenta verificada conectada, abra **Settings → Projects**, seleccione la carpeta y active **Memory in this project**. Escriba una preferencia, revísela y elija **Approve and save**. Cada cuenta y carpeta tiene sus propias preferencias; los worktrees separados también tienen memorias separadas.

Para un proyecto con pruebas, una preferencia útil especifica la verificación esperada:

> Al corregir un error, añada una prueba de regresión que lo reproduzca. Ejecute las pruebas relevantes después de la corrección e indique el comando y el resultado.

Guarde preferencias específicas del proyecto. Una convención de pruebas puede orientar futuras sesiones, pero conviene revisar la salida real antes de aceptar un cambio. Para reutilizar la preferencia en otro worktree, configure también la memoria de esa carpeta.

<Frame caption="Una preferencia aprobada del proyecto pide una prueba de regresión y el resultado real de las pruebas tras cada corrección.">
  <ScreenshotCrop src="/images/mka1-code/guides/memory.jpg" alt="Memoria del proyecto activada con una preferencia de pruebas aprobada" width={2720} height={1800} x={975} y={210} cropWidth={1300} cropHeight={960} maxWidth="100%" />
</Frame>

## Configure el valor predeterminado y la excepción

En **Settings → Projects**, seleccione una carpeta o use **Add folder…**. Esta selección puede diferir del proyecto abierto en Code: compruebe la carpeta antes de guardar.

En **All projects**, **Memory by default** establece el valor inicial para los proyectos locales de la cuenta. **Memory in this project** ofrece:

| Opción | Efecto |
| - | - |
| **Default (On)** o **Default (Off)** | Sigue el valor de la cuenta y muestra su estado. |
| **On** | Mantiene la memoria activada en esta carpeta aunque cambie el valor general. |
| **Off** | La mantiene desactivada aunque cambie el valor general. |

Se comparte el estado predeterminado, no el texto. Un proyecto nuevo empieza con una lista vacía. Los worktrees separados también tienen listas distintas.

## Edite o elimine preferencias

Revise las preferencias y sus fechas de aprobación en los ajustes del proyecto. Edite y vuelva a aprobar una entrada cuando cambie una convención. Use **Search preferences** cuando aparezca el buscador para una lista más larga.

**Delete** elimina una entrada. **Clear project memory** elimina todas las de la cuenta y carpeta tras confirmar, sin cambiar si la memoria está activada. Desactivarla conserva la lista y permite revisar o eliminar; añadir o editar requiere activarla otra vez.

Un proyecto admite hasta 50 preferencias, 2.000 caracteres por entrada y 12.000 en total. Si alcanza un límite, acorte o elimine una entrada en lugar de duplicar la misma instrucción.

## Cómo se utilizan las preferencias

Las preferencias se conservan en el almacenamiento local y se incluyen en las solicitudes al modelo mientras la memoria está activada. Desactivarla conserva las preferencias, pero deja de añadirlas a futuras solicitudes. Las conversaciones anteriores conservan el texto de las preferencias que ya recibieron. El recurso exige iniciar sesión con una cuenta y utilizar un proyecto local; el acceso solo mediante clave API y los entornos remotos no lo admiten.

### Compruebe las preferencias utilizadas

Si falta una preferencia esperada, compruebe cuenta, gateway, carpeta y estado efectivo. Otro worktree del mismo repositorio no hereda las preferencias de la carpeta original.

Cambiar la memoria puede interrumpir un turno local; reenvíe la solicitud si hace falta. Eliminar una preferencia no reescribe conversaciones que ya la contienen. Inicie una sesión nueva si necesita dejar de arrastrar ese texto anterior.

Continúe con [Sesiones y contexto del proyecto](/es/docs/mka1-code/sessions).
