TheOrcDev/shadscan

해결하는 문제

Shadscan은 shadcn/ui로 구축된 React 애플리케이션을 위한 결정론적 UI 감사 도구입니다. 개발 과정에서 자주 간과되는 명령어 메뉴, 접근성 제어, 모바일 동작과 같은 누락된 제품 세부 정보 및 UI 기본 요소를 식별하고, UI 품질을 0~100 사이의 점수로 정량화합니다.

작동 방식

이 도구는 프로젝트 코드에 대한 정적 소스 감사를 수행하여 62개의 결정론적 검사 규칙 세트와 비교 평가합니다. 또한 격리된 Chromium 브라우저를 사용하여 렌더링된 UI 검사를 수행하여 모바일 및 데스크톱 뷰포트에서의 수평 오버플로우와 같은 문제를 탐지할 수 있습니다. 결과는 수정, 결정, 권고로 분류되며, JSON으로 내보내거나 코드 에이전트용 프롬프트로 사용할 수 있습니다.

대상 사용자

shadcn/ui와 React(Next.js, React Router, TanStack Start, Astro 등)를 사용하는 프론트엔드 개발자 및 팀으로, 접근성, 상호작용, 프로덕션 품질 기준을 충족시키고자 하는 분들입니다.

주요 특징

• 결정론적 분석: AI 모델, 애플리케이션 시크릿, 앱 실행 없이 읽기 전용 스캔을 수행(소스 감사용).
• 에이전트 전달: 코드 에이전트가 수정을 구현할 수 있도록 복사 가능한 수정 계획을 생성.
• MCP 서버: AI 에이전트가 오디트 결과를 타입 지정된 도구 호출로 질의할 수 있는 Model Context Protocol 서버 제공.
• 다중 프레임워크 지원: 모노레포 및 하이브리드 Next.js 프로젝트를 포함한 다양한 React 환경에서 작동.
• CI/CD 통합: GitHub Action을 포함하여 스코어 하한선을 강제하고 GitHub Issues를 통해 발견 사항을 추적 가능.