From 3b6bee74d9957430a5cc7fa515899a5b85f1fe3d Mon Sep 17 00:00:00 2001
From: Julian Hurst <ark@mansus.space>
Date: Thu, 12 Mar 2026 00:24:04 +0100
Subject: spec: Add variable invocation

---
 spec/variable-invocation.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 spec/variable-invocation.md

diff --git a/spec/variable-invocation.md b/spec/variable-invocation.md
new file mode 100644
index 0000000..021ea13
--- /dev/null
+++ b/spec/variable-invocation.md
@@ -0,0 +1,21 @@
+---
+title: Variable invocation
+version: 1.0.0
+state: draft
+---
+
+# Variable invocation
+
+Variable invocation is the act of referring to a variable's name in order to invoke its value.  
+
+The variable invocation grammar is to be replaced with the value of the variable. 
+
+## Grammar
+
+A variable invocation is represented by the following grammar:
+
+```
+${VARNAME}
+```
+
+Where VARNAME is a valid variable that has been previously declared using the grammar specified in [variable-declaration](variable-declaration.md)
-- 
cgit v1.2.3