Cómo trabaja Urekz. Un colectivo AI-native que construye productos, comparte lo que aprende y crea comunidad alrededor de la IA aplicada.
La documentación que cambia con la implementación (ADR, arquitectura, runbooks) se desactualiza si vive lejos del código. Un agente solo ve el repositorio en el que trabaja.
Los ADR, la arquitectura, los runbooks técnicos y el brief enlazado de cada producto viven en su repositorio, en docs/. Este handbook enlaza al código; no lo describe. Plane guarda el brief canónico de una página; el repositorio guarda una copia enlazada y todo lo técnico.
Documentación técnica en Notion o en Plane Pages: se desactualiza y es invisible para los agentes que trabajan en el repositorio.
Cada repositorio de producto tiene el esqueleto docs/product-brief.md, docs/adr/ y CHANGELOG.md. Quien cambia el código cambia la documentación en el mismo PR.
Esqueleto de repositorios; Decisiones técnicas (ADR).
Que un repositorio activo necesite otra frontera para su documentación.