Notas y especificaciones

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

  • 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

Markdown

¿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. 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.

¿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 y /mcp/docs.

Funciones relacionadas