프로젝트 소개

Project Calavera는 웹 프로젝트용 린터, 포매터, TypeScript 구성, AI 에이전트 스킬, 훅 및 기타 공통 프로젝트 인프라를 스케폴딩하는 오픈소스 CLI 도구입니다. 빈 JavaScript, TypeScript, 라이브러리 프로젝트에 독립적으로 동작하거나 Vite+ 같은 프레임워크 스케폴딩 도구와 함께 보조 역할을 할 수 있습니다. 핵심 기능으로는 린팅/포매팅 도구 관리(Modern 프로필: Oxlint/Oxfmt/Stylelint, Classic 프로필: ESLint/Prettier/Stylelint 선택), `.js`, `.jsx`, `.ts`, `.tsx` 파일을 점검하는 TypeScript 구성 생성, CSS 품질 플러그인과 함께 Stylelint 설정이 포함됩니다. 또한 `.agents/` 아래 AI 스킬 및 에이전트 설치를 지원하고, `package.json` 스크립트를 관리하며, 반복 가능한 `calavera.config.json` 레시피 파일을 생성합니다. 이 도구는 npm, pnpm, Yarn, Bun 등 여러 패키지 매니저와 통합되며 각 패키지에 대해 문서화된 명령어 변형을 지원합니다. Claude Code, Codex, Cursor, OpenCode를 위한 프로젝트 로컬 MCP 서버 구성을 지원하여 `inspect_project`, `list_profiles`, `compose_recipe`, `dry_run_apply`, `apply_recipe` 같은 도구를 에이전트 네이티브 워크플로우에 노출합니다. Calavera에는 React 모범 사례(React Doctor 진단 포함), 임포트/모듈 규칙, Promise 안전성, Node 패키지 규칙, 테스트 규칙, Knip를 통한 미사용 파일/종속성 분석, HTML 유효성 검사, CSS 베이스라인 및 속성 유효성 검사, Varlock을 통한 환경 변수 스키마 유효성 검사를 아우르는 통합 카탈로그가 포함되어 있습니다. 선택사항으로 GitHub 저장소 제어는 정책 파일, Dependabot 구성, drift 검사를 위한 이식 가능한 Node.js 관리 스크립트를 생성합니다. CLI는 레시피 컴포지션(`init`), 더티런 미리보기를 통한 레시피 적용(`apply --dry-run`), 현재 프로젝트 도구 검사(`doctor`), 관리 중인 도구 업데이트(`update`), 오래된 파일 제거(`clean`) 명령을 제공합니다. 대화형 모드와 스크립트 모드 모두 지원되며, 브라우저 기반 레시피 컴포지션을 위한 Web UI도 제공됩니다. MCP 서버 등록은 프로젝트 로컬로만 이루어지며 Calavera는 전역이나 사용자 수준의 MCP 구성을 작성하지 않습니다. Bun 관리 프로젝트처럼 npm 11이 `devEngines.packageManager` 검사를 강제하는 경우 사전 실행 오류를 방지하기 위해 기존 프로젝트 패키지 매니저를 존중합니다.