AI 코딩 도구의 짜증 나는 부분

매 세션마다 에이전트는 다음 사항들을 잊어버립니다:

• 당신의 모듈 경계 (module boundaries)
• 파일 어디에도 명시되어 있지 않은 "모든 사용자는 조직(org)에 속한다"는 규칙
• 어떤 서비스가 어떤 이벤트를 방출하는지
• 당신이 기능을 구축하기를 원하는 방식 (테스트 우선? 명세 우선? 컨벤션?)

그래서 당신은 다시 설명합니다. 에이전트는 다시 작성합니다. 컨텍스트 (Context)는 어긋납니다. 토큰 (Tokens)은 낭비됩니다.

모든 프롬프트에 40k-토큰 분량의 AGENTS.md를 쏟아붓는 것은 전략이 아닙니다. 그것은 세금입니다.

저는 더 간단한 것을 원했습니다: 프로젝트 지식을 한 번만 작성하고, 에이전트가 이미 이해할 수 있는 형식으로 작성하여, 제가 실제로 사용하는 모든 도구에 설치하는 것입니다.

그것이 바로 cast-skills입니다.

npx cast-skills

그것은 무엇인가

cast-skills는 당신의 머신(또는 프로젝트)을 위한 **도구 간 AI 스킬 (cross-tool AI skills)**을 부트스트랩(bootstraps)하는 작은 CLI입니다:

스킬은 공개된 SKILL.md 형식을 사용합니다 — 점진적 공개 (progressive disclosure): 에이전트는 매 턴마다 위키 전체를 로드하는 것이 아니라, 필요한 것만 로드합니다.

cast-skills는 Anthropic의 Agent Skills 접근 방식을 기반으로 구축되었습니다: 매 세션마다 하나의 거대한 프롬프트를 로드하는 대신, 에이전트는 필요한 지식만을 점진적으로 로드합니다.

한 번의 설치. 여섯 가지 도구.

위저드(wizard)가 당신이 무엇을 가지고 있는지 자동으로 감지하고 올바른 위치에 스킬을 배치합니다:

네이티브 도구들은 SKILL.md를 그대로 가져갑니다. Cursor/Windsurf는 자동으로 변환된 형식을 사용하여 당신이 수동으로 여섯 개의 복사본을 유지 관리할 필요가 없게 합니다.

npx cast-skills
# 또는
npm i -g cast-skills && cast-skills

Node ≥ 18 버전이 필요합니다.

일반적인 기능 실행의 느낌

1. 당신은 "X 추가 / Y 수정 / Z 리팩터링"이라고 말합니다.
2. **using-project-skills**가 도메인 + 스택 + 컨벤션 (Conventions)을 로드합니다.
3. 당신이 수정 중인 코드에 대한 모듈 수준 (module-level) 스킬을 가져옵니다.
4. 해당 워크플로우가 존재하는 경우, 작업은 명세 기반 (spec-driven) 경로(명세 → 실패하는 테스트 → 구현)를 통해 유도됩니다.
5. 실제 변경이 이루어진 후, **explaining-changes**가 사람이 읽을 수 있는 설명글을 남길 수 있습니다.

핵심은 또 다른 챗봇 페르소나를 만드는 것이 아닙니다. 세션과 도구를 초월하여 유지되는 **안정적인 프로젝트 메모리 (stable project memory)**를 만드는 것입니다.

왜 이것을 Claude 전용으로 만들지 않았는가

우리 대부분은 하나의 환경(harness)에서만 살지 않습니다.

월요일: Claude Code.

화요일: 디자인 중심 UI에서의 Cursor.

수요일: 지루한 엔터프라이즈 레포지토리(repo)에서의 Copilot.

만약 "프로젝트 브레인 (project brain)"이 단 하나의 도구에서만 작동한다면, 당신은 화요일에 다시 설명을 반복해야 합니다.

cast-skills는 한 번 작성하면 → 스킬/규칙을 이해하는 모든 곳에서 실행되도록 최적화되어 있습니다.

이것이 아닌 것

• 완전한 코딩 에이전트가 아닙니다 (그것은 다른 제품 영역입니다).
• 모노레포 (monorepo)에 대한 마법 같은 RAG가 아닙니다 (스킬은 큐레이션된 지식이며, 자동 임베딩이 아닙니다).
• 좋은 아키텍처를 대체하는 것이 아닙니다 — 쓰레기 같은 컨벤션이 들어가면 쓰레기 같은 가이드가 나옵니다.

만약 팀에 컨벤션이 없다면, 부트스트래퍼 (bootstrapper)가 몇 가지 유용한 질문을 강제로 던질 것입니다. 그것은 기능(feature)입니다.

30초 만에 시도하기

cd your-repo
npx cast-skills

당신이 사용하는 도구들을 선택하세요 → 세 가지 스킬을 설치하게 합니다 → 실제 작업을 시작하고 에이전트가 당신의 아키텍처를 처음부터 마음대로 지어내지 않는지 확인하세요.

Repo: github.com/pedrocastanha/cast-skills

npm: npmjs.com/package/cast-skills

제가 실제로 원하는 피드백

만약 시도해 보신다면, 다음을 알려주세요:

1. 어떤 도구 조합을 사용하는지 (예: Claude + Cursor)
2. 위저드 (wizard)가 파일을 올바른 경로에 배치했는지
3. 당신의 팀이 가진 규칙 중 스킬이 되어야 하지만 명확하지 않은 것 하나

Issue와 PR은 언제나 환영합니다 — 특히 도구 업데이트에 따른 경로 수정(이러한 CLI들은 목표 지점을 자주 옮깁니다)은 더욱 환영합니다.