Community연구 & 데이터 분석github.com

VoDaiLocz/kilo-kit-mcp

안전한 코딩 에이전트를 위한 MCP 서버: 스킬 라우팅, C4 워크플로 게이트, 메모리 검사, 완료 전 검증.

kilo-kit-mcp란 무엇인가요?

Kilo-Kit Core Skill은 AI 에이전트가 증거 없는 추측(guesswork)에 기반하지 않고, 철저한 증거와 검증을 바탕으로 작업을 수행하도록 설계된 하드 게이트(Hard-Gate) 및 아이언 로(Iron Law) 기반의 안전장치입니다. 이 스킬은 모든 새 작업 시작, 아키텍처 변경 제안, 버그 진단, 프로덕션 시스템에 영향을 미치는 결정 등에서 필수적으로 사용됩니다. 주요 기능으로는 시스템(디스크, 메모리, 런타임) 및 코드베이스 스캔을 강제하는 'Hard-Gate', 7개의 불변 규칙(Iron Law)을 통한 행동 통제, 그리고 작업 의도와 컨텍스트에 따라 적절한 하위 스킬(디버깅, 코드 리뷰, 테스팅 등)로 라우팅하는 적응형 디스패치(Adaptive Dispatch)가 포함됩니다. Cursor, Claude Code, Codex 등 MCP(Model Context Protocol)를 지원하는 모든 코딩 에이전트에서 사용할 수 있으며, 작업의 안전성과 정확성을 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add VoDaiLocz/kilo-kit-mcp

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

🛡️ 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 — 증거가 추측보다 우선한다

관련 스킬