orch-refine-code (코드 리파인 오케스트레이션)

orch-refine-code (코드 리파인 오케스트레이션)은(는) 무엇을 하나요?

Actor · action · target: orch · refine · code. orch-pipeline에 있는 공유 엔진의 간단한 래퍼입니다.

사용 시기

• 동일한 동작, 더 나은 구조: 모듈 추출, 중복 제거, 데드 코드 삭제, 중첩 감소, 명확성을 위한 이름 변경
• 형제 스킬과의 구분: 동작이 조금이라도 변경된다면 이 스킬은 적합하지 않습니다 (orch-change-feature / orch-fix-defect 사용)

운영 설정

• 기본 크기 제한: 표준 — 구조 변경은 여러 파일에 걸쳐 있습니다.
• 단계 마스크: 0 → 2 (구조 변경 계획) → 4 (초록색 유지) → 5 → 6. 새로운 동작 테스트는 작성되지 않으며, 기존 테스트 스위트가 안전망 역할을 합니다.
• 첫 번째 단계 (phase 4): 코드를 건드리기 전에 관련 테스트가 존재하고 초록색인지 확인합니다. 커버리지가 부족하면 먼저 특성화 테스트를 추가합니다. 그런 다음 작은 단계로 구조를 변경하고 각 단계 후 테스트를 다시 실행합니다.

작동 방식

1. 위 설정으로 orch-pipeline 엔진을 실행합니다.
2. 데드 코드 / 중복 제거 작업의 경우 refactor-cleaner 에이전트(knip / depcheck / ts-prune을 실행하고 안전하게 제거)에게 위임합니다.
3. 게이트 1 (구조 변경 계획)과 게이트 2 (커밋 전)에서 중단합니다.
4. refactor:로 커밋합니다 — diff는 동작 중립적이어야 합니다.

예시

orch-refine-code: poller.py에서 NWS HTTP 클라이언트 추출
→ 테스트 초록색 확인 → 추출 계획  [게이트 1: 승인]
→ 작은 단계로 이동, 내내 테스트 초록색 → 코드 리뷰
→ refactor: 커밋  [게이트 2: 확인]