답변게시됨15 소스
테스트와 문서가 쌓이는 저장소, 해법은 ‘전부 삭제’가 아니다
오래 유지할 회귀·계약 테스트와 일회성 검증 자료를 구분해야 한다. ‘테스트를 전부 제출하지 않는다’는 식의 일괄 원칙은 적절하지 않다. 저장소에 보이는 파일과 실제 설치 패키지에 포함되는 파일은 다를 수 있다.
게시자GPT Image 2로 이미지 생성
연구 답변
주요 시사점
- 오래 유지할 회귀·계약 테스트와 일회성 검증 자료를 구분해야 한다. ‘테스트를 전부 제출하지 않는다’는 식의 일괄 원칙은 적절하지 않다.
- 저장소에 보이는 파일과 실제 설치 패키지에 포함되는 파일은 다를 수 있다. 임시 자료가 배포 자산에 섞이지 않도록 경계를 따로 관리해야 한다.
- 문서는 개수를 줄이기보다 분석·결정·실행 계획·임시 자료의 역할을 나누고, 모델이 현재 과제와 무관한 내용을 통째로 읽지 않게 하는 편이 낫다.
- 이번 검토는 정적 자료와 일부 외부 출처를 바탕으로 한 중간 점검이다. 테스트 실행이나 변경 적용은 이뤄지지 않았다.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/oBMfTzLzQzYo7VcXQdEGj2yQgAw1/images/73E9D63489E02AC46209/BEDABC175BE8FCADFC63.png)
AI 프롬프트
openai.comCreate a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W. Article summary: <tool call {"name":"attempt completion","arguments":{"result":"两个痛点都适合纳入 V4 的“产物生命周期背压”，但不应简化成“测试全部不提交”或“文档全部合并”。建议保留长期质量资产，隔离一次性验证材料，并分别控制仓库维护、安装分发和模型上下文。\n\n本次交付为阶段性调研：仓库静态证据、Geoffrey Huntley 的作者资料及部分学术资料已取得；Python 官方布. Topic tags: general web, openai, llm, agents, ai. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with fa
정리의 기준은 파일 개수가 아니라 수명과 용도
테스트와 문서가 쌓이는 저장소를 깔끔하게 만들고 싶을 때, ‘테스트는 다 빼자’거나 ‘문서는 한데 합치자’는 해법이 먼저 떠오를 수 있다. 하지만 이런 방식은 오래 필요한 품질 자산까지 없애거나, 서로 다른 목적의 기록을 뒤섞을 위험이 있다.
V4 검토에서 제안된 방향은 장기적으로 유지할 자산은 보존하고, 일회성 자료는 격리하며, 저장소 관리·설치 배포·모델 입력을 각각 따로 다루는 것이다.
테스트: 임시 검증 자료는 분리하고, 회귀 테스트는 살린다
저장소의 CI 설정은 테스트 디렉터리를 사용해 설정 계약, 설치·배포, 자산 보호 등을 확인한다. 따라서 테스트가 많아 보인다는 이유만으로 이를 임시 파일 취급해서는 안 된다. 다만 이번 점검에서 테스트를 다시 실행하거나 각 테스트의 유지 가치를 하나씩 평가한 것은 아니다.
반면 저장소의 무시 규칙에는 일부 샌드박스·캐시·임시 파일이 포함돼 있지만, 검토된 초안 및 검증 출력 경로가 명시적으로 들어 있지는 않았다. 디렉터리가 존재한다는 사실만으로 그 안의 파일이 Git에 추적되고 있다고 단정할 수도 없다. 이번 검토에서는 실제 추적 상태를 확인하지 않았다.
또 하나 구분할 점은 저장소 업데이트와 설치 대상 수집이 서로 다른 과정이라는 것이다. 업데이트 경로는 저장소를 갱신하고, 배포용 수집 로직은 지정된 제품군의 파일을 입력으로 삼는다. 이 로직은 제품군 안의 일반 파일을 재귀적으로 모으므로, 임시 자료를 제품군 디렉터리에 두면 배포에 섞일 가능성은 있다. 다만 현재 그런 일이 실제로 발생했다는 증거는 확인되지 않았다.
| 자료 유형 | 권장 관리 방식 |
|---|---|
| 장기 회귀 테스트, 계약 테스트, 필요한 통합 테스트 | 구현과 함께 관리하고 지속적으로 유지한다. 기본적으로 실행 환경 설치 파일과는 분리한다. |
| 일회성 진단 스크립트, 실험 입력, 검증 자료 | 기본적으로 로컬 또는 승인된 임시 작업 경로에 둔다. 제품군 자산 디렉터리에는 넣지 않는다. |
| 로그, 커버리지 결과, 실행 기록 | 테스트 코드와 분리하고, 목적에 따라 보존 여부를 정한다. 기본적으로 소스 제출물이나 설치 패키지에 포함하지 않는다. |
이는 검토에서 나온 제안이지, 이미 적용된 규칙은 아니다. 언어별 관례도 고려해야 한다. 예를 들어 Go 공식 튜토리얼은 테스트 파일을 테스트 대상 패키지와 같은 디렉터리에 두는 방식을 안내한다. 따라서 모든 Go 단위 테스트를 일괄적으로 별도 디렉터리로 옮기는 것을 보편 원칙으로 삼기는 어렵다.15 Python은 현재 저장소에서 중앙집중형 테스트 구조를 쓰고 있지만, Python 전반의 최선의 디렉터리 배치에 관해서는 이번 검토만으로 결론을 내릴 공식 근거가 충분하지 않았다.
무엇을 정리하려는지에 따라 해법도 달라진다. 일반 사용자가 받는 설치물을 깔끔하게 하고 싶다면 먼저 패키징 목록과 설치 경계를 손봐야 한다. 개발자가 보는 소스 트리를 정돈하고 싶다면 해당 언어와 프로젝트의 테스트 배치를 살펴야 한다. 테스트 파일을 옮기는 것만으로 두 문제를 동시에 해결할 수는 없다.
문서: 하나로 합치기보다 각 기록의 역할을 분명히
V4의 기존 산출물 경로는 분석, ADR(아키텍처 결정 기록), 실행 계획, 계약을 구분하고, 어디에 둘지 불분명하면 확인하도록 안내한다. 하지만 초안 규칙에는 별도의 경로 관례도 있어, 자료가 만들어지고 보관되고 정리되는 전 과정이 충분히 일관된다고 보기는 어려웠다. 이 정적 근거만으로 매번 임의의 디렉터리가 생기는 구체적 원인까지 단정할 수는 없다.
새 디렉터리를 여러 개 추가하기보다, 기존 구조 안에서 문서의 역할을 분명히 하는 편이 낫다.
- 분석 문서에는 근거와 비교, 반대 증거, 아직 모르는 점을 기록한다. 단순 질의응답은 대화에서 마무리하고, 보존할 이유가 있을 때만 별도 보고서로 남긴다.
- ADR에는 중요한 결정과 이유, 제약을 담는다. 분석 전체를 복사하거나 실행 과정을 그대로 반복해 적지 않는다.
- 실행 계획에는 승인 범위, 의존성, 검수 기준을 적고 관련 결정은 연결해 둔다. 조사 본문을 다시 붙여 넣지 않는다.
- 임시 자료에는 초안, 진단 입력, 원시 출력 등을 둔다. 제목에 ‘초안’이 들어간다는 이유만으로 정식 분석 자료와 같은 곳에 저장하지 않는다.
- 운영 문서는 반복해서 참고할 수 있는 절차를 설명할 때 보존한다. 한 번의 배포 과정이 있었다는 이유만으로 새 배포 디렉터리를 자동 생성하지 않는다.
문서의 개수, 버전 관리 여부, 설치 포함 여부, 모델이 읽을 범위는 서로 다른 결정이다. 모든 것을 한 디렉터리에 넣는다고 관리 문제가 저절로 해결되지는 않는다.
테스트와 문서는 서로 대체재가 아니다
Geoffrey Huntley는 에이전트가 더 긴 작업을 수행하도록 돕는 자동 피드백 구조와 품질·정확성 검증의 중요성을 강조한다.12 또 코드베이스를 다른 언어로 옮기는 특정 절차에서는 테스트의 동작을 명세 문서로 정리한 뒤 이를 바탕으로 이식하는 방식을 제안했다.
14
이 사례를 근거로 모든 프로젝트에서 테스트를 문서로 대체해야 한다고 일반화할 수는 없다. V4에 적용할 수 있는 제한적인 교훈은 오히려 반대에 가깝다. 실행 가능한 정확성 피드백은 유지하면서, 중복되거나 일회성인 검증 자료를 줄이는 것이다. 명세는 기대 동작을 설명하고 테스트는 이를 실행 가능한 방식으로 확인한다. 둘은 검토 없이 서로 대체할 수 없다.
Huntley가 테스트 제출, 초안 경로, 배포 제외에 대해 일관된 보편 기준을 제시했는지, 또는 관련 온라인 커뮤니티가 한 방향으로 합의했는지는 이번 자료만으로 확인되지 않았다.
문서가 길어질수록, 모델에 무엇을 읽힐지도 따져야
긴 입력에서 모델이 중간 부분의 정보를 충분히 활용하지 못하는 ‘lost in the middle’ 문제를 다룬 연구가 있다.3 HELMET 연구는 긴 문맥 모델을 평가할 때 단순 검색 과제에만 의존하지 않고 다양한 작업을 살펴야 한다고 지적한다.
4 그러나 이 결과만으로 특정 파일이 일정 줄 수를 넘으면 환각이 생긴다거나, 현재 V4에서 위험이 얼마나 큰지를 단정할 수는 없다.
실무적으로는 파일 수를 줄이는 데만 집중하기보다, 모델이 현재 작업에 필요한 내용을 읽도록 설계하는 편이 직접적이다. 주제와 결정 단위로 문서를 나누고, 과거 자료는 필요할 때 찾아보게 한다. 짧은 요약에는 근거의 위치와 미확인 사항, 끝나지 않은 의무를 남기되 원자료는 추적을 위해 보존한다. 인덱스는 길 안내 역할에 집중하고, 로그나 과거 보고서를 매번 통째로 모델 입력에 넣지 않는 방식이다.
V4에는 ‘산출물 생애주기’ 규칙을 더하는 편이 현실적
검토의 결론은 무거운 새 절차를 늘리기보다, 자료를 만들 때부터 배포하고 정리할 때까지 적용되는 간단한 원칙을 보완하자는 것이다.
- 만들기 전: 자료의 목적을 확인하고, 매번 새 파일을 만드는 대신 기존 테스트나 문서를 확장할 수 있는지 살핀다.
- 저장하기 전: 승인된 경로인지, 장기 자료인지 임시 자료인지, 버전 관리나 배포 대상인지 정한다. 불명확하면 임의로 디렉터리를 만들지 않는다.
- 제출하기 전: 임시 출력, 민감 정보, 중복 테스트와 문서를 점검한다. 정리를 이유로 테스트 전체를 무시하지 않는다.
- 배포하기 전: 설치 대상의 경계를 확인해 임시 자료가 제품군에 들어가지 않도록 한다. 기존 요약·식별·자산 보호 기능도 유지한다.
- 정리하기 전: 실패 증거, 진행 중인 작업, 과거 자료에 대한 참조를 보호한다. 작업 성공이나 자료의 오래됨만으로 삭제 권한이 생기는 것은 아니다.
따라서 우선순위는 임시 자료의 경로와 배포 경계를 보완하고, 문서 역할을 정리하며, 모델이 필요한 내용만 읽도록 하는 것이다. Go 단위 테스트를 일괄 이동하거나 장기 테스트 제출을 중단하거나 모든 문서를 한 파일로 합치는 방안은 이번 검토로 뒷받침되지 않는다.
이번 결과는 부분 조사에 기반한 제안이다. 외부 커뮤니티 자료와 Python 공식 배치 관례에 관한 확인은 완료되지 않았고, 테스트 실행·파일 변경·정리 작업도 수행하지 않았다.
Studio Global AI
연구를 계속하세요
이 페이지에는 Studio Global 내에서 계속할 수 있는 소스 기반 답변이 포함되어 있습니다.
사람들은 또한 묻습니다.
"테스트와 문서가 쌓이는 저장소, 해법은 ‘전부 삭제’가 아니다"에 대한 짧은 대답은 무엇입니까?
오래 유지할 회귀·계약 테스트와 일회성 검증 자료를 구분해야 한다. ‘테스트를 전부 제출하지 않는다’는 식의 일괄 원칙은 적절하지 않다.
먼저 검증할 핵심 포인트는 무엇인가요?
오래 유지할 회귀·계약 테스트와 일회성 검증 자료를 구분해야 한다. ‘테스트를 전부 제출하지 않는다’는 식의 일괄 원칙은 적절하지 않다. 저장소에 보이는 파일과 실제 설치 패키지에 포함되는 파일은 다를 수 있다. 임시 자료가 배포 자산에 섞이지 않도록 경계를 따로 관리해야 한다.
실무에서는 다음으로 무엇을 해야 합니까?
문서는 개수를 줄이기보다 분석·결정·실행 계획·임시 자료의 역할을 나누고, 모델이 현재 과제와 무관한 내용을 통째로 읽지 않게 하는 편이 낫다.
출처
go.devAdd a test
ghuntley.comdon't waste your back pressure
doi.orgFound in the Middle: How Language Models Use Long Contexts Better via Plug-and-Play Positional Encoding