KeystoneHarness — Hooks & Gates
04Gate type HARD / SOFT / Loop SOFT -> HARD

Harness — Hooks & Gates

HARD 차단과 SOFT 경고로 구성된 품질 게이트 시스템. 규칙을 읽으라고 요청하는 대신 진행 자체를 제어한다.

Gate typeHARD / SOFT

차단과 경고를 분리

LoopSOFT -> HARD

반복 위반은 자동 승격

Foundation / FoundationHarness — Hooks & Gates 기준선

quality brief · portfolio detail

01작업 요약

HARD 차단과 SOFT 경고로 구성된 품질 게이트 시스템. 규칙을 읽으라고 요청하는 대신 진행 자체를 제어한다.

이 기준이 흐려지면 페이지가 설명 자료로만 남고, 독자는 어떤 근거와 산출물을 확인해야 하는지 다시 물어봐야 합니다.

02입력 의존성

  • Gate type: HARD / SOFTready

    차단과 경고를 분리

  • Loop: SOFT -> HARDready

    반복 위반은 자동 승격

  • Policy to Harness Lifecyclewatch

    문서 규칙이 hook, eval, verdict로 승격되는 과정

  • 에이전트 운영 보기watch

    하네스를 사용하는 작업자 역할 분담

03리스크 신호

SignalSeverityMeaningFirst response
01_하네스란_무엇인가high하네스란 무엇인가Git 보호: .env 커밋, --no-verify, 보호 브랜치 직접 커밋 차단
02_자동_승격medium자동 승격같은 패턴이 반복되면 SOFT 경고는 HARD 차단 후보가 된다. 프롬프트로만 고치지 않고 실행 가능한 규칙으로 올리는 것이 핵심이다.

04반복 절차

하네스란 무엇인가

이 페이지를 처음 읽을 때

개발자나 AI가 실수하면 코드가 차단된다. HARD Gate는 조건 미충족 시 edit/write/push를 막고, SOFT Guard는 경고와 추가 맥락을 주입한다.

Git 보호: .env 커밋, --no-verify, 보호 브랜치 직접 커밋 차단코드 품질: any, console.log, CSS import 누락 같은 문제 감지행동 규칙: 증거 없는 완료 선언, 추측 답변, 사용자에게 검증 떠넘기기 방지

자동 승격

세부 기준을 검토할 때

같은 패턴이 반복되면 SOFT 경고는 HARD 차단 후보가 된다. 프롬프트로만 고치지 않고 실행 가능한 규칙으로 올리는 것이 핵심이다.

자동 승격Gate typePolicy to Harness Lifecycle

05역할 분담

RolePrimary workHandoff
Owner기준과 공개 범위 유지Decision / Boundary notes
Builder문서, 화면, 실행 산출물 반영Implementation notes
Reviewer누락, 과장, 공개 리스크 검토Review findings
Maintainer변경 후 다음 버전 동기화Update queue

06완료 체크리스트

01

한 문장으로 설명 가능

이 페이지가 어떤 판단을 돕는지 제목, 요약, 첫 절차에서 바로 읽혀야 합니다.

02

근거와 산출물 연결

설명만 남기지 않고 기준, 결과물, 다음 페이지가 같은 맥락으로 이어져야 합니다.

03

공개 가능한 범위 확인

내부 경로, 계정, 고객 정보, 미검증 아이디어가 섞이지 않아야 합니다.

04

다음 행동이 남음

읽은 사람이 어디를 보고 무엇을 검토하면 되는지 링크와 체크 항목으로 남아야 합니다.

Next read