Communitygithub.com

bbulman/arquitetura-de-informacao

Use quando alguém quiser organizar, reestruturar ou revisar como um site, aplicativo, conjunto de documentação, base de conhecimento ou biblioteca de conteúdo é agrupado e encontrado, abrangendo várias peças sem que esteja claro qual é necessária, mesmo que nunca mencionem 'arquitetura da informação' ou 'IA'. Não use para tarefas claramente delimitadas, como apenas um teste de árvore ou um mapa de redirecionamentos, nem para design visual.

O que é arquitetura-de-informacao?

Esta skill descreve a prática de Arquitetura da Informação (AI) — como estruturar, rotular e conectar conteúdo e funções de um sistema para que as pessoas encontrem o que precisam de forma rápida e intuitiva. Ela orienta o escopo do trabalho e estabelece regras que se aplicam a todo o processo, enquanto as tarefas específicas (inventário de conteúdo, card sorting, sitemaps, etc.) são delegadas a skills filhas. A skill é útil para desenvolvedores e agentes de IA que precisam reorganizar conteúdo existente, projetar novos sites ou seções, repensar menus ou navegação, criar taxonomias, melhorar a localização de informações ou preparar contextos para agentes de IA. Ela funciona em plataformas como codebases (lendo rotas, componentes de navegação, sitemap.xml, esquemas de CMS), pastas de conteúdo, bancos de dados ou CMS, e conjuntos de dados muito grandes (amostragem por tipo). A abordagem prioriza a estrutura baseada nas tarefas do usuário (não no organograma), dá a cada item um lar canônico, projeta para 10x o conteúdo atual e oferece múltiplas formas de acesso (navegação, busca, filtros, links relacionados). A skill também fornece orientações específicas para agentes de IA trabalharem nesse domínio, como propor múltiplas alternativas com prós e contras em vez de decidir unilateralmente, nunca inventar dados de pesquisa, e proteger o conteúdo antes de editá-lo. Para produtos de IA, ela sugere que uma estrutura clara e rótulos bem posicionados geralmente resolvem problemas de usabilidade de forma mais barata do que uma interface de chat aberta.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bbulman/information-architecture-skill/tree/HEAD/skills/information-architecture

Perguntar na sua IA favorita

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

Documentação

Arquitetura da informação

Arquitetura da informação é como o conteúdo e as funções de um sistema são agrupados, rotulados e conectados para que as pessoas encontrem o que precisam e entendam o que podem fazer. Cada decisão serve a um teste: essa estrutura ajuda a pessoa à sua frente a fazer uma boa escolha, rapidamente, sem precisar ser instruída?

Ela está a montante de tudo o mais. Uma estrutura errada sobrecarrega o conteúdo, que não tem um lar; o design, que precisa inventar navegação extra; a busca, onde as URLs mudam constantemente; e o CMS, que se torna um amontoado de gambiarras.

Esta skill delimita o escopo do trabalho e mantém as regras que se aplicam a ele. O trabalho em si está nas skills abaixo.

1. Escolha o trabalho

A maioria das solicitações precisa de parte do kit de ferramentas, não de tudo. Nomeie o que você vai produzir, para que a pessoa saiba o que está recebendo.

O trabalhoExecute estas, em ordem
Reorganizar conteúdo existentecontent-inventory, card-sort ou taxonomies, sitemaps, url-structure se os endereços mudarem, tree-tests, redirect-maps
Novo site, área de aplicativo ou seçãositemaps, navigation, url-structure, content-models
Repensar um menu, navegação ou alternador de aplicativosnavigation, labeling, tree-tests
Tags e categoriastaxonomies
Nomes que não estão funcionandolabeling
"As pessoas não encontram X"findability, em seguida, a skill para a qual o diagnóstico apontar
Migrar ou reconstruir um sitesitemaps, navigation, url-structure, content-models, redirect-maps
Verificar uma estrutura antes de construí-latree-tests
Um recurso ou produto de IASeção 5 aqui, depois findability

Um sitemap sozinho é decoração. Para a construção de um site, o conjunto completo é: sitemap, regras de URL, especificação de navegação, modelo de conteúdo e, para qualquer reconstrução, um mapa de redirecionamentos. Sem os outros quatro, ninguém consegue construir a partir dele.

Se uma skill irmã não estiver disponível, faça essa parte aqui usando as regras abaixo e informe isso.

2. Enquadre, depois mapeie o que existe

Antes de qualquer rota, defina quem usa isso e o que estão tentando fazer, quanto conteúdo existe agora e em dois anos, o que o negócio espera disso e como o sucesso será medido. Registre os números atuais dessas métricas antes que qualquer coisa mude, ou não haverá nada para comparar depois.

Em seguida, construa o panorama atual. Nunca redesenhe a partir apenas da página inicial.

  • Em um codebase: leia as rotas, componentes de navegação, sitemap.xml, o esquema do CMS e quaisquer tabelas de categoria ou tag. Conte itens por seção. Seções vazias e superlotadas são achados por si só.
  • Em uma pasta de conteúdo: examine todo o corpus, não um item de cada vez. Devolva o que é e a quem parece servir, e deixe a pessoa corrigi-lo antes de construir sobre uma leitura errada.
  • Conteúdo em um banco de dados ou CMS: exporte títulos, tipos, tags e datas primeiro.
  • Conjuntos muito grandes: examine por tipo e amostre dentro de cada tipo, e informe o que foi amostrado, para que ninguém confunda uma amostra com um censo.

Também pergunte pelo que só as pessoas sabem: os públicos e suas principais tarefas, para onde a organização está indo, análises, logs de busca do site e as perguntas que o suporte continua respondendo.

3. As regras que se aplicam a todo o trabalho

  • Estruture pelo que as pessoas estão tentando fazer, nunca pelo organograma. "Para desenvolvedores, APIs" é melhor que "Sobre nós, engenharia, APIs".
  • Dê a cada item um lar canônico. Ele pode ser linkado de outros lugares, mas vive em um único lugar.
  • Mantenha o rastro (scent) acima da contagem de cliques. As pessoas clicam mais quando cada passo cheira claramente ao seu objetivo. A regra dos três cliques é um mito. Becos sem saída e rótulos vagos são o custo real.
  • Projete para dez vezes o conteúdo. Se uma categoria vai crescer, projete para isso agora.
  • Ofereça várias formas de entrada. Navegação, busca, filtros, links relacionados, breadcrumbs.
  • Coloque pistas onde a decisão acontece. Uma boa pista responde a uma pergunta que a pessoa já tem, no momento em que ela escolhe, no lugar onde já está olhando, de forma silenciosa e barata.
  • Projete para o próximo contexto maior. Uma página está em uma seção, uma seção em um site, um site em um negócio.

4. Trabalhando como IA em AI

O que você faz bem: ler um corpus inteiro em minutos, propor esquemas alternativos, aplicar uma taxonomia consistentemente a milhares de itens, encontrar termos quase duplicados e identificar itens que não se encaixam em lugar nenhum.

O que você não pode fazer: executar um card sorting ou teste de árvore com pessoas reais, ou conhecer a estratégia e política da organização, a menos que lhe digam. Portanto:

  • Proponha, não decida. Dê dois ou três esquemas com suas vantagens e desvantagens, recomende um e explique por quê. Uma única resposta esconde a decisão.
  • Obtenha o público e a direção primeiro. Se não lhe disseram para quem é e para onde o produto está indo, pergunte ou declare sua suposição no início.
  • Coloque tudo o que foi solicitado para colocar. Um item sem encaixe recebe seu lar menos ruim e uma bandeira, e o caso para mover, mesclar ou aposentá-lo é uma recomendação separada.
  • Entregue todos os artefatos solicitados. Se você acha que um não deveria existir, entregue-o mesmo assim e argumente separadamente.
  • Nunca invente dados de pesquisa. Nenhum número de participantes, taxas de sucesso, volumes de tickets, citações ou frequências inventados. "Usado a cada hora" afirmado como fato conta. Diga "provavelmente" e liste como uma suposição.
  • Não adivinhe o comportamento da plataforma. O que um host ou CMS pode fazer varia. Diga o que você esperaria e peça para a pessoa confirmar.
  • Proteja o conteúdo. Antes de editar conteúdo, metadados, rotas ou redirecionamentos no lugar, certifique-se de que o trabalho está em controle de versão ou com backup.

5. AI para produtos de IA e para contexto de agentes

Antes de adicionar IA a um produto, procure o que realmente está atrapalhando. Se as pessoas não conseguem entender como o sistema funciona, não conseguem distinguir suas categorias ou precisam perguntar as mesmas coisas repetidamente, uma estrutura mais clara, um rótulo melhor ou uma pista bem posicionada geralmente resolvem isso de forma mais barata do que uma caixa de chat. Botões e menus fazem dois trabalhos: permitem que as pessoas ajam e mostram o que o sistema pode fazer. Um chat aberto faz o primeiro lentamente e o segundo nem um pouco. Use chat onde a tarefa é realmente aberta e, em outros lugares, use IA por trás de uma interface estruturada.

Contexto para agentes também é um problema de AI. Dê ao modelo a informação certa no momento certo: um arquivo de entrada curto que aponte para arquivos mais profundos, um lar canônico para cada fato, nomes consistentes e nada carregado que a tarefa não precise.

6. Quando o trabalho abrange várias skills

A menos que peçam outra coisa, entregue um documento com:

  1. Resumo: a recomendação em duas ou três frases e o principal motivo para ela.
  2. O que existe agora: a árvore atual e os problemas nela, com contagens.
  3. As opções: dois ou três esquemas, cada um com a quem serve, o que custa e onde tensiona.
  4. A proposta: a árvore recomendada com o tipo de template de cada nó, depois os rótulos e a especificação de navegação, e as regras de URL e modelo de conteúdo quando relevante.
  5. Migração: o mapeamento antigo-para-novo e notas de reetiquetagem, se algo se mover.
  6. Suposições e perguntas em aberto: tudo o que você presumiu.
  7. Como validar: tarefas de teste de árvore com suas respostas corretas e alvos, ou o card sorting a executar primeiro.

Dimensione para o trabalho. Comece com a recomendação, mantenha cada seção tão curta quanto possível, mas ainda utilizável, e empurre tabelas longas para o final. Um documento mais longo não é mais completo.

Verifique se está consistente antes de entregar. Recalcule totais em relação à tabela de posicionamento, verifique cada regra que você afirma contra as tabelas que escreveu, rastreie qualquer afirmação sobre comprimento de caminho através da árvore e certifique-se de que qualquer arquivo entregável implementa cada linha do plano de onde veio.

Para revisar uma arquitetura da informação, sua ou de outra pessoa, pontue-a com references/rubric.md.

7. Padrões para nomear quando você os vir

  • Navegação por organograma: seções nomeadas em homenagem a departamentos.
  • Duas taxonomias concorrentes: a barra lateral, os breadcrumbs e a URL dizem algo diferente.
  • Tudo sob um guarda-chuva: /servicos/<coisa> para cada seção, uma gaveta de tranqueiras com uma URL.
  • Seções de espaço reservado: páginas "Em breve" que são lançadas. Construa ou deixe de fora.
  • Uma caixa de chat no lugar da estrutura: uma interface de IA aberta onde opções claras responderiam à pergunta mais rápido e ensinariam as pessoas como o sistema funciona.

Individual skills in this repo

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

bbulman/findability

Use when people can't find something, when site search returns nothing or the wrong thing, when someone wants a search log analysed, best bets or synonyms set up, a no-results page designed or findability measured, or when a chatbot is proposed because "nobody can find anything". Not for redrawing the whole page tree, renaming a menu on its own, or running a tree test.

bbulman/labeling

Use when someone needs to name or rename a section, menu item, tab, category, feature or link, when labels feel vague or read like internal jargon, or when they ask "what should we call this", "is this label clear", "nobody knows what Resources means" or "people don't understand this menu". Not for deciding the structure behind the labels, building a tag vocabulary, or writing body copy and microcopy.

bbulman/navigation

Use when someone wants a navigation or menu designed, audited or cut down, including a main menu, nav bar, sidebar, app switcher, mega-menu, footer, breadcrumbs, tab bar or mobile menu, or says "there are too many items in the menu", "rethink the sidebar", "our nav is a mess" or "where should settings go". Not for deciding which pages exist, for wording a single label, for fixing site search, or for running a tree test.

bbulman/sitemaps

Use when someone needs the structure of a website, app or docs set decided, asking for a sitemap, site tree, page hierarchy or list of sections, or saying "what pages do we need", "how should we organise the site", "where should this page live" or "the site is too deep". This is where the structure gets decided. Not for writing the linked sitemap file that later design stages read once the structure is settled (design-os:create-sitemap), for generating sitemap.xml, or for designing the menus.

Habilidades Relacionadas