완료는 주장이 아니라 종료 코드다.
hiway-kit 은 Claude Code·Codex·Antigravity 에서 쓰는 에이전트·스킬·규칙 플러그인입니다. 큰 작업은 코드보다 계획을 먼저 거치고, 태스크는 그것을 확인하는 명령이 0 으로 끝나야 완료로 칩니다.
/plugin marketplace add This-HW/hiway-kit /plugin install hiway-kit@hiway-kit
계획 없는 에이전트는 너무 일찍 끝낸다.
코딩 에이전트에게 기능을 맡기면 곧바로 코드부터 씁니다. 한 시간 뒤에는 “다 됐습니다"라고 보고합니다. 그런데 아무도 정하지 않은 요구사항은 추측으로 채워져 있고, 돌렸다던 테스트는 실행된 적이 없으며, 설계가 기대던 모듈 경계는 조용히 깨져 있곤 합니다.
에이전트가 거짓말을 하는 것은 아닙니다. 자기 판단 말고는 대조할 기준이 없을 뿐입니다. hiway-kit 은 대조할 기준을 줍니다. 완료 조건이 명령으로 적힌 계획, 그리고 문장 대신 종료 코드를 읽는 관문입니다.
작동 방식
관문 두 개와 그 사이의 루프입니다. 관문에서는 사람이 결정하고, 루프는 끝나거나 가드에 걸리거나 사람만 답할 수 있는 질문을 만날 때까지 스스로 돕니다.
기획 관문
큰 새 기능은
brainstorming에서 시작하고, 중간 이상 규모의 작업은plan-task가docs/plans/<날짜>-<slug>/plan.md로 정리합니다. 완료 조건 하나하나가 실행할 수 있는 명령입니다. 작은 수정은 이 절차를 건너뜁니다.구현 루프
auto-dev가 승인된 계획을 배치 단위로 끝까지 밀고 갑니다. P0 질문, 가드, 계획의 끝에서만 멈춥니다.검증 관문
체크리스트 항목은 그 항목의
verify명령이 실제로 실행돼 0 으로 끝날 때만 통과합니다. 병합 전에는 리뷰와 보안 스캔이 변경을 봅니다.
킷이 실제로 하는 일
- 기획 관문
- 명세로 확인되지 않은 전제를 P0 부터 P3 까지 등급으로 나눕니다. 데이터 무결성·보안·금융·핵심 비즈니스에 닿는 P0 만 작업을 멈추고 묻고, 나머지는 기본값을 적고 진행합니다.
skills/plan-task - 적대적 리뷰
review-code는 작성자와 분리된 컨텍스트에서 완성된 diff 를 해커·머피·미래의 나·까다로운 사용자, 네 페르소나로 읽습니다. 설계는multi-perspective-review가 최대 열 가지 관점으로 검토합니다.agents/dev/review-code.md- 완료는 명령이 판정한다
- “완료”는 판단이 아닙니다. 검증 명령을 새로 실행해 출력을 읽기 전까지 에이전트는 “구현 완료, 검증 전”이라고 말하고 남은 것을 적습니다.
rules/definition-of-done.md - 실패에서 배운다
- 리뷰·검증에서 나온 결함은
.git/kit/아래 피드백 원장에 쌓입니다(상한·중복 제거·감쇠). 다음 세션은 반복되는 결함을 교훈으로 받고 시작합니다.tools/feedback_ledger.py - 경계는 프로젝트 도구로 지킨다
- 프로젝트에 import-linter·dependency-cruiser 같은 경계 검사 도구가 있으면
plan-task가 그 명령을 계획의 완료 조건에 넣습니다. 도구가 없으면 없다고 적고, 도입은 사용자가 정합니다.plan-task/references/boundary-check.md - 여러 하네스에서
- 규칙과 스킬은 Claude Code·Codex·Antigravity 에서 모두 작동합니다. 전용 서브에이전트와 도구 호출을 막는 훅은 Claude Code 기능이고, 다른 하네스에서는 같은 규율이 지침으로 전달됩니다.
README: Other Harnesses
지원 하네스
하네스마다 무엇이 되는지는 추정이 아니라 실제 CLI 로 측정했습니다. 규칙과 스킬은 어디서나 작동하고, 달라지는 것은 전달 방식입니다.
| 하네스 | 규칙 | 스킬 | 서브에이전트 | 차단 훅 |
|---|---|---|---|---|
| Claude Code | 세션 시작 시 주입 | 네이티브 | 지원 | 지원 |
| Codex | 훅 신뢰 승인 후 주입, AGENTS.md 폴백 | 모두 인식 | 없음 — 스킬이 세션 안에서 수행 | 없음 |
| Antigravity | AGENTS.md·GEMINI.md 로만 | 인식 | 없음 | 없음 |
Codex 는 한 번 승인하기 전까지 플러그인 훅을 조용히 건너뜁니다. 방법은 시작하기 문서에 있습니다.
현재 릴리스 5.2.1 에는 에이전트 15개, 스킬 15개, 규칙 12개가 들어 있습니다.
설치
Claude Code
마켓플레이스를 추가한 뒤 플러그인을 설치합니다. 훅은 이 머신의 python3(3.9 이상)로 돕니다.
/plugin marketplace add This-HW/hiway-kit
/plugin install hiway-kit@hiway-kit플러그인은 사용자 범위로 설치되므로, 이미 실행 중인 세션을 포함해 이 머신의 모든 세션이 바뀝니다. 긴 작업이 돌고 있지 않을 때 설치하세요. 업데이트는 /plugin marketplace update hiway-kit.