← App Store Screenshot StudioRead in English →

2026년 6월 업데이트: 안전한 레이아웃 검사와 더 자율적인 에이전트 워크플로

오늘 업데이트는 화려한 기능보다 도구를 믿고 반복해서 쓸 수 있게 만드는 쪽에 가깝습니다. 레이아웃 리포트 데이터가 더 정확해졌고, 작은 진단 버그들이 정리됐으며, AI 코딩 에이전트가 스크린샷 세트를 검사하고 보수적인 manifest 수정을 적용한 뒤 다시 렌더링할 수 있는 안전한 루프가 생겼습니다.

루프를 믿을 수 있게 만드는 기본 수정

헤들리스 렌더러는 이미 파일 폴더에서 스크린샷을 만들어낼 수 있었습니다. 약한 부분은 렌더링 뒤 레이아웃 문제가 발견됐을 때였습니다. 리포트가 텍스트 겹침이나 팝업의 안전 영역 이탈을 알려주더라도, 그 문제가 manifest의 어떤 필드에서 왔는지 항상 분명하지는 않았습니다.

이제 그 부분이 정리됐습니다. 레이아웃 리포트의 각 박스는 manifestPath를 갖고, issue는 관련 manifestPaths를 함께 전달하며, 각 issue는 suggestedFix를 노출할 수 있습니다. 렌더러는 --fail-on-layout-issues 옵션으로 레이아웃 문제가 있으면 명시적으로 실패할 수도 있습니다. CI나 에이전트가 돌리는 작업에서는 조용한 경고보다 훨씬 다루기 좋습니다.

에이전트가 실제로 쓸 수 있는 요약 파일

새로 중요한 산출물은 layout-summary.json입니다. 사람이든 에이전트든 긴 시각 리포트를 거꾸로 해석하지 않아도 되도록, issue와 suggested edit을 원래 manifest에 가까운 형식으로 묶습니다.

이게 중요한 이유는 manifest가 스크린샷 프로젝트와 자동화 사이의 안정적인 계약이기 때문입니다. /slides/1/highlights/0/popup/centerY 같은 JSON Pointer는 "두 번째 카드를 조금 아래로 내려"보다 훨씬 안전합니다. 전자는 검사하고, diff로 보고, 적용할 수 있습니다.

제안에서 안전한 자동 수정까지

이제 layout-summary.json을 읽고 suggested manifest edit을 적용하는 작은 fixer가 있습니다. 의도적으로 보수적으로 동작합니다. 기본은 dry-run입니다: 무엇이 바뀔지 출력만 하고 파일은 건드리지 않습니다. 실제 파일을 쓰려면 명시적으로 --write를 붙여야 합니다.

npm run headless:export -- launch-screenshots/ out/ --report
npm run layout:fix -- out/layout-summary.json launch-screenshots/manifest.json
npm run layout:loop -- launch-screenshots/ out/ --write --max-runs 3

첫 번째 명령은 렌더링과 리포트를 만듭니다. 두 번째는 사람이 읽을 수 있는 dry-run 요약을 보여줍니다. 세 번째는 전체 루프를 실행합니다: 렌더링하고, 안전한 manifest 수정을 적용하고, 다시 렌더링하며, 문제가 없어지거나 최대 반복 횟수에 도달하면 멈춥니다.

첫 지원 범위는 현지화된 App Store 스크린샷에서 자주 막히는 문제들입니다: text-overlap, safe-margin-overflow, badge-seam-overlap, 그리고 highlight popup의 overflow/source-overlap 계열입니다. 내보낸 PNG가 아니라 manifest 값을 고치기 때문에, 프로젝트는 계속 편집 가능하고 반복 가능합니다.

정리된 에이전트 스킬과 덜 시끄러운 저장소

프로젝트 전용 에이전트 스킬은 이제 .agents/skills/ 아래에 모았습니다. 반복해서 쓰는 루틴도 더 찾기 쉬워졌습니다: 세 단계 테스트 흐름 실행, 동작 변경 뒤 stale test 업데이트, 브라우저에서 project-import 파이프라인 검증, promo 플로 기록. 로컬 런타임 상태는 저장소 밖으로 빠져서, 다음 에이전트가 일을 시작할 때 관계없는 변경사항에 덜 흔들립니다.

왜 중요한가

목표는 에이전트에게 디자인 결정을 마음대로 맡기는 것이 아닙니다. 지루한 부분을 좁고 검토 가능한 경로로 넘기는 것입니다: 정확한 산출물을 렌더링하고, 기계적인 레이아웃 문제를 찾고, 가장 작은 manifest 수정을 만들고, diff를 보여주는 것. 취향은 여전히 사람이 가집니다. 루프는 수동으로 몇 번씩 위치를 미는 일을 줄여줄 뿐입니다.

이것은 App Store Screenshot Studio의 원래 철학과도 맞습니다: 계정 없음, 서버 없음, 스크린샷 업로드 없음, 숨겨진 상태 없음. 파일을 넣으면 PNG와 리포트가 나오고, 자동으로 바뀐 것은 적용 전에 검토할 수 있습니다.