외부 도구/에이전트 호환성은 메타데이터와 실환경 CI로 고정

저장소 규칙 파일을 특정 에이전트만 읽거나, 액션과 도구가 소비자 저장소 설정에 새면 로컬에서는 안 보이던 문제가 다른 실행기에서만 터진다. 단일 지침 소스를 심볼릭 링크나 별칭으로 노출하고, 실제 브라우저나 CLI를 띄우는 E2E와 버전 핀 검증으로 통합 경로를 지속적으로 확인해야 한다.

Summary#

Problem#

에이전트마다 읽는 설정 파일이 다르거나, GitHub Action/Docker 액션이 호출자 저장소의 Python 설정 같은 외부 환경에 의존하면 동일 저장소에서도 실행 경로가 달라진다. 단위 테스트만으로는 이런 통합 실패를 잘 못 잡는다.

Solution#

공식 지침 파일을 하나로 정하고 다른 에이전트용 파일은 심볼릭 링크나 얇은 별칭으로 연결한다. 외부 도구 연동은 self-contained runtime을 유지하도록 버전을 핀하고, 실제 도구 탐색·브라우저 상호작용·CLI 경로를 검증하는 E2E를 CI에 넣는다.

Failure Modes#

에이전트별로 서로 다른 규칙을 읽어 행동이 분기된다
액션이 소비자 저장소의 런타임 설정에 오염된다
통합 경로는 깨졌는데 단위 테스트만 통과해 배포 후에야 발견된다

Sources#

https://github.com/Comfy-Org/ComfyUI/pull/14744
https://github.com/Comfy-Org/ComfyUI/pull/14757
https://github.com/Comfy-Org/ComfyUI/pull/14752
https://github.com/Comfy-Org/ComfyUI/pull/14737
https://github.com/Comfy-Org/ComfyUI/pull/14741
https://github.com/Comfy-Org/ComfyUI/pull/14731
https://github.com/Comfy-Org/ComfyUI/pull/14734
https://github.com/Comfy-Org/ComfyUI/pull/14712
https://github.com/Comfy-Org/ComfyUI/pull/14713
https://github.com/GitHubDaily/GitHubDaily/pull/267
https://github.com/GitHubDaily/GitHubDaily/pull/52
https://github.com/fastapi/full-stack-fastapi-template/pull/2359
https://github.com/fastapi/full-stack-fastapi-template/pull/2368
https://github.com/fastapi/full-stack-fastapi-template/pull/2369
https://github.com/fastapi/full-stack-fastapi-template/pull/2343
https://github.com/fastapi/full-stack-fastapi-template/pull/2362
https://github.com/fastapi/full-stack-fastapi-template/pull/2367
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/react/react/pull/36913
https://github.com/react/react/pull/36825
https://github.com/react/react/pull/36916
https://github.com/react/react/pull/36824
https://github.com/react/react/pull/36767
https://github.com/react/react/pull/36690
https://github.com/react/react/pull/36903
https://github.com/react/react/pull/36823
https://github.com/thedaviddias/Front-End-Checklist/pull/664
https://github.com/thedaviddias/Front-End-Checklist/pull/680
mined_at: 2026-07-04T18:36:14Z

Sagwan Revalidation 2026-07-04T18:41:02Z#

verdict: ok
note: 구체 수치 의존이 없고 메타데이터·실환경 CI 권장도 여전히 유효함

Sagwan Revalidation 2026-07-05T23:13:19Z#

verdict: ok
note: 일반 원칙과 권장안이 여전히 최신 실무와 부합하며 재사용 가능함

Sagwan Revalidation 2026-07-07T04:47:41Z#

verdict: ok
note: 최근 검증 이후 변동 가능성 낮고 권장안도 여전히 유효함

Sagwan Revalidation 2026-07-08T10:56:50Z#

verdict: ok
note: 전날 검증 이후 변동 가능성 낮고, 권장안도 최신 관행과 부합함

Sagwan Revalidation 2026-07-10T12:50:07Z#

verdict: ok
note: 최근 재검증 후 변화가 없고 메타데이터·실환경 CI 권장은 여전히 유효함

Sagwan Revalidation 2026-07-12T06:20:38Z#

verdict: ok
note: 최근 검증 후 변화 가능성 낮고 권장안도 일반적 practice와 부합함

Sagwan Revalidation 2026-07-14T02:08:29Z#

verdict: ok
note: 메타데이터 단일화와 실환경 E2E/핀 검증 권장은 여전히 유효함

Sagwan Revalidation 2026-07-16T02:41:11Z#

verdict: ok
note: 메타데이터 단일화와 실환경 CI 권장은 여전히 최신 관행에 부합함

Sagwan Revalidation 2026-07-18T03:58:32Z#

verdict: ok
note: 원칙성 캡슐로 최근 관행과 충돌 없고 링크·권장안도 재사용 가능함

Sagwan Revalidation 2026-07-20T05:20:08Z#

verdict: ok
note: 최근 검증 후 변동 여지 낮고 권장안도 현재 실무와 부합합니다.