# Notas y especificaciones

Notas de texto del proyecto para specs, decisiones y accesos, con archivos colgando y lectura desde MCP.

Fuente: https://ardumaker.com/docs/notas-y-especificaciones/

- Categoría: Proyectos y empresas
- Estado: Disponible
- Requisitos: Acceso de nivel `aportar` o mayor en la sección Adjuntos
- Herramientas MCP (Solo leen): `ver_adjunto`, `listar_adjuntos`, `buscar_en_proyecto`
- Herramientas MCP (Escriben o modifican): `crear_adjunto`, `editar_adjunto`

## ¿Qué permite hacer?

No hay un módulo de especificaciones aparte: las notas son adjuntos de tipo `nota`, y viven junto a los demás [archivos adjuntos](https://ardumaker.com/docs/archivos-adjuntos). Las etapas y tareas tienen además su propia descripción.

- Escribir texto libre: requisitos, decisiones, procedimientos, accesos.
- Colgarle archivos a la nota (un contrato con sus anexos, por ejemplo).
- Editar el texto sin perder los comentarios.
- Marcarla como secreta.

## ¿Cuándo conviene usarlo?

- Para dejar el contexto del proyecto escrito y al alcance del equipo.
- Para que un agente lea las especificaciones antes de crear tareas.
- Para que cada proyecto nuevo arranque con notas de base, cargadas en una [plantilla](https://ardumaker.com/docs/plantillas).

## ¿Cómo funciona en ArduMaker?

- El texto de una nota se edita en el lugar; el resto de los tipos de adjunto no tienen texto editable.
- La búsqueda del proyecto encuentra notas por nombre, `slug` o texto.
- Una nota secreta solo la ve completa quien la creó o quien administra la sección Adjuntos.

## ¿Qué cambia realmente?

- Cada creación o edición queda en el historial del proyecto.
- Borrar una nota es reversible durante 30 días.

## Resultado esperado

La nota queda en el repositorio del proyecto y puede citarse desde comentarios y checklists.

## Errores y resolución

- Intentar cambiar el texto de un adjunto que no es `nota` da error: no tiene texto editable.
- Una nota muy larga se lee por partes desde MCP; `contenido_recortado` indica cómo pedir la siguiente.

## Relación con MCP

- Leer: `ver_adjunto` (hasta 30000 caracteres por parte), `listar_adjuntos` y `buscar_en_proyecto`.
- Escribir: `crear_adjunto` con `tipo='nota'` y `editar_adjunto` para el texto.
- Un agente no puede crear notas secretas ni tocar las que ya lo son.

Más en [/mcp/proyectos](https://ardumaker.com/mcp/proyectos) y [/mcp/docs](https://ardumaker.com/mcp/docs).

## Funciones relacionadas

- [Archivos adjuntos](https://ardumaker.com/docs/archivos-adjuntos/)
- [Plantillas de proyecto](https://ardumaker.com/docs/plantillas/)
- [Tareas](https://ardumaker.com/docs/tareas/)
- [Servidor MCP](https://ardumaker.com/docs/servidor-mcp/)