---
name: information-architecture
description: Definir arquitetura da informação para produto, site, app, dashboard, CLI/TUI ou documentação. Use antes de design visual ou tasks quando houver navegação, hierarquia de conteúdo, rotas, fluxos, URL patterns, estados de entrada, busca, filtros ou crescimento de conteúdo.
---

# Information Architecture SDD

## Objetivo

Definir a estrutura que sustenta a experiência: o que existe, onde vive, como o usuário encontra, como cresce e quais nomes aparecem na interface.

## Procedimento

1. Leia brief, PRD, Project Discovery e rotas/componentes existentes.
2. Inspecione estrutura real:
   - Frontend: `app/`, `pages/`, `routes/`, router config, layouts, nav, sidebar, tabs, breadcrumbs.
   - Conteúdo: CMS, MDX, docs, modelos, filtros, busca, paginação.
   - CLI/TUI: comandos, subcomandos, flags, prompts, estados e atalhos.
3. Preserve padrões existentes quando funcionam; proponha mudança só com motivo.
4. Priorize o que o usuário faz com mais frequência.
5. Produza mapa estrutural e fluxos críticos.

## Template

```md
## Arquitetura da informação

### Mapa estrutural
- <Página/view/comando> `<rota ou comando>`
  - <subview/subcomando>

### Modelo de navegação
- Primária:
- Secundária:
- Utilitária:
- Mobile ou terminal:

### Hierarquia por superfície
| Superfície | Prioridade 1 | Prioridade 2 | Secundário | Motivo |
|---|---|---|---|---|

### Fluxos críticos
1. Entrada:
2. Ação:
3. Decisão:
4. Resultado:
5. Recuperação:

### Vocabulário de interface
| Conceito | Label | Evitar | Motivo |
|---|---|---|---|

### Reuso estrutural
| Componente/layout | Usado em | Variações |
|---|---|---|

### Crescimento
- Conteúdo que cresce:
- Busca/filtro/paginação:
- URL/query/slug:
```

## Regras

- Não desenhe visual antes de resolver estrutura.
- Não invente rotas ou comandos que conflitam com padrões existentes.
- Não crie navegação profunda sem provar frequência ou necessidade.
- Use `artifact-diagrams` para sitemap, fluxo ou state machine quando ficar mais claro visualmente.
