Base Documental

Único arquivo no primeiro nível de docs/. Navegação: este arquivo → README.md mestre da categoria → satélite. Regras de trabalho dos agentes: CLAUDE.md.

Categoria	Leia quando
architecture/	for propor, criar ou refatorar feature (mapa do que o código faz hoje)
gameplay/	for entender como uma funcionalidade do jogo funciona hoje (combate, magias, talentos, loot, campanha, HUD...) sem ler o código
decisions/	for escolher tecnologia ou serviço, definir regra de negócio ou depender de uma suposição
specs/	for definir, implementar ou consumir uma spec (defining → backlog → in-progress)
engineering/	for escrever ou revisar código (stack, convenções), mexer em arquivo de risco, performance ou segurança
ui/	for mexer em telas (HUD, modais, menus) ou em acessibilidade
product/	for consultar roadmap, release, conta e dados ou princípios de produto
operations/	for rodar, configurar, publicar ou empacotar
testing/	for escrever ou rodar testes
troubleshooting/	for depurar um erro estranho ou recorrente (casos complexos já resolvidos)

Manutenção

• Só este arquivo fica no primeiro nível; o resto vai em pasta de categoria.
• Documento novo: liste no mestre da pasta. Categoria nova: liste aqui.
• Nomes de arquivo em kebab-case. Idioma: pastas e documentos de referência em inglês e nomeados pelo assunto; ADRs, casos de troubleshooting e specs em português. Specs seguem <tipo>-<tema>-<assunto> (tipo: bug-, feature-, discovery-; tema: grafico, audio, controles, ui, mundo, campanha, eventos, assets, distribuicao, persistencia, combate, progressao, docs); spec com várias partes vira pasta com README.md como índice e partes numeradas (01-...md). Documentos de referência (architecture, engineering, gameplay, operations, product, testing, ui) levam **Status:** verificado | não verificado | histórico e **Verificado em:** no topo; só confie em verificado.
• Todo documento (exceto README) traz **Mestre:** [pasta](README.md) no topo; ADRs têm o mesmo status no registro de decisions/ e no arquivo.
• Specs levam **Estágio:** e **Aprovação do responsável:**; em backlog/ e in-progress/ a aprovação é obrigatória. Também levam **Classe:** (A técnica, B regra de negócio, C aguarda ADR proposto, D discovery, E congelada) e **Depende de:** (ADRs; o docs:check confere que existem), **Prioridade:** (P1 a P3; "(sugerida)" até o responsável aprovar) e **Esforço:** (— até haver medição).
• Documentos de referência levam **Status:** (só verificado, não verificado ou histórico), **Verificado em:**, **Método:** (estático, executado ou não verificado) e **Fonte:** (caminhos conferidos; — se não verificado). Ressalvas vão numa linha "Nota de verificação:" no corpo.
• ADRs levam também **Specs afetadas:** e, se for o caso, **Substitui:**/**Substituída por:**.
• A documentação descreve o projeto como ele é hoje: sem relatórios de status, sem histórico (o histórico fica no Git).