feat(*): add contributor guidelines

.github/pull_request_template.md

@@ -35,3 +35,25 @@ Remove this section if this change applies to all flows or to the documentation
 If there are no setup requirements, you can remove this section.
 
 Thank you for your contribution. ❤️  -->
+
+### Contributor Checklist ✅
+
+- [ ] PR Title follows [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/)
+- [ ] Unit Tests added or updated to cover the change.
+- [ ] Documentation updated (plugin docs).
+- [ ] Setup instructions included if needed (API keys, accounts, etc.).
+
+⚙️ **Properties**
+- [ ] Properties are declared with `Property<T>` carrier type, do **not** use `@PluginProperty`.
+
+🌐 **HTTP**
+- [ ] Must use Kestra’s internal HTTP client from `io.kestra.core.http.client`
+
+📦 **JSON**
+- [ ] Must use Jackson mappers provided by core (`io.kestra.core.serializers`)
+
+✨ **New plugins/subplugins**
+- [ ] Icons added in `src/main/resources/icons`
+  - `plugin-icon.svg`
+  - One icon per package, e.g. `io.kestra.plugin.apify.svg`
+  - For subpackages, e.g. `io.kestra.plugin.aws.s3`, add `io.kestra.plugin.aws.s3.svg`

.github/workflows/main.yml

@@ -27,8 +27,36 @@
           - "false"
 
 jobs:
+  checklist:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request' && github.repository != 'kestra-io/plugin-template'
+    steps:
+      - name: Verify PR checklist
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const org = "kestra-io";
+            const username = context.payload.pull_request.user.login;
+
+            try {
+              await github.rest.orgs.checkMembershipForUser({ org, username });
+              core.info(`User ${username} is a member of ${org}, skipping checklist validation.`);
+              return;
+            } catch (e) {
+              core.info(`User ${username} is not in ${org}, checklist validation required.`);
+            }
+
+            const body = context.payload.pull_request.body || "";
+            const unchecked = body.match(/- \[ \]/g);
+            if (unchecked) {
+              core.setFailed("Some checklist items are still unchecked. Please complete them.");
+            } else {
+              core.info("All checklist items are checked.");
+            }
+
   check:
+    needs: checklist
     uses: kestra-io/actions/.github/workflows/plugins.yml@main
     with:
       skip-test: ${{ github.event.inputs.skip-test == 'true' }}
     secrets: inherit