Serena MCP-based symbolic refactoring plugin marketplace. Data-driven agent architecture for efficient code analysis, duplicate detection, strict quality gates, intelligent feature injection, systematic debugging workflows, and scientific experimentation laboratory.
npx claudepluginhub chkim-su/serena-refactorSerena MCP-based symbolic refactoring plugin with data-driven agent architecture. Direct daemon integration for SOLID analysis, duplicate detection, safe renaming, intelligent feature injection, systematic debugging, and scientific experimentation with parallel hypothesis testing. Hook-based workflow enforcement ensures code quality through automated gates.
Claude Code marketplace entries for the plugin-safe Antigravity Awesome Skills library and its compatible editorial bundles.
Curated collection of 141 specialized Claude Code subagents organized into 10 focused categories
Directory of popular Claude Code extensions including development tools, productivity plugins, and MCP integrations
Serena MCP 기반 심볼릭 리팩토링 플러그인입니다.
v2.4.0 - 데이터 드리븐 아키텍처, 직접 MCP 통합
Main Session
├─ MCP 도구로 코드 데이터 수집 (find_symbol, get_symbols_overview 등)
└─ 수집된 데이터를 에이전트에게 전달
↓
Specialized Agents (도구 없음, 분석 전담)
├─ serena-solid-analyzer: SOLID 위반 분석
├─ refactor-planner: 리팩토링 계획 수립
├─ duplicate-detector: 중복 코드 탐지
└─ feature-planner: 기능 구현 계획
장점:
Serena daemon과 직접 통합:
activate_project)| 명령어 | 설명 | 워크플로우 단계 |
|---|---|---|
/serena-refactor:analyze | SOLID 분석 실행 | 1단계: 분석 |
/serena-refactor:plan | 리팩토링 계획 수립 | 2단계: 계획 |
/serena-refactor:refactor | 전체 리팩토링 워크플로우 | 3단계: 실행 |
/serena-refactor:audit | 코드 품질 감사 | 4단계: 검증 |
/serena-refactor:rename | 안전한 심볼 이름 변경 | 단독 작업 |
/serena-refactor:extract | 메서드/클래스 추출 | 단독 작업 |
/serena-refactor:detect-duplicates | 중복 코드 탐지 | 분석 단계 |
/serena-refactor:inject | 지능형 기능 주입 | 기능 추가 워크플로우 |
/serena-refactor:analyze → .refactor-analysis-done
↓
/serena-refactor:plan → .refactor-plan-approved
↓ (Hook: 선행 조건 검증)
/serena-refactor:refactor → .refactor-execution-done
↓ (필수)
/serena-refactor:audit → .refactor-audit-passed (PASS 시)
↓
git commit
knowledge-extractor → .inject-knowledge-extracted
↓
feature-planner → .inject-plan-approved
↓ (Hook: 계획 승인 확인)
code-injector → .inject-execution-done
↓
검증 및 git commit
차단형 Hook (선행 조건 미충족 시 실행 거부):
serena-refactor-executor: 분석 + 계획 완료 확인code-injector: 기능 계획 승인 확인경고형 Hook (정보 제공):
refactor-planner: 분석 완료 권장feature-planner: 지식 추출 완료 권장| 파일 | 생성 시점 | 의미 |
|---|---|---|
.refactor-analysis-done | analyze/detect-duplicates 완료 | 분석 완료 |
.refactor-plan-approved | plan 완료 | 계획 승인 (자동) |
.refactor-execution-done | refactor 완료 | 실행 완료 |
.refactor-audit-passed | audit PASS | 품질 검증 통과 |
.inject-knowledge-extracted | knowledge-extractor 완료 | 지식 추출 완료 |
.inject-plan-approved | feature-planner 완료 | 기능 계획 승인 |
.inject-execution-done | code-injector 완료 | 코드 주입 완료 |
serena-solid-analyzer: SOLID 원칙 위반 분석 (데이터 전용)duplicate-detector: 코드 클론 탐지 (데이터 전용)refactor-planner: 리팩토링 계획 수립 (데이터 전용)feature-planner: 기능 구현 계획 (데이터 전용)serena-refactor-executor: 리팩토링 실행 (계획 기반)code-injector: 코드 주입 (계획 기반)refactor-auditor: 품질 검증 (실행 결과 분석)knowledge-extractor: 프로젝트 지식 그래프 생성debug-explorer: 버그 탐색 및 실행 경로 추적debug-strategist: 수정 전략 설계 (최소/포괄/방어적)debug-verifier: 수정 결과 검증 (직접/회귀/엣지케이스)e2e-test-runner: Playwright 기반 사용자 시뮬레이션 테스트| 스킬 | 용도 |
|---|---|
solid-design-rules | SOLID 원칙 및 TDD 규칙 |
serena-refactoring-patterns | Serena 도구 기반 리팩토링 패턴 |
duplicate-detection-rules | 코드 클론 탐지 및 수정 패턴 |
project-knowledge-graph | 프로젝트별 누적 지식 |
feature-injection-rules | 코드 주입 템플릿 및 가이드 |
find_symbol: 심볼 검색 및 본문 읽기find_referencing_symbols: 참조 추적get_symbols_overview: 파일 구조 분석search_for_pattern: 패턴 검색replace_symbol_body: 심볼 본문 교체rename_symbol: 안전한 이름 변경 (모든 참조 자동 업데이트)insert_before/after_symbol: 심볼 삽입replace_content: 정규식 기반 콘텐츠 교체activate_project: 프로젝트 전환list_memories: 메모리 목록read_memory / write_memory: 프로젝트 지식 저장플러그인 설치 시 SessionStart hook이 Serena MCP 자동 설정:
# 플러그인 설치
claude plugin add local refactor
# Claude Code 재시작 → Serena MCP 자동 등록
# Serena MCP 등록
claude mcp add --transport stdio --scope user serena -- \
uvx --from git+https://github.com/oraios/serena serena start-mcp-server
# 플러그인 설치
cd ~/.claude/plugins/local/
git clone <this-repo> serena-refactor