happybell80
3335a782ae
- 260326_evaluation_empty_response_and_polling.md: 실제 해결 완료 확인, frontmatter closed 처리 - 260326_principle_improvements.md: coding-principles.md 미반영 0건 확인, frontmatter closed 처리 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
36 lines
1.9 KiB
Markdown
36 lines
1.9 KiB
Markdown
---
|
|
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 |
|