Read Original
#AI

개발자 없이 5분 만에 버그를 고친 QA, 우리가 설계한 것과 설계하지 않은 것

개발자 없이 5분 만에 버그를 고친 QA, 우리가 설계한 것과 설계하지 않은 것
01

Summary

"개발자님 바쁘세요? 제가 고칠게요!" 비개발자가 코드 잡는 AI 대장간의 탄생

단순 프롬프트를 넘어 시스템으로 제어하는 AI 에이전트가 가져온 협업의 혁신

AI 코딩 에이전트가 개인의 도구를 넘어 팀의 인터페이스로 진화하는 과정을 상세히 다룹니다. '코드베이스가 스승이다'라는 철학 아래 설계된 하네스 엔지니어링을 통해, 비개발자도 전문적인 개발 지식 없이 코드 품질을 유지하며 프로젝트에 기여할 수 있는 새로운 워크플로우를 제시합니다.

  • 01프롬프트의 불확실성을 시스템적으로 제어하는 '하네스 엔지니어링' 개념 도입
  • 02비개발자가 터미널 대신 익숙한 환경에서 작업할 수 있도록 Slack 앱(Anvil)으로 구현
  • 03프로젝트의 기술 스택을 자동 감지하고 컨벤션을 주입하는 자동화된 셋업 프로세스
  • 04Jira 티켓과 연동하여 영향 범위 분석부터 PR 생성까지 이어지는 심리스한 흐름
  • 05누가 작업하든 동일한 품질 게이트를 통과하게 하여 일정한 코드 퀄리티 유지

RECOMMENDATION

AI 도입을 고민하는 팀이라면 단순히 모델의 성능에 의존하기보다, 조직의 컨벤션을 강제할 수 있는 시스템적 보호 장치(Harness)를 먼저 설계할 것을 강력히 권장합니다.

The Problem

AI 코딩 도구를 팀 단위로 확장할 때 각 개인의 로컬 설정과 규칙이 파편화되어 결과물의 일관성이 떨어지고, 단순한 UI 수정이나 코드 분석 요청이 개발자에게 집중되어 업무 병목이 발생하는 문제가 있었습니다.

The Solution

프롬프트의 한계를 극복하기 위해 시스템 레벨에서 훅(Hooks)과 품질 게이트를 강제하는 'code-forge' 플러그인을 개발하고, 이를 Slack 인터페이스인 'Anvil'과 결합하여 비개발자도 안전하게 코드를 수정하고 영향 범위를 분석할 수 있는 환경을 구축했습니다.

The Result

QA와 기획자가 직접 영향 범위를 파악하고 단순 버그를 수정하여 배포까지 완료하는 사례가 발생했으며, 이를 통해 개발자의 단순 반복 업무가 줄어들고 팀 전체의 작업 속도가 정량적으로 향상되었습니다.

Trade-off

비개발자에게 코드 수정 권한을 개방하기 위해 시스템적인 제약 사항을 매우 엄격하게 설계해야 했으며, 완전한 자동화 대신 최종 머지 단계에서 반드시 개발자의 리뷰를 거치도록 설계하여 안전성을 담보했습니다.

03

Key Concepts

Concept · 01

하네스 엔지니어링 (Harness Engineering)

AI 에이전트가 프롬프트를 무시하거나 우회하지 못하도록 시스템 레벨에서 Hooks, 권한 관리, 품질 게이트 등을 통해 행동을 제약하는 설계 방식입니다.

  • 코드 수정 직후 Lint와 테스트를 자동 실행하여 사이드 이펙트 방지
  • 에이전트가 접근하거나 수정해서는 안 되는 민감 파일에 대한 제어 수행
Concept · 02

code-forge

Claude Code 등 AI 에이전트의 판단 기준이 되는 사고 모델을 프로젝트 단위로 배포하고 관리하는 커스텀 플러그인입니다.

  • 프로젝트 스택(React, Next.js 등)을 자동 감지하여 최적화된 규칙 세팅
  • 개별 개발자의 로컬 환경에 상관없이 팀 전체가 동일한 AI 코딩 기준을 공유하게 함
Concept · 03

Anvil

code-forge의 시스템 제어 능력을 Slack 인터페이스로 확장하여 비개발자가 자연어로 코드를 조회하고 수정할 수 있게 만든 작업대입니다.

  • Jira 티켓 기반의 영향 범위 분석 및 자동 수정 요청 처리
  • 단순 작업은 바로 구현하되 코어 로직 변경 시 담당 개발자 승인 프로세스 작동