Claude Code 플러그인으로 팀 LLM 활용 역량의 저점을 올리는 방법, AI Harness 구축 사례

요약

토스 글쓴이가 Software 3.0 시대 조직 생산성 저점(Floor)을 올릴 도구로 Claude Code 플러그인·마켓플레이스 생태계를 제시. 컨텍스트 엔지니어링 노하우 격차를 개인이 아니라 팀이 표준화·배포해 흡수, 플러그인은 사람이 보면 가이드 / LLM이 읽으면 시스템 프롬프트가 되는 Executable SSOT라는 입장.

내용

같은 모델·같은 IDE를 쓰는 팀 안에서도 결과물이 갈리는 지점은 작업 전 컨텍스트 설계 여부. A는 레포 코딩 가이드라인·lint 규칙·기존 코드 패턴을 LLM에 주입한 뒤 시작해 10분 만에 머지 가능한 결과를 받고, B는 "이 함수 리팩토링해줘"로 시작해 1시간 동안 "우리 팀은 이렇게 안 해"를 반복.

격차의 본질은 코딩 실력이 아니라 LLM Literacy — 컨텍스트 엔지니어링 노하우. 이걸 개인 센스에 맡기면 조직 손실. 글쓴이 입장은 이 격차를 흡수할 그릇이 Claude Code의 TUI + 플러그인 + 마켓플레이스라는 것. 터미널 안에서 자연어와 코드가 끊기지 않는 환경(Frictionless Harness)이 전제되어야 워크플로우가 팀에 저항 없이 전파 가능.

해결 / 접근

Executable SSOT — 문서 대신 플러그인

• 위키·노션 문서는 작성된 순간부터 낡음, 사람이 읽기 위한 형태이기 때문
• 플러그인은 사람에게는 가이드라인·매뉴얼, LLM에게는 시스템 프롬프트
• 플러그인 코드 업데이트 → 팀원들 에이전트 행동 양식 즉시 갱신

Marketplace 1.0 — 워크플로우 배포 플랫폼

• 시나리오 1 (규율 자동 교정): claude가 main에 git commit 시도 → 플러그인 Hook 감지 → "feature/ 브랜치 생성하고 작업하겠습니다" 식 행동 교정. 린터처럼 차단만 하는 게 아니라 팀 컨벤션에 맞춰 align
• 시나리오 2 (워크플로우 전파): /new-feature 슬래시 커맨드 한 줄로 Jira 이슈 발급 → 브랜치 생성 → 구현 계획 → 검토 승인 → 구현 → PR 생성. A 엔지니어 노하우를 B 엔지니어가 그대로 실행

컨텍스트 계층화 — Global / Domain / Local

• Global: 전사 공통 보안 정책·기본 코딩 스타일
• Domain: 결제·정산·회원 등 팀별 비즈니스 지식
• Local: 특정 레포 구현 디테일·프로젝트 특화 규칙
• 신입에게 회사 전체 문서를 한꺼번에 안 주듯, LLM에도 현재 작업에 필요한 계층만 주입

RAG 대비 마켓플레이스 방식의 이점 (글쓴이 주장)

• 예측 가능성: 하이브리드 서치·리랭커 점수에 따라 어떤 컨텍스트가 들어갈지 가시성이 떨어지는 RAG와 달리, 플러그인은 명시적 문서·코드라 LLM 입력 컨텍스트를 100% 통제
• Dev-Prod Parity: 로컬 TUI에서 검증한 플러그인을 Claude Agent SDK로 서버 에이전트 환경에 그대로 로드 가능

Software 1.0 시선의 재현

• 인증·로깅·결제 연동 같은 반복 기능을 사내 공통 라이브러리로 만들어 바퀴 재발명을 줄였던 플랫폼 엔지니어링의 연장선
• 공통 모듈 = AI 워크플로우 플러그인, 라이브러리 배포 = 마켓플레이스 업로드. 모듈 내부가 코드에서 프롬프트·에이전트 로직으로 바뀐 차이

Data Flywheel 가설 (장기 방향)

• 플러그인으로 규격화된 데이터 축적 → 도메인 특화 sLLM 파인튜닝 → 기존 워크플로우가 평가 기준 → 선순환
• 충분한 데이터 수집 기간, 품질 관리 프로세스, 조직의 지속 투자 의지가 전제

결과 / 참고

• 구체적 성공 사례·수치보다는 방향성 제안에 가까운 글
• 글쓴이 입장: LLM 활용 능력은 개인 센스에서 팀이 설계·배포해야 할 시스템 영역으로 이동 중
• 출처: toss tech (Software 3.0 연재 — 이전 글에서 Claude Code 구조를 레이어드 아키텍처에 비유)
• 사용 도구: Claude Code TUI, 플러그인, 마켓플레이스, Claude Agent SDK
• 참고된 오픈소스: oh-my-zsh, oh-my-claudecode, oh-my-opencode, Open Interpreter, OpenCode