---
date: 2026-03-26
subject: 260325-26 세션에서 발견된 원칙 개선사항
status: closed
closed_date: 2026-03-27
closed_reason: "coding-principles.md 대상 미반영 항목 2건은 260326 01:22:19 커밋(bfe30d89)에서 이미 반영 완료. 본 문서는 반영 직후(01:23:15) 생성되면서 이미 반영된 내용을 미완료로 잘못 기록한 것. 실제 미반영 0건 확인(24-Codex 조사)."
---

# 원칙 개선사항

## 이미 반영됨

| 원칙 문서 | 변경 | 이유 |
|----------|------|------|
| coding-principles.md §5 | 스케줄러 raise 필수 + exc_info=True | coldmail/headlines 에러 삼킴 |
| AGENTS.md §10 | Docker→Systemd 전환 원칙 | rb8001 전환 후 hostname/SQLite 오류 |
| test-principles.md §9 | 테스트 엔드포인트 활용 원칙 | router-message로 먼저 검증 |
| orchestration rules §9 | 에이전트 균등 사용 필수 | 특정 에이전트 과의존 방지 |

## 반영 필요 (미완료)

| 원칙 문서 | 필요한 변경 | 이유 |
|----------|-----------|------|
| coding-principles.md §5 | 비동기 작업은 시작 시 pending 상태를 DB에 기록, 실패 시 failed로 갱신 | evaluation 빈 응답 문제 |
| coding-principles.md §3 | "실패"와 "미존재"를 같은 HTTP 404로 반환하지 않는다 | evaluation 폴링 무한루프 |
| infrastructure-ssot-principle.md §7 | compose environment에서 env_file과 겹치는 변수를 ${VAR:-default}로 두지 않는다 (이미 있으나 위반 반복) | summarize/whisper 배포 문제 |
| 311_backend_coding_principles.md | 비동기 API 패턴: 즉시 ID 반환 + pending DB INSERT + 완료/실패 UPDATE | 로빙 특화 구체화 |

## SSOT 경로 오류 수정됨

| 위치 | 수정 |
|------|------|
| DOCS/skills/SKILL.md | 02_Governance → 20_Governance |
| 315_테스트_원칙.md 상위 링크 | 02_Governance → 20_Governance |
| 311_backend_coding_principles.md 상위 링크 | 02_Governance → 20_Governance |
