Skip to content

feat(.ai): adds skills mindset/personas#6139

Open
marissahuysentruyt wants to merge 21 commits intomainfrom
marissahuysentruyt/feat-skills-mindset
Open

feat(.ai): adds skills mindset/personas#6139
marissahuysentruyt wants to merge 21 commits intomainfrom
marissahuysentruyt/feat-skills-mindset

Conversation

@marissahuysentruyt
Copy link
Copy Markdown
Collaborator

@marissahuysentruyt marissahuysentruyt commented Apr 3, 2026

Description

⚠️ SECOND PARALLEL MERGE ⚠️
Can be merged directly into feat-agnostic-ai-folder-stuff before or after the washing machine skills PR #6127

Adds a Mindset block near the top of .ai/skills/*/SKILL.md files so agents load a short role and quality bar before using a skill. Mindsets are tailored per skill (e.g. accessibility auditor vs code archaeologist vs requirements analyst).

Fixed conventional-commits so it has clearer lowercase-subject wording, body bullet continuation indentation, and examples refactored to leading - bullets were aligned with the skill’s actual body guidelines.

Motivation and context

Skills already described "what" to do; mindsets anchor "how" the agent should show up (verify vs assume, ask vs guess, reader-first docs).

Related issue(s)

sc-1890

Screenshots (if appropriate)


Author's checklist

  • I have read the CONTRIBUTING and PULL_REQUESTS documents.
  • I have reviewed at the Accessibility Practices for this feature, see: Aria Practices
  • I have added automated tests to cover my changes.
  • I have included a well-written changeset if my change needs to be published.
  • I have included updated documentation if my change required it.

Reviewer's checklist

  • Includes a Github Issue with appropriate flag or Jira ticket number without a link
  • Includes thoughtfully written changeset if changes suggested include patch, minor, or major features
  • Automated tests cover all use cases and follow best practices for writing
  • Validated on all supported browsers
  • All VRTs are approved before the author can update Golden Hash

Manual review test cases

  • Skim each updated SKILL.md
    • Mindset sits after intro / frontmatter and before “When to use”
    • Confirm tone matches the skill’s purpose without contradicting later sections.
  • conventional-commits: Examples still match commitlint expectations (lowercase subjects, sensible bodies); diff is copy/format only, no accidental rule changes.

Device review

  • Did it pass in Desktop?
  • Did it pass in (emulated) Mobile?
  • Did it pass in (emulated) iPad?

Accessibility testing checklist

Required: Complete each applicable item and document your testing steps (replace the placeholders with your component-specific instructions).

  • Keyboard
    Documentation only.

  • Screen reader
    Documentation only.

@changeset-bot
Copy link
Copy Markdown

changeset-bot bot commented Apr 3, 2026

⚠️ No Changeset found

Latest commit: 0a8340b

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

@marissahuysentruyt marissahuysentruyt force-pushed the marissahuysentruyt/feat-agnostic-folder-ai-stuff branch from 1eea82a to 46dfc1d Compare April 6, 2026 12:22
@marissahuysentruyt marissahuysentruyt force-pushed the marissahuysentruyt/feat-skills-mindset branch from 2da7b64 to fb70c0b Compare April 6, 2026 12:49
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 6, 2026

📚 Branch Preview Links

🔍 First Generation Visual Regression Test Results

When a visual regression test fails (or has previously failed while working on this branch), its results can be found in the following URLs:

Deployed to Azure Blob Storage: pr-6139

If the changes are expected, update the current_golden_images_cache hash in the circleci config to accept the new images. Instructions are included in that file.
If the changes are unexpected, you can investigate the cause of the differences and update the code accordingly.

@marissahuysentruyt marissahuysentruyt changed the title Marissahuysentruyt/feat skills mindset feat(.ai): adds skills mindset/personas Apr 6, 2026
@marissahuysentruyt marissahuysentruyt self-assigned this Apr 6, 2026
@marissahuysentruyt marissahuysentruyt added Status:WIP PR is a work in progress or draft do-not-merge NO MERGE-Y! labels Apr 6, 2026
…skill

- The a11y migration analysis doc is a full authoring playbook, not a
linting rule. Moves it from .ai/rules/ to .ai/skills/ with a SKILL.md
that mirrors the component-migration-analysis skill structure.

- Also fixes a stale .cursor/ path reference in
component-migration-analysis/SKILL.md.
- Delete .cursor/README.md and .cursor/config.json
- Delete all skill files under .cursor/skills/
@marissahuysentruyt marissahuysentruyt force-pushed the marissahuysentruyt/feat-agnostic-folder-ai-stuff branch from 7bdadee to 117b2a4 Compare April 8, 2026 17:21
@marissahuysentruyt marissahuysentruyt force-pushed the marissahuysentruyt/feat-skills-mindset branch from fb70c0b to 98fbdec Compare April 8, 2026 17:26
@marissahuysentruyt marissahuysentruyt added 1.0.0 Issues that should be addressed for a 1.0 release! 2nd gen These issues or PRs map to our 2nd generation work to modernizing infrastructure. Component:Tooling Issue or PR dealing with scripts, workflows, automation, etc. Component prefix is for Jira labels Apr 8, 2026
Base automatically changed from marissahuysentruyt/feat-agnostic-folder-ai-stuff to main April 13, 2026 19:25
@caseyisonit caseyisonit marked this pull request as ready for review April 13, 2026 19:51
@caseyisonit caseyisonit requested a review from a team as a code owner April 13, 2026 19:51
@caseyisonit caseyisonit added Status:Ready for review PR ready for review or re-review. and removed Status:WIP PR is a work in progress or draft do-not-merge NO MERGE-Y! labels Apr 13, 2026
@caseyisonit caseyisonit self-assigned this Apr 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

1.0.0 Issues that should be addressed for a 1.0 release! 2nd gen These issues or PRs map to our 2nd generation work to modernizing infrastructure. Component:Tooling Issue or PR dealing with scripts, workflows, automation, etc. Component prefix is for Jira Status:Ready for review PR ready for review or re-review.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants