9arm-skills 딥다이브
— 시니어 엔지니어의 작업 습관을 코드화한 Claude Code Skill 모음

거부 기반 게이팅

post-mortem은 작성 시작 전에 4개 입력(재현·근본원인·픽스·검증)을 모두 확인하지 못하면 한 줄도 쓰지 말고 무엇이 빠졌는지만 알려주고 멈추라고 명시한다. "그럴듯한 산문으로 빈칸을 채우는" LLM의 본성을 구조적으로 막는다.

Verbatim 암송 강제

debug-mantra는 4단 만트라 블록을 그대로 첫 응답에 출력하게 한다. 요약·축약·생략 금지. 이 의례적 반복이 LLM에게 "내가 어떤 모드에 들어왔는지"를 토큰 단위로 각인시킨다 — 일종의 self-prompting.

스킬 간 핸드오프

post-mortem SKILL.md는 명시적으로 "엔지니어 버전이 끝나면 management-talk에 넘겨라"를 적어 둔다. 스킬 하나가 모든 청중을 대응하지 않고, 책임을 분리해서 다른 스킬에 위임하는 마이크로서비스적 사고방식.

채널/청중 인지 출력

management-talk는 같은 내용을 JIRA · Slack · 비동기 스탠드업 · 이메일 · 미팅 토킹포인트 5가지 채널 형태로 분기해서 출력한다. "쓰는 사람이 매번 형식을 다시 고민하지 않게" 채널별 셰입을 스킬 안에 박아둔다.

SKILL.md의 황금 구조 7요소

1. YAML frontmatter — name, description. description에는 트리거 키워드를 모두 나열한다("/debug-mantra"는 물론 "버그", "재현", "디버그" 같은 자연어도)
2. 본문 첫 줄 — 한 문장 요약(시스템 프롬프트의 첫인상)
3. "When to invoke" / "When NOT to use" — 적용 범위를 양쪽에서 닫음
4. Required inputs — 거부 조건 (체크박스 형태가 LLM에게 잘 작동)
5. Structure / Workflow — 단계별 순서. "Do not skip ahead"를 명시
6. Rules — 종합 가드레일
7. Worked example — 실제 출력 한 통째

실습 아이디어: 본인이 자주 하는 작업 1개(예: "커밋 메시지 작성")를 골라 SKILL.md로 직접 작성. description에 자연어 트리거를 5개 이상 적고, "이 작업을 하면 안 되는 조건"을 3개 이상 명시.

4단 만트라 — 사람이 봐도 가치 있음

1. 재현성이 먼저다. 1~5초 안에 결정적 pass/fail이 나오는 repro를 먼저 만든다. 1% 플레이크는 디버그 불가, 50%는 가능 → 일부러 stress·sleep 주입해서 비율을 올린다
2. 실패 경로를 알라. 디버거 → 소스 트레이스 + knob 열거 → in-code 계측 순서. 로그 10개보다 브레이크포인트 1개가 낫다
3. 가설을 의심하라. 가설 1개가 아니라 3~5개를 랭킹. 증명보다 반증을 먼저 돌린다. 살아남으면 진짜
4. 모든 실행은 빵부스러기다. 세션 ledger를 유지. 새 가설이 나오면 ledger 전체와 일관성 검증

실습 아이디어: 최근에 자기가 잡은 버그 1개를 골라 이 4단계로 후행 정리(어디서 단계를 건너뛰었는지 보임). 로그 계측에 [DBG-7af3] 같은 고유 prefix 다는 습관 만들기. 다음 디버깅 세션에 ledger를 빈 텍스트 파일로 열어두고 매 시도마다 한 줄씩 기록.

코드/플랜 리뷰 — 외부자 시점의 4단계

1. Intent — 목표를 한 문장으로 다시 쓴다. 못 쓰면 underspecified, 거기서 멈춤. "더 간단한 방법이 있는가?"를 강제로 한 번 묻기
2. Trace — diff에 한정하지 말고 호출 그래프 전체를 따라간다. "버그는 이음새에 숨는다"
3. Verify — "이 PR은 X라고 주장한다. 내가 트레이스한 경로: A→B→C. C에서 [관찰]. 따라서 [성립/불성립]"
4. Report — 한 발견당 한 섹션. Finding/Why it matters/Evidence/Suggested change. 마지막에 ship/fix-then-ship/rework/reject 한 줄 평결

실습 아이디어: 오픈소스 PR 하나를 골라 이 스킬을 적용해 셀프 리뷰 작성. "No rubber-stamps" 규칙 — 자기 PR에서 LGTM 대신 "내가 트레이스한 것"을 적어 보기. "simpler alternative" 패스를 30초간 강제로 실행 — 정말 이게 필요한가?

9개 섹션 (Summary/Root cause/Fix/Validation은 필수)

1. Summary — 한 문단, "여기서 멈춰도 답이 맞을 것"
2. Symptom — 실제 관측된 것, 구체적 식별자
3. Root cause — 함수명/파일경로/SHA 환영. "이게 포스트모템이 존재하는 이유"
4. Why it produced the symptom — 원인과 증상 사이 체인
5. Fix — 무엇이 바뀌었고 왜 이 변경이 근본원인을 다루는가
6. How it was found — 디버깅 경로. 거부된 가설 + 한 줄 이유
7. Why it slipped through — CI 갭? 잠재 코드? 워크로드 갭? "사람이 아닌 시스템 갭"으로 적기 (blameless)
8. Validation — 정확히 무엇을 어디까지 테스트했는지. "다른 워크로드는 미검증"이라고 정직히 명시
9. Action items — 소유자+티켓 없이는 적지 말 것

Keep vs Strip vs Translate

안 좋은 예: "the kernel reads from scratchBuf == NULL"
좋은 예: "GPU들이 초기화되지 않은 버퍼를 읽으면서 절대 오지 않을 신호를 무한정 기다린다"

실습 아이디어: 자기가 최근 푼 기술 이슈를 JIRA / Slack / 스탠드업 / 이메일 4종으로 다시 써 보기 — 같은 내용, 다른 셸. "race condition"을 "타이밍 문제"로 바꾸지 말 것 — over-strip은 reader를 patronize한다는 룰 체득.

실습 1 — 9arm-skills 설치하고 한 번 돌려보기

레포를 clone → ./scripts/link-skills.sh 실행 → Claude Code에서 /debug-mantra를 호출해 만트라가 verbatim 출력되는지 확인. 출력이 어긋나면 그게 곧 SKILL.md 작성 학습 포인트.

실습 2 — "내 커밋 메시지 스킬" 만들기

9arm-skills의 SKILL.md 1개를 본떠 skills/personal/commit-message/SKILL.md를 만든다. YAML frontmatter, "When to invoke / When NOT to use", "Required inputs(예: 변경 diff 요약 + 이슈 번호)", "Structure"를 직접 채워본다.

실습 3 — 자기 회사 문화에 맞는 management-talk 변형

management-talk를 fork해서 자기 조직의 채널(예: Notion, Confluence, 사내 ChatOps)을 Channel shapes에 추가한다. Keep/Strip/Translate 표도 자기 도메인에 맞게 다시 작성.

실습 4 — 핸드오프 체인 만들기

3개 이상의 스킬이 명시적으로 서로를 참조하는 미니 워크플로우를 설계. 예: spec-write → code-review-prep → release-note. 각 SKILL.md에 "다음 단계는 X 스킬에 넘겨라"를 명문화.

실습 5 — "Refuse-to-draft Gate" 패턴 일반화

post-mortem의 4-input 거부 패턴을 추상화해서, 임의의 스킬에 끼울 수 있는 메타-스킬 require-inputs를 만든다. 입력 정의 → 체크 → 부족 시 stop 흐름을 다른 스킬이 import해서 쓸 수 있게.

Agent Skill 표준과 첫 스킬

Anthropic의 Agent Skills 공식 문서 정독 → SKILL.md YAML frontmatter 명세 이해 → 9arm-skills 4개를 그대로 설치해서 한 주간 사용 → 어떤 트리거가 잘 동작하고 어떤 트리거가 미스되는지 일지.

거부 기반 디자인과 단계 락

post-mortem의 "Required inputs" / debug-mantra의 "in order" 규칙을 패턴화. 직접 만든 스킬 1개에 거부 게이트와 단계 락을 적용. LLM이 진짜로 멈추는지, 우회해서 답하는지 테스트.

채널/청중 인지 출력

management-talk의 Keep/Strip/Translate를 자기 도메인에 적용. 같은 입력으로 5개 채널 출력을 생성해서 동료에게 보여주고 어색한 부분을 피드백 받는다. "race를 timing issue로 바꾸지 마라"의 미묘함이 보임.

스킬 컴포지션 / 핸드오프

여러 스킬을 묶은 워크플로우 설계. post-mortem → management-talk처럼 명시적 참조로 책임을 분리. 단일 거대 스킬보다 작고 합성 가능한 스킬이 왜 유지보수가 쉬운지 체득.

플러그인화 + 팀 배포

.claude-plugin/plugin.json 작성 → 사내 Git에 푸시 → 팀원이 git clone + link-skills.sh로 받아 쓰는 흐름 구축. 버전 관리, 변경점 공유, "personal/in-progress" 디렉토리 컨벤션 도입.

자기 조직 전용 Skill 라이브러리

회사 도메인 특화 스킬 5~10개 운영. autoresearch / skill-eval로 자동 평가 루프 도입. 사내 표준 코드 리뷰·릴리즈 노트·인시던트 RCA를 모두 스킬화 — 시니어의 암묵지를 조직 자산으로 결정화.