docs: define workspace visual plan and action animations

ROADMAP.md

@@ -252,3 +252,12 @@ Fora do MVP: IDE própria, servidor compartilhado obrigatório, memória organiz
 - [ai-memory](https://github.com/akitaonrails/ai-memory): memória contínua, handoffs e exportação.
 
 Foram consultados código e documentação. Não houve validação em execução desses projetos. Antes de reutilizar código, verificar a licença e o comportamento da versão escolhida. Diferenciais são hipóteses a validar, não alegações de exclusividade.
+
+## Refinamento visual autorizado — 2026-09-25
+
+O mantenedor aprovou a abelha à direita do campo com contorno amarelo e animações
+por ação, preservando a Clareira original. O [plano visual](docs/specs/workspace-visual.md)
+define entregas: referência HTML, renderizador Rust, conexão à demo e eventos
+reais. A frente visual pode avançar independentemente da prova dos harnesses;
+o lançamento conjunto continua condicionado ao ADR 0018. O HTML de roadmap
+não incorpora este refinamento; esta seção Markdown é a referência vigente.

docs/EXECUTION.md

@@ -28,6 +28,14 @@ de patches e consulta ao Git ficam para a etapa 04.
 
 ## Próxima tarefa de produto
 
+**Refinamento visual — próxima entrega local.** A orientação mais recente do
+mantenedor autoriza a frente visual em paralelo à prova dos harnesses. Referência
+HTML e [plano visual](specs/workspace-visual.md) concluídos; próximo recorte:
+renderizador Rust com abelha à direita do campo amarelo e estados por ação,
+seguido da conexão aos eventos da demo. Não iniciar esse porte na entrega
+restrita ao protótipo/plano. Exportação e troca de agente ainda precisam de
+animações próprias.
+
 **TUI unificada — prova de integração com assinaturas.** A orientação de
 2026-09-25 substitui a prioridade anterior da cena animada: interface permanente
 Memory Bee, assinaturas existentes e lançamento real somente com Claude e Codex.
@@ -590,3 +598,27 @@ escopo da entrega atual nem a próxima tarefa aprovada.
 - Ensaios humanos 46–49 pendentes; não substituídos por testes automatizados.
 - Próximo passo: prova de integração descrita no topo. O plano completo permanece
   em andamento; integração Claude com assinatura depende de confirmação externa.
+
+
+## Workspace — referência visual e plano por ação
+
+- Status: concluído o recorte de referência HTML e planejamento. Retomada da
+  sessão interrompida por limite de uso, preservando suas alterações locais.
+- Protótipo versionado em `docs/prototypes/workspace.html`: Clareira preservada,
+  conversa linear, campo amarelo e abelha à direita. Estados de pensamento,
+  leitura, edição, execução, permissão, conclusão, negação, interrupção, erro e
+  sono. Exportação e troca com animação própria continuam planejadas.
+- Plano em `specs/workspace-visual.md`; roadmap e ADR 0018 registram a frente
+  visual independente da prova de integração, sem mudar o lançamento conjunto.
+- Validação nesta retomada: sintaxe JavaScript via `node --check`; automação em
+  nova página Orca confirmou posição à direita e sequência pensar → ler → editar
+  → permissão → executar → concluir, negação, interrupção sem sucesso atrasado,
+  erro e quadro estável com movimento reduzido. Links relativos e
+  `git diff --check` conferidos. Nenhum código Rust alterado.
+- Autorrevisão de escopo, callbacks invalidados por turno e rótulos de simulação;
+  nenhuma revisão independente. Ensaio humano 50 permanece pendente, assim como
+  compatibilidade de terminal, renderizador Rust e integração/autenticação real.
+- Próximo passo: renderizador Rust conforme plano visual; esta entrega não inicia
+  essa implementação. O artifact externo é temporário; o HTML versionado mantém
+  a referência local.
+- Publicação e verificações remotas vinculadas ao [PR #20](https://github.com/lippdev/memory-bee/pull/20).

docs/MANUAL_TESTS.md

@@ -824,3 +824,18 @@ e dois perfis sem mistura. Não interpretar a demo como evidência desses aceite
 | 47: perfis fictícios, contexto, reinício e crash | Pendente | — |
 | 48: exportação revisada com proveniência e omissões | Pendente | — |
 | 49: terminal, acessibilidade e recusa de modo real | Pendente | — |
+
+## 50. Artifact visual e abelha no campo (ensaio humano pendente)
+
+```sh
+open docs/prototypes/workspace.html
+```
+
+Abrir conversa e enviar tarefa sintética. Esperado: abelha à direita do campo
+amarelo; pensar → ler → editar → aguardar permissão. Permitir mostra execução
+simulada e depois check; negar pousa sem executar. Interromper durante execução
+não pode produzir sucesso atrasado. Enviar `[erro]` mostra falha preservando o
+histórico. Após inatividade, digitar acorda. Conferir movimento desligado, sem
+cor, tema claro/escuro, larguras 140/100/60/40 e janela estreita. A cena inicial
+continua disponível. Nenhum teste, arquivo ou agente real é executado pelo HTML.
+Esse roteiro não valida o renderizador Rust, ainda pendente.

docs/decisions/0018-unified-workspace.md

@@ -73,3 +73,12 @@ I/O de persistência/exportação é síncrono; a demo não certifica responsivi
 sob disco lento. Uma sessão ativa por pasta de estado, não trava global de checkout
 para um futuro motor real. Colmeia estática, projeto explícito e tema não persistido.
 Autorrevisão e testes sintéticos não substituem ensaio humano ou prova real.
+
+## Refinamento visual — 2026-09-25
+
+O mantenedor aprovou preservar a Clareira da Colmeia e aproximar a organização da
+conversa do Claude Code, com identidade amarela própria e abelha à direita do
+campo. A mascote representa cada ação por animação, símbolo e texto; não substitui
+permissões ou evidência de execução. O [plano visual](../specs/workspace-visual.md)
+separa protótipo, renderizador Rust e integração real. Essa frente pode avançar
+com eventos simulados sem certificar nem desbloquear lançamento real.