증거와 audit, 사용자 확인

증거 적는 법

원칙은 하나예요. 실행하지 않은 검사는 통과가 아니에요. 증거 형식은 prokit-verify 스킬이 정해요.

• ✓, ok, done, 완료만 적거나 공백을 뺀 4자 미만으로 적으면 증거가 아니에요.

• 결과를 얻지 못했으면 blocked: 사유나 미실행: 사유로 적어요. blocked는 이번 세션에서 해소할 수 없는 원인(외부 서비스, 권한, 사용자 허락 없이 설치할 수 없는 도구 등)에 쓰고, 미실행은 사용자가 범위에서 뺀 단계나 앞 단계가 blocked여서 할 수 없는 뒤 단계에 써요.

• 테스트 러너(vitest 도입 행)나 로컬 테스트 DB처럼 라운드 안에서 준비하기로 된 것이 없다는 이유로는 blocked를 쓰지 않고 그 준비부터 해요.

• 다른 검사가 통과했다고 해서 실행하지 못한 검사를 통과로 합치지 않아요.

• 비밀값, 토큰, 연결 문자열, 실사용자 데이터는 증거에 옮겨 적지 않아요.

검사 고르기

바뀐 것에 따라 최소 검사가 정해져 있어요. 여러 줄에 해당하면 모두 해요.

명령은 .dev-cycle.json의 commands에 있어요. 린트 증거는 파일을 고치지 않는 pnpm exec biome check .로 남겨요. pnpm check는 파일을 고치므로 증거로 쓰지 않아요.

오류 예산은 0이에요. 확인한 화면마다 브라우저 콘솔의 오류와 경고, 개발 오버레이의 Issues, Next.js 진단(get_errors), 개발 서버 로그의 오류를 세요. 브라우저 확장 탓으로 보이는 항목도 빼지 않고, 깨끗한 브라우저에서 재현해 원인을 가려요.

audit

pnpm dev-cycle audit은 대조표를 검사해요.

• 빈칸이 있으면 실패해요.

• 작업이 다른 계층을 건드렸으면 케이스를 올리라고 알려 줘요.

• [confirm] 칸을 N/A, PASS, blocked, 미실행, 대기 같은 건너뛰기 표시로 채우면 거부해요.

• blocked:나 미실행:으로 채운 칸은 채운 것으로 봐요. 그래서 그런 칸이 있으면 "부분 완료(blocked N건, 미실행 M건)"로 보고하고, 사용자가 그대로 닫자고 할 때만 pnpm dev-cycle close --partial로 닫아요. 아직 하지 않은 작업을 이렇게 적어 audit을 넘기지 않아요.

audit이 통과한 뒤에만 완료라고 말해요.

사용자 확인

대조표 끝의 [confirm] 행은 사용자가 결과를 직접 보거나 써 본 뒤에 채워요.

• 에이전트는 먼저 audit으로 남은 문제가 이 행뿐인지 봐요. 사용자가 확인할 것은 마지막 결과예요.

• 화면이 있으면 개발 서버를 띄워 주소가 응답하는지 확인한 뒤 확인을 요청하고, 사용자가 답할 때까지 끄지 않아요.

• 화면이면 주소와 스크린샷, 기능이면 써 볼 순서를 줘요. 새 기능(F)은 스펙의 테스트 시나리오가 순서예요. 알려진 문제(남은 오류, 미룬 지적)도 함께 알려 줘요.

• 사용자가 확인하면 그 내용과 날짜를 적어요. 고칠 것이 나오면 고치고, 그 행을 다시 채운 뒤 확인을 또 받아요.

• 에이전트가 이 행을 스스로 넘기지 않아요. 사용자가 결과를 보지 않고 닫자고 하면 그 말과 날짜를 그대로 적어요(예: 사용자: 확인 없이 닫는다(2026-10-01)).

자세히

비밀값 검사

커밋 전에 pnpm dev-cycle secrets가 커밋할 변경에서 비밀값을 찾아요.

화면 점수 기준

화면 작업(케이스 B, B 행을 포함하는 F)의 impeccable audit 점수는 20점 만점에 16점(ui.auditMin), 접근성 점수는 4점 만점에 3점(ui.a11yMin) 이상이어야 해요. 다시 확인해도 못 미치면 완료로 보고하지 않고 더 다듬을지 물어요. 사용자가 그대로 두자고 하면 그 사실과 날짜를 적어요.

관련 문서

• dev-cycle 라운드

• 케이스 A~F·H와 대조표

• 비밀값 지키기

• 검증 결과