Documentos de proyecto

Los documentos de proyecto son la documentación del proyecto: especificaciones, decisiones, manuales o notas, en markdown y donde vive el trabajo. Es la misma documentación que tus agentes leen y escriben por MCP, así que no hay dos copias que mantener.

Cada proyecto tiene su pestaña Docs, con el árbol de documentos a la izquierda y el editor a la derecha. Cualquier miembro del workspace puede crear, editar y borrar (no hay autoría exclusiva). Los cambios se guardan solos: no hay botón de guardar.

Organizarlo en carpetas

Con Nuevo creas un documento suelto o una carpeta.

Cada carpeta tiene su propio menú (⋯) para crear un documento dentro, añadir una subcarpeta, renombrarla, moverla a otro sitio o borrarla.

• Las carpetas se anidan: puedes tener subcarpetas dentro de subcarpetas.
• Borrar carpeta no borra lo que hay dentro: sus documentos y subcarpetas suben un nivel.
• Lo que dejas plegado sigue plegado la próxima vez, en cada proyecto.
• Los documentos que no están en ninguna carpeta se quedan abajo, en Sin carpeta.

Buscar y enlazar entre documentos

El buscador de la barra lateral busca dentro del contenido, no solo en los títulos, y devuelve un extracto con lo que has escrito resaltado.

Para enlazar un documento desde otro, escribe / en el editor y el título del documento: el menú te lo ofrece y lo inserta como enlace. En el documento enlazado aparece Enlazado desde, con los documentos que apuntan a él. Así se construye la red de conocimiento del proyecto sin llevar un índice a mano.

Historial de versiones

Historial abre la lista de versiones guardadas de ese documento, con la fecha y quién escribió — también cuando quien escribe es un agente por MCP. Desde una versión, Restaurar devuelve el documento a ese estado.

Las versiones se agrupan mientras la misma persona sigue escribiendo, para que el autoguardado no genere cien entradas por tarde, y se conservan las últimas 50 de cada documento.

Publicarlo para tu cliente

Publicar en la web convierte un documento —o una carpeta entera— en una URL que abre cualquiera, sin cuenta y sin invitación. Es la opción del menú ⋯, y está a mano de administradores y miembros (un invitado no reparte acceso que no es suyo).

Publicar una carpeta no publica un documento: publica un mini-sitio navegable con su índice, su buscador y sus subcarpetas. Es el manual de tu cliente.

Lo que hay alrededor:

• El globo (🌐) marca en el árbol lo que está publicado. Un documento dentro de una carpeta publicada aparece como público porque lo es una carpeta superior.
• Copiar enlace público para pasárselo a quien sea.
• Publicar con enlace propio le da a un documento su propia URL, independiente de la de la carpeta.
• Generar un enlace nuevo cambia la dirección: la anterior deja de funcionar al instante. Es lo que se usa cuando un enlace se ha ido de las manos.
• Dejar de publicar lo corta. Si revocas una carpeta, cae el mini-sitio entero, incluidas las URLs de sus documentos.
• Mover un documento a una carpeta publicada te avisa antes de hacerlo: al moverlo pasa a leerse desde internet.

Seis meses después nadie recuerda qué dejó abierto, así que en Ajustes → Documentos publicados hay un inventario de todo lo que el workspace tiene expuesto ahora mismo —qué es, de qué proyecto, quién lo publicó y cuándo— con su botón para cortarlo. Esa pantalla es solo para administradores.

Lo que lo publicado no hace

Conviene tenerlo claro antes de prometérselo a un cliente:

• Es solo lectura. El lector anónimo no comenta ni edita. Si quieres que alguien de fuera comente, lo que necesitas es compartir el proyecto con un invitado por email.
• No sale en Google. Las páginas publicadas responden noindex a propósito.
• Quien tenga el enlace, entra. La dirección es aleatoria e inadivinable, pero no hay contraseña: trátala como lo que es, un secreto.
• No hay dominio propio ni personalización: ni logo ni colores del cliente en lo publicado.

Y los agentes leen lo mismo

Tus agentes acceden a estos documentos por MCP con list_docs, get_doc y save_doc (ver API y MCP). El documento que acabas de publicar para tu cliente es exactamente el que tu agente consulta para trabajar: se escribe una vez y sirve para los dos.

Relacionado: Proyectos · Agentes · API y MCP · Compartir un proyecto.