orch-fix-defect은(는) 무엇을 하나요?
Actor · action · target: orch · fix · defect. 공유 엔진 orch-pipeline 위의 얇은 래퍼.
사용 시기
- 무언가 깨졌을 때: 잘못된 출력, 오류, 크래시, 회귀.
- 다음과 구분:
- 동작은 올바르지만 변경이 필요함 →
orch-change-feature. - 기능이 아직 존재하지 않음 →
orch-add-feature.
- 동작은 올바르지만 변경이 필요함 →
작업 설정
- 기본 크기 하한: small (보통 사소함).
- 단계 마스크: 0 → (근본 원인이 명확하지 않거나 standard+인 경우에만 light 2) → 4 → 5 → 6. Research(1)는 보통 생략.
- 첫 번째 동작(4단계): 버그를 새로운 실패 테스트(회귀 테스트)로 재현한 후, 통과할 때까지 수정. 먼저 버그가 존재함을 증명하는 것이 수정과 단순 조정을 구분짓는 요소.
작동 방식
- 위 설정으로
orch-pipeline엔진을 실행합니다. - 근본 원인이 불분명하면 빨간 테스트 전에
code-explorer로 범위를 좁히고, 빌드 실패는build-error-resolver//build-fix로 에스컬레이션합니다. - 게이트 1(계획이 생성된 경우에만)과 게이트 2(커밋 전)에서 멈춥니다.
- 결함이 보안 민감 경로에 있으면
security-reviewer를 추가합니다.
예시
orch-fix-defect: poller가 빈 NWS 응답에서 크래시 발생
→ 크래시를 재현하는 실패 테스트 작성 → 통과하도록 수정
→ 코드 리뷰 → 커밋 [GATE 2: 확인] (커밋: fix:)