Apartment38/Agent-Skills

병렬 에이전트 위임

한 번의 delegate_task 호출로 여러 하위 에이전트에게 작업을 분산할 때 사용하며, 특히 파일을 생성하거나 편집할 때 유용합니다. 비용 초과와 트리 손상의 가장 큰 원인은 두 에이전트가 동일한 파일을 자신의 소유로 간주하기 때문입니다.

사용 시점

여러 에이전트로 분산하는 모든 작업이 동일한 저장소, 디렉토리 또는 프로젝트를 건드리는 경우 — 파일 생성, 영역별로 분할된 리팩토링, 빌드-후-테스트 분할 등.

절차

1. 경로별로 분할하여 전달하세요. 각 작업에 명명된 파일이나 디렉토리에 대한 독점 소유권을 부여하세요. 두 에이전트가 같은 파일에 쓸 수 없으며, 어떤 파일도 할당되지 않은 채로 남아 있어서는 안 됩니다. 많고 겹치는 조각보다는 더 적고 명확하게 큰 조각을 선호하세요.

2. 모든 작업 요약에 절대 경로를 명시하세요. 상대 경로는 일부 에이전트 내에서 다른 작업 디렉토리를 기준으로 해석되며, 이로 인해 작업이 ~/Projects/app/fixture 대신 ~/fixture에 떨어질 수 있습니다. "이 트리 외부에는 아무것도 생성하지 마십시오"라는 명시적인 줄을 포함하세요.

3. 공유 파일당 한 명의 소유자를 지정하세요. 설정 파일, 매니페스트 및 목록 레지스트리는 단일 작업이 이름으로 소유권을 주장하게 하고, 다른 작업자는 그것을 편집하지 말고 포함해야 할 내용만 보고하라고 지시하세요.

4. 원하지 않는 부수 효과를 금지하세요. 설치, 빌드, 테스트 실행, git 커밋이 허용되는지 명시적으로 말하세요. 감독 없는 설치는 node_modules를 관련 없는 디렉토리에 흩뜨립니다.

5. 기계 확인 가능한 보고서를 요청하세요: 생성된 정확한 절대 경로, 무엇이 검증되었는지, 그리고 어떻게 검증되었는지(파싱, 렌더링, 빌드, 단위 테스트)를 명시하세요. 검증 방법 없이 자체 보고된 성공은 노이즈에 불과합니다.

6. 병합된 결과를 직접 확인하세요 — 커밋하거나 보고하기 전에 빌드하고, 테스트 스위트를 실행하고, 중요한 파일을 다시 읽으세요. N개의 독립적인 보고서가 작동하는 트리를 구성한다고 신뢰하지 마세요.

7. 방치된 파일을 정리하세요. 대상 트리 외부에서 에이전트가 생성했을 수 있는 디렉토리(홈 루트, 형제 프로젝트 디렉토리, 스크래치)를 검색하세요. 세션이 끝나기 전에 발견된 모든 것을 정리하세요.

항상 적용되는 규칙

• 삭제된 파일은 증상입니다: 두 에이전트가 "사용되지 않는" 경로를 정리할 때, 각자 상대방이 방금 작성한 파일을 제거합니다. 삭제 권한을 명시적으로 지정하세요.
• 형제 에이전트를 기다리며 자신의 작업 순서를 차단하지 마세요. 독립적인 작업을 계속하고 그들의 결과가 도착하면 대응하세요.
• 이미 작업을 완료하고 커밋한 후에 결과가 도착하면, 작업 트리 상태와 방치된 파일을 확인하고 여전히 수행해야 할 작업을 결정하세요. 트리가 깨끗하다고 가정하지 말고, 그들의 작업이 충돌하지 않는다고 가정하지 마세요.
• 하나의 아티팩트에 쓰는 에이전트의 수를 최대한 낮게 유지하세요. 읽기 전용 분석에는 자유롭게 분산하고, 쓰기에는 드물게 분산하세요.

함정

• 공유 이름 충돌. "CSS 파일" 또는 "설정"을 설명하는 두 개의 요약이 에이전트마다 다른 경로로 연결됩니다. 정확한 절대 경로를 명명하세요.
• 관행 이탈. 부분적으로 빌드된 트리를 본 에이전트들이 진행 중에 다른 레이아웃을 채택하여 하나의 프로젝트에 두 가지 관행이 남을 수 있습니다. 요약에 레이아웃을 고정하세요.
• 실행되지 않은 검증 신뢰. 빌드나 렌더링이 통과했다는 증거 없는 보고서는 일반적으로 구조적으로 판단되었음을 의미합니다. 직접 재현하세요.
• 정리 충돌. 한 에이전트가 자신의 "이제는 죽은" 파일을 삭제하면 형제의 산출물을 삭제할 수 있습니다. 위의 항상 적용되는 규칙을 참조하세요.

지원 파일

• templates/delegation-brief.md — 경로 소유권, 금지된 부수 효과, 검증 가능한 보고서 형식을 적용하는 복사-채우기 작업 요약 템플릿입니다.