Communitygithub.com

cogni-work/insight-wave

Esta habilidad reanuda, continúa o verifica el estado de un proyecto cogni-website. Es el punto de reentrada principal para retomar el trabajo en el sitio web entre sesiones.

¿Qué es insight-wave?

Insight-Wave es una habilidad de IA especializada en la detección y reanudación de proyectos web cogni-website. Su función principal es identificar el estado actual del proyecto, mostrar el progreso y redirigir al siguiente paso apropiado, ya sea planificación, construcción, previsualización o configuración legal. Es compatible con agentes como Claude Code, Cursor y Codex, y responde a comandos como "continuar sitio web" o "reanudar proyecto". El flujo de trabajo incluye la detección automática del archivo `website-project.json`, la evaluación de la fase del proyecto (configuración, plan, construcción, previsualización o despliegue), el conteo de páginas planificadas versus construidas, y la detección de cambios en el contenido o nuevas fuentes externas. También ofrece recomendaciones dinámicas basadas en el estado legal y los marcadores TODO pendientes en archivos legales. Insight-Wave es útil para desarrolladores que trabajan en múltiples sesiones y necesitan retomar el trabajo sin perder contexto, ya que genera un resumen claro del proyecto y sugiere acciones concretas.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cogni-work/insight-wave/tree/HEAD/cogni-website/skills/website-resume

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Reanudar Sitio Web

Detecta el estado actual de un proyecto de sitio web, muestra el progreso y dirige al siguiente paso adecuado.

Flujo de Trabajo

1. Encontrar Proyecto de Sitio Web

Busca website-project.json en:

  • El directorio actual
  • Subdirectorios inmediatos que coincidan con cogni-website* o *-website

Si no se encuentra, informa al usuario y sugiere website-setup.

2. Evaluar el Estado del Proyecto

Lee los archivos disponibles y determina la fase del proyecto:

Archivo existenteFaseEstado
Solo website-project.jsonConfiguración completaNecesita plan
+ website-plan.jsonPlan completoNecesita construcción
+ output/website/index.htmlConstrucción completaListo para previsualización
+ output/website/css/style.css + páginasCompletamente construidoListo para despliegue

Cuenta:

  • Páginas planificadas (de website-plan.json)
  • Páginas construidas (archivos HTML en output/website/)
  • Páginas faltantes (planificadas pero no construidas)
  • Frescura de las fuentes de contenido (compara fechas de archivos fuente con fechas de construcción)

3. Presentar Estado

Website-Projekt: {slug}

  Fase:           {fase actual}
  Empresa:        {nombre de la empresa}
  Tema:           {nombre del tema}
  Idioma:         {idioma}

  Páginas planificadas: {N}
  Páginas construidas: {M} / {N}
  Páginas faltantes: {lista si las hay}

  Legal:
    Jurisdicción:    {jurisdicción o "aún no definida"}
    Páginas legales: {3/3 generadas | 0/3 faltantes | ⚠ falta legal_config}
    TODOs pendientes: {n marcadores «TODO: ...» sin completar}

  Última modificación: {fecha}

Al evaluar el estado legal, lee legal_config.jurisdiction de website-project.json, escanea website-plan.json en busca de entradas de página legal-*, y busca en content/legal/*.md cualquier marcador «TODO: .

4. Recomendar Próxima Acción

Según el estado:

EstadoRecomendación
Configuración completa, sin plan→ /website-plan — Planificar estructura de páginas
Plan completo, sin construcción→ /website-build — Generar sitio web
Construcción completa→ /website-preview — Revisar sitio web
Construcción desactualizada (fuentes más recientes que la construcción)→ /website-build — Actualizar sitio web (fuentes modificadas)
Construcción parcial (faltan algunas páginas)→ /website-build — Generar páginas faltantes

5. Detectar Cambios en el Contenido

Si el sitio ya está construido, verifica si el contenido fuente ha cambiado desde la última construcción:

  • Compara las fechas de modificación de los archivos fuente (de website-plan.json source_files) con los archivos HTML de salida
  • Marca las páginas cuyas fuentes son más recientes que el HTML construido
  • Ofrece reconstrucción parcial (solo páginas cambiadas) o reconstrucción completa

6. Detectar Cambios Externos

Vuelve a ejecutar la detección de contenido usando los mismos patrones de búsqueda que website-setup y compara con los conteos de content_discovery almacenados en website-project.json:

  • Nuevas entidades: p. ej., se añadió un nuevo producto al portafolio, o se publicaron nuevos artículos de marketing → sugerir re-planificación para incluirlos
  • Entidades eliminadas: los archivos fuente referenciados en el plan ya no existen → advertir sobre un plan obsoleto
  • Nuevos complementos externos: busca **/tips-project.json y **/output/draft-v*.md que no estaban presentes cuando se creó el proyecto (es decir, sources.trends_project o sources.research_projects es nulo/vacío pero ahora existen proyectos) → sugerir re-ejecutar setup para descubrir nuevas fuentes de contenido

Presenta los cambios:

Cambios desde la última construcción:

  Nuevo contenido:
    ✚ 2 nuevos artículos de marketing
    ✚ 1 nuevo producto en el portafolio

  Nuevas fuentes de contenido disponibles:
    ✚ Informe de tendencias encontrado (anteriormente no incluido)

  Recomendación: /website-setup ejecutar de nuevo para incluir nuevas fuentes

Añade a la tabla de recomendaciones:

EstadoRecomendación
Se descubrieron nuevas fuentes de contenido→ /website-setup — Incluir nuevas fuentes, luego planificar de nuevo
Nuevas entidades en fuentes existentes→ /website-plan — Actualizar estructura de páginas
legal_config.jurisdiction definido pero sin páginas legal-* en el plan→ /website-legal — Generar páginas obligatorias
legal_config.jurisdiction es null→ /website-legal — Definir jurisdicción y generar páginas obligatorias
Marcadores «TODO: ...» sin completar en content/legal/*.md→ /website-legal — Completar campos faltantes

Skills relacionados