Communitygithub.com

cogni-work/insight-wave

Esta habilidade resume, continua ou verifica o status de um projeto cogni-website. É o ponto de reentrada principal para retornar ao trabalho no site entre sessões.

O que é insight-wave?

Esta habilidade, chamada 'Website Resume', atua como o ponto de partida inteligente para qualquer sessão de trabalho em projetos de site da Cogni. Quando um usuário menciona frases como 'continuar site', 'status do site' ou 'onde eu parei', ela automaticamente detecta o estado atual do projeto, exibe um resumo claro do progresso e recomenda a próxima ação mais adequada. Suportada nos agentes Claude Code, Cursor e Codex, ela escaneia o sistema de arquivos em busca do arquivo `website-project.json`, avalia o progresso identificando arquivos de plano (`website-plan.json`), builds (HTML/CSS) e a integridade de conteúdos legais. Além de apresentar um status detalhado com métricas de páginas planejadas vs. construídas e frescor do conteúdo, a habilidade detecta automaticamente alterações em fontes de conteúdo — como novos artigos de marketing ou produtos — e fontes upstream não incorporadas, sugerindo re-extração ou re-planejamento. Dessa forma, garante que nenhum trabalho seja perdido entre sessões e que o desenvolvedor sempre saiba exatamente o próximo passo.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Resume do Site

Detecta o estado atual de um projeto de site, mostra o progresso e direciona para a próxima habilidade apropriada.

Fluxo de Trabalho

1. Encontrar o Projeto do Site

Procure por website-project.json em:

  • Diretório atual
  • Subdiretórios imediatos que correspondam a cogni-website* ou *-website

Se não for encontrado, informe o usuário e sugira website-setup.

2. Avaliar o Estado do Projeto

Leia os arquivos disponíveis e determine a fase do projeto:

Arquivo ExisteFaseStatus
website-project.json apenasConfiguração completaPrecisa de plano
+ website-plan.jsonPlano completoPrecisa de build
+ output/website/index.htmlBuild completoPronto para pré-visualização
+ output/website/css/style.css + páginasTotalmente construídoPronto para deploy

Conte:

  • Páginas planejadas (a partir de website-plan.json)
  • Páginas construídas (arquivos HTML em output/website/)
  • Páginas faltantes (planejadas mas não construídas)
  • Frescor da fonte de conteúdo (compare datas dos arquivos fonte com datas do build)

3. Apresentar Status

Projeto Web: {slug}

  Fase:           {fase atual}
  Empresa:        {nome da empresa}
  Tema:           {nome do tema}
  Idioma:         {idioma}

  Páginas Planejadas: {N}
  Páginas Construídas: {M} / {N}
  Páginas Faltantes: {lista se houver}

  Legal:
    Jurisdição:    {jurisdição ou "ainda não definida"}
    Páginas Legais:{3/3 geradas | 0/3 faltando | ⚠ legal_config ausente}
    TODOs Abertos: {n marcadores «TODO: ...» não preenchidos}

  Última Alteração: {data}

Ao avaliar o estado legal, leia legal_config.jurisdiction de website-project.json, verifique website-plan.json por entradas de página legal-* e pesquise em content/legal/*.md por quaisquer marcadores «TODO: .

4. Recomendar Próxima Ação

Baseado no estado:

EstadoRecomendação
Configuração completa, sem plano→ /website-plan — Planejar estrutura de páginas
Plano completo, sem build→ /website-build — Gerar site
Build completo→ /website-preview — Verificar site
Build desatualizado (fontes mais recentes que o build)→ /website-build — Atualizar site (fontes alteradas)
Parcialmente construído (algumas páginas faltando)→ /website-build — Gerar páginas faltantes

5. Detectar Alterações de Conteúdo

Se o site já estiver construído, verifique se o conteúdo fonte mudou desde o último build:

  • Compare as datas de modificação dos arquivos fonte (de website-plan.json source_files) vs. arquivos HTML de saída
  • Sinalize páginas onde as fontes são mais recentes que o HTML construído
  • Ofereça reconstrução parcial (apenas páginas alteradas) ou reconstrução completa

6. Detectar Alterações Upstream

Reexecute a descoberta de conteúdo usando os mesmos globs do website-setup e compare com as contagens de content_discovery armazenadas em website-project.json:

  • Novas entidades: por exemplo, um novo produto foi adicionado ao portfólio, ou novos artigos de marketing publicados → sugira replanejar para incluí-los
  • Entidades removidas: arquivos fonte referenciados no plano não existem mais → avise sobre plano obsoleto
  • Novos plugins upstream: pesquise por **/tips-project.json e **/output/draft-v*.md que não estavam presentes quando o projeto foi criado (ou seja, sources.trends_project ou sources.research_projects é nulo/vazio mas projetos agora existem) → sugira reexecutar o setup para descobrir novas fontes de conteúdo

Apresente as alterações:

Alterações desde o último build:

  Novos Conteúdos:
    ✚ 2 novos artigos de marketing
    ✚ 1 novo produto no portfólio

  Novas Fontes de Conteúdo Disponíveis:
    ✚ Relatório de tendências encontrado (anteriormente não incorporado)

  Recomendação: Execute /website-setup novamente para incorporar novas fontes

Adicione à tabela de recomendações:

EstadoRecomendação
Novas fontes de conteúdo descobertas→ /website-setup — Incorporar novas fontes, depois replanejar
Novas entidades em fontes existentes→ /website-plan — Atualizar estrutura de páginas
legal_config.jurisdiction definido mas sem páginas legal-* no plano→ /website-legal — Criar páginas obrigatórias
legal_config.jurisdiction é null→ /website-legal — Definir jurisdição e criar páginas obrigatórias
Marcadores «TODO: ...» não preenchidos em content/legal/*.md→ /website-legal — Preencher campos faltantes

Habilidades Relacionadas