코딩에서의 AI 에이전트: 규율을 위한 SENAR 표준

AI 에이전트 개발을 위한 엔지니어링 표준: 규칙에서 규율로

1년 반 동안 핸드 코딩 없이 개발하며 CLAUDE.md 같은 간단한 파일 지침의 한계를 깨달았습니다. Claude Code나 Cursor 같은 에이전트는 작업을 처리하지만 프로젝트 맥락을 무시하고, 논리를 임의로 만들며, 엣지 케이스를 놓칩니다. IT 리더 Andrey Yumachev는 일회성 프롬프트에서 체계적 프로세스로 전환했습니다: 공식 명세, 실패 메모리, SENAR 표준과 TAUSIK 프레임워크. 이로 서버 측 작업의 FPSR(최초 성공률)이 40%에서 75~80%로 상승했습니다.

실제에서 드러난 문제점

간단한 프로젝트는 규칙 파일로 충분합니다: 코드 스타일, 승인된 라이브러리, 초점 영역. 하지만 복잡한 작업은 에이전트를 한계 너머로 밀어냅니다.

무단 변경

에이전트가 작업 중 모듈을 리팩토링하며 7개 모듈에서 사용하는 유틸리티 라이브러리를 건드립니다. 테스트는 통과하지만 다음 날 3개 모듈이 깨집니다. 과도한 열혈 신입 개발자처럼 승인 없이 중복 코드를 추출합니다.

API 추측

외부 서비스 통합: 에이전트가 요청 코드, 재시도 로직(1초, 2초, 4초), 응답 파싱을 생성합니다. 5개 요청 중 2개가 실패—문서가 오래되어 에이전트가 그럴듯하지만 잘못된 방식으로 빈틈을 메웁니다. curl이나 Postman으로 수동 확인이나 코드 주석이 없습니다.

테스트 누락

비밀번호 재설정: 테스트는 초록 불이지만 OWASP 취약점이 있습니다—존재/비존재 이메일에 다른 응답으로 열거 공격이 가능합니다. 명시적 명세 없이 에이전트가 테스트를 추가하지 않았습니다.

지침은 제안일 뿐, 강제력이 없습니다. 집행 메커니즘이 없어요.

프로세스 진화: 명세에서 메모리로

요구사항 공식화

모든 작업: 목표, 수락 기준, 포함/제외 범위 파일, 부정 시나리오(빈 필드, 유효하지 않은 ID). FPSR이 2배 증가. 명세가 추측을 막아 에이전트가 명확한 규칙을 따릅니다.

공식화된 명세 예시:

• 목표: 비밀번호 재설정 구현.
• 기준: 모든 이메일에 동일 응답(타이밍 포함); 존재/비존재 테스트.
• 포함 범위: auth.py, tests/test_reset.py.
• 제외 범위: UI.

Sortula: 실패 메모리가 있는 프로젝트

링크 저장 서비스로 의미 검색(LLM이 논리를 DB에 추출). 에이전트가 한 라이브러리에서 빌드 3번 깨뜨립니다—과거 실패 기억 없음.

해결: 실패 로그 파일.

• 라이브러리 X: 서버 Y에서 빌드 실패(의존성 Z 누락).
• 대안: W, 설정 플래그로 작동.
• 날짜: YYYY-MM-DD.

6주 만에 40개 항목, 작업당 15분 이상 절약. 로그가 CLAUDE.md 서두에 삽입됩니다.

SENAR 표준과 TAUSIK 프레임워크

SENAR은 AI 개발 엔지니어링 표준: 명세(Specification), 집행(Enforcement), 메모리(Memory), 감사(Audit). TAUSIK은 구현 프레임워크입니다.

SENAR 구성 요소:

• 명세: 기준, 범위, 부정 시나리오 포함 YAML/JSON 명세.
• 집행: pre-commit 훅으로 준수 확인(린팅, 범위 외 변경 금지).
• 메모리: Sortula 스타일 로그 + 에이전트 메모리(Claude 컨텍스트 윈도우).
• 감사: 마일스톤별 인간 검토 체크포인트.
• 롤백: 기능 브랜치 Git 워크플로.

TAUSIK이 자동화: 명세 템플릿 생성, 프롬프트에 로그 주입, 스크립트로 집행.

지표와 솔직한 벤치마크

FPSR: 첫 시도 성공 작업 비율. 초기 역사 추정, 후기 로그 기반.

| 단계 | 서버 FPSR | 프론트엔드 FPSR | 비고 |

|-------|-------------|---------------|-------|

| 규칙만 | 40% | 30% | 기준 |

| +명세 | 75% | 60% | 익숙 영역 |

| +SENAR | 85%+ | 70%+ | 전체 스택 |

숫자는 주관적, 도메인 의존적. 미숙숙 영역에서 FPSR 20% 하락.

주요 교훈:

• AI 에이전트는 실행자일 뿐 엔지니어가 아님: 규율 있는 명세와 집행 필요.
• 실패 메모리 필수: 작업당 15~30분 절약.
• 익숙 스택에서 SENAR로 FPSR 80% 초과 가능.
• 인간 개입: 아키텍처, 검토, 결정.
• 30+ 프로젝트: PoC에서 프로덕션까지.

— Editorial Team