diff --git a/changes/247-pr-36-ci-fix.md b/changes/247-pr-36-ci-fix.md
new file mode 100644
index 0000000..74397c8
--- /dev/null
+++ b/changes/247-pr-36-ci-fix.md
@@ -0,0 +1,6 @@
+type: changed
+area: core
+
+- Refactored startup, query, and workflow code into focused modules.
+- Added repo-local workflow plugin shims and updated internal docs and verification helpers.
+- Expanded tests around launcher, runtime, stats, and immersion-tracker behavior.