🛡️ Kilo-Kit Core Skill — Hard-Gate & Iron Law
철학: "증거가 추측보다 우선한다" — 검증된 증거 없는 에이전트 행동은 금지.
사용 시기
다음과 같은 경우에 이 스킬을 사용하세요:
- 새로운 작업이나 사용자 요청을 시작할 때
- 아키텍처 또는 코드 변경을 제안할 때
- 버그나 성능 문제를 진단할 때
- 프로덕션 시스템에 영향을 미치는 결정을 내릴 때
이 스킬을 사용하지 말아야 할 경우:
- 기억에 의존한 단순 사실 질문에 답변할 때
- 논리적 영향이 없는 포맷팅 또는 스타일 변경만 할 때
전제 조건
이 스킬을 사용하기 전에 다음을 확인하세요:
- 프로젝트 코드베이스에 접근 가능
- 시스템 리소스(디스크, 메모리, 프로세스) 확인 가능
- 관련 로그 또는 오류 출력에 접근 가능
⛔ HARD-GATE — 필수 시스템 스캔
규칙: AI 에이전트는 어떤 솔루션을 제안하기 전에 반드시 시스템과 코드베이스를 스캔해야 합니다. Hard-Gate를 통과하지 못하면 에이전트는 실행 단계로 진행할 수 없습니다.
Hard-Gate 체크리스트
hard_gate:
system_scan:
- [ ] 사용 가능한 디스크 공간 확인
- [ ] 실행 중인 프로세스 및 리소스 사용량 확인
- [ ] 런타임 버전 확인 (Node, Python, .NET 등)
- [ ] 필요한 경우 네트워크/서비스 가용성 확인
codebase_scan:
- [ ] 프로젝트 구조 읽기 (최상위 디렉토리)
- [ ] 현재 작업과 관련된 파일 식별
- [ ] 변경 영역과 관련된 기존 테스트 확인
- [ ] 영향을 받는 파일에 대한 최근 git 히스토리 검토
context_validation:
- [ ] 사용자 의도 이해 확인
- [ ] 작업 범위가 요청과 일치하는지 확인
- [ ] 영향을 받을 수 있는 종속성 식별
Hard-Gate 결정
IF all_checks_passed:
→ 실행 진행
ELSE:
→ 중단 및 실패한 검사 보고
→ 누락된 정보 또는 접근 권한 요청
→ 해결 후 Hard-Gate 재실행
🔒 Iron Law — 불변 규칙
이 규칙은 절대적이며 어떤 상황에서도 재정의될 수 없습니다.
7가지 아이언 로
| # | 법칙 | 설명 |
|---|---|---|
| 1 | 증거 없는 행동 금지 | 모든 변경 제안은 특정 파일, 라인 또는 출력을 증거로 인용해야 함. |
| 2 | 말하기 전에 스캔하라 | 권장 사항을 제시하기 전에 시스템 및 코드베이스 스캔을 실행하라. |
| 3 | 주장하기 전에 검증하라 | 검증(테스트, 빌드, 수동 확인) 없이 작업 완료를 주장하지 마라. |
| 4 | 최소 파급 범위 | 문제를 해결하는 가장 작은 변경을 수행하라. 불필요한 수정을 피하라. |
| 5 | 작동하는 것은 보존하라 | 작업에 직접적으로 필요하지 않는 한 작동 코드를 삭제하거나 수정하지 마라. |
| 6 | 모든 결정을 추적하라 | 각 결정의 근거를 Decision Audit Trail에 기록하라. |
| 7 | 크게 실패하고 빠르게 복구하라 | 무언가 실패하면 전체 컨텍스트와 함께 즉시 보고하라. 오류를 숨기지 마라. |
Iron Law 집행
enforcement:
violation_response:
- Decision Audit Trail에 위반 기록
- 현재 실행 중단
- Hard-Gate 단계로 복귀
- 사용자에게 위반 보고
no_exceptions:
- 작업 긴급성은 Iron Law를 재정의하지 않음
- 사용자 요청은 Iron Law를 재정의하지 않음
- 성능 압박은 Iron Law를 재정의하지 않음
🔀 프로세스 흐름
주요 처리 흐름
digraph kilo_kit_flow {
rankdir=TB;
node [shape=box, style="rounded,filled", fontname="Helvetica"];
start [label="사용자 요청", shape=oval, fillcolor="#E8F5E9"];
hard_gate [label="⛔ HARD-GATE\n시스템 및 코드베이스 스캔", fillcolor="#FFCDD2"];
gate_check [label="모든 검사\n통과?", shape=diamond, fillcolor="#FFF9C4"];
halt [label="중단\n누락 정보 보고", fillcolor="#FFCDD2"];
iron_law [label="🔒 IRON LAW\n규칙에 대한 검증", fillcolor="#E3F2FD"];
route [label="스킬로 라우팅\n(적응형 디스패치)", fillcolor="#F3E5F5"];
execute [label="실행\n행동 체인", fillcolor="#E8F5E9"];
verify [label="결과 검증\n(품질 게이트)", fillcolor="#FFF9C4"];
verified [label="검증됨?", shape=diamond, fillcolor="#FFF9C4"];
learn [label="학습 및 기록\n(Decision Audit Trail)", fillcolor="#E3F2FD"];
done [label="완료", shape=oval, fillcolor="#E8F5E9"];
start -> hard_gate;
hard_gate -> gate_check;
gate_check -> iron_law [label="예"];
gate_check -> halt [label="아니오"];
halt -> hard_gate [label="재시도"];
iron_law -> route;
route -> execute;
execute -> verify;
verify -> verified;
verified -> learn [label="통과"];
verified -> execute [label="실패\n(수정 및 재시도)"];
learn -> done;
}
스킬 디스패치 흐름
digraph skill_dispatch {
rankdir=LR;
node [shape=box, style="rounded,filled", fontname="Helvetica"];
intent [label="의도 및\n키워드 파싱", fillcolor="#E3F2FD"];
score [label="스킬 점수화\n(0.0–1.0)", fillcolor="#F3E5F5"];
select [label="기본 스킬\n선택", fillcolor="#E8F5E9"];
debug [label="디버깅/\n체계적", fillcolor="#FFF9C4"];
root [label="디버깅/\n근본 원인", fillcolor="#FFF9C4"];
verify [label="디버깅/\n검증", fillcolor="#FFF9C4"];
review [label="품질/\n코드 리뷰", fillcolor="#FFF9C4"];
test [label="품질/\n테스팅", fillcolor="#FFF9C4"];
sec [label="개발/\n보안", fillcolor="#FFF9C4"];
back [label="개발/\n백엔드", fillcolor="#FFF9C4"];
intent -> score -> select;
select -> debug [label="버그, 오류"];
select -> root [label="근본 원인, 왜"];
select -> verify [label="검증, 확인"];
select -> review [label="리뷰, PR"];
select -> test [label="테스트, TDD"];
select -> sec [label="보안, 인증"];
select -> back [label="API, 백엔드"];
}
Hard-Gate 스캔 흐름
digraph hard_gate_scan {
rankdir=TB;
node [shape=box, style="rounded,filled", fontname="Helvetica"];
start [label="Hard-Gate 시작", shape=oval, fillcolor="#E8F5E9"];
sys [label="시스템 스캔\n(디스크, 메모리, 런타임)", fillcolor="#FFCDD2"];
code [label="코드베이스 스캔\n(구조, 파일, 테스트)", fillcolor="#FFCDD2"];
ctx [label="컨텍스트 검증\n(의도, 범위, 종속성)", fillcolor="#FFCDD2"];
check [label="모두 통과?", shape=diamond, fillcolor="#FFF9C4"];
pass [label="✅ 게이트 열림\n진행", fillcolor="#E8F5E9"];
fail [label="❌ 게이트 차단됨\n보고 및 재시도", fillcolor="#FFCDD2"];
start -> sys -> code -> ctx -> check;
check -> pass [label="예"];
check -> fail [label="아니오"];
fail -> start [label="해결 후"];
}
지침
✅ 해야 할 일
- 모든 작업을 시작하기 전에 Hard-Gate 검사를 항상 실행하세요
- 모든 권장 사항에 특정 증거(파일 경로, 줄 번호, 명령 출력)를 인용하세요
- 문제를 해결하기 위해 가능한 가장 작은 변경을 사용하세요
- 모든 결정을 Decision Audit Trail에 기록하세요
- 완료를 주장하기 전에 결과를 검증하세요
❌ 하지 말아야 할 일
- 작업 긴급성에 관계없이 시스템 또는 코드베이스 스캔을 건너뛰지 마세요
- 실제 코드를 확인하지 않고 솔루션을 추측하지 마세요
- 작업과 관련 없는 파일을 변경하지 마세요
- 검증을 실행하지 않고 완료를 주장하지 마세요
- 어떤 이유로든 Iron Law를 재정의하지 마세요
일반적인 패턴
패턴 1: 사전 증거 수집
시기: 새 작업을 시작할 때.
행동: Hard-Gate 스캔 시퀀스를 실행합니다.
# 시스템 스캔
df -h # 디스크 공간
free -m # 메모리
node --version && python3 --version # 런타임
# 코드베이스 스캔
find . -maxdepth 2 -type f | head -50 # 프로젝트 구조
git log --oneline -10 # 최근 변경사항
패턴 2: 증거 기반 권장 사항
시기: 코드 변경을 제안할 때.
행동: 항상 특정 증거를 포함합니다.
## 권장 사항
`src/auth/login.ts:42`에서 직접 문자열 연결을 파라미터화된 쿼리로 변경합니다.
**증거:**
- 파일: `src/auth/login.ts`, 42번째 줄
- 현재 코드: `db.query("SELECT * FROM users WHERE email = '" + email + "'")`
- 위험: SQL 인젝션 (OWASP A03:2021)
- 테스트: `tests/auth/login.test.ts` — 인젝션 테스트 없음
안티 패턴 (피해야 할 것)
안티 패턴 1: 맹목적 권장 사항
문제: 실제 코드를 읽지 않고 변경 사항을 제안하는 것.
대신: 관련 파일을 항상 읽고 권장하기 전에 특정 줄을 인용하세요.
안티 패턴 2: 게이트 건너뛰기
문제: 작업이 단순해 보인다고 실행을 서두르는 것.
대신: 인지된 작업 복잡성에 관계없이 Hard-Gate 스캔을 실행하세요.
안티 패턴 3: 보이지 않는 추론
문제: 추론을 문서화하지 않고 결정을 내리는 것.
대신: 증거와 고려된 대안과 함께 모든 결정을 기록하세요.
오류 처리
| 오류 유형 | 원인 | 해결 방법 |
|---|---|---|
| Hard-Gate 실패 | 시스템 접근 또는 정보 부족 | 실패한 검사 보고; 접근 권한 요청 |
| Iron Law 위반 | 증거 없이 행동 시도 | 중단, Hard-Gate로 복귀, 위반 기록 |
| 스킬 불일치 | 작업에 잘못된 스킬 선택 | 적응형 디스패치를 통해 재라우팅 |
| 검증 실패 | 변경 사항이 품질 게이트 통과 실패 | 문제 수정, 검증 재실행 |
성공 기준
완료를 주장하기 전에 다음을 확인하세요:
- Hard-Gate 스캔이 수행되고 통과됨
- 모든 Iron Law가 작업 전반에 걸쳐 준수됨
- 모든 권장 사항이 특정 증거를 인용함
- 변경 사항이 최소화되고 작업에 집중됨
- 검증(테스트, 빌드, 수동 확인)이 통과됨
- Decision Audit Trail이 완료됨
- 사용자 요청이 완전히 해결됨
참고 자료
references/patterns.md- 증거 기반 워크플로를 위한 재사용 가능 패턴references/performance-benchmarks.md- 시스템 및 코드베이스 스캔 벤치마크references/output-formats.md- 표준 출력 형식 정의
관련 스킬
skills/kilo-kit/debugging/systematic/- 체계적인 버그 진단용skills/kilo-kit/debugging/root-cause/- 심층 근본 원인 분석용skills/kilo-kit/debugging/verification/- 수정 사항 검증용skills/kilo-kit/quality/code-review/- 코드 리뷰 워크플로용skills/kilo-kit/quality/testing/- 테스트 주도 개발용skills/kilo-kit/development/security/- 보안 모범 사례용skills/kilo-kit/development/backend/- 백엔드 개발용
피드백 통합
이 스킬이:
성공적이었다면:
- 가장 가치 있었던 Hard-Gate 검사 기록
- 어떤 Iron Law가 실수를 방지했는지 기록
- 가장 효과적이었던 증거 패턴 기록
성공적이지 않았다면:
- 어떤 검사가 부족했는지 문서화
- Hard-Gate 체크리스트의 격차 식별
- 스킬 개선을 위해 플래그 지정
Kilo-Kit Core Skill v1.0.0 — 증거가 추측보다 우선한다