Skip to content

docs: plans for pfv6#3124

Open
bennypowers wants to merge 2 commits intostaging/pfv6from
pfv6/plans
Open

docs: plans for pfv6#3124
bennypowers wants to merge 2 commits intostaging/pfv6from
pfv6/plans

Conversation

@bennypowers
Copy link
Copy Markdown
Member

@bennypowers bennypowers commented May 4, 2026

What I did

  1. draft claude skills:
  • /create-element
  • /review-a11y
  • /review-api
  • /review-demos
  • /update-element
  1. add CLAUDE.md orchestrator
  2. add .claude/ADVICE.md
  3. add .claude/V6-MIGRATION-PLAN.md
  4. add .claude/settings.json

@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented May 4, 2026

⚠️ No Changeset found

Latest commit: 10ad760

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@netlify
Copy link
Copy Markdown

netlify Bot commented May 4, 2026

Deploy Preview for patternfly-elements ready!

Name Link
🔨 Latest commit f061e3c
😎 Deploy Preview https://deploy-preview-3124--patternfly-elements.netlify.app/

To edit notification comments on pull requests, go to your Netlify site settings.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 4, 2026

✅ Commitlint tests passed!

More Info
{
  "valid": true,
  "errors": [],
  "warnings": [],
  "input": "docs: plans for pfv6"
}

@bennypowers
Copy link
Copy Markdown
Member Author

@adamjohnson please give a careful eye to the /review-a11y skill
@zeroedin please take a good look at the /review-api skill as well as the CLAUDE.md orchestrator

@bennypowers
Copy link
Copy Markdown
Member Author

@markcaron does the .claude/V6-MIGRATION-PLAN.md say enough about migrating the docs site?

@github-actions github-actions Bot added the AT passed Automated testing has passed label May 4, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 4, 2026

SSR Test Run for 4ea4c33: Report

@bennypowers bennypowers changed the base branch from main to staging/pfv6 May 4, 2026 15:24
Comment thread .claude/skills/review-demos/SKILL.md
@zeroedin
Copy link
Copy Markdown
Collaborator

zeroedin commented May 4, 2026

One other note make sure it updates to the latest cem version from the start, otherwise it tries to fumble through a lot of errors.

Update: ok a 2nd run i told it to fork from pfv6/plans first and it updated cem, first run went from main and had the older version.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 5, 2026

SSR Test Run for f061e3c: Report

Copy link
Copy Markdown
Collaborator

@adamjohnson adamjohnson left a comment

Choose a reason for hiding this comment

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

Added some comments to the review-a11y skill. We should probably test it on a component or two before letting the harness run wild on the rest of the components.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Should this file mention the ARIA APG Patterns somewhere? Consider adding a step in Phase 1 to identify the matching APG pattern and use it as the source of truth for expected roles and keyboard behavior.


For each demo, in each state the element supports:

#### Chrome
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Should we instruct the AI to run an axe-core or lighthouse a11y test, then triage the violations before manual inspection?

declaratively, they must (as of Spring 2026) use ARIA IDL attrs like
`element.ariaDescribedByElements`. Verify these relationships work via
ElementInternals ARIA IDL properties or other workarounds.
Flag any broken cross-root references.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Should we also tell the AI to verify a11ySnapshot assertions exist for each state and relationship in tests?

| Disabled | aria-disabled=true | aria-disabled=true | yes |

### Critical Issues
[Failures that break accessibility]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

We should probably instruct the AI to classify critical failures with an accompanying WCAG Success Critierion, at least for Critical Issues.


- All demos demonstrate accessible patterns (no bad advice)?
- No redundant ARIA roles on elements with implicit roles?
- Don't treat div as button, etc
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Consider adding, "Check for WCAG color contrast violations".

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

Labels

AT passed Automated testing has passed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants