소프트웨어 개발의 '소프트한 부분' — 기획 검토, 문서화, 커뮤니케이션 — 을 자동화하는 툴킷입니다.
코드를 짜는 것은 일의 일부일 뿐입니다. SoftKit은 그 주변의 일을 돕는 Claude 플러그인입니다. 지금은 커뮤니케이션과 리뷰 두 갈래를 담고 있습니다. 세션에 묻혀 있던 공유거리와 확인받을 질문을 끄집어내 대상별 메시지 초안으로 만들고, 보낼 문장을 상대에 맞게 다듬어 주며, 내가 리뷰해야 할 PR을 대기 오래된 순으로 정리해 줍니다.
코드 자체는 짝꿍인 HardKit이 담당합니다.
커뮤니케이션
surface스킬 — 현재 세션에서 팀에 공유할 내용과, 아직 누군가의 답이 필요한 모호한 지점을 끄집어낸 뒤, 대상별 전달용 메시지 초안을 만들어 줍니다. 초안만 만들며 직접 전송하지는 않습니다.communicator에이전트 — 개발 맥락을 특정 대상에게 맞는 명확하고 적절한 톤의 메시지로 바꿔 주는 범용 소통 전문가입니다. 이미 써 둔 초안을 넘기면 원문을 살려 최소한만 고치고, 초안 없이 맥락만 주면 새로 씁니다. 단독으로도 쓰이고,surface가 초안을 작성할 때 문장 작성 엔진 역할도 합니다.
리뷰
to-review스킬 — 내가 리뷰어로 등록된 열린 PR을 한눈에 보여줍니다. PR마다 본문에서 뽑은 한줄요약, 리뷰가 요청된 시점부터의 대기 시간, 변경 파일 규모(파일 수 + 증감 라인)를 카드형 리스트로 정리하며, 대기가 오래된 순으로 보여줍니다. 조회·요약 전용이라 GitHub에 코멘트/approve를 남기지 않습니다. (GitHub CLI(gh) 로그인 필요)
기획·공수·플래닝·문서 관련 킷이 이어서 추가될 예정입니다.
Claude Code에서 아래 두 명령으로 설치합니다.
/plugin marketplace add https://github.com/khs3994/SoftKit
/plugin install softkit@softkit
설치가 끝나면 surface·to-review 스킬과 communicator 에이전트가 활성화됩니다.
repo를 클론한 뒤 로컬 경로로 마켓플레이스를 추가해도 됩니다.
git clone https://github.com/khs3994/SoftKit
/plugin marketplace add ./SoftKit
/plugin install softkit@softkit
플러그인 파일을 수정한 뒤에는 /plugin marketplace update softkit 로 새로고침하거나 세션을 다시 시작하면 반영됩니다.
/surface— 대화를 어느 정도 진행한 뒤 "이 내용 팀에 공유하고 확인받을 것 정리해줘" 같은 상황에서 실행합니다. 진행/결정/확인필요/블로커를 뽑아 대상별 초안을 만들어 줍니다./to-review— "내가 리뷰할 PR 목록 보여줘", "리뷰 대기 얼마나 됐지" 같은 상황에서 실행합니다. 리뷰 요청받은 PR을 요약·대기시간·변경규모와 함께 대기 오래된 순으로 정리해 줍니다.communicator(에이전트 — 슬래시 커맨드가 아닙니다) — 보낼 문장을 두고 "이거 슬랙에 보낼건데 개선해줘", "말투 좀 부드럽게 해줘", "비개발자도 알아듣게 써줘", "기획팀한테 이거 어떻게 물어보지"라고 하면 자동으로 호출됩니다. 초안이 이미 있으면 원문을 살려 최소한만 고치고 무엇을 왜 고쳤는지 함께 알려 주며, 초안이 없으면 맥락에서 새로 씁니다.
surface와 communicator의 구분: 손볼 원문이 아직 없고 세션에서 소통거리를 발굴해야 하면 surface, 보낼 문장을 쓰거나 이미 쓴 문장을 고치는 것이면 communicator입니다.
MIT