diff --git a/.gdbinit b/.gdbinit
new file mode 100644
index 0000000..4e533e4
--- /dev/null
+++ b/.gdbinit
@@ -0,0 +1,4 @@
+file build/boot/sys/core
+target remote :3117
+b _start
+c
diff --git a/HOW_TO_DEBUG.md b/HOW_TO_DEBUG.md
deleted file mode 100644
index 1b3d5e2..0000000
--- a/HOW_TO_DEBUG.md
+++ /dev/null
@@ -1,6 +0,0 @@
-# steps
-- run the `debug_run_qemu` script.
-- in another window, run `gdb`.
-  - inside gdb, run `file build/boot/sys/core`.
-  - run `target remote :3117`.
-  - start with `c`. Best set a breakpoint before!