The Harness
The Harness
The Harness
규칙으로 부탁하는 대신, 허용된 경로만 통과시키고 우회는 실패로 바꾸는 통제 구조를 다룬다.
60초 요약
- 문제는 대개 코드 한 줄이 아니라, 여러 우회 경로가 동시에 열려 있다는 데서 시작된다.
- 하네스는 “이렇게 해달라"고 설명하는 대신, 합법 경로만 통과하도록 구조를 고정한다.
- 목표는 모든 우회를 완벽히 제거하는 것이 아니라, 우회가 정공법보다 비싸고 더 잘 보이게 만드는 것이다.
- 이 문서는 모든 경계에 같은 강도의 강제를 요구하지 않는다. 핵심은 사고 비용이 큰 경계부터 safe velocity를 확보하는 것이다.
하네스 한 장 그림
먼저 한 장면만 본다
겉으로는 같은 기능을 만들지만, 시스템에는 전혀 다른 흔적을 남기는 두 경로가 있다.
// 우회: 값을 바로 바꾼다
document.status = "published";
save(document);// 합법 경로: 허용된 진입점을 통과한다
dispatch({ type: "publish", docId: document.id });첫 번째 경로는 빠르지만 검증, 전이, 이벤트 발행, 테스트 정렬을 쉽게 놓친다. 두 번째 경로는 더 길어 보이지만, 빌드 타임 규칙과 런타임 가드, 테스트 하네스가 같은 경계를 공유하게 만든다.
적용 기준
하네스는 모든 시스템을 곧바로 철창처럼 잠그자는 주장이 아니다. 초기 프로토타입, 레거시 정리, 핵심 상태 전이 경계는 같은 강도로 다루지 않아야 한다.
중요한 것은 엄격함 자체가 아니라, AI와 사람이 같은 우회를 반복해서 만들며 비용을 키우는 표면부터 닫아 안전한 속도를 확보하는 것이다.
적용 비용과 강도 조절은 도입 전략과 트레이드오프에서 따로 다룬다.
읽기 시작점
- 문제를 먼저 보려면 → 개요
- 하네스의 실제 우회 패턴을 보려면 → 하네스
- 강제가 실제로 어떻게 작동하는지 보려면 → 실행 통제
- 용어 기준부터 맞추려면 → 용어집
- 비용과 적용 강도를 먼저 보려면 → 도입 전략과 트레이드오프