Communitygithub.com

coastdigitalgroup/coastai-skills

Projetar e implementar um framework sistemático para eventos cronológicos e logs de atividade, gerenciando ritmo espacial, agrupamento de eventos e visualização de status.

O que é coastai-skills?

O Timeline Activity System (Sistema de Atividades em Linha do Tempo) fornece uma metodologia para projetar sequências cronológicas de eventos, logs de histórico ou roadmaps. Ele garante que os usuários possam acompanhar o progresso, entender relações temporais e digitalizar dados históricos de forma eficiente. Este sistema equilibra densidade de informação com ritmo espacial, assegurando que a narrativa de "quando" e "o que" seja clara em todas as viewports. Ele suporta uma ampla gama de casos de uso, incluindo feeds de atividade para painéis SaaS, roadmaps de produtos, marcos de empresa, histórico de pedidos e visualizações de processos de múltiplos estágios. O sistema define entradas como inventário de eventos, resolução temporal, tipos de eventos, restrições espaciais e tokens de marca, e produz especificações de anatomia de linha do tempo, estratégias de agrupamento, matriz de estados e plantas responsivas. Ele descreve um fluxo de trabalho que cobre a definição do fio temporal e orientação (vertical ou horizontal), design de nós e marcadores, aplicação de ritmo espacial e agrupamento, organização do bloco de conteúdo e adaptação responsiva. Regras de decisão incluem a regra do "fio", limites de agrupamento, hierarquia de nós e posicionamento de carimbos de data/hora. O sistema impõe restrições de acessibilidade, responsividade e contraste visual, e identifica padrões comuns de falha, como fios quebrados, sobrecarga de informações e alinhamento inconsistente. Os critérios de validação garantem ordem cronológica clara, estilo consistente, agrupamento temporal, comportamento responsivo e marcação semântica acessível.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/timeline-activity-system

Perguntar na sua IA favorita

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

Documentação

Sistema de Atividades em Linha do Tempo

Propósito

O Sistema de Atividades em Linha do Tempo fornece uma metodologia para projetar sequências cronológicas de eventos, logs de histórico ou roadmaps. Ele garante que os usuários possam acompanhar o progresso, entender relações temporais e digitalizar dados históricos de forma eficiente. Este sistema equilibra densidade de informação com ritmo espacial, garantindo que a narrativa de "quando" e "o que" seja clara em todas as viewports.

Casos de Uso

  • Projetar feeds de atividade para painéis SaaS (ex.: histórico de projetos).
  • Estruturar roadmaps de produtos ou notas de versão.
  • Organizar histórico empresarial ou marcos "Sobre Nós".
  • Implementar rastreamento de pedidos ou histórico de envios para e-commerce.
  • Gerenciar visualizações de processos de múltiplos estágios (ex.: status de inscrição).

Quando NÃO Usar

  • Progresso Linear de Etapas: Para uma sequência simples de etapas que o usuário deve concluir em tempo real, use step-progress-system.
  • Dados Puramente Tabulares: Se o objetivo principal for classificar e filtrar por muitas colunas (ex.: um log de auditoria financeira completo), use data-table-ui-system.
  • Navegação Global: Para estrutura em todo o site, use site-navigation-system.
  • Feeds de Blog Simples: Onde cartões padrão em uma grade ou lista são suficientes sem um "fio" visual ou marcadores temporais.

Entradas

  1. Inventário de Eventos: A lista de eventos, carimbos de data/hora e metadados associados.
  2. Resolução Temporal: O usuário se importa com segundos, dias ou anos?
  3. Tipos de Eventos: Categorização de eventos (ex.: Informação, Sucesso, Aviso, Erro, ou Marco vs. Ação Menor).
  4. Restrições Espaciais: A linha do tempo ficará em uma barra lateral, uma visualização de página inteira ou um cartão estreito?
  5. Tokens de Marca: Cores, escalas tipográficas e tokens de espaçamento.

Saídas

  1. Especificação de Anatomia da Linha do Tempo: Definição do "Fio" (a linha vertical/horizontal), "Nós" (os marcadores) e "Blocos de Conteúdo".
  2. Estratégia de Agrupamento: Regras para agrupar eventos (ex.: "Hoje", "Ontem", "Outubro de 2023").
  3. Matriz de Estado e Status: Tratamentos visuais para diferentes tipos de evento e estados interativos.
  4. Planta Responsiva: Como a linha do tempo se adapta de uma disposição centrada ou alternada para uma visualização de coluna única em dispositivos móveis.

Fluxo de Trabalho

1. Definir o Fio Temporal e Orientação

Determinar a direção do tempo:

  • Vertical (Padrão): Melhor para comprimentos de conteúdo variáveis e históricos longos.
  • Horizontal: Melhor para roadmaps de alto nível ou processos curtos onde o espaço horizontal é abundante.

Estabelecer o "Fio" (a linha que conecta eventos) e garantir que ele tenha peso visual e cor consistentes (geralmente um tom neutro suave).

2. Estabelecer Nós de Evento e Marcadores

Projetar as âncoras visuais para cada evento:

  • Nós Simples: Pequenos pontos ou círculos para ações menores.
  • Nós Icônicos: Ícones dentro de círculos para indicar tipos de evento (ex.: uma marca de seleção para "Concluído").
  • Marcadores de Data: Rótulos que flutuam ao lado ou acima dos nós.

3. Aplicar Ritmo Espacial e Agrupamento

Evitar poluição visual agrupando eventos por períodos de tempo:

  • Agrupamento Relativo: "Agora mesmo", "Há 2 horas".
  • Agrupamento Absoluto: "Segunda-feira, 23 de Outubro", "Setembro de 2023".

Use o fluid-spacing-system para manter lacunas verticais consistentes entre eventos. Marcos de alta prioridade devem ter mais espaço em branco do que itens de atividade menores.

4. Organizar o Bloco de Conteúdo

Aplicar o visual-hierarchy-system ao conteúdo adjacente a cada nó:

  • Título: A ação central ou nome do evento.
  • Metadados: Carimbo de data/hora, ator (avatar/nome do usuário) e categoria.
  • Corpo/Descrição: Detalhes opcionais ou conteúdo expandido.
  • Ações: Botões contextuais (ex.: "Ver Detalhes", "Desfazer").

5. Planejar Adaptação Responsiva

  • Disposição Alternada (Padrão Z): No desktop, os eventos alternam à esquerda e à direita do fio. No celular, colapsa para uma coluna única (Fio à esquerda, Conteúdo à direita).
  • Disposição de Um Lado: Padronizar para "Fio-à-Esquerda, Conteúdo-à-Direita" no celular para maximizar a legibilidade.

Regras de Decisão

  • A Regra do "Fio": A linha nunca deve ser quebrada, a menos que haja uma lacuna lógica no tempo ou uma ação "Carregar Mais".
  • Limite de Agrupamento: Se mais de 5 eventos ocorrerem no mesmo dia, agrupe-os sob um único cabeçalho de data para reduzir texto redundante.
  • A Hierarquia de "Nós": Use nós maiores ou cores da marca para "Marcos" e nós menores e neutros para "Atividades".
  • Posição do Carimbo de Data/Hora: Para linhas do tempo verticais, coloque carimbos de data/hora à esquerda do fio (desktop) ou imediatamente abaixo do título (celular) para a digitalização mais rápida.

Restrições

  • Acessibilidade: Linhas do tempo devem ser navegáveis como uma lista (<ul> ou <ol>). Nós contendo ícones devem ter aria-label ou texto oculto para leitores de tela. Envolva carimbos de data/hora em um elemento <time datetime="..."> para que rótulos relativos ("Há 2 horas") permaneçam legíveis por máquina. Para feeds de atividade com atualização em tempo real, adicione novas entradas dentro de uma região aria-live="polite" (não a lista inteira) para que usuários de leitor de tela ouçam novos eventos sem perder seu lugar.
  • Responsividade: Linhas do tempo nunca devem transbordar a viewport. Linhas do tempo horizontais devem mudar para verticais ou usar uma rolagem horizontal no celular.
  • Contraste Visual: O fio e os nós devem atender a uma taxa de contraste de 3:1 em relação ao fundo.

Padrões Comuns de Falha

  • Fios Quebrados: A linha vertical começa e termina arbitrariamente, dificultando o acompanhamento da sequência.
  • Sobrecarga de Informação: Incluir muito texto do corpo em cada evento, transformando a linha do tempo em uma parede de texto.
  • Alinhamento Inconsistente: Misturar texto centralizado e alinhado à esquerda dentro da mesma linha do tempo sem uma lógica clara.
  • Aglomeração em Celular: Tentar manter uma disposição alternada (esquerda/direita) no celular, deixando colunas minúsculas para texto.

Critérios de Validação

  • Os eventos seguem uma ordem cronológica clara e consistente (Ascendente ou Descendente).
  • Os marcadores visuais (nós) e o fio de conexão são estilizados de forma consistente.
  • O agrupamento temporal (ex.: "Hoje") é usado para reduzir a carga cognitiva.
  • O comportamento responsivo (ex.: colapsar para uma coluna única) é definido e funcional.
  • Acessibilidade: A linha do tempo é marcada como uma lista semântica e os carimbos de data/hora usam <time datetime="...">.
  • Feeds em tempo real anunciam novas entradas através de uma região aria-live="polite" com escopo definido, sem interromper o foco do leitor de tela.
  • Marcos primários são visualmente distintos da atividade secundária.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Habilidades Relacionadas