피드로 돌아가기
I got tired of AI agents trashing my codebase, so I built a skill to fix that
Dev.toDev.to
AI/ML

8단계 엔지니어링 규율 기반의 AI Agent 제어 프레임워크 Squirrel

I got tired of AI agents trashing my codebase, so I built a skill to fix that

날다람쥐2026년 4월 27일6분intermediate

AI 요약

Context

AI Coding Agent가 기존 코드의 Naming Convention을 무시하거나 임의로 프레임워크를 교체하는 등 코드 일관성을 파괴하는 문제 발생. 명시적 제약 조건 부재로 인한 무한 디버깅 루프와 무분별한 리팩토링으로 코드베이스 오염 가속화.

Technical Solution

  • SKILL.md 파일 기반의 8단계 Engineering Discipline(Discover, Plan, Build, Test, Bug Hunt, Polish, Document, Ship) 강제 적용
  • 프로젝트 상태(Greenfield, In-Progress, Mature, Targeted)를 사전 진단하는 Step 0 모드 감지 로직 구현
  • 기존 스타일 가이드(.eslintrc, pyproject.toml 등) 분석을 통한 코드 스타일 일치 및 최소 변경 원칙 수립
  • 3-Strike Rule 도입을 통한 무한 루프 방지 및 3회 실패 시 즉시 Revert 후 사용자 개입 요청 구조 설계
  • 온디맨드 템플릿 로딩 방식을 통한 컨텍스트 윈도우 최적화 및 필요한 시점에만 관련 Reference 제공
  • Markdown 기반의 플랫폼 독립적 설계를 통한 8개 주요 AI Agent 도구와의 호환성 확보

실천 포인트

- AI Agent 도입 시 프로젝트 진단 단계(Audit)를 강제하여 현재 코드 성숙도 파악 - 반복적인 오류 발생 시 중단 및 보고를 강제하는 '최대 시도 횟수(Strike Rule)' 설정 - 스타일 가이드 파일(.toml, .json 등)을 Agent가 먼저 읽도록 지시하여 일관성 유지 - 기능 구현 전 의존성과 완료 기준이 포함된 Plan.md 작성을 선행 프로세스로 구축

태그

#AI Agent#Engineering Discipline#Context Window#Prompt Engineering#Coding Convention
원문 읽기