docs: Refactor and prioritize project task lists

- Restructured PROJECT_CONTEXT.md to introduce a clear roadmap with 'Next Up', 'In Progress', and 'Future Goals'.
- Condensed the 'Session Decisions' section into a concise 'Architectural Overview' focusing on the current state.
- Updated TODO.md to reflect the highest priority tasks: finalizing the build system and optimizing spectrogram assets.

1 files changed, 13 insertions, 30 deletions

diff --git a/TODO.md b/TODO.md
index e0e6b14..414ff0f 100644
--- a/TODO.md
+++ b/TODO.md
@@ -1,35 +1,18 @@
-# list of quick TODO tasks
+# To-Do List
 
-this is temporary, frequently-updated, list of quick TODO that
-don't warrant a 'Task' in itself.
-Once done, move the task description to the 'Past Tasks' section
+This file tracks the next set of immediate, actionable tasks for the project.
 
+## Next Up
 
-## Up-to-date Tasks list
+-   **Task #4: Finalize Build System**
+    -   [ ] Implement Linux cross-compilation from macOS.
+    -   [ ] Create `scripts/check_all.sh` to build and test all platform targets (macOS, Windows, Linux) to ensure stability before commits.
+-   **Task #10: Optimize Spectrogram Assets**
+    -   [ ] Modify `spectool` to trim leading and trailing silent frames from `.spec` files to reduce asset size.
 
-In no particular order, they just need to be done:
-
-  * A) each build_XXX build directory is generating its own build_XXX/src/generated/* assets and code.
-       This is wrong and error-prone. There should be one source of truth
-       for the generated assets/data/code at the top of the tree, under a common
-       src/generated/ directory. Adapt all the code for that. Pay attention
-       to tests (test_assets, e.g.) that *also* generate assets. They must§
-       generate them in a throw-away directory.
-
-  * B) make a pass of 'vertical compaction' for the code: there's a lot of
-       superfluous '\n' empty lines in the code that shouldn't be here.
-       Remove them to have a vertically more dense code. Use clang-format if needed.
-
-  * C) add a top-level @README.md file with a short description of the
-       project for new-comers, a one-line description of each .md files, and
-       a quick layout and description of the source tree.
-
-  * D) move all the non-essential .md files to a top-level doc/ directory
-       (or any other more appropriate name) to remove the top-level file
-       clutter. Keep ony the essential ones at top level. Update the git
-       repo accordingly.
-
-## Past Tasks
-
-The past TODO are already done (stored here for archiving):
+## Completed
 
+-   Centralize generated files into `src/generated`.
+-   Vertically compact C++ source code.
+-   Create top-level `README.md`.
+-   Move non-essential documentation to `doc/`.
\ No newline at end of file