CreaRack-SL

Apartado Guías del Workspace: documentos de lectura del equipo y aviso de bienvenida

Funcionalidadactivecreado Thu Sep 24#workspace#guias#onboarding#documentacion#ux#redaccion

Apartado Guías del Workspace

Qué es y para qué sirve

Guías (/guias) es un apartado propio del Workspace, en el grupo principal del menú justo debajo del Dashboard, reservado exclusivamente para documentos de lectura escritos para personas: la bienvenida al proyecto, la guía de trabajo diario de cada persona del equipo, el método de trabajo y las versiones pensadas para enseñar fuera (clientes, proveedores, colaboradores). Los estudios, análisis y deliberaciones NO van aquí: siguen en /informes.

Nació el 24-09-2026 (decisión de Edu) al rehacer las presentaciones de Txell y Dani como documentos al estilo de la Guía de bienvenida: hacía falta un sitio fijo donde encontrarlos y un aviso que indicara a quien llega que empiece por ahí.

Cómo está hecho

  • Cada guía es un HTML autocontenido en public/guias/<slug>/index.html, con sus imágenes en la misma carpeta, servido estático por CF Pages en /guias/<slug>/.
  • public/guias/index.json es el manifest curado. Campos por guía: slug, grupo (empieza · diario · metodo · fuera), titulo, resumen, para, terceros (admite versión para terceros), revisada (fecha ISO) y ruta.
  • src/pages/guias.astro lista las guías por grupo. Como en Informes, en build escanea public/guias/: una carpeta con index.html sin entrada en el manifest aparece igualmente en «Sin clasificar», marcada «sin registrar».
  • Entrada «Guías» en Sidebar.tsx (icono book) y en el grupo Tareas de BottomNav.tsx (móvil).

Aviso de bienvenida

En el Dashboard (src/pages/index.astro) aparece un recuadro fijo abajo a la derecha: «Si acabas de llegar, empieza por las Guías», con los botones «Cerrar» e «Ir a las Guías» y la casilla «No volver a mostrar». La casilla se recuerda en el navegador (localStorage, clave ws-aviso-guias-oculto), así que en otro ordenador o navegador el aviso vuelve a salir una vez. Cerrar sin marcar la casilla solo lo oculta hasta la siguiente visita.

Cómo añadir una guía

  1. Partir de la plantilla del método claude-method/templates/GUIA.html.template y de las normas de redacción (global-rules/redaccion.md, puntos 7 y 8: sencillo no es corto, contexto antes que afirmación).
  2. Guardar el documento como public/guias/<slug>/index.html, con sus capturas al lado.
  3. Añadir su entrada en public/guias/index.json, eligiendo grupo y marcando terceros si admite versión para fuera.
  4. PR normal del Workspace.

Las versiones para terceros no se enseñan desde el Workspace, que solo admite al equipo: se prepara una copia sin datos internos y se entrega como PDF o enlace privado.

Estado al crearse (24-09-2026)

Tres guías: bienvenida (grupo «Empieza aquí», admite versión para terceros), Txell y Dani (grupo «Tu trabajo diario»). Los grupos «Cómo trabajamos» y «Para enseñar fuera» estaban vacíos. En el mismo cambio se retiró de Informes la presentación del método del 21-09-2026, sustituida por estas guías.

Ampliación del grupo «Cómo trabajamos» (24-09-2026 tarde, PR#186)

El grupo que había quedado vacío se llena con tres guías nuevas:

  • metodo — «Cómo trabajamos con Claude en Esferic Labs»: el método completo en 11 apartados.
  • metodo-ejemplo-decision — un caso real (la decisión de la pasarela de pago, agosto de 2026) contado de principio a fin, como ejemplo del apartado 7 del método.
  • metodo-pruebas-apertura — por qué hoy se prueba en producción, la propuesta de un paso intermedio de pruebas y la capacidad medida del servidor de pruebas, complementando el apartado 6 del método.

Las seis guías publicadas hasta ahora (bienvenida, txell, dani y estas tres) ganan además un apartado final común, «¿Algo no cuadra?», que enlaza a la tarea #341 del Gestor para reportar discrepancias entre lo escrito y la realidad — es contenido repetido en cada HTML, sin lógica de código nueva.

El grupo «Para enseñar fuera» sigue vacío. El mismo cambio publicó, aparte, un informe de tipo storm sobre protocolos de seguridad internos para un equipo de tres (/informes/storm/protocolo-seguridad-interno-2026-09-24.html) — no forma parte de Guías, vive en Informes.

Véase también

  • [[feature—workspace—informes-deliberaciones]]
  • [[entity—workspace—shell]]