diff --git a/.jules/palette.md b/.jules/palette.md
new file mode 100644
index 0000000..51d4c5f
--- /dev/null
+++ b/.jules/palette.md
@@ -0,0 +1,3 @@
+## 2024-05-24 - Headless CLI Architecture Constraints
+**Learning:** vspec is a local-first CLI application designed exclusively for AI consumption. It outputs machine-parseable JSON envelopes to stdout without a human-readable text format, meaning visual, text-based, or standard UI/UX enhancements (like ARIA labels or visual polish) are inapplicable.
+**Action:** When acting as Palette in this repository, immediately recognize the headless nature of the project and stop execution without creating a PR, as traditional UX enhancements cannot be applied.