# Verification Engine

Use when verifying build/test/lint before commit, PR, or completion claims.

- Repository: https://github.com/sangrokjung/claude-forge (868 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-09-03
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add sangrokjung/claude-forge --skill verification-engine -g -a claude-code -y`
Codex: `npx skills add sangrokjung/claude-forge --skill verification-engine -g -a codex -y`
Cursor: `npx skills add sangrokjung/claude-forge --skill verification-engine -g -a cursor -y`
Gemini CLI: `npx skills add sangrokjung/claude-forge --skill verification-engine -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add sangrokjung/claude-forge`

## Description

Use when verifying build/test/lint before commit, PR, or completion claims. Runs verification pipeline in fresh subagent context with auto-repair. Triggers on /handoff-verify, pre-commit check, build verification, test validation.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## 검증 원칙

Iron Law, Gate Function, Common Failures 체크리스트는 `rules/verification.md`에 정의되어 있다.
이 스킬은 해당 원칙의 **실행 엔진**이다.

---

## Overview

통합 검증 엔진 스킬은 `/handoff-verify` 커맨드의 핵심 동작을 정의한다.
v5의 `/verify` 단독 커맨드에서 v6의 `/handoff-verify` 통합 커맨드로 진화하였다.

핵심 변경: **Task 도구로 verify-agent 서브에이전트를 생성하여 fresh context에서 검증.**
`/clear` 없이도 편향 없는 검증이 가능하다.

---

## Trigger Conditions

### 직접 호출

| 트리거 | 설명 |
|--------|------|
| `/handoff-verify` | 핸드오프 + 기본 루프 검증 (최대 5회) |
| `/handoff-verify --once` | 핸드오프 + 단발 검증 |
| `/handoff-verify --loop 3` | 핸드오프 + 3회 루프 |
| `/handoff-verify --security` | 핸드오프 + 보안 검증 포함 |
| `/handoff-verify --coverage` | 핸드오프 + 테스트 커버리지 분석 |
| `/handoff-verify --extract` | 핸드오프 + 에러 추출/분류 모드 |
| `/handoff-verify --skip-handoff` | 핸드오프 생략 + 검증만 |

### 자동 호출

| 상황 | 동작 |
|------|------|
| `/commit-push-pr` 실행 전 | `--once` 모드로 사전 검증 |
| `/orchestrate` 검증 단계 | 루프 모드로 자동 실행 |

---

## Architecture (v6)

```
/handoff-verify 커맨드 (부모 컨텍스트)
   │
   ├── [1] handoff.md 자동 생성
   │     └── git diff 분석, 변경 의도 문서화
   │
   ├── [2] verify-agent 서브에이전트 생성 (Task 도구)
   │     └── Fresh context! (/clear 대체)
   │         │
   │         ├── handoff.md 읽기
   │         ├── 검증 파이프라인 실행
   │         ├── 실패 시 자동 수정 + 재시도
   │         └── 결과 반환
   │
   └── [3] 결과 수신 및 처리
         ├── PASS → handoff.md 정리, 다음 단계 안내
         └── FAIL → 에러 보고, 권장 조치 안내
```

### v5 대비 아키텍처 변경

| v5 | v6 |
|----|-----|
| /handoff → /clear → /verify | /handoff-verify (단일 커맨드) |
| 부모 컨텍스트에서 직접 검증 | 서브에이전트가 fresh context에서 검증 |
| /clear로 컨텍스트 손실 | 부모 컨텍스트 보존 |
| 수동 3단계 워크플로우 | 자동 1단계 워크플로우 |

---

## Verification Pipeline

### 단계별 실행 순서 (verify-agent 내부)

The rest: https://github.com/sangrokjung/claude-forge/blob/HEAD/skills/verification-engine/SKILL.md