diff --git a/.learnings/LEARNINGS.md b/.learnings/LEARNINGS.md
index 7ee9c7f..6dcd0b8 100644
--- a/.learnings/LEARNINGS.md
+++ b/.learnings/LEARNINGS.md
@@ -301,3 +301,22 @@ Migração de stack Docker Swarm (trocar de nome/namespace):
 - Tags: docker, swarm, migration, stack
 - Pattern-Key: docker.swarm-stack-migration
 
+
+## LRN-20260520-010 — Stack Portainer API Attachable=false bloqueia deploy
+
+**Categoria**: knowledge_gap
+
+### Problema
+- Rede `public` tem `Attachable: false`
+- `docker stack deploy` CLI FUNCIONA mesmo assim (Daemon local ignora)
+- Portainer API BLOQUEIA (Docker Remote API respeita `Attachable=false`)
+- Erro: `failed to set up container networking: Could not attach to network public: rpc error: code = PermissionDenied desc = network public not manually attachable`
+
+### Decisão tomada
+Stack `project` fica gerenciada por `docker stack deploy` CLI (Swarm nativo).
+Portainer controla apenas stacks 1,2,4,6,7,8,9 (com SwarmId preenchido).
+Stack `project` não é controlável pelo Portainer enquanto `Attachable=false`.
+
+### Para resolver completamente
+Recriar rede `public` com `--attachable` impactando 19 containers — NÃO recomendado agora.
+