MerlijnW70/sota-scan
요약
이 글은 Claude Code용 애드온인 'MerlijnW70/sota-scan' 도구를 소개합니다. 이 도구는 사용자의 프로젝트를 최고 수준의 실제 프로젝트와 비교하여, 부족한 점(gap)을 성적표와 할 일 목록 형태로 제공합니다. 이를 통해 개발자는 객관적인 피드백과 구체적인 개선 방향을 얻을 수 있습니다.
핵심 포인트
- 최고 수준 프로젝트와의 격차를 명확히 파악할 수 있습니다.
- 모호한 조언 대신 실제 구현된 프로젝트를 근거로 제시합니다.
- 성적표와 할 일 목록 형태로 체계적인 피드백을 제공합니다.
- 다양한 스캔 모드(quick, standard, exhaustive)가 있어 필요에 따라 사용할 수 있습니다.
프로젝트에 적용해 보세요. 이 도구는 한 가지 질문을 합니다:
"제가 부족한 점은 최고의 프로젝트들이 무엇을 가지고 있나요?"
이 도구는 사용자의 분야에서 최고 수준의 실제 프로젝트들을 확인하고, 이를 사용자의 프로젝트와 비교합니다. 그리고 성적표(scorecard)와 할 일 목록(to-do list)을 제공합니다.
모든 격차(gap)는 이미 그것을 구현한 실제 프로젝트를 가리킵니다. 모호한 조언이나 불필요한 내용은 없습니다.
🪞 솔직한 거울. 사용자가 실제로 어디에 서 있는지 보여줍니다.
🎯 공정한 경쟁. 접근 방식별로 프로젝트들을 분류합니다. 무작위 집합이 아닌, 실제 동료들과 비교합니다. 다른 스타일에서 가져온 아이디어는 선택 사항으로 표시되며, 결코 감점 요인이 되지 않습니다.
🧾 의견이 아닌 증거(Receipts). 모든 격차에는 실제 프로젝트가 이름 붙여져 있습니다.
✅ 실제 할 일 목록. 순위별로 나열됩니다. 가장 부족한 것부터 시작하며, 다음 단계까지 제시합니다.
📈 진행 상황 추적. 다시 실행하여 무엇이 개선되었는지 확인하세요.
🧭 SOTA Standing — my-project
Verdict: 핵심은 탄탄하지만, 테스트와 보안 측면에서 뒤처져 있습니다.
Score: █████░░░░░ 63% Standing: BEHIND vs 11 projects
...
이것은 Claude Code용 애드온입니다. 다음 두 파일을 복사하세요:
Mac / Linux
mkdir -p ~/.claude/skills/sota-scan ~/.claude/workflows
cp SKILL.md ~/.claude/skills/sota-scan/
cp workflows/sota-scan-fanout.js ~/.claude/workflows/```
**Windows**
New-Item -ItemType Directory -Force ~/.claude/skills/sota-scan, ~/.claude/workflows | Out-Null
Copy-Item SKILL.md ~/.claude/skills/sota-scan/
Copy-Item workflows/sota-scan-fanout.js ~/.claude/workflows/```
어떤 프로젝트에서든 Claude Code를 열고 이렇게 말하세요:
/sota-scan
또는 단순히 물어보세요:
"제 프로젝트가 최고 수준인가요?" 또는 "최고와 비교했을 때 제가 부족한 점은 무엇인가요?"
끝입니다. 나머지는 이 도구가 알아서 합니다.
| 말하기 | 얻게 되는 것 | 용도 |
|---|---|---|
/sota-scan quick | 상위 3가지 격차(top 3 gaps) | 빠른 점검 (a fast check) |
/sota-scan | 전체 성적표 (full scorecard) | 일상적인 사용 (everyday use) |
/sota-scan exhaustive | 가장 깊은 스캔 (the deepest scan) | 출시/투자자 준비 완료 (launch / investor ready) |
처음이신가요? quick으로 시작하세요. 저렴하고 빠른 맛보기입니다. 마음에 들면 더 깊게 파고들 수 있습니다.
실제 조사를 수행합니다. 단순히 요약본만 읽는 것이 아니라, 수십 개의 경쟁 프로젝트를 읽습니다. 따라서 즉각적이거나 무료는 아닙니다:
| 모드 | 대략적 시간 |
|---|---|
quick | |
standard | ~150–350k 토큰 · 몇 분 |
exhaustive | ~400k+ 토큰 · 수 분 |
필요할 때만 사용하세요 — 출시 전, 발표 자료 준비 시, 또는 궁금할 때 — 모든 커밋마다 사용하지 마세요. Claude 플랜에는 포함되어 있습니다. 토큰당 비용을 지불하는 경우? quick 모드를 이용하세요.
모든 스캔은 .sota/에 저장되므로 재실행하고 진행 상황을 추적할 수 있습니다. PR, 이슈 또는 문서에 넣을 복사본이 필요하신가요? 독립적인 Markdown 보고서를 내보내세요:
node scripts/sota-report.mjs --report # .sota/report.<도메인>.md 파일 작성
요약 + 등급, 기능 매트릭스, 높은 신뢰도의 격차점, 인용된 출처/공개 정보 추적 경로가 포함된 깨끗하고 독립적인 파일을 얻게 됩니다. 이는 **결정론적(deterministic)**입니다 — 동일한 스캔은 항상 동일한 보고서를 생성하므로 --check
플래그는 오래된 보고서에 경고를 표시하며, 어떤 플래그도 미리보기를 터미널에 제공하지 않습니다. 실제 예시: .sota/report.sota-benchmark-agent.md
Claude Code와 인터넷이 필요합니다. — 방향을 틀라고 말해주지 않습니다. 단지 이미 하고 있는 것에서 어떻게 승리할 수 있는지 알려줍니다.
자신을 스캔했고 최고 등급으로 나왔습니다 — 증거(그리고 공유 가능한 보고서)는 .sota/에 있습니다.
MIT 라이선스입니다. 사용하고 구축하는 데 무료입니다. LICENSE를 확인하세요.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기