diff --git a/scoreodonto/arquitetura.md b/scoreodonto/arquitetura.md
index 2120815..e6f4553 100644
--- a/scoreodonto/arquitetura.md
+++ b/scoreodonto/arquitetura.md
@@ -36,6 +36,18 @@ Para garantir que o histórico de deploys (`deploys.json`) e o contador de build
 > [!TIP]
 > Sem a chamada `node ../update-version.js` antes do comando de build, o sistema de versionamento não fará a contagem e a versão exibida na interface ficará congelada.
 
+### 🐳 Regra de Contexto Docker e Comportamento do Git
+Para que o Docker consiga executar o script `update-version.js` (que fica na raiz) durante a compilação do frontend, os Agentes DEVEM OBRIGATORIAMENTE seguir esta arquitetura de container:
+
+1. O **Build Context** no `docker-compose.yml` deve apontar para a raiz do projeto (`context: .`), e não apenas `./frontend`.
+2. O `Dockerfile` do frontend deve copiar a raiz para `/app/` e definir `WORKDIR /app/frontend`.
+
+> [!WARNING]
+> **COMPORTAMENTO DE VERSIONAMENTO EM CONTAINER**
+> Durante o `docker compose build`, o script `update-version.js` incrementa o contador e altera os arquivos estáticos **dentro do ambiente isolado do container**. Isso significa que a nova versão (ex: V1.0.4) aparecerá perfeitamente na interface web em produção.
+> 
+> Contudo, como a alteração ocorre dentro do container, os arquivos no repositório Git não são modificados. Para lançamentos de versões maiores fixadas (ex: `V1.1.0` ou `V2.0.0`), o desenvolvedor deve editar o arquivo base manualmente no VSCode e realizar o commit.
+
 ## 🤖 Fluxo de Auto-Cura (Self-Healing) com Grafana/Gitea
 Para automatizar a geração de Issues no repositório `ruicesar/scoreodonto.com` quando ocorrerem falhas em produção (VPS 1), os Agentes/Administradores devem configurar as regras no Grafana estritamente desta forma: