Todo lo que hace,
y todo lo que no hará.
Lectura
- front matter eliminado
- imágenes de insignias eliminadas
- enlaces relativos reescritos desde la raíz del repository
- rutas conservadas, para que un modelo pueda citarlas
La estructura de carpetas es la navegación
Sin archivo de configuración, sin front matter, sin barra lateral que mantener. La raíz de la documentación se encuentra sola, los títulos salen del front matter, luego del primer encabezado y luego del nombre de archivo; el orden pone el README primero y después los prefijos numéricos, y CHANGELOG y LICENSE se agrupan abajo en lugar de saturar la parte superior.
El camino iluminado
El riel junto al árbol ilumina la ascendencia de lo que estés leyendo, para que siempre sepas en qué punto del corpus te encuentras.
Hecho para leerse de principio a fin
Una medida de 78 caracteres en cualquier ancho, tipografía de verdad, oscuro por defecto. Para una especificación que alguien lee de verdad, no una página que alguien hojea.
Diagramas y código
Mermaid se muestra con la paleta del propio producto, y los bloques de código usan seis colores de sintaxis que siguen el tema. Ninguno de los dos se carga en un documento que no los tiene.
Tus preferencias de lectura
El tema, el ancho de lectura, la densidad de la barra lateral y las animaciones son tuyos y te acompañan, aplicados antes del primer renderizado y no después.
Copiar para un LLM
Lleva un documento o una carpeta entera a tu modelo como markdown limpio — sin front matter ni badges, con los enlaces reescritos — con el recuento de tokens antes de pegar.
Fuentes
Dos proveedores, solo lectura, nunca clonados
Una GitHub App con acceso de lectura a los repositories que elijas, revocable desde GitHub en cualquier momento. O un token de acceso de GitLab — gitlab.com, instancias autogestionadas o internas, proyectos públicos y privados. Una sola llamada devuelve el árbol completo más un blob SHA por archivo; sin binario de git, sin copia de trabajo, nada en disco.
Ningún token en la base de datos
Los tokens de instalación de GitHub se emiten bajo demanda a partir de la clave de la App y solo se guardan en memoria. Un token de GitLab se cifra en reposo con su propia clave, y uno con alcance de escritura o sin caducidad se rechaza explícitamente al conectarlo.
Muchos repositories, un solo proyecto
Un ingeniero que trabaja en seis servicios los lee y los busca todos desde un solo lugar. Un proyecto agrupa repositories y lleva la lista de acceso.
Las imágenes privadas funcionan
Las imágenes de un repository privado se sirven a través de un proxy autenticado en lugar de enlazarse directamente, así que cargan para quienes pueden verlas y para nadie más.
La branch se lee, no se adivina
La lista real de branches viene del repository. Un selector fijo de main o master apuntó una vez una conexión a una branch que no existía, y la sincronización no encontró nada.
Búsqueda
Todos los documentos de cada repository conectado
Búsqueda de texto completo en toda la organización en una sola consulta, ordenada por relevancia, con la ruta y el estado de revisión junto a cada resultado. Postgres estándar, sin extensiones — una búsqueda que necesita una deja de funcionar en la base de datos gestionada de alguien.
Una sola tecla
La paleta de comandos se abre con ⌘K para todo y ⌘P para archivos, con proyectos, ajustes y acciones de la cuenta en la misma lista.
Buscar en el documento
⌘F resalta las coincidencias sin tocar el marcado del documento, así que nada se mueve en la página mientras buscas.
Flujo de trabajo
Dos ejes, y la desviación medida contra el contenido
El estado de revisión y el de implementación avanzan por separado, y cada uno recuerda la versión exacta sobre la que se fijó. Edita el documento y mostrará validado · desfasado en lugar de conservar una insignia que ya no es cierta. Un documento que nadie ha clasificado no tiene fila alguna — un corpus sin clasificar no cuesta nada y no muestra pastillas.
El tablero
Cada documento con un estado, en columnas entre las que puedes arrastrarlo, en un proyecto o en toda la organización, filtrado por una URL que puedes enviar a alguien.
Notas sobre un encabezado
Comentarios anclados a la sección a la que se refieren. Una nota cuyo encabezado desaparece falla de forma visible en lugar de trasladarse a un texto que dice otra cosa.
Acuses de lectura
Se cuentan tras diez segundos de permanencia visible, nunca por un clic, y solo sobre la versión actual — así «tres de cinco revisores lo han leído» significa lo que dice.
Marcar un documento como «No aplica»
Saca un README del tablero sin decir nada del documento en sí. Ni borrador ni rechazado: no es un elemento de trabajo, sin más.
El registro de revisiones
Las versiones anteriores se guardan en lugar de volver a descargarse, para que veas qué cambió entre la versión que alguien validó y el texto actual.
Pregunta a tu documentación
Resúmenes que saben cuándo están desfasados
Un resumen está ligado al contenido del documento, no a una fecha, así que está al día o dice que no lo está. Una respuesta en caché no gasta créditos, y eso es lo que hace viable la asignación. El texto de un documento solo sale de la máquina en una organización que lo haya activado — el ajuste está desactivado por defecto y activarlo queda auditado.
Las preguntas que ofreció el resumen
Preguntas lo que sugiere el resumen actual, no texto libre. Sin ese filtro, cualquier miembro tiene un canal no validado y pagado por la organización hacia un modelo de terceros.
Conversar con un documento
En streaming, basado en un solo documento y separado de las preguntas sugeridas precisamente por la razón anterior.
Resúmenes de cambios
Un párrafo sobre lo que cambió, para los documentos que alguien sigue, en lugar de un diff que tengas que leer.
Resúmenes por lotes
Resume un corpus a propósito, con el precio antes de ejecutarlo. Nunca automático, porque una pasada en segundo plano que gasta una asignación es una factura que nadie aceptó.
Agentes
Un servidor MCP sobre tu propia documentación — 16 herramientas
Un único endpoint sin estado. Tu agente de código encuentra, lee y cita lo que tu equipo ya escribió, sin pegar nada en un prompt. Las herramientas se ocultan por alcance y no por nombre, así que a una clave de solo lectura nunca se le muestra la mitad de escritura.
Artifacts
Un agente archiva una especificación o un plan como documento versionado junto a la documentación. Nunca puede llegar a un archivo del repository, y no hay borrado.
Umbrales de revisión
Una clave puede llevar un estado de revisión mínimo. Por debajo, los documentos dan 404 en todas las puertas — también en las rutas del lector, porque un umbral con una sola puerta de entrada no es un umbral.
Respuestas tipificadas
Un agente responde a una nota con de acuerdo, en desacuerdo, necesita aclaración o atendido. Cuatro notas en las que discrepó son una cola que abre un responsable; una transcripción, no.
Declaraciones de implementación
Un agente dice que empezó o terminó, con pruebas guardadas como nota. Registra una afirmación, nunca una finalización.
Límites de tasa, no cuotas
Las lecturas son gratis en todos los planes y están limitadas por un token bucket por clave en lugar de una asignación mensual.
Organizaciones y acceso
La membresía es la organización; el acceso es el proyecto
Unirse no da acceso a ningún documento. Nada es implícito: un Member lee un proyecto mediante un permiso de equipo o uno directo, y alguien sin equipo ni permiso no lee nada. El acceso se resuelve en el servidor en cada petición, con una sola consulta, y un proyecto al que perdiste el acceso responde exactamente igual que uno que nunca existió.
Roles que significan una sola cosa cada uno
Owner, Admin, Member y Guest en la organización; Admin, Member y Viewer en un proyecto. Un Guest solo ve lo que se le concedió — para él, la organización es mobiliario invisible.
Equipos
Concede un proyecto a un equipo en lugar de a siete personas, y retira a alguien una sola vez.
Invitaciones
Una invitación lleva una intención — un rol, algunos permisos de proyecto, algunos equipos — y no concede nada hasta que se acepta. El enlace funciona una vez, caduca y se puede revocar.
Un identificador, reclamado una vez
Se reclama una vez y nunca cambia, porque cuatro tablas lo desnormalizan junto a un nombre y un cambio de nombre no tiene respuesta honesta.
Irse sin riesgos
Puedes irte salvo que irte deje a alguien tirado. El último Owner de una organización con más personas tiene que traspasarla antes.
Seguridad
El Markdown se sanea en el servidor, sobre una lista blanca
Markdown permite HTML sin procesar, así que una etiqueta script en el README de alguien se ejecutaría en nuestro origen con tu sesión. Es el riesgo más grave en un producto como este y se cierra antes de guardar nada, no al renderizar.
Registro de auditoría
Cada cambio de seguridad y de producto, con quién y cuándo, escrito en la misma transacción que el cambio — si el cambio se revierte, el registro se va con él.
Sesiones y dispositivos
Una lista real de dónde has iniciado sesión y una notificación cuando aparece un dispositivo nuevo. Una etiqueta de plataforma aproximada y una dirección truncada — sin ciudad, sin país, sin adivinar si fue inusual.
Lista de direcciones permitidas
Rechaza cualquier petición de una dirección que no hayas indicado, tanto para claves de API como para navegadores.
Claves que sobreviven a las personas
Una clave de API pertenece a la organización y nombra un solo proyecto, así que un trabajo de CI no se rompe el día que quien la configuró cambia de equipo. Solo se guarda su hash, y revocarla surte efecto en la siguiente petición.
Dos formas de entrar, ninguna eliminable sola
GitHub, una contraseña o ambos. Quitar uno se rechaza cuando falta el otro, así que una cuenta nunca puede quedarse sin forma de entrar.
Salud de la documentación
Tres señales, ninguna de ellas una opinión
Un enlace relativo que no lleva a ningún documento. Un documento cuyo contenido no ha cambiado en más tiempo que tu umbral. Un documento que nombra un archivo de código que cambió después que él — la única señal del producto que conecta el código con la documentación. Nada aquí llama a un modelo, así que nada cuesta.
Los hallazgos se derivan, no se archivan
Un hallazgo que dejó de ser cierto desaparece en lugar de resolverse. Lo que sobrevive a la reconstrucción es la decisión de una persona de que uno estaba equivocado.
Silencio sobre lo que no puede saber
Un repository recién conectado no informa de nada desactualizado con ningún umbral, y la pantalla lo dice en lugar de dar a entender que todo está al día.
Notificaciones
Una bandeja de entrada, no una segunda copia del registro de auditoría
El registro de auditoría responde qué pasó en esta organización; la bandeja de entrada, qué te queda por ver. Son preguntas distintas y ninguna tabla puede responder la de la otra — una sincronización correcta, una respuesta a una nota, una asignación agotada y cada evento de facturación no escriben ninguna fila de auditoría.
Nunca se te notifica sobre ti mismo
Quien realiza la acción nunca es destinatario, un duplicado aún sin leer se suprime y cualquiera que no pueda leer el asunto queda fuera — un título es contenido.
Se te dice una vez, a tu manera
Por categoría: al momento, en un resumen con tu frecuencia o nunca por correo. Desactivado significa «no me lo digas dos veces», así que un resumen tampoco te lo dirá después.
La seguridad siempre te llega
No hay ningún interruptor que suprima «tu contraseña se ha cambiado». Un ajuste que pudiera hacerlo solo ayudaría a quien la cambió.
Lo que deliberadamente no construimos
Ni una hoja de ruta, ni cosas para las que no dio tiempo. Cada una se consideró y se rechazó, y el motivo es lo que impide que el producto se convierta en aquello que vino a sustituir.
- Un editor para tu repository
- Los documentos del repository son de solo lectura aquí: los editas en tu IDE y haces commit. Los borradores y las páginas del manual tienen editor; los archivos de tu repository nunca.
- Un tablero público de comentarios
- El sitio público es para leer. Los comentarios se quedan dentro de Docs Flowy como notas, donde los agentes responden y las personas las cierran.
- Una wiki con almacenamiento propio
- Git es la fuente de verdad de cada documento del repository. Docs Flowy solo guarda lo que está a su lado: borradores, artifacts de agentes y páginas del manual.
- Componentes MDX personalizados
- CommonMark y GFM estándar. La portabilidad es la promesa: tu documentación sigue siendo legible sin nosotros.
- Nuestro propio renderizador de markdown
- Un problema resuelto. Usamos uno bueno en lugar de mantener uno peor.
- Un archivo de configuración obligatorio
- Existe una forma de sobrescribir. Nunca es obligatoria, y necesitarla sería un error nuestro.
Si alguno de estos es lo que necesitas, te decimos qué herramienta usar en su lugar.