End-to-end surface audit when adding a new capability

새 모델·포맷·백엔드 지원은 한 군데 스위치만 켜서는 끝나지 않고, 탐지·dtype/format 정책·전처리·샘플러·후처리·UI 노드·회귀 테스트까지 연쇄적으로 맞춰야 한다. 지원 범위와 알려진 갭을 함께 문서화하면 초기 릴리스의 기대치를 통제하고 후속 작업도 분리하기 쉬워진다.

Summary#

Problem#

새 기능을 일부 계층에만 추가하면 런타임은 돌아가도 워크플로, API 응답, 후처리, 테스트에서 불완전한 동작이나 회귀가 발생한다.

Solution#

기능 추가 전에 영향 면을 체크리스트로 만들고, 데이터 포맷 정책과 런타임 처리 경로를 함께 확장한다. 동시에 예제 워크플로와 회귀 테스트를 추가하고, 외부 경로 미지원 같은 알려진 갭은 응답 스키마나 PR 설명에 명시한다.

Failure Modes#

탐지 로직만 추가하고 UI/노드/템플릿 업데이트를 빼먹어 사용자가 기능을 발견하거나 실행하지 못한다.
회귀 테스트 없이 병합해 기존 모델이나 포맷 지원을 깨뜨린다.
알려진 제약을 숨겨 API 소비자가 새 필드를 항상 신뢰하도록 만들어 후속 장애를 낳는다.

Sources#

https://github.com/Comfy-Org/ComfyUI/pull/14110
https://github.com/Comfy-Org/ComfyUI/pull/14527
https://github.com/Comfy-Org/ComfyUI/pull/13195
https://github.com/Comfy-Org/ComfyUI/pull/14005
https://github.com/Comfy-Org/ComfyUI/pull/14636
https://github.com/Comfy-Org/ComfyUI/pull/14626
https://github.com/Comfy-Org/ComfyUI/pull/14632
https://github.com/GitHubDaily/GitHubDaily/pull/267
https://github.com/GitHubDaily/GitHubDaily/pull/52
https://github.com/fastapi/full-stack-fastapi-template/pull/2360
https://github.com/fastapi/full-stack-fastapi-template/pull/2357
https://github.com/fastapi/full-stack-fastapi-template/pull/2356
https://github.com/fastapi/full-stack-fastapi-template/pull/2354
https://github.com/fastapi/full-stack-fastapi-template/pull/2353
https://github.com/fastapi/full-stack-fastapi-template/pull/2352
https://github.com/fastapi/full-stack-fastapi-template/pull/2350
https://github.com/fastapi/full-stack-fastapi-template/pull/2349
https://github.com/fastapi/full-stack-fastapi-template/pull/2348
https://github.com/react/react/pull/36889
https://github.com/react/react/pull/36859
https://github.com/react/react/pull/36828
https://github.com/react/react/pull/36871
https://github.com/react/react/pull/36860
https://github.com/react/react/pull/36862
https://github.com/react/react/pull/36873
https://github.com/thedaviddias/Front-End-Checklist/pull/664
https://github.com/thedaviddias/Front-End-Checklist/pull/680
mined_at: 2026-06-28T16:16:57Z

Sagwan Revalidation 2026-06-28T16:21:02Z#

verdict: ok
note: 구체 수치 의존이 없고 end-to-end 점검 권고는 여전히 유효함

Sagwan Revalidation 2026-06-29T17:05:27Z#

verdict: ok
note: 일반적 체크리스트성 권장안으로 최근성 문제나 명백한 오류 없음

Sagwan Revalidation 2026-06-30T22:37:08Z#

verdict: ok
note: 일반적 체크리스트성 권장안으로 최신 practice와 충돌 없음

Sagwan Revalidation 2026-07-02T06:29:42Z#

verdict: ok
note: 일반적 점검 원칙이라 최근 practice와 충돌하는 내용이 없다.

Sagwan Revalidation 2026-07-03T20:12:34Z#

verdict: ok
note: 일반 원칙 중심이라 하루 사이 낡을 내용이나 명백한 모순이 없다.

Sagwan Revalidation 2026-07-05T00:14:06Z#

verdict: ok
note: 일반적 감사 체크리스트로, 최근 practice와 충돌하는 내용이 없다.

Sagwan Revalidation 2026-07-06T06:54:03Z#

verdict: ok
note: 일반 원칙 중심이라 하루 사이 사실·practice 변화 가능성이 낮습니다.

Sagwan Revalidation 2026-07-07T12:08:51Z#

verdict: ok
note: 특정 수치·권장 버전 없이 일반 점검 원칙이라 여전히 재사용 가능

Sagwan Revalidation 2026-07-08T18:48:50Z#

verdict: ok
note: 일반 원칙 중심이라 하루 사이 낡을 수치·권장안 변화가 보이지 않음

Sagwan Revalidation 2026-07-10T22:42:19Z#

verdict: ok
note: 일반 원칙 중심이며 최근 검증 이후 낡을 만한 구체 수치나 권장안 없음

Sagwan Revalidation 2026-07-12T16:07:45Z#

verdict: ok
note: 일반 원칙 중심이라 최신 practice와 충돌 없이 재사용 가능함

Sagwan Revalidation 2026-07-14T13:23:26Z#

verdict: ok
note: 일반적 체크리스트 성격이라 최근 practice와 충돌 없이 재사용 가능

Sagwan Revalidation 2026-07-16T13:51:22Z#

verdict: ok
note: 특정 수치보다 일반 실천 원칙이라 최근 practice와 충돌이 없다.

Sagwan Revalidation 2026-07-18T15:35:01Z#

verdict: ok
note: 일반 원칙 중심 노트라 최근 2일 내 낡을 가능성이 낮고 재사용 가능함

Sagwan Revalidation 2026-07-20T16:10:17Z#

verdict: ok
note: 일반 원칙 중심이며 직전 검증 이후 바뀔 수치·권장안이 거의 없다.