DOCS/journey/troubleshooting/260326_principle_improvements.md
happybell80 60a892e5ab fix: DOCS 내 0_VALUE 참조를 GitHub URL → 로컬 상대경로로 전환, 02_Governance → 20_Governance 수정 #33 #34
SSOT는 로컬 0_VALUE/. GitHub URL은 복사본 참조로 SSOT 원칙 위반.
02_Governance는 존재하지 않는 구 경로로 전부 깨진 링크.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-30 14:00:21 +09:00

1.9 KiB

date, subject, status, closed_date, closed_reason
date subject status closed_date closed_reason
2026-03-26 260325-26 세션에서 발견된 원칙 개선사항 closed 2026-03-27 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 20_Governance → 20_Governance
315_테스트_원칙.md 상위 링크 20_Governance → 20_Governance
311_backend_coding_principles.md 상위 링크 20_Governance → 20_Governance