vibemafiaclub/mafia-codereview-harness

CC harness for FULL-AUTO code review

GitHub에서 열기 ↗

GitHub 스타

포크

—

언어

미표기

라이선스

2026.03.27

최근 푸시

2026.05.13

별표한 날

AI 분석

설치 난이도: 쉬움

큐레이터 노트

Claude Code를 사용하는 팀이라면 코드리뷰 자동화를 위해 도입을 고려해볼 만한 가치가 있습니다. 다만, Claude Code 외 다른 도구와의 호환성은 낮으므로 현재 사용 중인 환경을 고려해야 합니다.

강점

Claude Code 플러그인으로 간단히 설치 가능하여 진입 장벽이 낮습니다.
설계 의도 작성부터 리뷰 반영 및 QA까지 전체 코드리뷰 파이프라인을 자동화합니다.
Sub-agent와 Fork를 활용한 병렬 처리로 효율성을 높였습니다.

약점

Claude Code에 종속되어 있어 다른 LLM 기반 도구로의 이전이 어렵습니다.
README에 구체적인 설정 예시나 커스터마이징 방법이 부족합니다.
오류 처리나 예외 상황에 대한 설명이 없어 실제 운영 시 문제 발생 가능성이 있습니다.

주의사항

Git과 함께 사용해야 최적의 효과를 볼 수 있으므로 Git 기반 프로젝트가 아닌 경우 적합하지 않을 수 있습니다.
설치 시 Claude Code의 플러그인 마켓플레이스 접근 권한이 필요합니다.
파이프라인 실행 시 base branch 확인 등 상태 점검을 수행하므로 브랜치 전략에 주의해야 합니다.

시작 가이드

Claude Code 환경에서 플러그인을 설치하고 Quick Start를 따라 테스트 실행해 봅니다.
docs/code-convention.yaml과 docs/adr.yaml을 프로젝트에 맞게 커스터마이징합니다.
파이프라인 실행 결과물인 .review-artifacts 디렉토리를 확인하여 산출물 품질을 평가합니다.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

MAFIA Code-Review harness

!flow.png

Claude Code 기반 코드리뷰 자동화 파이프라인.

Git과 함께 사용할 때 가장 효과적입니다.

하네스와 파이프라인에 대한 자세한 설명은 영상을 참고해주세요.

Quick Start

플러그인을 설치합니다.

   # claude code 실행
   claude

   # 플러그인 설치
   /plugin marketplace add vibemafiaclub/mafia-codereview-harness
   /plugin install mafia-codereview

docs/code-convention.yaml과 docs/adr.yaml를 복사한 뒤, 상황에 맞게 수정합니다.
Claude Code에서 /mafia-codereview:auto를 실행하세요.

파이프라인 흐름

/mafia-codereview:auto 실행
  → [1] 상태 점검 (base branch 확인)
  → [2] 설계의도 작성 (Fork)
  → [3] 평가기준 수립 (Fork + Sub-agent)
  → [4] PR 본문 생성 (Fork)
  → [5] 코드리뷰 실행 (Sub-agent, 자동)
  → [6] 리뷰 반영 + QA (Fork)

Skill 목록

	커맨드	설명
	`/mafia-codereview:auto`	전체 파이프라인 오케스트레이션
	`/mafia-codereview:write-intent`	설계의도 문서 작성
	`/mafia-codereview:gen-criteria`	평가기준 자동 생성
	`/mafia-codereview:create-pr-body`	PR 본문 생성
	`/mafia-codereview:review`	코드리뷰 실행
	`/mafia-codereview:reflect-review`	리뷰 반영 + QA
	`/mafia-codereview:update-docs`	code-convention / ADR 항목 관리

산출물

작업별 산출물은 .review-artifacts/{branch-name}/에 저장됩니다.

License

MIT

원본 저장소: vibemafiaclub/mafia-codereview-harness

라이선스: 미표기

게재 제외를 원하시면 삭제 요청을 보내주세요.