diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..35fc410
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,22 @@
+# Claude Code Instructions
+
+## Plugin Development Workflow
+
+When creating, modifying, or removing plugins:
+
+1. **Always update the plugin documentation** in `docs/plugins.md` after any plugin changes
+2. Ensure the documentation includes:
+   - Plugin name and category (Development, Fun and entertainment, Utility, Security, Social Media)
+   - Brief description of functionality
+   - Usage instructions with examples
+   - Any configuration requirements
+
+## Testing
+
+Before committing plugin changes:
+
+1. Check files are properly formatted: Run `make format`
+2. Check code style and linting: Run `make lint`
+3. Test the plugin functionality: Run `make test`
+4. Verify documentation accuracy
+5. Ensure all examples work as described