# ADR-009 — Desacoplamiento de la Suite Documental en Portal Web Independiente * **Estado:** Aceptada * **Fecha / Hito:** 2026-09-30 (Resolución integral de la Fase 5 de TickTick) --- ## Contexto Conforme el ecosistema creció en robustez técnica (ADRs, topología de 4 repositorios, sombreado, firmas GPG, Docker y cron de cadencia), la dispersión de notas en archivos markdown sueltos dentro de `scratchpad` y múltiples repositorios generó una severa sobrecarga cognitiva que dificultaba la comprensión global del proyecto. La propuesta preliminar de portar la documentación dentro del repositorio del código fuente (`robert-flo/omarchy/docs/personal/`) introducía el grave riesgo de ensuciar el árbol de trabajo y provocar conflictos innecesarios durante los rebases cotidianos de upstream. --- ## Decisión 1. **Repositorio y Portal Web Independiente:** Se crea el repositorio público `robert-flo/fork-docs`, servido en GitHub Pages mediante `jekyll-vitepress-theme`. 2. **Estándar de Oro Canónico:** `fork-docs` se establece como la **única fuente de la verdad** técnica y operativa para desarrolladores humanos y agentes de inteligencia artificial. 3. **Consolidación Total:** Se absorben y sintetizan todos los ADRs (001 al 009), la Matriz de Decisión, la topología, los runbooks y el historial de cambios en una jerarquía clara y navegable. 4. **Archivo de Scratchpad:** El repositorio histórico `robert-flo-scratchpad` queda marcado como archivado y de solo lectura. --- ## Consecuencias * **Cero Fricción con Upstream:** El repositorio de código fuente permanece limpio y libre de documentación accesoria que complique los rebases. * **Experiencia de Usuario Superior:** Navegación instantánea con Turbo Frames, alternador de modo oscuro/claro, búsqueda integrada y diagramas Mermaid interactivos.

ADR-009 — Desacoplamiento de la Suite Documental en Portal Web Independiente

• Estado: Aceptada
• Fecha / Hito: 2026-09-30 (Resolución integral de la Fase 5 de TickTick)

---

Contexto

Conforme el ecosistema creció en robustez técnica (ADRs, topología de 4 repositorios, sombreado, firmas GPG, Docker y cron de cadencia), la dispersión de notas en archivos markdown sueltos dentro de scratchpad y múltiples repositorios generó una severa sobrecarga cognitiva que dificultaba la comprensión global del proyecto.

La propuesta preliminar de portar la documentación dentro del repositorio del código fuente (robert-flo/omarchy/docs/personal/) introducía el grave riesgo de ensuciar el árbol de trabajo y provocar conflictos innecesarios durante los rebases cotidianos de upstream.

---

Decisión

1. Repositorio y Portal Web Independiente: Se crea el repositorio público robert-flo/fork-docs, servido en GitHub Pages mediante jekyll-vitepress-theme.
2. Estándar de Oro Canónico: fork-docs se establece como la única fuente de la verdad técnica y operativa para desarrolladores humanos y agentes de inteligencia artificial.
3. Consolidación Total: Se absorben y sintetizan todos los ADRs (001 al 009), la Matriz de Decisión, la topología, los runbooks y el historial de cambios en una jerarquía clara y navegable.
4. Archivo de Scratchpad: El repositorio histórico robert-flo-scratchpad queda marcado como archivado y de solo lectura.

---

Consecuencias

• Cero Fricción con Upstream: El repositorio de código fuente permanece limpio y libre de documentación accesoria que complique los rebases.
• Experiencia de Usuario Superior: Navegación instantánea con Turbo Frames, alternador de modo oscuro/claro, búsqueda integrada y diagramas Mermaid interactivos.