diff --git a/internal/formula/parser.go b/internal/formula/parser.go
index e05fe7079a..d5af22494a 100644
--- a/internal/formula/parser.go
+++ b/internal/formula/parser.go
@@ -1,3 +1,6 @@
+// parser.go handles reading, parsing, and validating formula.toml files which define
+// workflow orchestration patterns (workflows, convoys, expansions, and aspects).
+
 package formula
 
 import (