pr-feedback-action

Turn merged pull requests into clear, actionable product feedback.

pr-feedback-action helps teams collect ideas from real contributors with a simple PR comment and sends that feedback directly to Google Sheets so product, engineering, and leadership can review everything in one place.

Why Teams Like It

• Easy for contributors: they comment with @suggestion and move on.
• Easy for managers: feedback is already organized in a sheet.
• Easy to scale: one consistent format across repositories.

How Contributors Use It

On your own merged PR, write a comment that starts with:

@suggestion

Example:

@suggestion Add validation for empty title in the form submit flow.

For Technical Setup

Technical setup and implementation notes are in docs/technical-details.md.

Internal architecture and flow diagram are in docs/internal-architecture.md.

Example Client Workflow (Fork-Safe)

Use issue_comment to capture comment events and include pull_request_target to align with fork-safe base-repo execution patterns.

name: Save PR Feedback

on:
  issue_comment:
    types: [created]
  pull_request_target:
    types: [closed]

jobs:
  save-feedback:
    if: ${{ github.event_name == 'issue_comment' && github.event.issue.pull_request }}
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: read
      issues: read
    steps:
      - name: Run action
        uses: your-org/pr-feedback-action@v1
        env:
          GITHUB_TOKEN: ${{ github.token }}
        with:
          google-sheets-id: ${{ vars.FEEDBACK_SHEET_ID }}
          google-service-account-key: ${{ secrets.GOOGLE_SA_KEY }}
          trigger-keyword: '@suggestion'

The guard condition keeps processing limited to PR comment events while still allowing the workflow file to be wired for pull_request_target repositories and policies.