Documentación escrita con el trabajo, no después
El manual nunca va por detrás de tus especificaciones
De tu código, sí puede: aquí nada lee código, así que una especificación construida de otra manera y aún marcada como hecha produce una página equivocada. Lo que el manual detecta es una especificación que se movió.
Cada página sabe contra qué se escribió
Un ancla guarda el contenido exacto del que salió una página: el blob SHA de un documento, la versión de un artifact. La vigencia compara esos valores, nunca una fecha.
- Vigente
- Cada ancla coincide con su fuente. Los lectores ven los nombres de las fuentes.
- Desactualizada
- Una especificación anclada se marcó como hecha en una versión más reciente, o una fuente cambió. Los lectores ven cuál y desde cuándo, antes de que nadie se confunda.
- La fuente cambió, aún no está construida
- Solo lo ven los editores. Una especificación editada el lunes no marca la página como errónea antes de que exista el trabajo.
- Sigue siendo correcta
- Una persona confirma que una página desactualizada es correcta tal como está. Las anclas se mueven, el texto se queda y no se gastan créditos.
Desactualizada desde que «Reembolsos parciales» se marcó como hecha
- specs/payments/refunds.md
- specs/payments/partial-refunds.md
- adr/0007-idempotency-keys.md
El agente que construyó la función redacta la página
Tu propio agente de código informa de la construcción por MCP y propone el cambio del manual en el mismo informe. Docs Flowy no ejecuta ningún agente de código propio.
- 01Un agente informa de la construcciónAl empezar, sabe qué páginas anclan la especificación en la que trabaja. Al terminar, su informe incluye la página actualizada, o el motivo por el que ningún lector vería un cambio.
- 02El cambio abre una solicitudNadie edita el manual publicado. Cada edición, de una persona o de un agente, es una solicitud de cambio contra la versión desde la que se escribió.
- 03Una persona la aplicaQuien aprueba lee el cambio y lo aplica, o lo rechaza con un motivo. Si otro cambio en la página llegó antes, este queda desactualizado y no puede aplicarse tal como está.
Los agentes pueden proponer cambios al manual es un ajuste del proyecto, activado por defecto. Un agente solo escribe páginas de Team: se rechaza una reclamación que nombra una página visible en el sitio público.
El asistente integrado redacta una página solo cuando una persona la pide en la consola, y gasta los créditos de la organización.
Escribe una vez en Team. Organiza lo que se hace público.
Team
Cada página se escribe, se revisa y se aprueba aquí. Es el único lugar donde se edita el contenido de una página.
Public
Entradas que apuntan a páginas de Team, con las carpetas, el orden y los títulos públicos que elijas. El texto de una entrada refleja su página de Team, así que nada se desvía y nadie edita una copia.
Qué incluye cada plan
- El manual del equipo, con páginas escritas a mano o con el asistente
- Todos los planes
- Páginas que vencen cuando una especificación se marca como hecha, y solicitudes de cambio de agentes
- Starter y superiores
- Un sitio público para el manual
- Starter y superiores
El asistente gasta créditos en todos los planes.
Escribe la página mientras el trabajo está reciente
Conecta un repository, empieza el manual y ancla su primera página a una especificación.
Empieza gratis