convez.ai
SkillDevOps & InfraestruturaAvançado
PengEjeen

Claude Code Skills & Harness Engineering Suite

PengEjeen/claude_skills

Framework de harness engineering com 32 hooks para Claude Code: verification, observability, segurança

Ver no GitHub
InicialPluginScore · de 0 a 100

Conjunto abrangente de 36 skills, 24 agentes, 40 comandos e 32 hooks para Claude Code CLI. Implementa padrões SOTA 2026 de harness engineering (wrappers ao redor do modelo) com verification loops, observability, loop detection e quality gates automatizados via bash, sem alterar o modelo base.

Instalação

$npx convez-ai PengEjeen/claude_skills

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
14%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Melhorar performance do Claude Code sem trocar modelo (52.8% → 66.5% conforme benchmark)
  • Implementar quality gates automatizados (testes, coverage, análise de dependências, segurança)
  • Rastrear e prevenir loops de execução, detecção de alucinações e controle de depleção de tokens
  • Auditar permissões, detectar secrets e bloquear comandos perigosos antes da execução

Veredito

Framework maduro e bem documentado baseado em research (LangChain, Anthropic, Spotify Honk). Requer domínio de bash scripting e arquitetura de Claude Code, mas entrega ROI mensurável em qualidade e segurança de execução automática. Recomendado para equipes que usam Claude Code em produção.

README

A tradução para o português deste README ainda está na fila.

My Claude Code Settings

Claude Code CLI를 위한 종합 하네스 엔지니어링 저장소. 36개 스킬, 24개 에이전트, 40개 커맨드, 17개 규칙, 32개 훅 스크립트를 포함합니다.

core-harness-v1 — Agent Router, Verification Planner, Test Integrity Gate를 추가해 자동 실행이 아닌 advisory-first 라우팅과 검증 계획을 제공합니다.

최신 업데이트: 2026-04-02 — 하네스 v7: 29개 훅 (11-Event), CLAUDE.md 최적화 (51→24 lines), 4개 신규 이벤트 훅 (MainAgentTokenDepletion, WorktreeCreate, SubagentStart, PermissionDenied), Reasoning Budget 정정 (xhigh→high)

처음이신가요? → GUIDE.md를 먼저 읽어보세요 (15분 입문 가이드)


하네스 엔지니어링 (2026)

모델을 바꾸지 않고 하네스(모델을 감싸는 시스템)만 개선해 성능을 올리는 방법론. LangChain: 동일 모델로 Terminal Bench 2.0에서 52.8% → 66.5% (+13.7점, Top 30 → Top 5).

이 저장소는 Claude Code의 훅 시스템으로 2026 SOTA 하네스 패턴을 구현합니다:

Session Start
  → EnvironmentBootstrap       (env-context-injector.sh)
  → ProgressRehydration        (progress-loader.sh)
  → RegressionGate             (regression-gate.sh)

Agent Request
  → LocalContextMiddleware     (env-context-injector.sh)
  → Safety Guard               (dangerous-command-blocker.sh + secret-detector.sh)
  → CommitGuard                (pre-commit-security.sh + code-quality-gate.sh + test-coverage-gate.sh)
  → [Tool Execution]
  → SupplyChainGuard           (dependency-audit.sh)
  → Quality Gate               (console-log, prettier, tsc, ruff)
  → VerificationLoop           (verification-loop.sh)          ← NEW
  → LoopDetectionMiddleware    (loop-detector.sh)
  → Observability              (observability-metrics.sh)       ← NEW
  → ExecutionTracing           (trace-logger.sh)
  → LearningIndexer            (learning-indexer.sh)            ← NEW
  → FailureAnalysis            (failure-explainer.sh)

Context Compression
  → CompactionCheckpoint       (compact-checkpoint.sh)

Lifecycle Events
  → TokenBudgetGuard           (token-depletion.sh)             ← NEW
  → WorktreeLifecycle          (worktree-setup.sh)              ← NEW
  → SubagentMonitor            (subagent-context.sh, async)     ← NEW
  → PermissionAudit            (permission-logger.sh, async)    ← NEW

Session End
  → DoD Verification           (dod-checker.sh)
  → ProgressPersistence         (progress-tracker.sh)
  → PreCompletionChecklist      (pre-completion-check.sh)
  → SessionLearning             (session-learning.sh)

2026 SOTA 패턴 구현 현황

패턴근거구현
Verification LoopSpotify Honk: 환각 34%↓, 코드 품질 28%↑verification-loop.sh
ObservabilityLangChain/OpenAI: 트레이스 분석이 개선의 핵심observability-metrics.sh
LoopDetectionLangChain 미들웨어 표준loop-detector.sh
Reasoning BudgetTerminal Bench 2.0: high(63.6%) > xhigh(53.9%)agents.md
Tool Minimizationmini-SWE-agent: bash-only로 SWE-bench 74%agents.md Tool Strategy
PreCompletionAnthropic 공식 패턴pre-completion-check.sh
Cross-Session StateAnthropic: claude-progress.txtprogress/SCHEMA.md
Agent TeamsAnthropic: 병렬 작업 50-70% 빠름settings.local.json env 플래그
Test Coverage Gate커밋 전 80% 강제test-coverage-gate.sh
.claudeignore토큰 5-10% 절약.claudeignore

핵심 설계 원칙

  • JSON 출력 통일: 모든 훅이 {"decision":"approve|block","reason":"..."} 형식
  • 세션 격리: 모든 lock/tracking 파일이 session-specific → 멀티 세션 안전
  • Bash-First: 에이전트 도구는 bash 우선, 전용 도구는 5-10% 케이스에만
  • 실측 기반: Reasoning Budget은 Terminal Bench 2.0 벤치마크 결과에 따라 high 레벨 사용

core-harness-v1 사용법

core-harness-v1은 세 개의 경량 훅을 추가합니다.

훅이벤트Timeout모드
agent-router.shUserPromptSubmit3sadvisory
verification-planner.shPostToolUse Edit/Write5sadvisory
test-integrity-gate.shPreToolUse Edit/Write, Bash(git commit*)3sadvisory + commit blocking

보조 커맨드:

  • /route <request>: 요청을 agent-router 기준으로 분류하고 추천 agent만 출력합니다.
  • /verify-plan [files|staged|all]: 변경 파일 기준 검증 계획을 요약합니다.
  • /test-hooks: 신규 훅 fixture 테스트 실행법을 확인합니다.
  • /install-settings: settings.local.json을 실제 Claude Code 런타임 설정인 ~/.claude/settings.json에 병합하는 절차를 확인합니다.
  • /check-harness: Claude Code가 core-harness-v1 훅을 실제로 읽는지 점검합니다.

기본 원칙:

  • 신규 훅은 fail-open을 기본으로 합니다.
  • advisory 훅은 무거운 테스트를 실행하지 않고 계획/경고만 출력합니다.
  • test-integrity-gate.sh는 Edit/Write 중에는 경고만 출력하지만, git commit 전 staged diff에서 검증 약화 패턴을 발견하면 block할 수 있습니다.
  • 자세한 성능 기준은 rules/harness-performance.md를 따릅니다.

런타임 settings 적용:

scripts/install-settings.sh --dry-run
scripts/install-settings.sh --yes

setup.sh는 symlink 설치 후 interactive shell에서 ~/.claude/settings.json 병합 여부를 묻습니다. 기존 runtime settings는 백업 후 merge하며, hook command 중복은 건너뜁니다.


프로젝트 구조

├── README.md                    ← 이 파일
├── GUIDE.md                     ← 입문자용 15분 가이드 ★
├── MCP_QUICK_SETUP.md           ← MCP 서버 설정 가이드
├── CLAUDE.md                    ← 글로벌 지침 (on-demand 규칙 라우터)
├── .claudeignore                ← 토큰 최적화 (빌드 산출물 제외)
├── settings.local.json          ← 설정 (권한, 훅 배선, Agent Teams)
├── setup.sh / setup.ps1         ← 설치 스크립트
├── uninstall.sh / uninstall.ps1 ← 제거 스크립트
│
├── hooks/ (32개)                ← 하네스 미들웨어 훅 스크립트
│   ├── 안전: dangerous-command-blocker, secret-detector, pre-commit-security
│   ├── 품질: console-log-warning, prettier, tsc, ruff, code-quality-gate
│   ├── 검증: verification-loop, test-coverage-gate, regression-gate ★
│   ├── 추적: trace-logger, observability-metrics, learning-indexer ★
│   ├── 세션: env-context-injector, progress-loader, progress-tracker
│   ├── 생명주기: token-depletion, worktree-setup, subagent-context, permission-logger ★
│   ├── 분석: failure-explainer, loop-detector, dod-checker, compact-checkpoint, session-learning
│   └── 유틸: trace-analyzer (수동 실행 전용, 훅 미배선)
│
├── rules/ (17개)                ← AI 행동 규칙
│   ├── ALWAYS: workflow.md, harness-engineering.md, defaults.md
│   ├── 에이전트: agents.md (24개 오케스트레이션 + Tool Strategy)
│   ├── 코드: coding-style.md, testing.md, security.md, git-workflow.md
│   ├── 시스템: hooks.md, context-management.md, cs-boost.md, mcp-patterns.md ★
│   └── 고급: advanced-workflows.md (Headless, Worktree, /loop, Auto Mode) ★
│
├── skills/ (36개)               ← 전문 스킬 (/skill-name으로 활성화)
├── agents/ (24개)               ← 특화 서브 에이전트
├── commands/ (40개)             ← CLI 커맨드 (/command-name)
└── progress/                    ← 세션 상태 관리
    ├── README.md
    └── SCHEMA.md                ← claude-progress.txt 스키마 ★

구성 요약

항목수량설명
Rules17ALWAYS 3개 + on-demand 규칙 + core-harness-v1 라우팅/검증/성능 규칙
Hooks3211-Event 파이프라인 + core-harness-v1 신규 훅 3개
Commands40/plan, /tdd, /verify, /tool-registry, /route, /verify-plan, /test-hooks, /install-settings, /check-harness 등
Agents24Core 7 + Quality 10 + Domain 4 + Meta 3
Skills36기획, 개발, AI, 문서, 품질, QA
MCP3Context7, GitHub, Playwright
TracingJSONL~/.claude/traces/ (metrics + traces, 7일 보관)

훅 파이프라인 (32개)

SessionStart (3)

훅역할
env-context-injector.shGit/프로젝트/런타임 환경 자동 주입
progress-loader.sh이전 세션 상태 로드
regression-gate.sh이전 실패 테스트 회귀 검사 (24h TTL)

UserPromptSubmit (2)

훅역할
env-context-injector.sh세션 컨텍스트 재주입 fallback (SessionStart 미실행 시)
agent-router.sh사용자 요청 분석 후 task/risk/domain/recommended agent advisory 출력

PreToolUse (7)

훅매처역할
dangerous-command-blocker.shBashrm -rf, git push --force 등 차단
pre-commit-security.shgit commitstaged diff 시크릿 검사
test-integrity-gate.shEdit/Write테스트/타입/커버리지 약화 패턴 advisory warning
test-integrity-gate.shgit commitstaged diff의 검증 약화 패턴 차단
code-quality-gate.shgit commitmerge conflict, TODO/FIXME, 대용량 변경
test-coverage-gate.shgit commit80% 미만 커버리지 차단 ★
secret-detector.shEdit/Write14개 provider 패턴 감지

PostToolUse (11)

훅역할
dependency-audit.shnpm/pip 패키지 보안 검사
console-log-warning.shconsole.log 경고
prettier-format.shJS/TS/CSS/JSON 자동 포맷
tsc-check.shTypeScript 타입 체크
ruff-format.shPython lint + format
loop-detector.sh동일 파일 4회+ 편집 doom loop 경고
trace-logger.sh도구 호출 JSONL 기록
verification-planner.sh변경 파일 유형별 검증 계획 advisory JSON 출력
verification-loop.sh코드 변경 후 관련 테스트 자동 실행 ★
observability-metrics.sh메트릭 수집 (도구 사용량, 성공률) ★
learning-indexer.sh학습 패턴 자동 인덱싱 ★

PostToolUseFailure (1)

훅역할
failure-explainer.sh에러 분류 + WHY 3단계 + 에스컬레이션

PostCompact (1)

훅역할
compact-checkpoint.sh압축 시 체크포인트 저장

MainAgentTokenDepletion (1)

훅역할
token-depletion.sh토큰 고갈 임박 시 /compact·/clear 프롬프트

WorktreeCreate (1)

훅역할
worktree-setup.sh격리 워크트리 환경 자동 설정 (Node/Python/Go/Rust)

SubagentStart (1)

훅역할
subagent-context.sh서브에이전트 스폰 카운터 추적 (async)

PermissionDenied (1)

훅역할
permission-logger.sh권한 거부 감사 JSONL 기록, 3회+ 에스컬레이션 (async)

Stop (4)

훅역할
dod-checker.sh완료 조건 검증
progress-tracker.sh세션 상태 기록
pre-completion-check.sh테스트 실행 여부 검증
session-learning.sh학습 리마인더

스킬 (36개)

/skill-name으로 활성화.

제품 기획

스킬설명
product-planner시니어 PM 수준 제품 기획 (TAM/SAM/SOM, JTBD, RICE)
chatbot-designerLLM Agent Architect — 대화형 AI 시스템 설계
llm-app-plannerLLM 앱 아키텍처 빠른 참조
api-spec-generatorAPI 명세서 자동 생성

개발

스킬설명
architecture-design시스템 설계 + ADR (Clean Architecture, DDD)
backend-apiFastAPI 구현 (라우터, 미들웨어, Pydantic)
react-componentAnti-AI Frontend Design System
api-designRESTful/GraphQL API 설계 (OpenAPI 3.x)
clean-codeProject Guardian — 품질 관리 종합
refactoring안전한 리팩토링 (동작 변경 없이 구조 개선)
debugging체계적 디버깅 (가설 기반, 이분 탐색, RCA)
performance-optimization성능 분석/최적화
database-schemaDatabase Schema Design
mcp-integrationMCP 서버 설정/연동

AI / 연구

스킬설명
rag-2.0고급 RAG (Hybrid Search, GraphRAG)
ml-trainingML 모델 학습/평가, 임베딩, 벡터 검색
agent-evaluatorAI 에이전트 자동 테스트/평가
agentic-workflows멀티 에이전트 시스템 (ReAct, Plan-Execute)
ai-developer-practiceAI 개발자 실무 7대 역량
ai-research-integration논문 조사/평가/POC
research-agent-techLLM/Agent 최신 트렌드
prompt-optimizer프롬프트 엔지니어링 최적화

문서 / 품질

스킬설명
code-review5-Layer 코드 리뷰
security-auditOWASP Top 10 보안 감사
tdd-workflowTDD 워크플로우 (Red-Green-Refactor)
documentation-gen기술 문서 자동 생성
dev-journal개발 일지 자동화
dev-blog-writer기술 블로그 작성
frontend-codemap프론트엔드 코드맵
context-compressor컨텍스트 압축으로 토큰 최적화
git-workflow고급 Git (Conventional Commits, 자동 PR)
developer-growth개발자 성장 프레임워크
learning-journal학습 일지 자동 생성
portfolio-generator포트폴리오 문서 자동 생성
mobile-tablet-redesign모바일/태블릿 UX 리디자인

QA / 테스트

스킬설명
industry-persona-qa산업별 다중 페르소나 QA ★ (12개 산업, 5-8 페르소나/산업)

에이전트 (24개)

자동으로 트리거되는 특화 서브 에이전트 (4개 카테고리):

Core (7) — 필수 자동 트리거

에이전트모델트리거
plannerOpus기능 요청 시 (mandatory)
code-reviewerSonnet코드 작성 후 (mandatory)
tdd-guideSonnet새 기능, 버그 수정
security-reviewerSonnet인증/API/입력 처리
build-error-resolverSonnet빌드 실패
debuggerSonnet런타임 에러
architectOpus아키텍처 변경

Quality & Review (10) — 도메인별 리뷰

a11y-reviewer, database-reviewer, python-reviewer, go-reviewer, go-build-resolver, graphql-expert, rust-expert, refactor-cleaner, performance-optimizer, doc-updater

Domain-Specific (4) — 전문 도메인

react-agent, e2e-runner, infrastructure-agent, vector-db-agent

Meta & Orchestration (3) — 메타 추론

coordinator, critic-agent, tree-of-thoughts


커맨드 (31개)

카테고리커맨드
핵심/plan /tdd /code-review /build-fix /verify /checkpoint /define-dod /handoff
검색/tool-registry ★ — 92개 도구 카테고리별 검색
프론트엔드/modern-frontend /frontend-codemap /update-codemaps /e2e
문서/분석/update-docs /token-analysis /test-coverage /eval /learn
멀티에이전트/multi-agent /orchestrate /evolve
리팩토링/refactor-clean /skill-create /setup-pm
Go/Rust/go-build /go-review /go-test /rust
학습/instinct-export /instinct-import /instinct-status

고급 기능 (2026.03)

기능설명사용법
Agent Teams병렬 에이전트 팀 (50-70% 빠름)settings.json env 플래그 활성화
Headless ModeCI/CD 자동 실행claude -p "리뷰해줘" --output-format json
Worktree격리된 병렬 개발claude -w feature-name
/loopcron-like 반복 작업/loop 5m "PR 상태 확인"
Auto ModeAI 안전 분류기 자동 승인permission mode: auto (샌드박스만)

→ 자세한 내용은 rules/advanced-workflows.md 참조


설치

자동 설치

Windows (PowerShell):

git clone https://github.com/hyunseung1119/My_ClaudeCode_Skill.git
cd My_ClaudeCode_Skill
.\setup.ps1

Linux / macOS:

git clone https://github.com/hyunseung1119/My_ClaudeCode_Skill.git
cd My_ClaudeCode_Skill
chmod +x setup.sh && ./setup.sh

업데이트

cd My_ClaudeCode_Skill
git pull
./setup.sh  # 또는 .\setup.ps1

제거

./uninstall.sh     # Linux/macOS
.\uninstall.ps1    # Windows

문서 목록

문서대상내용
README.md전체프로젝트 개요 (이 파일)
GUIDE.md입문자15분 설치~활용 가이드 ★
MCP_QUICK_SETUP.md중급MCP 서버 설정 (Context7, GitHub, Playwright)
CLAUDE.mdClaude글로벌 지침 라우터
progress/SCHEMA.md고급claude-progress.txt 스키마

업데이트 이력

날짜내용
2026-04-02하네스 v7 — CLAUDE.md 최적화 (51→24줄), 4개 신규 이벤트 훅 (MainAgentTokenDepletion, WorktreeCreate, SubagentStart, PermissionDenied), 수치 전면 정정 (실제 파일 기준), docs-site 배포 업데이트
2026-03-26하네스 v6 — Verification Loop(Spotify Honk 패턴), Observability 메트릭, Test Coverage Gate(80% 강제), Learning Indexer, Agent Teams 활성화, Tool Strategy(Bash-First), Reasoning Budget 실측 반영(high>xhigh), industry-persona-qa 스킬, tool-registry 커맨드, .claudeignore, advanced-workflows(Headless/Worktree/Loop/Auto Mode), MCP 가이드, 입문자 GUIDE.md
2026-03-24하네스 v5 — 훅 계약 통일, regression gate, python-reviewer, secret 14패턴
2026-03-22dependency-audit, trace-analyzer 추가, 튜토리얼 가이드
2026-03-13하네스 v4 — 12개 훅, JSON 출력 통일, 세션 격리
2026-03-12하네스 엔지니어링 적용 (9개 훅)
2026-03-11Harness v3, Vercel React, Office 스킬
2026-03-04CLAUDE.md 경량화, Learning Mode
2026-02-0229개 스킬 전체 동기화

참고 자료


Author

hyunseung1119 — @hyunseung1119

MIT License

Ver o original no GitHub

Bom para

Relacionados