diff --git a/PLAYWRITER_AGENTS.md b/PLAYWRITER_AGENTS.md
index a709f65..8143b68 100644
--- a/PLAYWRITER_AGENTS.md
+++ b/PLAYWRITER_AGENTS.md
@@ -72,7 +72,9 @@ pnpm --filter mcp-extension reload  # builds and opens chrome://extensions page
 
 then click the reload button on the extension card in Chrome. the extension has a stable dev ID (`pebbngnfojnignonigcnkdilknapkgid`) so you don't need to reconfigure anything.
 
+## extension version
 
+after EVERY change made inside extension/ folder you MUST bump the manifest.json version and update the CHANGELOG.md file. then create a git tag with extension@version after committing.
 
 ### testing