chore: add agentic guidance

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,57 @@
+name: Bug report
+description: Report a problem with the PatternFly User feedback extension
+title: '[User feedback] - [short description]'
+type: bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for the report. Please include enough detail for maintainers to reproduce the issue.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What is going wrong? What did you expect instead?
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to reproduce
+      placeholder: |
+        1. …
+        2. …
+        3. …
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Versions help narrow the issue.
+      placeholder: |
+        - @patternfly/react-user-feedback version:
+        - @patternfly/react-core version:
+        - React version:
+        - Browser:
+    validations:
+      required: false
+
+  - type: textarea
+    id: code
+    attributes:
+      label: Minimal example or code snippet (optional)
+      description: Short snippet or CodeSandbox-style reference if possible.
+    validations:
+      required: false
+
+  - type: textarea
+    id: accessibility
+    attributes:
+      label: Accessibility (optional)
+      description: Keyboard, screen reader, or focus issues?
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,55 @@
+name: Feature request
+description: Suggest an improvement or new capability for the User feedback extension
+title: '[User feedback] - [short description]'
+type: feature
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Share enough context for maintainers to evaluate fit with PatternFly and this extension.
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      description: Which part of the extension is this about?
+      options:
+        - Modal / feedback flow
+        - Forms (feedback, bug report, mailing list)
+        - Locales / i18n
+        - Documentation or examples
+        - Build / tooling
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem or use case
+      description: What are you trying to achieve?
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: Ideas, API shape, or UX notes.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+    validations:
+      required: false
+
+  - type: textarea
+    id: accessibility
+    attributes:
+      label: Accessibility (optional)
+      description: Any specific a11y requirements?
+    validations:
+      required: false

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,40 @@
+Closes #
+
+## Summary
+
+<!-- What changed and why? Link the GitHub issue above so the PR is connected and can auto-close when merged. -->
+
+## Documentation preview (Surge)
+
+<!-- Required for review: paste the Surge URL where the updated PatternFly docs / examples for this extension can be reviewed. -->
+
+**Preview URL:**
+
+## Screenshots / recordings (optional)
+
+<!-- For visible UI changes, add before/after or short capture if helpful alongside the Surge link. -->
+
+## Testing
+
+- [ ] `yarn lint`
+- [ ] `yarn build`
+- [ ] `yarn test` (if applicable for this change)
+- [ ] Docs: `yarn build:docs` (and `yarn test:a11y` if the change affects UI or docs in a way that warrants it)
+
+## Breaking changes
+
+<!-- None, or describe impact and migration for consumers of @patternfly/react-user-feedback. -->
+
+## Follow-up work
+
+<!-- Link issues filed for out-of-scope follow-ups (keeps the original issue from growing without bound). -->
+
+-
+
+## Review
+
+- [ ] This PR needs review from **a maintainer of this repository** before merge.
+
+## AI-assisted changes
+
+<!-- If any part of this PR was produced or heavily edited with AI, see PatternFly guidance: https://github.com/patternfly/.github/blob/main/CONTRIBUTING.md -->

.github/workflows/build-lint-test.yml

@@ -2,28 +2,37 @@ name: build-lint-test
 on:
   workflow_call:
 jobs:
+  actionlint:
+    name: Lint workflow YAML
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Download actionlint
+        run: curl -fsSL https://raw.githubusercontent.com/rhysd/actionlint/v1.7.7/scripts/download-actionlint.bash | bash -s -- 1.7.7
+      - name: Run actionlint
+        run: ./actionlint -color
   build:
     runs-on: ubuntu-latest
     env:
       GH_PR_NUM: ${{ github.event.number }}
     steps:
       - uses: actions/checkout@v4
       - run: |
-          if [[ ! -z "${GH_PR_NUM}" ]]; then 
+          if [[ -n "${GH_PR_NUM}" ]]; then
             echo "Checking out PR"
-            git fetch origin pull/$GH_PR_NUM/head:tmp
+            git fetch origin "pull/${GH_PR_NUM}/head:tmp"
             git checkout tmp
           fi
-      - uses: actions/setup-node@v3
+      - uses: actions/setup-node@v4
         with:
           node-version: '20'
       - uses: actions/cache@v4
         id: yarn-cache
         name: Cache npm deps
         with:
           path: |
-           node_modules
-           **/node_modules
+            node_modules
+            **/node_modules
           key: ${{ runner.os }}-yarn-14-${{ secrets.CACHE_VERSION }}-${{ hashFiles('yarn.lock') }}
       - run: yarn install --frozen-lockfile
         if: steps.yarn-cache.outputs.cache-hit != 'true'
@@ -45,21 +54,21 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - run: |
-          if [[ ! -z "${GH_PR_NUM}" ]]; then 
+          if [[ -n "${GH_PR_NUM}" ]]; then
             echo "Checking out PR"
-            git fetch origin pull/$GH_PR_NUM/head:tmp
+            git fetch origin "pull/${GH_PR_NUM}/head:tmp"
             git checkout tmp
           fi
-      - uses: actions/setup-node@v3
+      - uses: actions/setup-node@v4
         with:
           node-version: '20'
       - uses: actions/cache@v4
         id: yarn-cache
         name: Cache npm deps
         with:
           path: |
-           node_modules
-           **/node_modules
+            node_modules
+            **/node_modules
           key: ${{ runner.os }}-yarn-14-${{ secrets.CACHE_VERSION }}-${{ hashFiles('yarn.lock') }}
       - run: yarn install --frozen-lockfile
         if: steps.yarn-cache.outputs.cache-hit != 'true'
@@ -82,22 +91,22 @@ jobs:
       - uses: actions/checkout@v4
       # Yes, we really want to checkout the PR
       - run: |
-          if [[ ! -z "${GH_PR_NUM}" ]]; then 
+          if [[ -n "${GH_PR_NUM}" ]]; then
             echo "Checking out PR"
-            git fetch origin pull/$GH_PR_NUM/head:tmp
+            git fetch origin "pull/${GH_PR_NUM}/head:tmp"
             git checkout tmp
           fi
-      - uses: actions/setup-node@v3
+      - uses: actions/setup-node@v4
         with:
           node-version: '20'
       - uses: actions/cache@v4
         id: yarn-cache
         name: Cache npm deps
         with:
           path: |
-           node_modules
-           **/node_modules
-           ~/.cache/Cypress
+            node_modules
+            **/node_modules
+            ~/.cache/Cypress
           key: ${{ runner.os }}-yarn-14-${{ secrets.CACHE_VERSION }}-${{ hashFiles('yarn.lock') }}
       - run: yarn install --frozen-lockfile
         if: steps.yarn-cache.outputs.cache-hit != 'true'
@@ -123,22 +132,22 @@ jobs:
       - uses: actions/checkout@v4
       # Yes, we really want to checkout the PR
       - run: |
-          if [[ ! -z "${GH_PR_NUM}" ]]; then 
+          if [[ -n "${GH_PR_NUM}" ]]; then
             echo "Checking out PR"
-            git fetch origin pull/$GH_PR_NUM/head:tmp
+            git fetch origin "pull/${GH_PR_NUM}/head:tmp"
             git checkout tmp
           fi
-      - uses: actions/setup-node@v3
+      - uses: actions/setup-node@v4
         with:
           node-version: '20'
       - uses: actions/cache@v4
         id: yarn-cache
         name: Cache npm deps
         with:
           path: |
-           node_modules
-           **/node_modules
-           ~/.cache/Cypress
+            node_modules
+            **/node_modules
+            ~/.cache/Cypress
           key: ${{ runner.os }}-yarn-14-${{ secrets.CACHE_VERSION }}-${{ hashFiles('yarn.lock') }}
       - run: yarn install --frozen-lockfile
         if: steps.yarn-cache.outputs.cache-hit != 'true'

.github/workflows/build.yml

@@ -9,9 +9,9 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - run: |
-          if [[ ! -z "${GH_PR_NUM}" ]]; then 
+          if [[ -n "${GH_PR_NUM}" ]]; then
             echo "Checking out PR"
-            git fetch origin pull/$GH_PR_NUM/head:tmp
+            git fetch origin "pull/${GH_PR_NUM}/head:tmp"
             git checkout tmp
           fi
       - uses: actions/cache@v4
@@ -30,16 +30,16 @@ jobs:
         run: ./devSetup.sh
         shell: bash
         if: steps.setup-cache.outputs.cache-hit != 'true'
-      - uses: actions/setup-node@v3
+      - uses: actions/setup-node@v4
         with:
           node-version: '20'
       - uses: actions/cache@v4
         id: yarn-cache
         name: Cache npm deps
         with:
           path: |
-           node_modules
-           **/node_modules
+            node_modules
+            **/node_modules
           key: ${{ runner.os }}-yarn-14-${{ secrets.CACHE_VERSION }}-${{ hashFiles('yarn.lock') }}
       - run: yarn install --frozen-lockfile
         if: steps.yarn-cache.outputs.cache-hit != 'true'
@@ -52,4 +52,4 @@ jobs:
           key: ${{ runner.os }}-dist-14-${{ secrets.CACHE_VERSION }}-${{ hashFiles('yarn.lock', 'package.json', 'packages/*/*', '!packages/*/dist', '!packages/*/node_modules') }}
       - name: Build dist
         run: yarn build
-        if: steps.dist.outputs.cache-hit != 'true'
+        if: steps.dist.outputs.cache-hit != 'true'

.github/workflows/promote.yml

@@ -2,7 +2,7 @@ name: promote
 on:
   push:
     # Sequence of patterns matched against refs/tags
-    tags:        
+    tags:
       - v6.*
 jobs:
   build-and-promote:
@@ -15,7 +15,7 @@ jobs:
       - uses: actions/checkout@v4
       - name: Build for promotion
         run: yarn install --frozen-lockfile && yarn build
-      - uses: actions/setup-node@v3
+      - uses: actions/setup-node@v4
         with:
           node-version: '20.x'
           registry-url: 'https://registry.npmjs.org'

.github/workflows/release.yml

@@ -15,17 +15,17 @@ jobs:
       GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-node@v3
+      - uses: actions/setup-node@v4
         with:
           node-version: '20'
       - uses: actions/cache@v4
         id: yarn-cache
         name: Cache npm deps
         with:
           path: |
-           node_modules
-           **/node_modules
-           ~/.cache/Cypress
+            node_modules
+            **/node_modules
+            ~/.cache/Cypress
           key: ${{ runner.os }}-yarn-14-${{ secrets.CACHE_VERSION }}-${{ hashFiles('yarn.lock') }}
       - run: yarn install --frozen-lockfile
         if: steps.yarn-cache.outputs.cache-hit != 'true'