portugalfuturista/universalisos
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

AGENTS.md: minor update before bootloader work

Browse source
This commit is contained in:
Fábio Coutada 2026-07-19 01:01:18 +01:00
parent 5f358c6724
commit 87f1367e3d
1 changed files with 2 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
AGENTS.md
View file

@ -33,6 +33,8 @@ Every execution — QEMU or hardware, any test, any boot — runs with GDB attac
### RULES (NON-NEGOTIABLE) ### 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. 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. 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.