Skip to content

[NA] docs(agents): wire frontend-design-fidelity into the automated reviewer#7436

Draft
aadereiko wants to merge 1 commit into
sashaa/fe-design-fidelity-baz-skillfrom
sashaa/wire-fe-design-fidelity-reviewer
Draft

[NA] docs(agents): wire frontend-design-fidelity into the automated reviewer#7436
aadereiko wants to merge 1 commit into
sashaa/fe-design-fidelity-baz-skillfrom
sashaa/wire-fe-design-fidelity-reviewer

Conversation

@aadereiko

@aadereiko aadereiko commented Jul 11, 2026

Copy link
Copy Markdown
Collaborator

Details

Wires the frontend-design-fidelity skill (added in #7435) into the automated review flow. Adds a Design fidelity item to the Frontend review criteria in both .agents/commands/comet/review-github-pr.md and .agents/agents/code-reviewer.md.

The skill was orphaned — nothing in the review flow referenced it, so it only applied when manually invoked. This makes its design-drift checks part of the standard criteria that run automatically on any apps/opik-frontend/** change, so the design team's most-repeated comments (variant/size, typography scale, tokens vs raw hex/px, missing states, tooltips, dark-mode contrast) get caught before a designer sees them.

Based on #7435 so the referenced SKILL.md exists in the diff base — merge #7435 first, or merge them together. Docs-only — no runtime code changes.

Change checklist

  • User facing
  • Documentation update (agent/dev tooling)

Issues

  • N/A — no ticket ([NA])

AI-WATERMARK

AI-WATERMARK: yes

  • Tools: Claude Code
  • Model(s): Claude Opus 4.8
  • Scope: added a Design-fidelity reference to the two review-flow docs
  • Human verification: confirmed the skill was previously unreferenced (grep) and the additions sit in the correct Frontend sections

Testing

Docs-only; no code paths. Verified via grep that frontend-design-fidelity was referenced only by the skill file + README before this change, and now also by the reviewer command and agent.

Documentation

Updates internal agent/review documentation only. No external/product docs affected.

…eviewer

The frontend-design-fidelity skill (#7435) was orphaned — nothing in the
review flow referenced it, so it only ran when manually invoked. Reference
it from the Frontend review criteria in both the /review-github-pr command
and the code-reviewer agent, so its design-drift checks run automatically
on every apps/opik-frontend change.

Docs-only. The ESLint token guardrail (tailwindcss/no-arbitrary-value +
raw-hex) is intentionally NOT included here: the FE lint runs with
--max-warnings=0 and there are ~666 pre-existing arbitrary-value usages, so
enabling it now would break CI. It needs a separate cleanup-then-enforce
pass (tracked as a follow-up).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@aadereiko aadereiko requested review from a team as code owners July 11, 2026 09:10
@github-actions github-actions Bot added 🔵 size/XS documentation Improvements or additions to documentation labels Jul 11, 2026
@github-actions

Copy link
Copy Markdown
Contributor

⏱️ pre-commit per-hook timing

No linted files changed — nothing to run.

⏭️ 41 skipped (no matching files changed)
Hook Description Result
🐍 trim trailing whitespace — python sdk Strip trailing whitespace ⏭️
🐍 fix end of files — python sdk Ensure files end in a newline ⏭️
🐍 ruff — python sdk Lint + autofix Python (ruff) ⏭️
🐍 ruff-format — python sdk Format Python code (ruff) ⏭️
🐍 mypy — python sdk Static type check ⏭️
🤖 trim trailing whitespace — optimizer Strip trailing whitespace ⏭️
🤖 fix end of files — optimizer Ensure files end in a newline ⏭️
🤖 check yaml — optimizer Validate YAML syntax ⏭️
🤖 check json — optimizer Validate JSON syntax ⏭️
🤖 check toml — optimizer Validate TOML syntax ⏭️
🤖 check for added large files — optimizer Block large files (>1MB) ⏭️
🔐 detect private key — optimizer Block committed private keys ⏭️
🤖 check for merge conflicts — optimizer Block merge-conflict markers ⏭️
🤖 check for case conflicts — optimizer Block case-only name clashes ⏭️
🤖 pyupgrade — optimizer Modernize Python syntax ⏭️
🤖 ruff — optimizer Lint + autofix Python (ruff) ⏭️
🤖 ruff-format — optimizer Format Python code (ruff) ⏭️
🤖 mypy — optimizer Static type check ⏭️
📓 nbstripout — optimizer notebooks Strip notebook output ⏭️
📝 markdownlint — optimizer Lint Markdown ⏭️
🔤 codespell — optimizer Fix common misspellings ⏭️
📊 radon cc — optimizer Cyclomatic-complexity gate ⏭️
📊 radon raw — optimizer Raw size metrics gate ⏭️
📊 xenon — optimizer Fail on complexity thresholds ⏭️
📊 lizard — optimizer Cyclomatic-complexity gate ⏭️
🧹 vulture — optimizer Find dead code ⏭️
🛡️ trim trailing whitespace — guardrails Strip trailing whitespace ⏭️
🛡️ fix end of files — guardrails Ensure files end in a newline ⏭️
🛡️ ruff — guardrails Lint + autofix Python (ruff) ⏭️
🛡️ ruff-format — guardrails Format Python code (ruff) ⏭️
🛡️ mypy — guardrails Static type check ⏭️
⚓ helm-docs Regenerate Helm chart README ⏭️
block non-public FE plugins Block non-public FE plugins ⏭️
☕ spotless — java backend Format Java code ⏭️
🧪 pre-commit wrapper smoke tests Self-test the wrapper scripts ⏭️
🌐 eslint — frontend Lint + autofix JS/TS ⏭️
🌐 typecheck — frontend Whole-project tsc type check ⏭️
📘 eslint — typescript sdk Lint + autofix JS/TS ⏭️
📘 typecheck — typescript sdk Whole-project tsc type check ⏭️
⚙️ actionlint — github workflows Lint GitHub Actions workflows ⏭️
🐳 hadolint — dockerfiles Lint Dockerfiles ⏭️

@aadereiko aadereiko marked this pull request as draft July 11, 2026 10:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation 🔵 size/XS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant