AI 코딩 정책은 단순히 AGENTS.md 파일만으로는 부족하며 증빙 자료가 필요합니다
요약
본 글은 AI 에이전트의 코딩 윤리(coding-ethos)를 다루며, 단순한 규칙 설명 파일(`AGENTS.md`)만으로는 부족하다고 지적합니다. 대신 정책, 훅, 코드 인텔리전스 등을 활용하여 에이전트의 행동과 결정 과정을 증명하는 메커니즘 구축의 중요성을 강조합니다.
핵심 포인트
- AI 에이전트의 행동은 단순 규칙을 넘어선 '증빙 자료'가 필요하다.
- 코딩 윤리는 정책, 훅, 코드 인텔리전스 등으로 분할되어 체계화된다.
- v0.3.0 버전은 플러그인 확장성 및 중앙 집중식 라우팅 개선이 특징이다.
- 거부된 행동에 대해서도 구조화된 판결과 복구 페이로드를 기록해야 한다.
AGENTS.md 파일은 규칙을 설명할 수는 있습니다. 하지만 에이전트가 그 규칙을 보았는지, 제안된 행동이 평가되었는지, 혹은 거부된 변경 사항이 사용 가능한 복구 흔적을 남겼는지를 증명할 수는 없습니다. 이것이 바로 코딩 윤리(coding-ethos) 뒤에 숨겨진 유용한 질문입니다.
코딩 윤리는 이 문제를 정책(policy), 에이전트(agents), 훅(hooks), 그리고 코드 인텔리전스(code intelligence)로 분할합니다. coding_ethos.yml은 메커니즘을 설명하고, ETHOS.md와 코딩 윤리 표준은 가치를 담고 있습니다. AGENTS.md와 CLAUDE.md는 에이전트 계약(agent contracts)을 설명합니다. 훅 러너(hooks runner)는 생명주기 이벤트(lifecycle events)를 받아 관련 평가자 또는 MCP 도구로 라우팅하고 결과를 표준화합니다.
v0.3.0 버전은 세 가지 구체적인 이유로 흥미롭습니다: 정책 확장 지점(policy extension seams)을 통해 다운스트림 규칙이 컴파일러를 재작성할 필요 없이 플러그인될 수 있고; 라우팅이 모든 훅에 중복되는 대신 중앙 집중화되었으며; 그리고 복구 증거가 코드 인텔 스토어(code-intel store)에 영속적으로 저장되기 때문입니다. 거부된 행동은 단순히 빨간색 로그 줄일 것이 아니라, 구조화된 판결(structured verdict)과 복구 페이로드(remediation payload)로 테스트 가능해야 합니다.
저의 첫 사용 확인 절차는 의도적으로 작게 설계되었습니다: 일회용 리포지토리에 대해 uvx coding-ethos를 실행하고, 허용된 행동 하나와 거부된 행동 하나를 수행한 다음, 규칙 ID와 증거 페이로드를 읽고, 복구 후 재시도한 다음, 임시 구성을 제거하고 롤백을 검증합니다. 눈에 보이는 MCP 도구 목록은 강제 집행의 증거가 아니며, hooks/runner를 우회하는 레거시 경로는 증거를 조용히 누락시킬 수 있습니다.
Doramagic 패키지는 또한 Bubblewrap 프로비저닝, git amend 정책, MCP stdio 커버리지, 그리고 에이전트 프록시 작업에 대한 커뮤니티 보고서를 기록합니다. 이것들은 Doramagic이 모든 이슈를 재현했다는 주장이 아니라, 다시 검토해야 할 출처 기반 확인 사항들입니다. 프로젝트 노트: https://doramagic.ai/en/projects/coding-ethos/manual/
공개 고지: 이것은 공식적인 coding-ethos 릴리스나 승인이 아닌, 독립적인 Doramagic 기능 패키지입니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기