diff --git a/notes.md b/notes.md
index f7e1367..3c9a3a9 100644
--- a/notes.md
+++ b/notes.md
@@ -69,3 +69,32 @@ The `~/.config/opencode/opencode.json` written by Home Manager contains:
 ### license
 
 MIT
+
+---
+
+## chi / framework 12 — notes to expand later
+
+This section is a placeholder for things to document as the setup settles.
+
+### hardware
+
+- Framework 12 laptop specs (CPU, RAM, storage, display, expansion cards)
+- What works out of the box under NixOS
+- Any manual tweaks needed for sleep, suspend, power profiles, etc.
+
+### performance with apps and gaming
+
+- General desktop smoothness under KDE Plasma 6
+- Specific games and how they run
+  - Team Fortress 2: currently needs a config to run well
+- Emulators / Proton / native Linux games worth noting
+
+### current difficulties (assumed temporary)
+
+- TF2 performance without a config
+- Any other apps or games that need workarounds at time of writing
+- Things likely to improve with driver/kernel/proton updates
+
+### misc
+
+- Anything else worth remembering about this machine's NixOS setup