Summary#
호환성은 교체보다 적층형으로 추가하라
Problem#
새 기능이나 새 API를 넣을 때 기존 훅, 노드, 엔드포인트, 프런트엔드 호출 방식과 충돌하면 통합 비용이 커지고 기존 사용자 흐름이 깨진다.
Solution#
기존 동작을 유지한 채 얇은 호환 레이어를 추가한다. 기존 상태별 분기 로직은 단일 상위 API로 감추고, 기존 컴포넌트나 훅이 이미 설치된 경우에는 거부하지 말고 그 위에 attach 하며, 이름 변경은 즉시 삭제 대신 deprecate+rename으로 단계적으로 진행한다.
Failure Modes#
- 새 구현이 기존 전역 훅이나 확장을 독점한다고 가정해 설치를 거부함
- 클라이언트가 내부 상태를 알아야만 API를 호출할 수 있어 분기 코드가 퍼짐
- 기존 노드나 이름을 한 번에 제거해 워크플로가 깨짐
Sources#
- https://github.com/Comfy-Org/ComfyUI/pull/14523
- https://github.com/Comfy-Org/ComfyUI/pull/14555
- https://github.com/Comfy-Org/ComfyUI/pull/14509
- https://github.com/Comfy-Org/ComfyUI/pull/14547
- https://github.com/Comfy-Org/ComfyUI/pull/13325
- https://github.com/Comfy-Org/ComfyUI/pull/14493
- https://github.com/Comfy-Org/ComfyUI/pull/14316
- https://github.com/Comfy-Org/ComfyUI/pull/14559
- https://github.com/Comfy-Org/ComfyUI/pull/14234
- https://github.com/Comfy-Org/ComfyUI/pull/14540
- https://github.com/GitHubDaily/GitHubDaily/pull/267
- https://github.com/GitHubDaily/GitHubDaily/pull/52
- https://github.com/fastapi/full-stack-fastapi-template/pull/2317
- https://github.com/fastapi/full-stack-fastapi-template/pull/2337
- https://github.com/fastapi/full-stack-fastapi-template/pull/2338
- https://github.com/fastapi/full-stack-fastapi-template/pull/2340
- https://github.com/fastapi/full-stack-fastapi-template/pull/2332
- https://github.com/fastapi/full-stack-fastapi-template/pull/2336
- https://github.com/fastapi/full-stack-fastapi-template/pull/2330
- https://github.com/fastapi/full-stack-fastapi-template/pull/2323
- https://github.com/react/react/pull/36682
- https://github.com/react/react/pull/36599
- https://github.com/react/react/pull/36598
- https://github.com/react/react/pull/36597
- https://github.com/react/react/pull/27502
- https://github.com/react/react/pull/36779
- https://github.com/react/react/pull/36809
- https://github.com/react/react/pull/36732
- https://github.com/thedaviddias/Front-End-Checklist/pull/664
- https://github.com/thedaviddias/Front-End-Checklist/pull/680
- mined_at: 2026-06-20T16:29:14Z
Sagwan Revalidation 2026-06-20T16:35:17Z#
- verdict:
ok - note: 구체 수치 없이 호환 레이어·점진 폐기는 여전히 유효한 관행이다.
Sagwan Revalidation 2026-06-21T18:58:51Z#
- verdict:
ok - note: 일반적 호환성 원칙이라 최근 practice와 충돌하지 않아 재사용 가능.
Sagwan Revalidation 2026-06-22T19:04:37Z#
- verdict:
ok - note: [chatgpt HTTP 401] {
Sagwan Revalidation 2026-06-23T19:15:40Z#
- verdict:
ok - note: [chatgpt HTTP 401] {
Sagwan Revalidation 2026-06-24T20:00:21Z#
- verdict:
ok - note: [chatgpt HTTP 401] {
Sagwan Revalidation 2026-06-25T20:33:00Z#
- verdict:
ok - note: 원칙성 캡슐로 최근 practice와 충돌 없고 재사용 가능하다.
Sagwan Revalidation 2026-06-27T01:02:07Z#
- verdict:
ok - note: 원칙형 캡슐로 최근 관행과 충돌 없고 수치 의존도 낮아 재사용 가능
Sagwan Revalidation 2026-06-28T02:48:49Z#
- verdict:
ok - note: 일반 호환성 원칙으로 최근 practice와 충돌하지 않아 재사용 가능
Sagwan Revalidation 2026-06-29T03:18:14Z#
- verdict:
ok - note: 호환 레이어·deprecate 후 전환 원칙은 여전히 최신 관행과 부합함
Sagwan Revalidation 2026-06-30T03:56:56Z#
- verdict:
ok - note: 일반 원칙성 캡슐로 수치·권장안 변동 위험이 낮아 재사용 가능.
Sagwan Revalidation 2026-07-01T10:29:53Z#
- verdict:
ok - note: 호환 레이어·deprecate 후 전환 원칙은 현재도 유효한 실무 관행이다.
Sagwan Revalidation 2026-07-02T23:25:26Z#
- verdict:
ok - note: 구체 수치 없이 호환 레이어 원칙이라 최신 practice와 충돌 없음
Sagwan Revalidation 2026-07-04T11:04:13Z#
- verdict:
ok - note: 일반 원칙 중심이라 수치·권장안 변동 없이 재사용 가능함
Sagwan Revalidation 2026-07-05T13:11:03Z#
- verdict:
ok - note: 일반 호환성 원칙으로 수치 의존이 없고 최근 practice와도 부합함
Sagwan Revalidation 2026-07-06T19:18:23Z#
- verdict:
ok - note: 원칙성 캡슐로 최신 관행과 충돌 없고 어제 검증 이후 갱신 필요 없음
Sagwan Revalidation 2026-07-08T02:07:46Z#
- verdict:
ok - note: 원칙형 캡슐이며 최근 검증 이후 사실·권장안 변화 징후가 없습니다.
Sagwan Revalidation 2026-07-10T00:01:00Z#
- verdict:
ok - note: 이전 검증 후 하루라 원칙·권장안 모두 여전히 재사용 가능함
Sagwan Revalidation 2026-07-11T17:30:00Z#
- verdict:
ok - note: 원칙성 캡슐로 수치 의존이 없고 최근 호환성 관행과도 부합함
Sagwan Revalidation 2026-07-13T12:32:55Z#
- verdict:
ok - note: 원칙형 캡슐로 수치 의존이 없고 최근 관행과도 충돌 없음.
Sagwan Revalidation 2026-07-15T11:36:59Z#
- verdict:
ok - note: 원칙형 캡슐로 최근 검증 이후 사실·권장안 변화 징후가 없다.
Sagwan Revalidation 2026-07-17T12:08:39Z#
- verdict:
ok - note: 일반 원칙 중심이라 최근 practice와 충돌 없고 재사용 가능함
Sagwan Revalidation 2026-07-19T13:45:52Z#
- verdict:
ok - note: 적층형 호환·점진적 deprecate 권장은 여전히 유효한 일반 원칙임
Sagwan Revalidation 2026-07-21T14:49:55Z#
- verdict:
ok - note: 일반 원칙성 캡슐로 최근 검증 이후 낡은 수치·권장안이 보이지 않음