Skip to content

feat: design review lite in /review and /ship + gstack-diff-scope (v0.6.3)#142

Merged
garrytan merged 4 commits intomainfrom
garrytan/review-qa-design-check
Mar 18, 2026
Merged

feat: design review lite in /review and /ship + gstack-diff-scope (v0.6.3)#142
garrytan merged 4 commits intomainfrom
garrytan/review-qa-design-check

Conversation

@garrytan
Copy link
Owner

Summary

  • Every PR touching frontend code now gets a design review automatically in /review (Step 4.5) and /ship (Step 3.5)
  • 20-item code-level design checklist with HIGH/MEDIUM/LOW confidence tags — catches AI slop, typography issues, accessibility gaps, !important abuse
  • Mechanical CSS fixes (outline:none, !important, font-size < 16px) are auto-fixed; design judgment calls ask the user
  • New bin/gstack-diff-scope helper categorizes branch changes (SCOPE_FRONTEND, SCOPE_BACKEND, SCOPE_PROMPTS, SCOPE_TESTS, SCOPE_DOCS, SCOPE_CONFIG)
  • Review Readiness Dashboard distinguishes "LITE" (code-level) vs "FULL" (visual audit) design reviews
  • E2E eval with planted CSS/HTML fixtures verifying detection of 7 design anti-patterns

Test Coverage

Step 3.4: All new code paths have test coverage.

  • generateDesignReviewLite() → covered by gen-skill-docs + skill-validation tests
  • TOUCHFILES entry → covered by touchfiles.test.ts
  • E2E eval → planted fixture with 7 anti-patterns, threshold ≥ 4/7

Pre-Landing Review

No issues found.

Design Review

No frontend files changed — design review skipped.

Eval Results

No prompt-related files changed — evals skipped.

TODOS

  • "Smart review relevance detection" updated to PARTIALLY SHIPPED — gstack-diff-scope provides the infrastructure, dashboard conditional row display is remaining work

Test plan

  • bun run gen:skill-docs — all 15 templates resolve
  • bun test — all free tests pass (skill validation, gen-skill-docs, touchfiles)
  • bun run skill:check — all skills healthy
  • gstack-diff-scope main — correctly categorizes changes

🤖 Generated with Claude Code

garrytan and others added 4 commits March 17, 2026 17:55
bin/gstack-diff-scope categorizes branch changes into SCOPE_FRONTEND,
SCOPE_BACKEND, SCOPE_PROMPTS, SCOPE_TESTS, SCOPE_DOCS, SCOPE_CONFIG.

review/design-checklist.md is a 20-item code-level checklist with
HIGH/MEDIUM/LOW confidence tags for detecting design anti-patterns
from source code.
Add generateDesignReviewLite() resolver, insert {{DESIGN_REVIEW_LITE}}
partial in review Step 4.5 and ship Step 3.5. Update dashboard to
recognize design-review-lite entries. Ship pre-flight uses
gstack-diff-scope for smarter design review recommendations.
Planted CSS/HTML fixtures with 7 design anti-patterns. E2E test
verifies /review catches >= 4 of 7 (Papyrus font, 14px body text,
outline:none, !important, purple gradient, generic hero copy,
3-column feature grid).
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@garrytan garrytan merged commit 28becb3 into main Mar 18, 2026
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