DWP v5: 이제 보장되는 약속들

오늘 Deep Work Plan v5를 릴리스합니다. 이것은 다시 쓰기가 아닙니다. 실제 플랜 108개에 대한 직접 감사를 포함해, 방법론의 약속과 에이전트의 실제 동작이 어디에서 어긋날 수 있는지를 격차 하나하나 드러낸 몇 달간의 실사용의 결과입니다. 이 릴리스의 정직한 요약은 이렇습니다. 이 방법론은 이미 이 모든 것을 약속해 왔습니다 — 이제는 이를 보장합니다. v5 이전에는 문서를 글자 그대로 따르는 에이전트조차 실제 실패 시나리오에 빠질 수 있었습니다. 그런 시나리오는 이러한 사용과 피드백을 통해 식별되어, 이제 하나씩 모두 닫혔고 실행 가능한 테스트로 고정되었습니다 — 더 많은 글로 덮어 가린 것이 아닙니다. 이번 주기에 스킬의 계약 스위트는 132개에서 258개 테스트로 성장했고, 아래의 모든 보장은 릴리스된 태그를 대상으로 실제로 검증되었습니다 — 깨끗한 저장소에 설치하고 고유한 흐름을 전부 통과시킨 뒤에야 이 항목을 작성했습니다.

검증하지 않은 성공을 절대 주장하지 않는 검증기. 적합성 검사는 예전에 조용히 저하되었습니다. 유능한 인터프리터가 없으면 모든 검증을 건너뛰면서도 여전히 적합하다는 판정을 출력했고, 필드 안의 굵은 텍스트가 누락된 필드로 오인되기도 했습니다. 이제 검증기는 실제로 검증할 수 없을 때 언제나 명시적인 UNVERIFIED 판정으로 종료됩니다. 검증기는 자신이 확인하지 않은 성공을 보고하지 않습니다 — 게이트에 대한 신뢰가 제안의 전부이며, 자기 검사를 건너뛸 수 있는 게이트는 그 신뢰의 사슬을 끊습니다.

Lite 플랜에 대한 단일 승인 계약. “이 플랜을 시작하는 것이 현재 범위를 승인하는 것인가?“라는 질문에 세 표면이 서로 다른 답을 내놓았고, 에이전트는 가장 위험한 경계에서 정확히 교착하거나 승인 없이 실행할 수 있었습니다. v5는 모든 곳에 하나의 계약을 정착시킵니다. 명시적인 execute 또는 resume이 현재 ready 범위를 승인하고, 어떤 작업보다 먼저 그 승인을 기록합니다. 보류 중인 제안만으로는 아무것도 승인되지 않습니다. 중단된 승격은 제품 작업이 실행되기 전에 복구됩니다.

상태를 훼손하지 않는 다중 저장소 오케스트레이션. 오케스트레이터 허브의 환경 오버라이드는 예전에 자식 저장소로 새어 나갔습니다 — 자식이 허브 자신의 폴더에 플랜 상태를 쓸 수도 있었습니다. 오케스트레이터 템플릿은 FAIL을 출력하면서도 성공으로 종료했고, 상태 문자열을 grep하는 완결성 검사는 완료된 작업 하나를 완료된 플랜으로 잘못 읽을 수 있었습니다. 이제 허브 루트는 하위 저장소로 이동하기 전에 저장되고, 각 자식은 자신의 .dwp/를 격리되게 해석하며, 모든 실패 분기는 오류로 종료되고, 완결성은 플랜의 최상위 상태에서 파싱되며, devcontainer 진입점은 무언가를 삭제하기 전에 복사 오류를 전파합니다.

하나의 애드온 동의 매트릭스. 어떤 애드온이 기본으로 설치되고, 어떤 것은 제안만 되며, 어떤 리뷰가 필수인지 — 이전 표면들은 서로 다르게 답했습니다. v5는 하나의 매트릭스를 선언합니다. AI Diff Reviewer는 로컬 리뷰에 필수이며 검증된 릴리스에 고정되고, CI 리뷰는 절대 스스로 설치되지 않는 명시적 옵트인입니다. design-system 애드온은 UI 작업이 감지되면 반드시 제안되지만, 명시적 수락이 있을 때만 설치됩니다. dependency-upgrade 애드온은 거의 기본값인 불활성 위임자로 도착하며 정확한 스냅샷 롤백을 갖추고, dailybot은 승인된 곳에서만 보고합니다. 빈 diff는 더 이상 완료된 리뷰로 간주되지 않습니다.

긴 플랜을 위한 실질적인 기제. 실제 플랜 108개에 대한 감사는 병렬화 가능한 작업이 흔했지만 순차 실행 결정은 거의 선언되지 않았고, 스테이지 게이트는 즉흥적인 관행에만 존재했음을 보여주었습니다. v5는 실행 결정이 항상 선언되게 합니다 — 병렬화가 타당하지 않을 때는 이유가 기록된 순차 실행으로 선언됩니다 — 20개 이상 작업의 플랜에 선택적 Stage Gates를 추가하고, Plan Variables를 엄격도 단계·증거 기준·금지 작업으로 확장합니다. 이 모든 것은 점진적으로 로드되며 Lite 플랜에 결코 부담을 주지 않습니다.

강제되는 Context, 작업당 하나의 목표. 플랜은 맥락 없는 작업 목록으로 퇴화할 수 있었고, 하나의 작업이 초록 게이트 하나 뒤에 세 가지 목표를 묶을 수도 있었습니다. v5는 플랜 수준의 Goal과 Context 쌍을 요구하고, 모든 새 작업 기록에 작업 수준의 Context — 새 세션이 해당 작업만 홀로 시작하는 데 필요한 것 — 를 요구하며(완료된 기록은 작성된 그대로 유지), 작업당 하나의 목표를 붕괴를 막는 수호 장치가 붙은 규범적 규칙으로 만듭니다.

안전한 업그레이드 경로. /dwp-upgrade는 새로 생겼습니다. 확인 단계는 읽기 전용이며 아무것도 설치하지 않습니다. 업그레이드는 명시적 수락이 있을 때만 시작되고, 무언가를 덮어쓰기 전에 로컬 적용 내용이 비교되어 노출됩니다. 설치는 정확한 태그를 대상으로 하며 스스로를 검증하고, 온보딩은 새로운 init으로 다시 실행됩니다. 업그레이드는 결코 .dwp/를 건드리지 않습니다 — 어떤 플랜, 상태 파일, 게이트 기록, 증거도 마이그레이션·재작성·무효화되지 않습니다.

정직하고 측정 가능한 증거. 효율성 주장은 이제 세 가지 베이스라인 — v3.0.0, v4.0.3, 최종 트리 — 에서 다시 측정되며, 측정 스크립트는 저장소에 커밋되어 있습니다. 결과는 파일시스템 바이트로 보고되며, 우리가 뒷받침할 수 없는 토큰 수나 비용 수치로 결코 환산되지 않습니다. 검증할 수 없는 모든 주장은 평가 기록에서 그렇게 격리됩니다.

버전이 관리되고 공개된 계약. 위의 모든 약속은 글이 아니라 다른 도구가 읽을 수 있는 데이터로 뒷받침됩니다. plan-manifest와 plan-state 형식은 이제 v5 스키마 계열로 버전이 관리됩니다 — plan-manifest/v5.json과 plan-state/v5.json — 그래서 플랜, 검증기, 또는 서드파티 도구가 문서 한 단락 대신 공개되고 기계가 읽을 수 있는 계약에 대해 적합성을 확인할 수 있습니다. v5 계열은 v2 대비 형태를 전혀 바꾸지 않습니다. v1이나 v2 스키마를 참조하는 기존 플랜은 계속 유효하며 결코 다시 작성되지 않습니다.

Deep Work Plan v5는 DWP 표준 5.0.0을 따릅니다. 규범 명세를 읽고, 스킬 저장소를 확인하거나, /init에서 도입을 시작하세요.

업데이트 — 2026-09-17 · 스킬 v5.4.0

v5 계열의 첫 포인트 릴리스는, 실제로는 한 번도 확인되지 않은 작업 위에서 계획이 마무리될 수 있었던 마지막 경로를 막고, 계획 자신의 증거가 어디에 놓이는지를 확정합니다. DWP 표준 5.0.0은 그대로입니다. 이번은 애드온 계약과 문서의 릴리스이며 스키마 변경이 아닙니다.

한 번도 실행되지 않은 리뷰가 더 이상 깨끗한 리뷰와 구분되지 않는 일은 없습니다. Final Review의 보안 점검은 리뷰어 부재(지적으로 기록)와 호출 오류(한 번 경고하고 계속)를 이미 구분하고 있었습니다. 업스트림 리뷰어는 세 번째 결말을 더했습니다. 시작한 뒤 지적을 하나도 쓰지 않고 종료하는 실행입니다. 이름이 없을 때 그것은 “점검이 완료되었고 아무것도 찾지 못함”에 흡수되어, 일어나지도 않은 리뷰를 근거로 계획을 닫게 만들 수 있었습니다. 이제는 그 자체가 하나의 상태입니다. 불완전한 리뷰로 기록되고, 변경 사항이 깨끗하다는 근거로 결코 계산되지 않으며, Final Review를 닫을 이유도 되지 않습니다. 서로 다른 세 가지 결말이 있고, 그 어느 것도 “diff를 읽었고 문제가 없었다”를 뜻하지 않습니다.

계획의 증거는 계획의 것입니다. 표준은 분석 기록, skills 대장, 보안 검토, 게이트 로그를 이미 계획 자신의 analysis_results/ 안에 두고 있었지만, 그 배타성을 규칙으로 말한 적은 없었습니다. 그래서 보고서 경로가 기본적으로 작업 디렉터리를 가리키는 저장소 자체의 감사 도구가, 어떤 플로우도 알아채지 못한 채 계획의 증거를 저장소 루트에 써 버릴 수 있었습니다. 이제 명세가 이를 요구합니다. 플로우가 어떤 계획에 관해 만들어 낸 것은 모두 그 계획의 폴더로 가고, 기본 출력이 작업 디렉터리인 도구에는 명시적인 출력 옵션을 주어야 합니다. 계획이 말한 자리에 없는 증거는 잃어버린 증거입니다. 이것이 규칙의 현실적인 이유이며, 정리 취향이 아닙니다.

AI Diff Reviewer 고정 버전이 v2.3.0으로 올라갑니다. 필수 로컬 리뷰가 이제 설치하는 리뷰어는 runner와 backend를 분리합니다. 따라서 동일한 리뷰를 호환되는 어떤 엔드포인트에 대해서도 실행할 수 있으면서 DWP가 의존하는 대상은 달라지지 않습니다. 중립성 보장은 느슨해지는 것이 아니라 강해집니다. 여기에 체크섬으로 검증되는 설치 프로그램, 추측이 아니라 실측에 근거한 비용 기본값, 그리고 미해결 지적을 이어받으면서 실제로 새로 생긴 diff를 검토하는 후속 라운드가 더해집니다. 마지막 항목에는 분명히 말해 둘 계약상의 결과가 있습니다. 모델이 스스로 어떤 지적을 해결했다고 주장해도 그것이 철회되지는 않습니다. 철회하는 것은 메인테이너입니다.

작업 원칙이 이제 하니스와 함께 배포됩니다. 같은 날 뒤이어 나온 v5.5.0은 온보딩이 저장소에 무엇이 있는지뿐 아니라 그 저장소의 agent가 어떻게 일해야 하는지까지 가르치게 합니다. 열 가지 간결한 행동 — 결과를 책임지기, 묻기 전에 조사하기, 일상적 판단은 독립적으로 내리기, 판단 근거나 권한이 정말 없을 때 에스컬레이션하기, 완료를 주장하기 전에 검증하기 등 — 을 AGENTS.md에 인라인으로 적어, 진입 파일만 읽는 agent도 찾을 수 있게 합니다. 이는 요청 범위 안의 기본값이지 새로운 권한이 아닙니다. 호스트 권한, 더 좁은 범위, 계획의 게이트, 저장소 자체의 승인 규칙을 무시할 수 없습니다. 업그레이드는 키워드가 아니라 의미로 조정하므로, 이미 있는 동등한 규칙은 덮어쓰지 않고 유지됩니다.

AI Diff Reviewer 고정 버전이 v2.3.1로 올라갑니다. 스킬 v5.5.1이 설치하는 리뷰어는 check, 리뷰 본문, 추적 댓글이 서로 일치합니다. 본문이 Recommendation: approve라고 적혀 있어도 check가 통과했다는 증거가 아닙니다 — 추적 마커의 Check status 블록을 읽으세요. advisory 모드에서는 스레드가 이미 접힌 지적도 뒷받침된 수정으로 철회할 수 있어, 막힌 PR이 실제 수정 뒤에 초록으로 바뀔 수 있습니다.

규범 텍스트는 명세를, 리뷰어가 지금 무엇을 하는지는 애드온 레퍼런스를, 출처는 v5.5.1 릴리스를 보세요.

업데이트 — 2026-09-25 · 스킬 v5.5.3 + 리뷰어 v3.1.1

AI Diff Reviewer 애드온은 이제 2026-09-24에 출시된 리뷰어의 v3 라인(v3.0.0 → v3.1.1, 이동 핀 @v3)을 문서화하고 설치합니다. 스킬 v5.5.2는 애드온의 규범 문서, 온보딩 훅, 통합 템플릿을 v3 리뷰어가 실제로 하는 일에 맞춰 다시 썼고, v5.5.3이 CI 측을 출하했습니다. 태그 v3.1.1의 출시된 리뷰어에 대해 검증된 가장 중요한 변경 사항:

critical은 검증된 경우에만 게이트합니다. v3부터 모델이 주장하는 각 크리티컬 발견 — 경고의 30 % 샘플 추가 — 은 별도의 모델 호출에 의한 두 번째 짧은 코드 기반 검사를 받습니다(검증된 발견당 ≈ 3 k 토큰, 10 초, $0.009). critical이 게시되는 — 그리고 Final Review를 차단하는 — 것은 그 검증기가 확인할 때만입니다. 반박된 주장은 주석 달린 경고로 계속 보이며 구조화된 출력에 나열되고, 인라인으로 게시되지 않습니다. 턴 한도(incomplete)나 벽시계(timeout)를 소진한 리뷰는 차단 엄격도에서 빨간색입니다. “발견 없음”은 이제 항상 리뷰어가 보았고 아무것도 찾지 못했다는 뜻입니다.

예산은 위험 등급을 따릅니다. 리뷰 예산은 변경의 결정론적 위험 등급에서 도출됩니다 — low에서 critical까지 8/20/30/40 턴 — 그리고 코드를 전혀 변경하지 않는 푸시는 −93 % 비용으로 검증기 전용 라운드를 실행합니다. budget-profile: fixed는 전환 기간에 v3 이전 상수를 복원합니다. 증분 라운드는 입력 토큰을 62–76 % 절감합니다.

여섯 개의 하위 스킬, 그중 하나는 루프. 라우터에 address-review(v3.1.1 신규)가 추가됩니다. 한 번의 호출로 브랜치의 열린 PR을 찾고, 리뷰가 현재 head를 커버하는지 확인하고, 발견 항목을 제시한 뒤 — 한 번의 “예”로 — 적용하고, 작은 Conventional Commits 배치로 커밋하고, 푸시하고, 저장소가 트리거하는 방식으로 리뷰어를 재무장합니다. apply-review는 읽기 전용으로 유지됩니다. 구조화된 출력(review-output/3.0)이 모든 자동화의 기계용 경로입니다. @v2 라인은 release/v2에서 6개월의 보안 및 카탈로그 유지보수와 함께 동결됩니다 — v3는 권장 사항이며 결코 강제 이전이 아닙니다.

리뷰어는 이제 자신의 home을 리뷰합니다. 스킬 저장소와 이 웹사이트 모두 라벨 게이트식 CI 셀프 리뷰를 실행합니다 — DailybotHQ/ai-diff-reviewer@v3을 통한 단일 grok 레그, ready 라벨 적용당 한 번 트리거(재실행은 라벨을 뗐다 다시 부착), 제공자 시크릿이 없으면 정직하게 건너뜁니다. 이 웹사이트는 v3.1.1 리뷰어도 vendorize하여, 로컬 Final Review와 문서가 이제 동일한 계약을 가르칩니다.

명세, v3 전체 기능 목록은 애드온 참조, 소스는 v5.5.3 릴리스, 업스트림 변경 사항은 리뷰어 v3.1.1 릴리스를 읽어 주세요.