chore(ai): AI harness (skills, agents, cursor/copilot rules, browse tooling) - #1709
Draft
brtbrt wants to merge 2 commits into
Draft
chore(ai): AI harness (skills, agents, cursor/copilot rules, browse tooling)#1709brtbrt wants to merge 2 commits into
brtbrt wants to merge 2 commits into
Conversation
…browse tooling) Collects the AI-development harness that was mixed into the sidenav-bar branch: - .claude/.cursor/.github agent skills and instructions - agents/ skills + README, scripts/browse-story.js, scripts/open-story.js - AGENTS.md guidance, browse yarn script, lint-staged patterns - .gitignore entries for local settings and the .component-specs cache
Contributor
There was a problem hiding this comment.
Pull request overview
This PR introduces an “AI harness” baseline for the repo: new agent skills documentation plus a yarn browse CLI to drive Storybook stories in a real browser (preferably the dockerized Chromium used in CI) for interaction, measurement, screenshots, and a11y inspection.
Changes:
- Add
yarn browsecommand and supporting Puppeteer utilities to open/drive Storybook stories and emit a JSON report. - Add vendor-neutral agent skills documentation (
agents/skills/*) and link/expand always-on agent rules inAGENTS.md. - Adjust
lint-stagedpatterns to avoid Prettier issues with symlinks while still formatting relevant.githuband.claudefiles; add ignores for local AI caches/settings.
Reviewed changes
Copilot reviewed 15 out of 16 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| scripts/open-story.js | New Puppeteer helper to open Storybook stories via local browser or dockerized Chromium; provides measure/find helpers. |
| scripts/browse-story.js | New yarn browse CLI to apply scripted steps (click/hover/press/measure/shot/a11y/html) and print a JSON report. |
| package.json | Adds browse script and updates lint-staged globs to avoid symlink/prettier issues. |
| agents/skills/run-in-browser/SKILL.md | Documents the “run in CI browser” workflow and the yarn browse interface. |
| agents/skills/read-component-specs/SKILL.md | Documents a workflow for consolidating component specs from issue/spec markdown/Figma. |
| agents/README.md | Explains skill structure and symlink-based vendor integration paths. |
| AGENTS.md | Expands repo-wide agent rules (including guidance to use yarn browse). |
| .gitignore | Ignores local Claude settings and local .component-specs/ cache directory. |
| .claude/settings.json | Adds Claude hook prompting before running git commit* via Bash tool. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Comment on lines
+174
to
+176
| log('Starting the dockerized Chromium…'); | ||
| execSync(`docker compose -f ${DOCKER_COMPOSE_FILE} up -d`, {stdio: 'inherit'}); | ||
|
|
| const os = require('os'); | ||
| const path = require('path'); | ||
| const {execSync} = require('child_process'); | ||
| const puppeteer = require('puppeteer'); |
Comment on lines
+64
to
+72
| if (STEP_FLAGS.has(arg)) { | ||
| const next = argv[index + 1]; | ||
| const takesValue = arg !== '--a11y' && (arg !== '--shot' || (next && !next.startsWith('--'))); | ||
| steps.push({kind: arg.slice(2), value: takesValue ? next : undefined}); | ||
| if (takesValue) { | ||
| index++; | ||
| } | ||
| continue; | ||
| } |
|
Size stats
|
|
Accessibility report ℹ️ You can run this locally by executing |
|
Deploy preview for mistica-web ready!
Deployed with vercel-action |
brtbrt
marked this pull request as draft
August 26, 2026 16:26
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
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.
No description provided.