stalemap의 개요
stalemap은 모델의 학습 데이터 기준일 이후 API가 바뀐 프로젝트의 npm 의존성을 찾아 그 변경 사항을 코딩 에이전트에 전달합니다. 설정된 모델의 기준일을 models.dev에서 확인하고, 그보다 최소 30일 전에 나온 최신 안정 버전을 모델이 아는 버전으로 보고, 사용자가 고정한 버전과 비교합니다.
비교할 때는 두 버전의 .d.ts 타입 파일을 내려받아 TypeScript 컴파일러 API로 차이를 구하고, changelog와 GitHub Releases에서 호환성이 깨지는 변경 항목을 더합니다. 에이전트는 결과를 세 가지로 받습니다. AGENTS.md나 CLAUDE.md에 쓰이는 순위가 매겨진 메모 블록(기본 1,800토큰), 편집할 때마다 프로젝트 자체의 tsc를 실행해 각 오류에 맞는 메모를 붙이는 가드, 그리고 search_changes라는 MCP 도구입니다.
npm 패키지, Claude Code 플러그인, GitHub Action, Cursor·Codex·OpenCode용 설정 명령으로 제공됩니다. 코드는 MIT이며, 저장소는 2026년 10월 19일에 만들어졌고 최신 릴리스는 10월 20일의 0.4.1입니다.
stalemap, 쓸 만한 가치가 있습니까?
stalemap이 겨냥하는 실패는 구체적입니다. 에이전트는 사용자가 고정한 버전이 아니라 자신이 학습한 버전의 라이브러리에 맞춰 코드를 씁니다. README의 예는 AI SDK 7에 대한 maxSteps, zod 4에 대한 required_error, Next 16에 대한 middleware.ts입니다. 문서 페이지 전체를 가져오는 대신 두 버전의 타입 정의를 비교해, 내 코드가 import하는 API에서 바뀐 부분만 에이전트에 넘깁니다.
근거는 대부분의 에이전트 도구보다 탄탄합니다. 인기 npm 패키지 33개가 2026년 7월부 터 10월 사이에 낸 변경에서 뽑은 66개 과제로 진행한 블라인드 사전 등록 테스트에서, claude-sonnet-5-5는 stalemap과 함께 세션의 89%를 통과했고, 도움 없이는 68%, 편집마다 단순한 tsc --noEmit 훅을 돌렸을 때는 73%였습니다. 주요 비교의 구간은 13.6~28.3포인트였습니다. 작성자는 상한도 밝혔는데, 변경을 직접 짚는 손으로 쓴 한 줄 힌트는 98%에 도달했습니다. 도구, 테스트 환경, 프로토콜은 같은 작성자의 것이지만 과제는 별도 세션이 작성했고 독립 검토자가 확인했으며, 측정한 모델은 Claude 두 종뿐입니다.
공짜로 쓰는 것은 아닙니다. 세션당 비용 중앙값은 claude-sonnet-5-5에서 $0.041에서 $0.050으로, claude-sonnet-4-5에서는 $0.085에서 $0.124로 올랐고 세션 시간도 47초에서 79초로 늘었습니다. 코드는 컴퓨터 밖으로 나가지 않지만, 패키지 이름과 버전은 npm 레지스트리, GitHub, models.dev로 가고, 선택 모드인 --llm, --examples, --guides는 타입 diff와 import한 API 이름을 Claude에 보냅니다.
한계는 README에 분명히 적혀 있습니다. package.json은 하나만, 워크스페이스는 미지원이고, @types 패키지는 비교하지 않으며, 사용 추적은 import한 이름과 x.member 접근에서 멈추고, Cursor·Codex·OpenCode용 설정은 실제 설치 환경에서 시험하지 않았습니다. Context7은 최신 문서를 요청 시 제공해 더 많은 언어를 다룹니다. stalemap은 더 엄격한 도구로, 에이전트가 물어볼 생각을 하지 않아도 편집 시 가드가 낡은 호출을 잡아냅니다.
제 역할을 하는 곳
Claude Code로 Next.js 16과 AI SDK 7 앱을 만드는 1인 개발자
더는 컴파일되지 않는 middleware.ts와 maxSteps 코드를 에이전트가 쓰지 않게 하기
/plugin 명령 두 개로 Claude Code 플러그인을 설치합니다. 메모는 세션 시작 시 로드되고, 가드가 편집마다 컴파일 오류와 해결 방법을 알려 줍니다. 세션 비용이 조금 늘어, claude-sonnet-5-5 중앙값 기준 과제당 약 $0.009가 더 듭니다.
개발자 20명 규모 TypeScript 에이전시의 테크 리드
Renovate가 메이저 버전을 올릴 때 에이전트 지침을 최신으로 유지하기
메모 블록을 커밋하고 model 입력값과 함께 GitHub Action을 추가합니다. npx stalemap check는 블록이 낡으면 CI를 실패시키고, 댓글 모드는 의존성을 건드리는 풀 리퀘스트에 바뀐 내용을 게시합니다. 댓글 모드에는 pull-requests: write 권한이 필요합니다.
Claude Code 대신 Cursor나 Codex를 쓰는 개발자
작업 중인 에이전트에 필요할 때 최신 API 변경을 제공하기
stalemap setup --agent cursor(또는 codex)를 실행하면 메모 작성, MCP 서버 등록, 편집 후 가드 설치가 프로젝트 파일로 이뤄집니다. 작성자에 따르면 이 경로는 아직 실제 Cursor나 Codex 설치 환경에서 시험하지 않았습니다.
도입 전 확인할 점
- 설정
- Claude Code에서 /plugin marketplace add Umair/stalemap, 이어서 /plugin install stalemap@stalemap을 실행합니다. 또는 npx stalemap으로 미리 보고 npx stalemap sync로 블록을 씁니다. 어떤 MCP 클라이언트든 npx -y stalemap@latest mcp로 실행할 수 있습니다.
- 연동
- MCP 도구 4개(search_changes, package_changes, project_changes, check_notes), Claude Code의 SessionStart와 PostToolUse 훅, Cursor·Codex·OpenCode용 설정, GitHub Action, npm·pnpm·yarn·bun 잠금 파일 지원.
- 데이터와 개인정보
- 소스 코드는 로컬에서 분석되며 업로드되지 않습니다. 패키지 이름과 버전은 npm 레지스트리, GitHub, models.dev로 갑니다. --llm, --examples, --guides는 타입 diff, 릴리스 노트 발췌, import한 API 이름을 Claude에 보냅니다. 캐시는 ~/.cache/stalemap에 있습니다. MIT.
- 대규모 사용 시 비용
- 도구는 무료입니다. 작성자의 벤치마크에서 세션당 비용 중앙값이 claude-sonnet-5-5는 $0.041에서 $0.050으로, claude-sonnet-4-5는 $0.085에서 $0.124로 올랐습니다. Claude가 쓰는 선택형 요약은 내 키로 API 호출이 늘어납니다.
- 제한
- JavaScript와 TypeScript만 지원. package.json 하나. @types 패키지는 비교하지 않음. 동작 변경은 릴리스 노트나 업그레이드 가이드에 적힌 경우에만 감지. 에이전트가 올바른 메모를 무시하기도 함.
좋은 점
- 모델이 요약한 문서가 아니라 실제 타입 정의를 비교
- 편집 시 가드가 컴파일러 오류마다 해당 변경 메모를 붙임
- 상한과 비용까지 공개한 블라인드 사전 등록 벤치마크
- 소스 코드는 업로드되지 않고 분석은 로컬에서 진행
- Claude Code 플러그인, MCP 서버, CLI, GitHub Action
아쉬운 점
- JavaScript와 TypeScript만 지원, package.json 하나, 워크스페이스 미지원
- 세션 비용 중앙값 상승, claude-sonnet-5-5에서 약 22%
- Cursor, Codex, OpenCode 설정은 실제 환경에서 미검증
- 메인테이너 한 명, 2026년 10월 19일 생성
추천 대상
Next.js, AI SDK, zod처럼 빠르게 바뀌는 패키지의 예전 버전에 맞춰 코딩 에이전트가 계속 코드를 쓰는 TypeScript 개발자.
stalemap: 자주 묻는 질문
- stalemap, 쓸 만한 가치가 있습니까?
- 실제로 비용이 큰 문제를 겨냥한 좁은 해법이며 보기 드물게 꼼꼼한 벤치마크가 뒷받침하지만, JavaScript와 TypeScript 전용이고 메인테이너는 한 명뿐입니다. 평점은 5점 만점에 3.8점입니다.
- stalemap의 가격은 얼마입니까?
- MIT로 무료입니다. 선택 기능 --llm, --examples, --guides는 사용자의 Anthropic 키나 Claude Code 로그인으로 Claude를 호출합니다.
- stalemap의 단점은 무엇입니까?
- JavaScript와 TypeScript만 지원, package.json 하나, 워크스페이스 미지원; 세션 비용 중앙값 상승, claude-sonnet-5-5에서 약 22%; Cursor, Codex, OpenCode 설정은 실제 환경에서 미검증; 메인테이너 한 명, 2026년 10월 19일 생성.
- stalemap에 적합한 사람은 누구입니까?
- Next.js, AI SDK, zod처럼 빠르게 바뀌는 패키지의 예전 버전에 맞춰 코딩 에이전트가 계속 코드를 쓰는 TypeScript 개발자.
- 팀이나 프로덕션 환경에서 stalemap의 비용은 얼마입니까?
- 도구는 무료입니다. 작성자의 벤치마크에서 세션당 비용 중앙값이 claude-sonnet-5-5는 $0.041에서 $0.050으로, claude-sonnet-4-5는 $0.085에서 $0.124로 올랐습니다. Claude가 쓰는 선택형 요약은 내 키로 API 호출이 늘어납니다.
- stalemap에 회사 데이터를 맡겨도 안전합니까?
- 소스 코드는 로컬에서 분석되며 업로드되지 않습니다. 패키지 이름과 버전은 npm 레지스트리, GitHub, models.dev로 갑니다. --llm, --examples, --guides는 타입 diff, 릴리스 노트 발췌, import한 API 이름을 Claude에 보냅니다. 캐시는 ~/.cache/stalemap에 있습니다. MIT.
답변 확인일: 2026년 11월 5일.