pro-workflow (Claude Skill) — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

수정 사항을 파일/기능 범위에 연결된 지속적인 규칙으로 캡처
작업 시작 시 관련 규칙을 표시 (세션마다 다시 말할 필요 없음)
동시 에이전트 스레드를 위한 병렬 git worktree 오케스트레이션
50개 이상의 세션에 걸쳐 축적 — 측정 가능한 드리프트 감소
버전 관리가 있는 CLAUDE.md 자동 편집

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pro-workflow-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/rohitg00/pro-workflow",
        "~/.claude/skills/pro-workflow"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "pro-workflow-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/rohitg00/pro-workflow",
        "~/.claude/skills/pro-workflow"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "pro-workflow-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/rohitg00/pro-workflow",
        "~/.claude/skills/pro-workflow"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pro-workflow-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/rohitg00/pro-workflow",
        "~/.claude/skills/pro-workflow"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "pro-workflow-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/rohitg00/pro-workflow",
        "~/.claude/skills/pro-workflow"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "pro-workflow-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/rohitg00/pro-workflow",
          "~/.claude/skills/pro-workflow"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add pro-workflow-skill -- git clone https://github.com/rohitg00/pro-workflow ~/.claude/skills/pro-workflow

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: pro-workflow

Claude Code에게 같은 것을 두 번 수정하는 것을 멈추기

👤 매일 Claude Code를 사용하는 분 ⏱ ~10 min beginner

언제 쓸까: Claude에게 'lodash isEmpty 사용, !arr.length 금지'를 세 번 말했는데 계속 되돌아갈 때.

사전 조건

저장소에 Skill 설치 — git clone https://github.com/rohitg00/pro-workflow ~/.claude/skills/pro-workflow

흐름

다음 수정 사항 캡처

Use pro-workflow. Capture this rule: 'Use lodash isEmpty for emptiness checks; never !arr.length'. Scope: src/utils/.✓ 복사됨

→ 범위와 함께 규칙 저장됨; CLAUDE.md 업데이트됨
다음 세션에서 확인

Tomorrow: ask Claude to clean up an empty-check pattern in src/utils/.✓ 복사됨

→ Claude가 다시 설명하지 않아도 isEmpty 사용
월간 규칙 세트 감사

List all captured rules. Anything stale or superseded?✓ 복사됨

→ 마지막 적용 날짜가 있는 규칙 목록; 불필요한 것 정리

결과: 각 수정은 한 번만 지불, 매주가 아니라.

함정

너무 넓은 규칙('항상 함수형 스타일 사용')이 역효과 — 규칙을 디렉토리나 기능 영역으로 범위 지정; 구체적인 것 > 일반적인 것

함께 쓰기: filesystem

같은 저장소에 두 Claude Code 스레드를 충돌 없이 실행

👤 긴 에이전트 작업을 실행하는 개발자 ⏱ ~20 min intermediate

언제 쓸까: Claude가 모듈 B에서 기능을 계속하는 동안 모듈 A를 리팩토링하고 싶을 때.

흐름

worktree 생성

Use pro-workflow. Create two worktrees: ../wt-refactor-a and ../wt-feature-b from main.✓ 복사됨

→ Worktree 생성됨; 각각에 규칙 동기화됨
스레드 실행

Start a Claude Code session in each. Worktree-aware rules apply per directory.✓ 복사됨

→ 두 세션 모두 실행 중; 비행 중 병합 충돌 없음
재통합

When both branches are ready, open PRs. The skill notes any rules that triggered and their effects.✓ 복사됨

→ PR에 규칙 효과 요약 포함

결과: 실제 병렬성 — 조정 비용 없이 에이전트 처리량 배가.

함정

규칙이 한 worktree에서만 업데이트되면 diverge — Skill이 worktree 생성 시 규칙 세트를 동기화함; 지속적인 편집에는 sync-rules 실행

50개 세션에 걸쳐 컨텍스트가 어떻게 축적되는지 감사

👤 AI 워크플로우를 평가하는 엔지니어링 리더 ⏱ ~30 min advanced

언제 쓸까: 'AI가 이 저장소에서 시간이 지날수록 더 똑똑해진다'는 것이 실제인지 감으로인지 데이터를 원할 때.

흐름

기준선

Use pro-workflow. Show me corrections per session over the last 30 days.✓ 복사됨

→ 트렌드 차트; 하향 기울기 예상
카테고리 태그

Categorize corrections: style, architecture, dependency choice, test pattern. Show category-wise decay.✓ 복사됨

→ 카테고리별 추세
결정

Recommend whether to roll this out team-wide based on data.✓ 복사됨

→ 주의사항이 있는 구체적인 권고

결과: 에이전트 워크플로우 투자에 대한 데이터 기반 결정.

함정

수정 감소 != 품질 향상 — 단지 검토를 멈췄을 수도 있음 — PR 리뷰 피드백 또는 테스트 실패율과 교차 확인

조합

다른 MCP와 조합해 10배 효율

pro-workflow-skill + filesystem

팀이 공유할 수 있도록 저장소에 규칙 영속화

Commit .claude/rules/ and CLAUDE.md to git; teammates inherit the same rule set.✓ 복사됨

pro-workflow-skill + claude-mem-skill

계층적 메모리 — 규칙에는 pro-workflow, 세션 연속성에는 claude-mem

Use pro-workflow to capture corrections; use claude-mem to bridge session context.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
capture_rule	rule_text, scope_path?, severity?	지속적인 사항에 대해 Claude를 수정한 직후
list_rules	scope?	감사 / 정리
create_worktree	branch, path	병렬 에이전트 스레드 시작
sync_rules	—	한 worktree에서 규칙을 업데이트한 후 다른 곳에 동기화
correction_stats	since?	트렌드 감사

비용 및 제한

운영 비용

API 쿼터: 없음 — 로컬
호출당 토큰: 표시된 규칙이 시스템 prompt에 100–800 token 추가; 정리가 중요
금액: 무료
팁: 월간 규칙 감사; 너무 넓거나 오래된 규칙은 영원히 token 비용 발생

보안

권한, 시크릿, 파급범위

최소 스코프: filesystem-read filesystem-write

자격 증명 저장: 저장소에 규칙 저장 (.claude/rules/) — 저장소 자체와 동일한 신뢰 수준

데이터 외부 송신: 없음

규칙으로 비밀 키를 캡처하지 않기 — 규칙은 git에 올라감

문제 해결

자주 발생하는 오류와 해결

다음 세션에서 규칙이 적용되지 않음

범위 경로 확인; 규칙이 편집 중인 파일보다 좁게 범위 지정됐을 수 있음

확인: list_rules --scope /the/file

CLAUDE.md 편집으로 병합 충돌 발생

Skill이 규칙을 별도 파일에 씀; CLAUDE.md의 인덱스만 변경됨 — rebase 전략 확인

Worktree 생성 실패

git 버전 >= 2.5 필요; 새 경로를 막는 추적되지 않은 파일이 없는지 확인

확인: git worktree list

50개 세션에서도 통계에 감소 없음

규칙이 너무 좁아 적용이 안 됨; 감사 실행 후 핵심 규칙 몇 개를 넓히기

대안

pro-workflow 다른 것과 비교

대안	언제 쓰나	단점/장점
claude-reflect (BayramAnnakov)	명시적 캡처 대신 더 수동적인 반성 기반 캡처를 원할 때	다른 캡처 스타일; worktree 오케스트레이션 없음
Manual CLAUDE.md curation	팀이 소규모이고 규칙을 직접 관리해도 괜찮을 때	분석 없음; 병렬 worktree 도움 없음

pro-workflow