에이전트에게 대량 콘텐츠를 생성시키는 건 쉽습니다. 쓰레기를 배포하지 않으면서 시키는 건 3단계 규율입니다.
1. SPEC.md를 쓴다
생성 전에 data/*/SPEC.md에 정확한 스키마·품질 기준·예시 골격 하나를 씁니다. 스펙이 "완료"를 체크 가능하게 만듭니다 — 에이전트가 좋은 게 뭔지 추측하는 게 아니라 정의된 형태에 맞춥니다.
2. 파일럿 1배치 생성 — 그리고 검증
Codex가 파일럿 1배치를 먼저 생성하게 하고, 손으로 검증합니다. 값싼 체크포인트입니다: 스키마가 틀렸거나, 톤이 어긋나거나, 구조가 안 서면 50개가 아니라 1배치에서 압니다. 파일럿이 통과한 뒤에야 규모를 키웁니다.
3. 병렬 배치, 스키마 파싱을 게이트로
그다음 병렬 배치가 돕니다:
codex exec -C <dir> -s workspace-write --skip-git-repo-check "$(cat SPEC 기반 프롬프트)"…nohup으로 백그라운드. 게이트는 빌드에 연결된 엄격한 스키마 파싱(zod): 깨진 파일은 배포가 아니라 빌드를 실패시킵니다. 빌드 통과가 곧 콘텐츠 검증 — 구조 파손을 잡으려 별도 리뷰 패스가 필요 없습니다.
솔직한 부분
유능한 에이전트의 유혹은 곧장 "전부 생성"으로 건너뛰는 것입니다. 그럴 때마다 미묘하게 틀린 파일 한 배치를 전부 다시 만드는 비용을 치렀습니다. 파일럿 배치는 제가 아는 가장 값싼 보험입니다: 볼륨에 커밋하기 전 검증된 예시 하나. 그리고 빌드 경계의 스키마 파싱은 실패 모드를 조용히 깨진 프로덕션 데이터가 아니라 빨간 빌드로 만듭니다. 기계가 자기 실수를 잡도록 위임을 구조화하세요.