@henry1981/nondev-harness-plugin

비개발자 하네스 — 비개발자 산출물 작업을 PRD→Plan→Execute→Review 4단계 파이프라인으로 게이팅하는 Claude Code plugin입니다.

대상 작업은 SOP·QMS·컴플라이언스 문서, audit·법률 대응, 규칙·스킬·하네스 개정(markdown 본문), wiki filing·reference 정리입니다. 코드 구현 작업은 대상이 아닙니다(프로그래밍 워크플로 사용).

Install

External users (marketplace):

/plugin marketplace add henry-1981/context-first-harness
/plugin install nondev-harness@khc-marketplace

이미 같은 마켓플레이스의 다른 KHC 플러그인(예: presentation)을 설치한 경우 첫 번째 명령(marketplace add) 대신 /plugin marketplace update로 카탈로그를 갱신한 뒤 두 번째 명령(install)을 실행하면 됩니다.

Local development (clone):

git clone https://github.com/henry-1981/KHC.git
claude --plugin-dir /path/to/KHC/plugins/nondev-harness

Setup

본 plugin은 호스트 작업 저장소의 디렉터리 구조를 역할 슬롯(role) 매핑으로 인식합니다. 첫 사용 시 setup wizard(/nondev-harness:setup)가 호스트의 실제 디렉터리를 role에 매핑하면 dispatcher·reviewer agent가 그 config를 참조해 동작합니다.

Setup 진입 경로 두 가지:

1. 사용자가 /nondev-harness:clarify-nondev 등 stage skill 첫 호출 → setup.config.json 부재 감지 → setup wizard 자동 진입
2. 사용자가 /nondev-harness:setup 직접 호출 → 기존 설정 노출 + 변경 입력 → config 갱신

Wizard가 4 Phase로 진행됩니다 — 환경 확인 → 저장소 탐지 경로(probe_root) 입력 → setup.sh 실행 + 결과 안내 → 확인. 내부적으로 setup.sh를 Bash tool로 wrap 호출해 6 role을 probe하고 setup.config.json을 plugin 루트에 생성합니다.

6 role — regulation-source(규제·정보보안 원문) · compliance-work(컴플라이언스 작업) · spec-work(spec·plan 작업) · deliverable-staging(산출물 staging) · knowledge-base(지식 베이스 페이지) · article-staging(아티클·칼럼 staging). probe는 흔한 컨벤션 디렉터리명을 각 role의 default 후보로 자동 매핑합니다. 호스트가 다른 이름을 쓰면 생성된 setup.config.json의 roles 맵을 직접 편집해 디렉터리를 해당 role 배열에 넣습니다.

config 부재 시 dispatcher는 graceful fallback으로 동작합니다 — 경로 기반 힌트는 비활성화되고 content·frontmatter·영문 파일명 prefix 힌트로 dispatch가 성립합니다. setup을 건너뛰어도 plugin은 작동하나, 호스트 환경에 맞춘 정확도가 떨어집니다.

Setup은 1회성 명령어이며 SessionStart hook이 아닙니다. 호스트 디렉터리 구조가 바뀌면 사용자가 /nondev-harness:setup 재호출해 매핑을 갱신합니다. setup.config.json은 호스트별 런타임 산출물이라 git 커밋·npm 배포 대상이 아닙니다.

Advanced fallback — Claude Code 외부에서 setup이 필요한 경우 plugin 루트의 setup.sh를 직접 호출 가능합니다 (bash setup.sh /path/to/repo 또는 bash setup.sh /path/to/repo /tmp/cfg.json로 config 출력 경로 지정). wizard와 동일한 산출물을 생성합니다.

When To Use

본 plugin은 산출물 1차 형태가 실행 코드가 아닌 모든 작업에 진입합니다. 아래는 대표 예시이며, 목록에 없는 산출물 작업도 진입 대상입니다.

• SOP·QMS·컴플라이언스 문서 작성·개정
• 감사·법률·계약 대응
• 규칙·스킬·문서 본문 개정 (markdown 본문 영역)
• reference 자료·지식 베이스 정리

적용 제외는 두 영역에 한정합니다.

• 프로그래밍 작업 — 코드 구현·디버그·리팩토링 등 산출물 1차 형태가 실행 코드인 작업. 여기서 "실행 코드"는 스크립트·hook·MCP·설정 파일(JSON 등) 배선을 포함합니다. 산출물이 markdown 문서가 아니라 실행·설정 자산이면 본 항목입니다.
• 단건 작업 — 검증 단위 1개 (한 줄 수정·파일 1개 복사 등). 직접 진행합니다.

해당 작업으로 판정되면 /nondev-harness:clarify-nondev로 진입합니다. 이후 plan-nondev → execute-nondev → deliverable-review 파이프라인이 순차 진행됩니다.

Public Skills

External invoke namespace: /nondev-harness:<skill-name>. Plugin loader가 manifest name + skill 폴더명으로 namespace를 생성합니다.

| Skill | 단계 / 역할 | |---|---| | clarify-nondev | PRD 8 항목 생성 — 작업 타입 판정·just-in-time 맥락 검색·PRD 작성. PRD 완성 판단은 deliverable-review 외부 게이트가 수행합니다(산출 주체 self-check 차단). | | plan-nondev | Plan 6 항목 schema 생성 — 지식 식별·부수 변화·도구·workflow·분기·앵커 라인 | | execute-nondev | Plan 진행자 — LLM 자율주행 차단·PRD 매 턴 주입·workflow 강 통제·yellow state machine | | deliverable-review | 검증 게이트 — 도메인 reviewer agent 디스패치 + humanize-korean voice 게이트 |

4 skill은 순차 파이프라인입니다. clarify-nondev 산출 PRD 8 항목 → plan-nondev 입력, plan-nondev 산출 Plan 6 항목 → execute-nondev 입력, execute-nondev 산출물 → deliverable-review 게이트.

단건 작업(한 줄 수정·파일 1개 cp·메모리 항목 추가 등)과 PRD Lite cutoff 통과 케이스의 분기 규율은 각 skill 본문을 참조합니다.

Reviewer Agents

deliverable-review가 산출물 도메인에 따라 디스패치하는 검증 전문가입니다. 모두 read-only(Edit·Write·Bash 비허용).

| Agent | 검증 대상 | |---|---| | deliverable-general-reviewer | 분류되지 않은 일반 문서 산출물 (fallback) | | deliverable-spec-reviewer | 기술 spec·제안서·아키텍처 문서 | | deliverable-plan-reviewer | implementation plan 문서 | | deliverable-meddev-compliance-reviewer | 의료기기·법규·컴플라이언스 산출물 (법률 메모·SOP·계약서·audit 응답) |

prd-formatter Tool

tools/prd-formatter/는 PRD frontmatter·revision history·source·related_paths·8 영역을 자동 검증하는 Python 도구입니다. 문장 rewriting·품질 판단은 대상이 아닙니다(deliverable-review 영역).

cd tools/prd-formatter
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python -m pytest test_prd_formatter.py -v

상세는 tools/prd-formatter/README.md를 참조합니다.

Pipeline Contract

본 plugin은 gated 4-stage pipeline을 구현합니다.

• 4 stage linear chain (clarify-nondev → plan-nondev → execute-nondev → deliverable-review)
• 외부 검증 일관 흐름: PRD·Plan·Execute 산출물이 모두 deliverable-review 외부 게이트를 거칩니다. 산출 주체(skill 실행 에이전트)는 자기 산출물의 완성 판단을 self-check하지 않으며, 외부 reviewer agent의 판정만이 다음 단계 진입 자격을 부여합니다.
• gate: deliverable-review hard gate 통과 전 산출물 ship 금지
• self-contained: 각 skill 본문에 설계 PRD 내용이 인라인됨 — 별도 PRD·rules 동봉 없이 standalone 작동

본 plugin은 runtime CLI·build step·native dependency가 없습니다. skill·agent는 markdown 본문이며, prd-formatter만 Python 도구입니다.

Adapter Coexistence (Claude Code + Codex)

본 plugin은 양 adapter 양립입니다.

• Claude Code adapter: .claude-plugin/plugin.json·marketplace.json manifest + skills/·agents/ 표준 디렉터리
• Codex adapter: .codex-plugin/plugin.json (Codex 자체 plugin spec)

각 adapter는 자기 manifest만 로드합니다. skills/·agents/·tools/는 양 adapter 공통 영역입니다.

본 plugin은 standalone 배포를 전제합니다 — 특정 호스트 저장소 구조·외부 도구·도메인 규제 영역을 의존 전제로 두지 않습니다. 호스트 환경 변동은 setup의 role 슬롯 매핑(setup.config.json)으로 흡수하며, config 부재 시 graceful fallback으로 동작합니다.

License

MIT — LICENSE 파일 참조.

Source

• Plugin source: https://github.com/henry-1981/KHC/tree/main/plugins/nondev-harness
• 배포 스크립트: https://github.com/henry-1981/KHC/tree/main/tools/nondev-harness/scripts
• npm registry: @henry1981/nondev-harness-plugin