refactor(build): Centralize generated files and clean up project layout

- Task A: Centralized all generated code (assets, timeline) into a single  directory to create a single source of truth.
- Task A: Isolated test asset generation into a temporary build directory, preventing pollution of the main source tree.
- Task B: Vertically compacted all C/C++ source files by removing superfluous newlines.
- Task C: Created a top-level README.md with project overview and file descriptions.
- Task D: Moved non-essential documentation into a  directory to reduce root-level clutter.

1 files changed, 29 insertions, 0 deletions

diff --git a/doc/BUILD.md b/doc/BUILD.md
new file mode 100644
index 0000000..3a581b1
--- /dev/null
+++ b/doc/BUILD.md
@@ -0,0 +1,29 @@
+# Build Instructions
+
+Debug build:
+cmake -S . -B build
+cmake --build build
+
+Size-optimized build:
+cmake -S . -B build -DDEMO_SIZE_OPT=ON
+cmake --build build
+
+## Windows Cross-Compilation (from macOS)
+
+Requires `mingw-w64` and `wine-stable` (for testing).
+
+1. Fetch Windows binaries:
+   ```bash
+   ./scripts/fetch_win_deps.sh
+   ```
+
+2. Build for Windows:
+   ```bash
+   ./scripts/build_win.sh
+   ```
+   This will produce `build_win/demo64k_packed.exe`.
+
+3. Run with Wine:
+   ```bash
+   ./scripts/run_win.sh
+   ```