대표 사례로

AI 개발 작업 도구

AI 개발 도구에 작업 규칙·검사·문서 검색을 연결한 개인 개발 도구입니다. 반복되는 구현·검증 작업을 지원합니다.

내가 맡은 일

개발 규칙·훅·검사 묶음 구성 · 완료 전 독립 재검증 단계 적용

개발 도구

2026-04 ~ 지금

주요 결과

  • 구현·검증·배포 전 점검 등 반복 개발 절차 자동화규칙·훅·검사 묶음
  • 완료 보고 전 독립 재검증 단계 적용
에이전트 명령 가드 훅

작업 트리 생성과 직접 빌드는 정해 둔 진입점을 안내하며 차단하고, 조회 명령은 통과시키는 실제 훅 응답입니다.

공개용 화면 안내

화면이 없는 도구라 실제 명령 출력과 현재 원본 파일을 읽기 전용 터미널 형태로 렌더링해 촬영했습니다. 비밀 값 검사는 가짜 토큰만 사용했습니다.

문제와 시작

AX 프로젝트를 빠르게 구현해도 품질·리뷰·배포 안전장치·반복 실수 방지·맥락 기억이 남지 않으면 현업 적용 속도가 유지되지 않습니다. 요즘 유튜브에 도는 에이전트 하네스·루프 엔지니어링·RAG 기억은 데모로는 흔하지만, 실제 납품 현장에서 굴러가는 형태로 만드는 건 다른 문제였습니다.

직접 한 일

세 층으로 만들었습니다. ① 하네스 — Claude Code·Codex 작업 방식을 규칙·훅·에이전트·온디맨드 스킬로 묶어 코드 원칙·보안·배포 기준을 자동 주입했습니다. ② 루프 엔지니어링 — 완료를 자기보고가 아니라 독립 재검증으로 막는 완료 게이트(kdh), 가정을 먼저 노출하는 진화 루프(ooo), 매일 밤 부채를 자율 수정하는 무인 루프까지 실제로 돌립니다. ③ 기억 — 파일 기반 장기 기억과 의사결정 자동 회수 훅, 위키·문서 검색(RAG)으로 프로젝트 맥락을 다음 세션이 계속 회수합니다. 다만 트렌드를 그대로 따르지 않고, 무엇을 만들고 무엇을 안 만들지는 har_eval로 측정해 갈랐습니다.

결과와 현재 상태

개인 생산성 도구를, AX 프로젝트를 계속 납품할 수 있는 재사용 가능한 운영 하네스 — 검증 루프·자율 루프·장기 기억까지 — 로 바꿨습니다. 트렌드를 좇은 게 아니라 측정으로 만들 것과 안 만들 것을 갈랐습니다. 개발 도구 · 화면이 없는 설정 저장소라 실제 명령 실행 결과를 터미널 화면으로 옮겼습니다.

만든 화면

실제 훅·커밋 전 검사의 명령 출력과 현재 지침·폴더 구성을 읽기 전용 터미널 형태로 촬영했습니다. 비밀 값 감지 확인에는 가짜 토큰만 사용했습니다.

커밋 전 서식·비밀 값 검사

독립 임시 저장소에 가짜 토큰을 넣고 실제 커밋 전 검사를 실행했습니다. 비밀 값 후보를 감지해 커밋을 막는 결과입니다.

공개용 화면 안내

화면이 없는 도구라 실제 명령 출력과 현재 원본 파일을 읽기 전용 터미널 형태로 렌더링해 촬영했습니다. 비밀 값 검사는 가짜 토큰만 사용했습니다.

공통 지침

개발·검사·배포·백업과 도구 적용 기준을 연결하는 현재 공통 지침입니다. 적용 원칙과 담당 문서 연결을 한 구간으로 담았습니다.

공개용 화면 안내

화면이 없는 도구라 실제 명령 출력과 현재 원본 파일을 읽기 전용 터미널 형태로 렌더링해 촬영했습니다. 비밀 값 검사는 가짜 토큰만 사용했습니다.

규칙·훅·에이전트·스킬 구성

지침·정책·참조 문서와 실행 훅·자체 스킬을 관리하는 실제 폴더 구성입니다. 파일 이름을 읽을 수 있도록 본문 폭에 맞췄습니다.

공개용 화면 안내

화면이 없는 도구라 실제 명령 출력과 현재 원본 파일을 읽기 전용 터미널 형태로 렌더링해 촬영했습니다. 비밀 값 검사는 가짜 토큰만 사용했습니다.

사용한 기술

  • Bash
  • Markdown
  • YAML
  • Claude Code
  • Codex
  • Git Hooks
  • RAG Memory
맨 위로