diff --git a/CLAUDE.md b/CLAUDE.md index b3b1a5c..6fbf60d 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -129,3 +129,17 @@ Make sure you are on the right branch before doing any work. - Once the pull request has been created, wait for the GitHub Action checks to run and fix any issues they find. - Wait for GitHub Copilot to review your pull request and then use the GitHub GraphQL API to find all code suggestions, fix the issues and then resolve the threads. +## Preview Verification + +Pull requests are checked by the `preview-verification.yml` workflow, which runs the [muffet](https://github.com/raviqqe/muffet) link checker against the per-PR preview site. + +### NEVER Add Muffet Exclusions Without Confirmation + +**NEVER add exclusions to `.github/workflows/preview-verification.yml` without first asking the user for confirmation using the AskUserQuestion tool.** Exclusions hide potential problems and should be deliberate decisions, not automatic fixes. + +Before proposing an exclusion, you MUST: +1. Investigate the root cause of the failure +2. Attempt to fix the actual problem (broken URL, missing anchor, etc.) +3. If an exclusion is truly needed, use AskUserQuestion to explain the situation and get explicit approval +4. Document why the exclusion is necessary in the commit message +