신규하 블로그

개발 기록 보관소

Claude Code 스킬 자동 발동 가이드

Development AI
핵심 요약 스킬 자동 발동은 ‘좋은 skill 설명 + 좋은 시작 프롬프트 + 적절한 프로젝트 메모리 + 필요한 곳만 수동 호출’ 조합일 때 가장 잘 됩니다. Claude Code는 skill의 description 필드를 보고 언제 쓸지 판단합니다. 관련 있을 때 자동으로 로드하거나 /skill-name으로 직접 호출할 수 있습니다. flowchart TD A[사용자 요청] --> B{description 매칭} B -->|키워드 일치| C[스킬 자동 발동] B -->|애매함| D[수동 호출 필요] C --> E[작업 수행] D --> F["/skill-name 직접 호출"] F --> E style A fill:#c5dcef style C fill:#c0ecd3 style D fill:#ffc8c4 style E fill:#fde8c0 더보기

Claude Code 프로젝트 구조 가이드: CLAUDE.md, hooks, skills, docs, tools, src를 어떻게 나눌까

AI Development Engineering
Claude Code를 조금만 깊게 써 보면 금방 부딪히는 문제가 있습니다. 규칙은 CLAUDE.md에 몰아넣고, 자동화는 훅에 넣고, 반복 작업은 스킬로 빼야 한다는 말은 알겠는데, 실제로 레포를 어떻게 나눠야 할지 애매합니다. 특히 프로젝트가 커질수록 “무엇을 항상 읽게 할지”, “무엇을 필요할 때만 불러올지”, “무엇을 문서로 남길지"가 섞이기 시작합니다. 이번 글은 temp/claude-structor.md의 간단한 구조 예시를 출발점으로, 실제로 운영 가능한 Claude Code 프로젝트 디렉터리 구조로 확장한 버전입니다. 단순히 폴더 이름만 나열하지 않고, 각 폴더가 왜 필요한지, 어떤 파일을 넣어야 하는지, 그리고 바로 가져다 쓸 수 있는 샘플 예제까지 같이 정리합니다. 더보기

pm-skills-ko 분석: 한국어 PM 스킬 마켓플레이스를 실제로 쓰기 좋은 구조로 옮긴 방식

AI Product Management Tools
lucas-flatwhite/pm-skills-ko 는 단순히 README만 한국어로 바꾼 저장소가 아닙니다. README, 플러그인 README, 커맨드 문서, SKILL 문서, 그리고 validate_plugins.py 까지 함께 보면, 이 저장소는 원본 pm-skills 를 한국어 사용자에게 바로 설치하고 실행할 수 있는 플러그인 컬렉션으로 재구성한 형태에 가깝습니다. 특히 흥미로운 지점은 세 가지입니다. 첫째, 루트 README가 전체 구조를 한 번에 설명하고, 둘째, 각 플러그인이 skills/, commands/, .claude-plugin/plugin.json 을 갖춘 독립 패키지처럼 정리되어 있으며, 셋째, 검증 스크립트가 이 구조가 실제 Claude Code 플러그인 규약에 맞는지 점검한다는 점입니다. 더보기

프롬프트 한 줄로 50분 AI 애니메이션 뽑는 매직 라이트 완전 정복

AI 영상 제작
AI 영상 제작 도구가 폭발적으로 발전하고 있습니다. 이제 전문적인 애니메이션 스튜디오가 아니더라도, 한 줄의 프롬프트만으로 고품질 애니메이션을 제작할 수 있는 시대가 도래했습니다. 이 글에서는 매직 라이트(Magic Light) 라는 AI 툴을 통해 프롬프트 한 줄로 최대 50분 길이의 애니메이션을 만드는 방법을 상세히 설명합니다. 더보기

Paperclip: AI 직원으로 구동되는 자율 회사 오픈소스 오케스트레이션

AI DevOps SaaS
AI 에이전트가 개발 작업, 글쓰기, 고객 지원을 자동화하는 시대가 되었지만, 여러 에이전트를 조율하고 관리하는 것은 여전히 큰 과제입니다. Claude Code 탭 20개를 열어두고 어디서 뭘 하는지 추적하기 어렵고, 재부팅하면 맥락이 사라지며, 루프가 돌면서 토큰이 수백 달러씩 날아가는 경험을 해보셨을 겁니다. Paperclip은 이러한 문제를 해결하기 위해 등장한 AI 직원들을 관리하는 조직 관리 시스템입니다. 오픈소스로 제공되며, 조직도, 목표 추적, 비용 관리, 거버넌스를 통합하여 에이전트가 아닌 회사를 운영할 수 있게 해줍니다. 더보기