CLAUDE CODE × CODEX / DEVELOPER HARNESS

말이 아니라
증거로 완성하는 개발.

dev-harness-kit은 계획부터 릴리스까지 반복 가능한 개발 루프를 제공하는 플러그인입니다. 훅과 산출물로 에이전트의 작업을 검증 가능한 상태로 바꿉니다.

dev-kit / workflow

$ /dev-kit:plan

→ PRD.md

→ phases/checkout/index.json

$ /dev-kit:build

✓ phase 1 verified

✓ acceptance checks passed

$ /dev-kit:babysit-pr

● repair loop ready _

2클라이언트
환경
8핵심
Iron Laws
10OWASP
보안 영역
1재개 가능한
루프

01 / GET STARTED

처음 3분을 위한 설정

마켓플레이스에서 설치하거나 로컬 체크아웃을 직접 가리킬 수 있습니다. 새 프로젝트라면 /dev-kit:bootstrap이 규칙 문서, 훅 설정, CI 템플릿을 함께 준비합니다.

claude plugin marketplace add sh-ai-x/dev-harness-kit
claude plugin install dev-kit

/dev-kit:bootstrap
로컬 개발이라면

claude --plugin-dir /path/to/dev-harness-kit으로 최신 소스를 바로 사용하세요. 같은 방식으로 Codex에서도 설치된 명령을 실행할 수 있습니다.

02 / THE LOOP

작은 상태 전이, 확실한 증거

각 단계는 한 가지 책임만 갖고, 다음 단계가 읽을 산출물을 디스크에 남깁니다. 중단되어도 같은 명령을 다시 실행해 재개할 수 있습니다.

01

bootstrap

프로젝트 규칙, CLAUDE.md, AGENTS.md와 CI를 초기화합니다.

02

plan

한 줄 아이디어를 PRD와 재개 가능한 build phase로 바꿉니다.

03

build

단계별로 구현하고 인수 조건과 테스트를 실행합니다.

04

verify

자동 검증 gate가 현재 diff와 check의 증거를 확인합니다.

05

ship

검증이 통과된 결과에 릴리스 태그를 발행합니다.

03 / WHY IT MATTERS

작업을 중단해도 근거에서 다시 시작합니다.

dev-harness-kit은 계획·구현·복구의 각 단계에 산출물을 남깁니다. 다음 작업은 이전 단계의 문서와 상태를 읽고 같은 맥락에서 이어집니다.

02

Resumable phases
재개 가능한 단계

phase 상태와 인수 조건을 파일로 관리해 작업을 멈췄다가도 마지막으로 확인된 지점에서 이어갈 수 있습니다.

PRD.md → phases/<name>/
03

Repair until green
통과할 때까지 복구

사용자가 babysit loop를 시작하면 실패 로그를 재현하고 최소 패치를 적용한 뒤 push와 재검사를 반복합니다.

/dev-kit:babysit-pr

04 / COMMANDS

필요할 때 꺼내 쓰는 명령어

유지보수·관측·평가 명령어도 제공합니다: inspect, refactor, prune, status, code-viz, evaluate, token-analyzer, ci-doctor.

05 / DOCUMENTATION

스킬과 hook 사용법은 Docs에서

랜딩페이지는 사용자가 직접 시작하는 핵심 흐름만 보여줍니다. 전체 skill 설명과 hook 문구, 실제 실행 예시는 Docs에서 확인하세요.

Docs에서 전체 사용법 보기 ↗

07 / ENFORCEMENT

Iron Laws — 자동화가 건너뛸 수 없는 규칙

규칙은 프롬프트에만 있지 않습니다. 훅이 파일 편집과 셸 명령을 감시하고, 완료 주장은 검증 로그와 함께 남겨져야 합니다.

L1

검증 산출물 없는 프로덕션 코드는 없다

L2

버그 재현 없이 수정하지 않는다

L3

종료 코드·테스트 수·빌드 로그 없는 완료 주장은 없다

L4

TODO/FIXME와 미완성 약속을 남기지 않는다

L5

요청하지 않은 선택지 목록을 만들지 않는다

L6–L8

스킬의 강제력과 상태 머신을 SSOT로 유지한다

READY WHEN YOU ARE

다음 작업을
증거로 남겨보세요.

GitHub에서 시작하기 ↗