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에서 도입을 시작하세요.