docs(amiga): complete AmigaOS 3.1/3.2 developer reference — 172 files across 17 sections

Comprehensive technical documentation covering:
- Hardware: OCS/ECS/AGA custom chip registers, Copper & Blitter deep dives
- Boot sequence: cold boot through startup-sequence
- Binary format: HUNK executable spec, relocation, debug info
- Linking & ABI: .fd files, LVO tables, register calling conventions
- Exec kernel: tasks, interrupts, memory, signals, semaphores
- AmigaDOS: file I/O, FFS/OFS layout, CLI/Shell scripting
- Graphics: planar bitmaps, Copper programming, HAM/EHB modes
- Intuition: screens, windows, IDCMP, BOOPSI
- Devices: trackdisk, SCSI, serial, timer, audio, keyboard
- Libraries: utility, expansion, IFFParse, locale, ARexx
- Networking: bsdsocket API, SANA-II, TCP/IP stack comparison
- Toolchain: GCC, vasm/vlink, SAS/C, NDK, debugging
- Reverse engineering: IDA/Ghidra setup, compiler fingerprints, case studies
- CPU & MMU: 68040/060 emulation libs, PMMU, cache management
- Driver development: SANA-II, Picasso96/RTG, AHI audio

All files include breadcrumb navigation. No local paths or proprietary content.

13_toolchain/debugging.md

@@ -0,0 +1,62 @@
+[← Home](../README.md) · [Toolchain](README.md)
+
+# Debugging Tools — BareFoot, wack, GDB Remote
+
+## Overview
+
+Debugging Amiga programs ranges from ROM-resident kernel debuggers (wack/SAD) through software monitors to modern cross-debugging via GDB stubs.
+
+---
+
+## Tool Comparison
+
+| Tool | Type | Target | Best for |
+|---|---|---|---|
+| BareFoot | Serial debugger | Real hardware / UAE | OS-level, Exec kernel |
+| wack/SAD | ROM debugger | Real hardware | Boot-time, crash analysis |
+| MonAm | Software monitor | AmigaOS | Breakpoints, disassembly |
+| IDA Pro | Static + remote | Cross-platform | Static RE, decompilation |
+| GDB (m68k-elf-gdb) | Cross-debugger | FS-UAE / Basilisk | Source-level C debugging |
+| Enforcer | Memory watchdog | AmigaOS (68020+) | Illegal memory access detection |
+| MuForce | Memory watchdog | AmigaOS (68040+) | Same as Enforcer for 040/060 |
+
+---
+
+## Enforcer / MuForce
+
+Detects invalid memory accesses using MMU:
+
+```
+Enforcer Hit!   $0000000C read by task "myapp" at $00020456
+```
+
+```
+; Install:
+run >NIL: Enforcer
+; or for 040/060:
+run >NIL: MuForce
+```
+
+---
+
+## FS-UAE GDB Debugging
+
+```bash
+# In fs-uae.conf:
+remote_debugger = 1
+remote_debugger_port = 6860
+
+# Connect from host:
+m68k-elf-gdb myapp
+(gdb) target remote localhost:6860
+(gdb) break main
+(gdb) continue
+```
+
+---
+
+## References
+
+- BareFoot: Aminet `dev/debug/BareFoot.lha`
+- Enforcer: Aminet `dev/debug/Enforcer.lha`
+- MuForce: Aminet `dev/debug/MuForce.lha`