By yunjeLee
앱팀 공통 harness-engineering 워크플로우 플러그인 V2 (Android / iOS) — 계획→TDD→검증→bug-fix 닫힌 루프
확정된 완료기준(실행 명령)을 격리 컨텍스트에서 실행하고, 명령별 통과/실패·로그 경로·실패 원인 시그니처를 보고하는 실행 워커 에이전트. work 의 완료기준 검증(7단계)과 bug-fix 의 재검증(3단계)에서 호출된다. 코드를 수정하지 않고 bug-fix/harness-check 분기도 결정하지 않는다. 대상은 "확정된 완료기준 명령"이며 시점은 "TDD·통합테스트 작성 후 최초 검증, 그리고 bug-fix 수정 후 재검증"이다.
하네스 문서(harness-root / harness-module)를 6축 기준으로 검증하고 수정 제안을 작성하는 검증 에이전트. harness-verify 스킬이 문서 검증을 위임할 때 사용한다. 대상은 "이미 생성된 문서"이며 시점은 "생성 후"다.
코드베이스를 격리된 컨텍스트에서 대량으로 읽고, 그 결과로 하네스 문서(harness-root / harness-module)를 작성(create)하거나 갱신(update)하는 워커 에이전트. harness-root, harness-module, harness-root-edit, harness-module-edit 스킬이 초안 생성·문서 갱신을 위임할 때 사용한다.
work 스킬에 계획이 존재할 때, 그 실행 계획을 7축 기준으로 검토하는 에이전트. work 가 계획 경로를 탈 때만 TDD 코드 작성 직전(실행 전)에 검토를 위임한다. 계획이 없는 작업에는 호출되지 않는다. 대상은 "실행 의도(계획)"이며 시점은 "실행 전"이다. 하네스 문서 검증 agent와 분리 유지한다.
완료기준(실행명령) 검증 중 버그 발생 시 .harness/logs 의 실패 로그에서 에러를 추출해 즉시 자동 수정하고 재검증을 반복하는 스킬. 완료기준 명령별 최대 5회(스킬 내부 카운터). 5회 초과 또는 수정 후 동일 원인 재발 시 루프 중단 후 /harness-check 자동 트리거. /bug-fix, 테스트 실패 수정, 빌드 에러 자동 수정, 검증 실패 고쳐줘 요청 시 사용한다.
작업 산출물이 하네스 문서와 다르거나 불만이 있을 때, 또는 bug-fix가 5회 초과로 막혔을 때 하네스 문서의 문제점을 진단해 로컬(.harness/issues)에 기록한다. /harness-check, 하네스 문제 진단, 하네스가 잘못 가이드, 결과가 문서와 다름 요청 시 사용한다. 수정은 사람이.
이미 생성된 모듈 CLAUDE.md({path}/CLAUDE.md)를 인자로 받은 모듈만 코드 기준으로 갱신하고 검증·승인까지 잇는다. /harness-module-edit {모듈경로}, 모듈 CLAUDE.md 갱신, decay 반영, 모듈 하네스 수정 요청 시 사용한다. 인자 없으면 모듈 목록을 묻는다.
leaf 모듈별 CLAUDE.md(≤50줄)와 docs/MODULE_MAP.md 인덱스를 워크플로우로 병렬 생성·6축 검증하고 사람 게이트까지 잇는다. /harness-module, 모듈 하네스 생성, 모듈 CLAUDE.md 작성, 모듈 맵 만들기 요청 시 사용한다. 루트 7종이 있어야 실행 가능. (이 스킬 호출 = 워크플로우 실행 동의)
이미 생성된 루트 하네스 문서(docs/*.md, CLAUDE.md)를 인자로 받은 대상만 코드 기준으로 수정하고 검증·승인까지 잇는다. /harness-root-edit prd, /harness-root-edit architecture, 루트 문서 수정, 하네스 루트 편집 요청 시 사용한다. 인자 없으면 어떤 문서 수정할지 묻는다.
Executes bash commands
Hook triggers when Bash tool is used
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
앱팀(Android / iOS) 공통 harness-engineering 워크플로우 플러그인. 입력 → (계획 → 계획검수) → TDD → 통합/E2E → 검증 → bug-fix 로 이어지는 닫힌 루프를 구성하고, 하네스 문서로 Claude Code 에 프로젝트 그래프를 제공한다.
superpowers 플러그인 (필수) — work 가 superpowers:test-driven-development(TDD) 를 호출한다. 미설치 시 /work 의 TDD 단계가 동작하지 않는다.| 스킬 | 역할 |
|---|---|
harness-root | 루트 문서 8종 초안 생성 |
harness-root-edit | 루트 문서 인자 대상 편집 |
harness-module | leaf 모듈 CLAUDE.md + MODULE_MAP 병렬 생성 |
harness-module-edit | 모듈 CLAUDE.md 인자 대상 갱신 |
harness-update | 변경분(git diff) 기준 하네스 문서 주기적 update (변경 추출 -> update -> 검증) |
harness-verify | root/module 문서 6축 검증 |
harness-check | 산출물↔하네스 불일치 진단 → 로컬 기록 |
work | 닫힌 루프 엔진 (입력→(계획→검토)→TDD→통합/E2E→검증) |
bug-fix | 검증 실패 자동 수정 루프 (최대 5회) |
| Agent | 역할 |
|---|---|
harness-read-write | 코드 읽고 문서 초안 작성 (sonnet) |
harness-doc-verifier | 문서 6축 검증 (opus) |
plan-reviewer | 계획 7축 검토 (opus) |
completion-verifier | 완료기준 명령 격리 실행·결과 보고 (opus) |
| Hook | 역할 |
|---|---|
block-dangerous-command.sh | 위험 명령 차단 (PreToolUse/Bash) |
harness-decay-notify.sh | 문서 decay 알림 (PostToolUse/Bash) |
| Script | 역할 |
|---|---|
harness-module-gen.js | harness-module 이 호출하는 워크플로우 — 분류→leaf CLAUDE.md 병렬 작성→6축 검증→MODULE_MAP/루트 CLAUDE.md 집계→모듈 간 일관성 검증 격리 실행 |
harness-update-scope.sh | harness-update 의 결정론적 스코핑 — 변경분→갱신 후보 문서(module/root/rule) 매핑 |
harness-update.js | harness-update 이 호출하는 워크플로우 — 후보 6축 검증으로 drift 감지→썩은 문서만 최소 diff 갱신→재검증 격리 실행 |
harness-root| 파일 | 설명 |
|---|---|
CLAUDE.md | 자동 로드 주체 — 자동 적재 @참조와 조건부 로딩 규칙을 담는 그릇 |
docs/ARCHITECTURE.md | CLAUDE.md 적재 — 모듈 구조·계층·의존성 방향 |
docs/CONVENTIONS.md | CLAUDE.md 적재 — 코딩 규칙·네이밍·금지 패턴 |
docs/SESSION.md | CLAUDE.md 적재 — 짧은 세션 규칙 목록 |
docs/rules/PRD.md | 조건부(신규 기능 시작 시) — 제품 요구사항 |
docs/rules/ADR.md | 조건부(의존성 매니페스트 편집 시) — 아키텍처 결정 기록 |
docs/rules/TESTING.md | 조건부(test 편집 시) — build/lint/unit/통합/E2E 검증 명령의 단일 출처 |
docs/rules/UI_GUIDE.md (선택) | 조건부(지정 경로 접근 시) — UI/디자인시스템 가이드 |
harness-module| 파일 | 설명 |
|---|---|
{module}/CLAUDE.md | leaf 모듈별 ≤50줄 — 역할·금지·의존성·암묵규칙 |
docs/rules/{module}.md | 상위 묶음 모듈 rule — 계층 경계·의존성 방향·절대 금지 |
docs/MODULE_MAP.md | 전체 모듈 인덱스(leaf/상위 매핑) — 루트 CLAUDE.md 조건부 로딩과 연결 |
| 파일 | 설명 |
|---|---|
.harness/runs/run-{id}.md | 진행 상태(계획/단계/완료기준/bug-fix 횟수/결정 로그). work 생성, bug-fix 갱신. .harness/ 최초 생성 시 대상 프로젝트 .gitignore 에 .harness/ 자동 등록 |
.harness/logs/{명령slug}.log | 완료기준 명령 실행 로그 — bug-fix 가 받는 핸드오프 입력 |
.harness/issues/{날짜}/{시간}-{slug}.md | harness-check 진단 기록(로컬) |
.harness/last-update | harness-update 가 승인 시 기록하는 직전 적용 커밋 SHA — 다음 실행의 변경분 기준점 |
닫힌 루프를 실행하게 하여 사용자(사람)의 개입을 최소화 하는 방향으로 사용
🟩 자동 구간 · 🟨 사람 게이트 · 🟦 하네스(규칙)
flowchart TD
H["하네스 구축<br/>/harness-root · /harness-module"]:::harness
H --> W["/work 시작<br/>입력 폼 수집"]:::auto
W --> P["계획 (선택)"]:::gate
P --> PR["계획 검증<br/>plan-reviewer"]:::gate
PR --> TDD["TDD 구현 (unit)"]:::auto
TDD --> IT["통합/E2E 작성<br/>test-after"]:::auto
IT --> Q{"결과물 OK?"}
Q -->|하네스 위반| HC
Q -->|OK| CRI["완료기준 검증<br/>completion-verifier"]:::auto
CRI --> Q2{에러 발생?}
Q2 -->|에러| BF["bug-fix<br/>자동 수정"]:::auto
BF -->|재검증 ≤5회| CRI
Q2 -->|통과| DONE([✅ 완료 → 커밋]):::gate
DONE --> HU["변경분 문서 동기화<br/>(주기적 업데이트)<br/>/harness-update"]:::auto
HU -->|drift 갱신·재검증| H
BF -->|5회 초과·동일원인 재발| HC
HC["harness-check<br/>문서 진단(triage)"]:::harness
HC -->|규칙 갱신| H
classDef auto fill:#e7f5e7,stroke:#2e7d32,color:#1b3d1b
classDef gate fill:#fff3cd,stroke:#d39e00,color:#5c4500
classDef harness fill:#e3f0fb,stroke:#1565c0,color:#0d3b66
npx claudepluginhub yunjelee/yeoboya_harness_plugin --plugin yeoboya-workflow-v2앱팀 공통 개발 워크플로우 플러그인 (Android / iOS)
Ultra-compressed communication mode. Cuts ~75% of tokens while keeping full technical accuracy by speaking like a caveman.
Multi-model consensus engine integrating OpenAI Codex CLI, Gemini CLI, and Claude CLI for collaborative code review and problem-solving.
Curate auto-memory, promote learnings to CLAUDE.md and rules, extract proven patterns into reusable skills.
Comprehensive UI/UX design plugin for mobile (iOS, Android, React Native) and web applications with design systems, accessibility, and modern patterns
Memory compression system for Claude Code - persist context across sessions