mcpbeat

Verification Loop

loulanyue/awesome-claude-notes-verification-loop

A comprehensive verification system for Claude Code sessions.

622 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
265
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/loulanyue/awesome-claude-notes --skill verification-loop

The instruction itself

7 sections, as written by the author

검증 루프 스킬

Claude Code 세션을 위한 포괄적인 검증 시스템.

사용 시점

다음 상황에서 이 스킬을 호출하세요:

  • 기능 또는 주요 코드 변경을 완료한 후
  • PR을 생성하기 전
  • 품질 게이트가 통과하는지 확인하고 싶을 때
  • 리팩터링 후

검증 단계

단계 1: 빌드 검증

# Check if project builds
npm run build 2>&1 | tail -20
# OR
pnpm build 2>&1 | tail -20

빌드가 실패하면 계속하기 전에 중단하고 수정합니다.

단계 2: 타입 검사

# TypeScript projects
npx tsc --noEmit 2>&1 | head -30

# Python projects
pyright . 2>&1 | head -30

모든 타입 에러를 보고합니다. 중요한 것은 계속하기 전에 수정합니다.

단계 3: 린트 검사

# JavaScript/TypeScript
npm run lint 2>&1 | head -30

# Python
ruff check . 2>&1 | head -30

단계 4: 테스트 스위트

# Run tests with coverage
npm run test -- --coverage 2>&1 | tail -50

# Check coverage threshold
# Target: 80% minimum

보고 항목:

  • 전체 테스트: X
  • 통과: X
  • 실패: X
  • 커버리지: X%

단계 5: 보안 스캔

# Check for secrets
grep -rn "sk-" --include="*.ts" --include="*.js" . 2>/dev/null | head -10
grep -rn "api_key" --include="*.ts" --include="*.js" . 2>/dev/null | head -10

# Check for console.log
grep -rn "console.log" --include="*.ts" --include="*.tsx" src/ 2>/dev/null | head -10

단계 6: Diff 리뷰

# Show what changed
git diff --stat
git diff --name-only
git diff --cached --name-only

각 변경된 파일에서 다음을 검토합니다:

  • 의도하지 않은 변경
  • 누락된 에러 처리
  • 잠재적 엣지 케이스

출력 형식

모든 단계를 실행한 후 검증 보고서를 생성합니다:

VERIFICATION REPORT
==================

Build:     [PASS/FAIL]
Types:     [PASS/FAIL] (X errors)
Lint:      [PASS/FAIL] (X warnings)
Tests:     [PASS/FAIL] (X/Y passed, Z% coverage)
Security:  [PASS/FAIL] (X issues)
Diff:      [X files changed]

Overall:   [READY/NOT READY] for PR

Issues to Fix:
1. ...
2. ...

연속 모드

긴 세션에서는 15분마다 또는 주요 변경 후에 검증을 실행합니다:

Set a mental checkpoint:
- After completing each function
- After finishing a component
- Before moving to next task

Run: /verify

Hook과의 통합

이 스킬은 PostToolUse Hook을 보완하지만 더 깊은 검증을 제공합니다.

Hook은 즉시 문제를 포착하고, 이 스킬은 포괄적인 검토를 제공합니다.

원문

  • 영문 원문

탐색

  • 한국어 문서 안내
  • 기여 가이드

How to use it

Copy the folder

Take loulanyue/awesome-claude-notes-verification-loop from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.

Install what it needs

The instructions reference npx. Without those the skill loads but fails at the first command.