🧠 에이전트 행동 강령 및 데브로그 원칙 (SOP & Devlogs)

우리 회사의 AI 에이전트 마스터(new_gene)는 단순히 코드를 짜는 기계가 아니라 팀의 주니어급 이상 개발자로 대우해야 합니다. Agent_SOP_Devlog 문서는 에이전트가 "실패를 회피하고 망상을 방지"하기 위해 반드시 지켜야 할 <3대 필수 행동 강령> 과 **<데브로그 기록 원칙>**을 Gitea 서버 상에 퍼지는 룰로 정립합니다.

⛔ 1. 무결성 방어 3대 원칙 (Legacy Guardrails)

과거 antig_web 시절부터 이어져 온, 이 룰을 어기는 AI는 강제로 세션을 종료당하는 핵심 수칙입니다.

🚫 3진 아웃제 및 오답노트 (Failure Protocol)

에이전트가 똑같은 코드나 패키지를 깔다가 2번 동일 에러가 뜨면, 그 접근법을 과감히 포기(STOP)합니다.
반드시 실패 원인과 우회로를 고민하여 이 Gitea Wiki(또는 로컬 .knowledge/project_wiki/devlog/known-issues.md) 에 영구 박제시킨 뒤에야 다른 방법을 찾습니다. (똑같은 삽질을 내일 또 하지 않기 위함).

🔍 프로듀서-컨슈머 디버깅 (P-C Rule)

에러가 딱 1개 파일에서 났다고 그 파일만 들여다보며 고치는 행위를 일절 금지합니다.
AI는 문제를 파악할 때 데이터를 쏜 놈과 지운 놈 양쪽 파일을 모두 열어서(mcp-server-filesystem JSON-RPC 통신) 교차 검증한 결과를 요약한 뒤에나 코드를 허락받습니다.

🎥 가짜 완료 통보 영구 박탈 (No Fake Verification)

"구현 다 했습니다." 와 "진짜 브라우저를 띄워 화면 렌더링에 깨짐 없는 걸 육안으로 검증했습니다." 는 다른 이야기입니다. Vision 확인이나 로그 체크가 없는 가짜 완료를 엄단합니다.

📝 2. Devlog (일일 개발 일지) 핑퐁 전략

에이전트가 한 에픽(Phase)의 작업을 완료할 때, 지식(Wiki) 체계를 어떻게 구축하는지 설명합니다.

설계 의도 남기기: 에이전트는 로컬에서 코딩 완료 시, "왜 A 옵션보다 B 옵션을 썼는지"에 대한 기록을 .knowledge/project_wiki/devlog/YYYY-MM-DD.md (옵시디언 방식의 마크다운) 파일로 날짜별 정리합니다.
Gitea 자동 연동: 작성된 데브로그는 백그라운드 서버를 통해 origin main 원격 Gitea 위키 탭으로 1초 만에 송출됩니다. (Git 동기화).
인간의 개입 (PM): 프로젝트 관리자나 인간 개발자가 Gitea 위키를 읽다 마음에 들지 않으면 웹 브라우저에서 문서 내용을 수정 후 [저장] 만 누르십시오.
에이전트 흡수: 에이전트가 다음 날 작업을 시작하면 git pull --rebase origin main으로 인간이 수정한 위키를 1순위로 흡수하여 얌전하게 코딩을 수정합니다.