Blog

Tu segundo cerebro no debería necesitar que lo escribas


Cada wiki y base de conocimientos requiere que un ser humano la escriba y la mantenga. ¿Y si se escribiera sola? La documentación que se escribe sola y se actualiza a partir de tu trabajo real es lo más radical que hemos desarrollado.



La historia de la gestión del conocimiento es una historia de proyectos de redacción manual que fracasan. La wiki que alguien pasó una semana completando y nadie mantuvo después del primer mes. El sprint de documentación que produjo cincuenta páginas, cuarenta y siete de las cuales quedaron desactualizadas en un trimestre. La base de conocimientos que el equipo estaba "demasiado ocupado para actualizar", que es otra forma de decir que el coste de mantenimiento superaba el beneficio percibido.

Cada uno de estos sistemas fracasó por la misma razón: requerían que los seres humanos escribieran y mantuvieran la documentación como una tarea separada del trabajo que la documentación describía. El trabajo ocurre en Slack, en reuniones, en revisiones de código, en correos electrónicos. La documentación sobre el trabajo debe escribirse por separado, por alguien que deja de hacer el trabajo para describirlo. La documentación siempre va un paso por detrás de la realidad porque está escrita por humanos con otras prioridades.

La pregunta no es "¿cómo logramos que la gente escriba mejor documentación?". Es "¿y si la documentación se escribiera sola a partir del trabajo que ya se está realizando?"


Qué significa realmente la documentación autoescrita

Los documentos autoescritos generan documentación estructurada, citada y editable a partir de la actividad en tus herramientas conectadas. La documentación no es un resumen ni una transcripción. Es conocimiento estructurado extraído de la actividad bruta y mantenido a medida que esa actividad evoluciona.

De Slack: el hilo donde tu equipo debatió si usar microservicios o un monolito se convierte en un registro de decisiones con la pregunta, las opciones consideradas, el razonamiento y la conclusión. Tú no escribes el registro de decisiones. Se escribe solo a partir de la discusión.

De reuniones: la reunión de planificación del sprint se convierte en un documento de estado del proyecto con decisiones, puntos de acción y contexto. La llamada del cliente se convierte en notas de la cuenta con comentarios, solicitudes y compromisos. Tú no escribes las notas de la reunión. El sistema transcribe, extrae y estructura.

De GitHub: las solicitudes de incorporación de cambios (PR), los comentarios de revisión de código y las discusiones sobre problemas se convierten en documentación de ingeniería que describe cómo funcionan los sistemas y por qué se construyeron de esa manera. La documentación se actualiza a medida que cambia el código porque se deriva de la actividad del código.

De actividad de ventas: las llamadas de clientes, las notas de CRM y las discusiones sobre acuerdos se convierten en perfiles de inteligencia competitiva, historiales de cuentas y documentación de procesos que se mantienen actualizados a medida que continúa la actividad del equipo.

Cada afirmación en la documentación cita su fuente: el mensaje específico de Slack, la marca de tiempo de la reunión, la descripción de la PR. La documentación no es ficción generada por IA. Es una extracción estructurada de actividad real, verificable a través de citas. Los ingenieros que han aprendido a desconfiar de las wikis obsoletas pueden verificar cualquier afirmación haciendo clic en la fuente.


Por qué esto cambia la ecuación del segundo cerebro

El segundo cerebro tradicional te pide hacer dos trabajos: el trabajo en sí y la documentación del trabajo. La mayoría de la gente hace lo primero y se salta lo segundo porque lo primero es por lo que se les evalúa y lo segundo es una carga de trabajo adicional.

Un segundo cerebro autoescrito elimina el segundo trabajo. Tú haces el trabajo (discutir en Slack, asistir a reuniones, revisar código, enviar correos a clientes). La documentación ocurre como un subproducto. El segundo cerebro se alimenta de tu actividad en lugar de requerir que tú lo alimentes.

Esto cambia la economía de la gestión del conocimiento de "dedicar tiempo a crear documentación" a "la documentación es un subproducto gratuito del trabajo que ya estás haciendo". La inversión de tiempo se reduce a cero. La captura de conocimiento pasa a ser exhaustiva. El mantenimiento se reduce a revisiones periódicas en lugar de una escritura continua.

Para las personas, esto significa un segundo cerebro que no muere en un mes porque nunca dependió de tu disciplina para llenarlo. Para los equipos, esto significa un cerebro de la empresa que se mantiene actualizado porque la documentación realiza un seguimiento de la actividad del equipo en tiempo real. Para las organizaciones, esto significa un almacén de contexto que acumula conocimiento institucional como un subproducto de las operaciones diarias.


Qué sigues escribiendo tú

Los documentos autoescritos se encargan del conocimiento operativo: decisiones, procesos, documentación del sistema, resultados de reuniones, estado del proyecto. Lo que no reemplazan:

Pensamiento estratégico. Tu análisis de por qué el mercado se mueve en una dirección particular. Tu tesis sobre qué debería hacer la empresa a continuación. El pensamiento original requiere un autor humano.

Trabajo creativo. El artículo del blog, la narrativa de la presentación, la justificación del diseño. El resultado creativo se redacta, no se extrae.

Reflexión personal. Tus notas sobre lo que aprendiste, lo que piensas, cómo quieres abordar algo. El editor de notas y documentos es donde haces esta escritura, junto con la documentación autoescrita que maneja el contexto operativo.

El sistema autoescrito se encarga de la documentación que nadie quiere escribir y que todos quieren que exista. Tú escribes las cosas que solo tú puedes escribir. El sistema escribe todo lo demás.


Preguntas frecuentes

¿En qué se diferencia esto de las herramientas de notas de reuniones con IA? Las notas de reuniones con IA (como Otter o Fireflies) transcriben y resumen reuniones. Los documentos autoescritos capturan las reuniones junto con las discusiones de Slack, la actividad de GitHub y el correo electrónico, y lo sintetizan todo de manera estructurada a través de todas las fuentes. Las notas de la reunión son una entrada. La wiki autoescrita es el resultado integral.

¿Puedo editar la documentación autoescrita? Sí. La documentación es totalmente editable. La IA genera la versión inicial y la mantiene. Tú la refinas, corriges o amplías según sea necesario. La combinación de generación por IA y revisión humana produce una documentación que es tanto exhaustiva como precisa.

¿Cómo sé si la IA capturó las cosas con precisión? Cada afirmación cita su fuente. Haz clic en la cita para ver el mensaje original de Slack, la marca de tiempo de la reunión o la descripción de la PR. Si la IA interpretó algo mal, la fuente está ahí mismo para su verificación y corrección.

¿Funciona esto para equipos no técnicos? Sí. Los documentos autoescritos se generan a partir de cualquier fuente conectada: canales de ventas, discusiones de productos, reuniones con clientes y actividad general de Slack. La documentación de ingeniería de GitHub es solo una aplicación. El sistema funciona para cualquier equipo cuyo trabajo implique discusión y comunicación.

¿Qué pasa si discutimos temas confidenciales en Slack que no deberían documentarse? Tú controlas qué canales y fuentes alimentan el sistema autoescrito. Puedes excluir canales confidenciales. La documentación solo se genera a partir de las fuentes que hayas conectado y autorizado.

¿Cómo se compara esto con Notion o Confluence? Notion y Confluence requieren escritura y mantenimiento manuales. Los documentos autoescritos generan y mantienen la documentación automáticamente. El patrón de fracaso de las wikis manuales (contenido obsoleto, abandono del mantenimiento) no se aplica aquí porque el sistema se encarga del mantenimiento.

¿Con qué rapidez se acumula la documentación? Durante la primera semana de conectar las fuentes, el sistema genera documentación a partir de la actividad actual. En un mes, hay suficiente documentación acumulada para responder a la mayoría de las preguntas sobre decisiones y procesos recientes. La documentación continúa creciendo y refinándose a medida que continúa la actividad.

¿Cómo se ve en realidad la documentación "citada"? Cada declaración en la documentación incluye un pequeño enlace de cita. Al hacer clic en él, te lleva a la fuente: el mensaje exacto de Slack, la marca de tiempo específica de la reunión o la descripción particular de la PR de la que se derivó la declaración. Las citas proporcionan una verificabilidad de la que suele carecer la documentación escrita manualmente.

¿Se puede compartir la documentación externamente? Sí. La documentación se puede publicar como una página para compartir, con protección por contraseña si es necesario. La documentación para clientes, las guías de incorporación y la documentación de procesos se pueden compartir con partes interesadas externas.



Lecturas relacionadas: Explicación de los documentos autoescritos, Por qué fallan la mayoría de los segundos cerebros, Nadie lee la wiki, Tu segundo cerebro debería pensar. Páginas relacionadas: Documentos autoescritos, Fabric frente a Notion, Fabric frente a Confluence.

The workspace that thinks with you.

Ready when you are.

The workspace that thinks with you.

Ready when you are.

The workspace that thinks with you.

Ready when you are.