프로젝트 태스크 라우터은(는) 무엇을 하나요?
대규모 출력을 생성하기 전에 작업을 가장 작고 안정적인 구조로 라우팅합니다. 오래된 대화 기록 대신 프로젝트 파일과 간결한 인계를 통해 연속성을 유지하세요.
복잡도 게이트 실행
가장 간단한 방식으로 작업을 분류하세요:
- 단순(Simple): 명확한 결과 하나, 의존성 위험이 거의 없고, 지속적인 인계가 필요하지 않습니다. 계획을 보여주지 않고 직접 실행하세요.
- 집중 다단계(Focused multi-step): 몇 가지 관련 단계가 있는 하나의 주요 결과물입니다. 2~5단계의 짧은 계획을 제시하고 동일한 대화에서 계속 진행하세요.
- 다단계(Multi-stage): 여러 개의 개별 결과물, 서로 다른 참조 집합, 또는 명확한 상류/하류 의존성이 있습니다. 전체 작업을 수행하기 전에 단계와 대화 경계를 제안하세요.
- 장기 실행(Long-running): 작업이 여러 세션에 걸쳐 진행되거나, 많은 결정이 누적되거나, 안정적인 대화 컨텍스트를 초과할 가능성이 있습니다. 실행 전에 진실 공급원(source of truth), 단계 상태, 인계 방법을 설정하세요.
정확한 남은 컨텍스트 비율을 안다고 가정하기보다 관찰 가능한 증거를 사용하세요. 경고 신호로는 반복적인 수정, 많은 파일이나 아티팩트, 초기 제약 조건 확인의 어려움, 이전 턴의 요약, 필요한 참조 집합을 변경하는 단계 전환 등이 있습니다.
대화 경계 결정
작업이 밀접하게 결합되어 있거나, 동일한 아티팩트를 반복하거나, 동일한 소규모 컨텍스트 집합으로 안정적으로 완료할 수 있을 때는 동일한 대화에서 작업을 유지하세요.
다음 중 하나라도 해당되면 새 대화를 권장하세요:
- 현재 단계가 다른 단계에서 사용할 안정적인 아티팩트를 생성하는 경우;
- 다음 단계에 실질적으로 다른 파일이나 전문 지식이 필요한 경우;
- 한 결과물에 대한 독립적인 검토가 가치 있는 경우;
- 계속 진행하면 버려진 탐색, 로그, 또는 거부된 초안이 많이 쌓이는 경우;
- 간결한 파일 기반 인계가 대화 기록을 안전하게 대체할 수 있는 경우.
기계적으로 분할하지 마세요. 새 대화는 컨텍스트 부하, 재작업, 또는 모호성을 줄일 때만 정당화됩니다. 별도의 대화를 권장하고 시작 프롬프트를 제공하되, 사용자가 명시적으로 요청하지 않는 한 사용자 소유 작업을 생성하거나 포크하지 마세요.
라우팅 카드 제시
다단계 또는 장기 실행 작업의 경우, 대량 실행을 일시 중지하고 다음을 포함하는 간결한 라우팅 카드를 제시하세요:
- 전체 목표 — 한 문장.
- 권장 단계 — 의존성 순서.
- 대화 경계 — 각 단계에 대해 동일하거나 새로운 대화, 한 줄 근거.
- 입력 — 읽어야 할 정확한 상류 파일 또는 확정된 결정; 광범위한 프로젝트 스캔은 피하세요.
- 출력 — 명명된 결과물과 적절한 프로젝트 위치.
- 완료 조건 — 관찰 가능한 완료 기준.
- 인계 업데이트 — 업데이트해야 할 상태, 결정, 또는 진실 공급원 파일.
분해가 범위나 순서를 실질적으로 변경하는 경우, 이후 단계를 실행하기 전에 사용자의 동의를 얻으세요. 첫 번째 단계가 이미 명확히 승인된 경우, 구조를 제시한 후 해당 단계만 시작하세요.
진실 공급원 체인 유지
채팅을 작업 공간으로 취급하고, 권위 있는 아카이브로 취급하지 마세요.
- 적용 가능한
AGENTS.md및 기존 프로젝트 구성을 따르세요. - 현재 단계에 필요한 정확한 파일만 읽으세요.
- 승인된 결과를 콘텐츠의 실제 프로젝트 내 명확하게 명명된 파일에 저장하세요.
- 각 내구성 있는 사실을 하나의 권위 있는 위치에 두고, 다른 곳에서는 복제하지 말고 참조하세요.
- 이후 작업에 영향을 미치는 결정만 기록하세요. 숨겨진 추론, 버려진 초안, 또는 장황한 대화 요약을 보존하지 마세요.
- 상류 결정이 변경되면, 검토가 필요한 하류 결과물을 식별하고 프로젝트 상태에 명확히 표시하세요.
기존 프로젝트 상태 또는 결정 파일을 선호하세요. 그러한 파일이 없고 의미 있는 교차 세션 작업에 필요한 경우, 모든 프로젝트에 대한 인덱스를 생성하기보다 가장 작은 유용한 파일 집합을 제안하세요.
간결한 인계 생성
대화를 변경하거나, 미완료 작업을 일시 중지하거나, 컨텍스트 신뢰도가 떨어진 후 계속하기 전에 먼저 공식 아티팩트를 업데이트한 다음 다음을 포함하는 간결한 인계를 준비하세요:
- 작업 및 현재 단계;
- 완료 및 승인된 작업;
- 확정된 결정;
- 권위 있는 파일 경로 및 버전;
- 미완료 작업 및 차단 요소;
- 즉시 수행할 다음 작업;
- 다음 대화가 읽어야 할 정확한 파일;
- 다음 대화에 사용할 수 있는 바로 사용 가능한 시작 프롬프트.
인계는 빠르게 훑어볼 수 있을 만큼 짧게 유지하세요. 다음 대화는 공식 파일과 인계에서 재개해야 하며, 이전 대화 기록을 재구성해서는 안 됩니다.
시작 프롬프트 패턴
새 대화를 권장할 때 이 구조를 사용하세요:
[프로젝트] 계속, 단계: [단계 이름].
다음을 읽고 따르세요:
1. [해당 AGENTS.md]
2. [프로젝트 진실 공급원]
3. [현재 상태 또는 인계]
4. [정확한 상류 아티팩트 또는 관련 섹션]
읽지 않음: [관련 없는 채팅, 폴더 또는 초안].
목표: [단일 단계 목표].
출력: [명명된 결과물 및 위치].
완료 조건: [관찰 가능한 기준].
완료 후: [상태/결정/인계 업데이트].
오버헤드 비례 유지
- 간단한 요청에 복잡한 워크플로를 알리지 마세요.
- 미래에 사용할 소비자가 없는 계획 파일을 생성하지 마세요.
- 정확한 소스를 알고 있을 때 전체 프로젝트를 다시 읽지 마세요.
- 필요한 상류 결정이 안정화되기 전에 후속 단계 자산을 계속 생성하지 마세요.
- 사용자가 명시적으로 위임을 요청하거나 해당 지침이 요구하지 않는 한 하위 에이전트나 병렬 에이전트를 사용하지 마세요.
이 스킬이 실행을 실질적으로 변경하는 경우, 작업이 분할되거나 인계되고 그 이유를 사용자에게 간략히 알리세요.