[NDR-319] Add PR checklist (#530)

Author: megan-bower4

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,32 @@
+<!-- markdownlint-disable-next-line first-line-heading -->
+## Overview
+
+**Jira ticket**: [TBC](https://nhsd-jira.digital.nhs.uk/browse/XXX)
+
+### Description
+
+<!-- Describe your changes in detail. -->
+
+### Context
+
+<!-- Why is this change required? What problem does it solve? -->
+
+## Checklist
+
+<!--
+
+  Put an `x` in the completed tasks.
+
+  If a task is not relevant, `x` it, then strike through the text e.g.:
+  - [x] ~~This task is not relevant.~~
+
+-->
+
+Tasks for all changes:
+
+- [ ] 1. I have linked this PR to its Jira ticket.
+- [ ] 2. I have run git pre-commits.
+- [ ] 3. I have updated relevant documentation.
+- [ ] 4. I have considered the cross-team impact (and have PR approval from both Core & Demographics if necessary).
+- [ ] 5. I have successfully [deployed this change to a sandbox](https://github.com/NHSDigital/national-document-repository-infrastructure/actions/workflows/deploy-sandbox.yml) and witnessed it build: [Workflow run: TBC](https://github.com/NHSDigital/national-document-repository-infrastructure/actions/runs/XXX)
+- [ ] 6. I have checked the Terraform Plan from this PR against `ndr-dev`.

.github/workflows/automated-pr-validator.yml

@@ -2,7 +2,9 @@ name: "Z-AUTOMATED: PR Validator"
 
 on:
   pull_request:
-    types: [opened, synchronize, reopened]
+    types: [opened, synchronize, reopened, edited]
+
+permissions: {}
 
 jobs:
   sbom_scan:
@@ -120,3 +122,23 @@ jobs:
           BRANCH_NAME=${{ github.event.repository.default_branch }}
           chmod +x scripts/markdown-validator.sh
           scripts/markdown-validator.sh
+
+  checklist_validator:
+    name: Checklist Validation
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v5
+
+    - name: Set up Python 3.11
+      uses: actions/setup-python@v6
+      with:
+        python-version: 3.11
+
+    - name: Run checklist validator
+      run: |
+        python3 scripts/github/checklist_validator/main.py
+      env:
+        PR_BODY: ${{ github.event.pull_request.body }}

scripts/github/checklist_validator/__init __.py

@@ -0,0 +1,30 @@
+def validate_checklist(body: str) -> bool:
+    """
+    Check if all PR checklist items are ticked.
+    Returns True if all boxes are checked, False otherwise.
+    """
+    if not body:
+        return False
+
+    lines = body.splitlines()
+    for line in lines:
+        line = line.strip()
+        if line.startswith("- [ ]"):
+            return False
+    return True
+
+
+def main():
+    import os
+
+    pr_body = os.environ.get("PR_BODY", "")
+    if validate_checklist(pr_body):
+        print("All checklist items are checked ✅")
+        exit(0)
+    else:
+        print("Some checklist items are not checked ❌")
+        exit(1)
+
+
+if __name__ == "__main__":
+    main()