제네릭 주제 기반 xhigh 보고서 위임 지침서

Purpose

대형 Markdown/report/knowledge 컬렉션을 background write-agent에게 위임할 때 topic worker와 final integration worker를 분리하는 재사용 지침입니다.

운영 원칙

• 파일 수는 worker 수가 아니다. 최상위 주제 그룹이 자연스럽게 존재하면 topic worker를 우선 선택한다.
• Topic worker는 자기 주제의 모든 source를 직접 읽고 file-level report와 topic integrated knowledge를 함께 만든다.
• Final cross-topic integrated knowledge는 모든 topic integrated knowledge가 실제로 존재한 뒤 별도 handoff로 작성한다.
• 완료 보고는 allowed changes, blocked changes, 실행한 테스트, 실행하지 못한 테스트, residual risk, handoff item을 분리한다.

절차

1. Parent Simdeong이 source tree, 사용자 요청 단위, output boundary를 확인한다.
2. 파일 수가 아니라 최상위 주제 그룹을 기준으로 worker 수를 설계한다.
3. 각 handoff에 paths, sourceManifest, scope, qualityRequirements, coveragePolicy를 명시한다.
4. 독립 topic 작업은 병렬 실행하되 final/root 작업은 모든 dependency가 존재한 뒤 별도 stage로 실행한다.
5. 소스를 직접 읽을 수 없으면 전체를 읽은 것처럼 쓰지 않고 limitation 또는 blocker를 명시한다.

Failure modes

• Final worker를 topic worker와 같은 독립 batch에 넣어 누락된 근거로 최종 보고서를 만드는 경우.
• 주제별 요청을 파일별 worker 수로 오해해 중복 산출물을 만드는 경우.
• 원본 Markdown이나 이전 산출물을 덮어써 근거 추적성을 잃는 경우.
• 명시 요청 없이 archive/original HTML을 생성하는 경우.
• Cloudflare URL처럼 completion workflow가 반환해야 할 값을 writer가 임의로 주장하는 경우.

Stage 3 static HTML. Relative links only.