docs(ci): add paths-filter self-test policy to ci-standards.md - #43
Open
jdwillmsen wants to merge 1 commit into
Open
docs(ci): add paths-filter self-test policy to ci-standards.md#43jdwillmsen wants to merge 1 commit into
jdwillmsen wants to merge 1 commit into
Conversation
Default going forward: an allowlist paths: filter includes the workflow's own .github/workflows/<file>.yml path, so editing the workflow re-triggers it. Exception path (written reason + forced-run procedure) is defined for cases where self-testing wouldn't exercise anything real. paths-ignore: denylists don't have this failure mode by construction and need no change. workflow_run-triggered workflows are called out as structurally out of scope for this policy, not newly exempted by it. Closes the deliverable from JDWLABS-452, which also fixed the two real instances found (infrastructure/terraform.yml, infrastructure/bootstrap.yml). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TrYLd68mqFxfDFuqnPJCy7
Merged
3 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/ci-standards.md: the org-wide policy that an allowlistpaths:filter must include the workflow's own.github/workflows/<file>.yml, with a documented-exception path for cases where self-testing on an edit wouldn't exercise anything real.bootstrap.yml/terraform.ymlblind-spot note in §1 to point at the fix (both now carry their own path — see the companioninfrastructurePR).paths-ignore:denylists don't have this failure mode by construction (a workflow YAML change never matches**/*.md/docs/**) and calls outworkflow_run-triggered workflows (update-pages.yml) as structurally out of scope for this policy rather than newly exempted.paths:/paths-ignore:usage: the only two allowlistpaths:filters missing their own path wereinfrastructure/terraform.ymlandinfrastructure/bootstrap.yml(fixed in the companion PR).apps,deployments, andplatformonly usepaths-ignore:(doc-skip), which is not a blind spot.Test plan
security-scan.yml'spaths-ignore: ['**/*.md', 'docs/**']means this PR itself won't trigger that scan, which is expected and correct per the policy this PR documentsRefs JDWLABS-452. Companion PR making the two mechanical fixes this policy is written against: jdwlabs/infrastructure#142
🤖 Generated with Claude Code
https://claude.ai/code/session_01TrYLd68mqFxfDFuqnPJCy7