Skip to content

chore(pr-quality): add proof-backed PR contract#8

Merged
BenSheridanEdwards merged 2 commits into
mainfrom
codex/chore/pr-quality-contract
Jun 29, 2026
Merged

chore(pr-quality): add proof-backed PR contract#8
BenSheridanEdwards merged 2 commits into
mainfrom
codex/chore/pr-quality-contract

Conversation

@BenSheridanEdwards

@BenSheridanEdwards BenSheridanEdwards commented Jun 29, 2026

Copy link
Copy Markdown
Owner

Why

AgenticProjectTemplate already had strong gates and a Definition of Done, but PR readiness was not surfaced at PR creation time. This adds a review-facing contract so agents have to carry local proof, visual evidence status, CI status, and risk into the PR body instead of leaving reviewers to infer it.

What Changed

  • Added .agents/project/PR_QUALITY.md as the tool-agnostic PR readiness contract.
  • Added .github/pull_request_template.md so every PR starts with proof, CI status, risk, rollback, and Definition of Done prompts.
  • Added the repo-local pr-quality-contract skill under .claude/skills/.
  • Linked the new contract from AGENTS.md, CLAUDE.md, .agents/README.md, .agents/project/DEFINITION_OF_DONE.md, and README.md.

Proof

  • pnpm verify
  • pnpm e2e
  • Visual proof attached or linked, or N/A with reason: N/A — docs, template, and skill-only change; no UI/CSS surface changed.
  • StyleProof reviewed, or N/A with reason: N/A — StyleProof passed with No visual changes.
  • Other proof: python3 /Users/agents/.codex/skills/.system/skill-creator/scripts/quick_validate.py .claude/skills/pr-quality-contract; pre-commit hook passed typecheck, staged Biome, Fallow, and gitleaks; pre-push hook passed coverage, build, and E2E.

CI Status

  • Latest-sha GitHub Actions are green.
  • Pending checks are named below.
  • Failing checks are named below with the fix plan.

Latest-sha checks are green: CI quality, Fallow, unit/component tests, production build, E2E behaviour map, security audit, CodeQL, Lighthouse, computed-style visual gate, and StyleProof.

Risk And Rollback

Low risk. This changes PR guidance, docs, and a repo-local skill; it does not change runtime code. Rollback is reverting the single commit if the contract is too strict or needs to be split differently.

Definition Of Done

  • Behaviour is covered by the E2E map when user-visible behaviour changed. (N/A — no product behaviour changed.)
  • Logic is unit-tested where logic changed. (N/A — no runtime logic changed.)
  • Accessibility was considered and verified for interactive/UI changes. (N/A — no UI changed; existing Playwright axe scan passed.)
  • The diff follows .agents/project/ARCHITECTURE.md and CONVENTIONS.md.
  • Any new architectural decision is recorded as an ADR. (N/A — this codifies existing PR proof expectations, no new architecture choice.)
  • No gates were bypassed or weakened.

@github-actions

Copy link
Copy Markdown

Fallow audit report

Found 1 finding.

Details
Severity Rule Location Description
minor fallow/unused-dev-dependency package.json:44 Package '@lhci/cli' is in devDependencies but never imported

Generated by fallow.

@github-actions

Copy link
Copy Markdown

Fallow audit report

0 inline findings selected for GitHub review.

@github-actions

Copy link
Copy Markdown

🗺️ StyleProof report

✓ No visual changes detected.

@BenSheridanEdwards BenSheridanEdwards merged commit c458da5 into main Jun 29, 2026
11 checks passed
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.

1 participant