diff --git a/.changeset/v2-hook-shims.md b/.changeset/v2-hook-shims.md
new file mode 100644
index 000000000000..f0fc5965f231
--- /dev/null
+++ b/.changeset/v2-hook-shims.md
@@ -0,0 +1,5 @@
+---
+"opencode": patch
+---
+
+Expose V2 compatibility surfaces alongside legacy plugin hooks for agent pre-step and pre-system transforms, tool post-execution, command pre-execution, permission requests, compaction preparation, and completed text. Preserve mutations produced by legacy hooks as the default input for the new waterfall stages.