diff --git a/AGENTS.md b/AGENTS.md index 9d839f572..52c5276fc 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -33,6 +33,8 @@ Every execution — QEMU or hardware, any test, any boot — runs with GDB attac ### RULES (NON-NEGOTIABLE) +-1. **ULTRA RULE — NUNCA corras código fora de uma sessão de debug. SEMPRE.** Qualquer execução de código — hardware ou QEMU, teste ou validação, bootloader, kernel, ou app — TEM de correr com GDB attached (GDB stub, JTAG/OpenOCD, ou QEMU `-s -S`). Não há exceções. Não "runs rápidos" via serial. Não observações só por UART. Se o código corre sem debugger, é uma violação da regra. "Debug é a tua única opção." Ver detalhes na secção "Verification Workflow" abaixo. + 0. **COMMIT ANTES DE QUALQUER COISA.** Antes de mudar, apagar, ou reestruturar QUALQUER ficheiro, faz commit do working tree primeiro. Sem exceções. Se o tree tem trabalho não committed, a primeira ação é `git add -A && git commit`. Perder 24 horas de trabalho porque ninguém fez commit é inaceitável. 1. **NUNCA refactor, reestruture, renomeie, ou mude o comportamento de QUALQUER COISA sem autorização explícita do Fabio.** Isto inclui: build targets, linker scripts, boot chains, bootloaders, flash layouts, Makefiles, HAL vs raw registers, e qualquer código que funcione. "Pareceu uma simplificação" NÃO é desculpa.