Skip to content

Add targeted copy-guard workflow for README.md and docs index.mdx - #55791

Merged
pelikhan merged 1 commit into
mainfrom
copilot/add-agentic-workflow-protect-readmes
Aug 25, 2026
Merged

pelikhan merged 1 commit into
mainfrom
copilot/add-agentic-workflow-protect-readmes

Conversation

Copilot AI commented Aug 25, 2026 •

Copy link
Copy Markdown
Contributor

Recent PRs regressed front-page messaging by rewriting core copy into overly technical language. This change adds a dedicated guardrail workflow that scrutinizes edits to the two public entry-point docs and forces explicit intent checks.

  • Scope: protect only the two critical files

    • Introduces .github/workflows/front-page-copy-guard.md (and compiled lockfile) with PR path filtering limited to:
      • README.md
      • docs/src/content/docs/index.mdx
  • Review contract: detect copy drift, require justification

    • Workflow agent is constrained to review only those files.
    • It classifies risk (safe, needs-justification, high-risk-copy-drift) and posts a single focused PR comment.
    • It must ask at least one direct confirmation question per changed protected file to challenge messaging changes before merge.
  • Safety envelope: no writes, comment-only output

    • Safe outputs are restricted to add-comment (single comment) or noop, preventing branch/file mutation by this workflow.
on:
  pull_request:
    types: [opened, synchronize, reopened, ready_for_review]
    paths:
      - 'README.md'
      - 'docs/src/content/docs/index.mdx'

safe-outputs:
  add-comment:
    max: 1
  noop:

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title Add workflow guard for front-page messaging files Add targeted copy-guard workflow for README.md and docs index.mdx Aug 25, 2026
Copilot AI requested a review from pelikhan August 25, 2026 13:48
@pelikhan
pelikhan marked this pull request as ready for review August 25, 2026 13:56
Copilot AI balanced review requested due to automatic review settings August 25, 2026 13:56
@pelikhan
pelikhan merged commit fb6bb66 into main Aug 25, 2026
@pelikhan
pelikhan deleted the copilot/add-agentic-workflow-protect-readmes branch August 25, 2026 13:56
Copilot stopped reviewing on behalf of pelikhan due to an error August 25, 2026 13:57

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot could not run the full agentic suite for this review because it was automatically requested on a bot-authored pull request. Request a review from Copilot under Reviewers to retry with the full agentic suite. Improved support for bot-authored pull requests is coming soon.

Adds a gh-aw “Front Page Copy Guard” workflow to scrutinize copy changes in the repository’s front-facing docs and automatically leave a single PR comment (or noop) based on drift risk.

Changes:

  • Introduces a new gh-aw skill file defining the copy-guard prompt, scope, and safe-output constraints.
  • Adds the compiled lockfile workflow YAML generated from the skill (plus shared imports).
Show a summary per file
File Description
.github/workflows/front-page-copy-guard.md Defines the copy-guard agent behavior, scope, and safe-output tool constraints.
.github/workflows/front-page-copy-guard.lock.yml Compiled GitHub Actions workflow implementing the agent run + safe-outputs processing.

Review details

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

  • Files reviewed: 1/2 changed files
  • Comments generated: 2
  • Review effort level: Lite

Comment on lines +28 to +33
safe-outputs:
add-comment:
max: 1
hide-older-comments: true
noop:
---
- 'docs/src/content/docs/index.mdx'
permissions:
contents: read
pull-requests: read
@github-actions

Copy link
Copy Markdown
Contributor

🎉 This pull request is included in a new release.

Release: v0.87.8

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants