happybell80
886bd42ae3
- session-logs, blogwatcher, summarize, whisper, gitea, himalaya, skill-creator SKILL.md - SKILL.md 인덱스 업데이트 (16개 스킬) - 311/314/315 상위 SSOT 중복 제거 + 링크 수정 - Phase 1-3 결과 + 테스트 결과 + evaluation 트러블슈팅 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
34 lines
1.6 KiB
Markdown
34 lines
1.6 KiB
Markdown
---
|
|
date: 2026-03-26
|
|
subject: 260325-26 세션에서 발견된 원칙 개선사항
|
|
status: open
|
|
---
|
|
|
|
# 원칙 개선사항
|
|
|
|
## 이미 반영됨
|
|
|
|
| 원칙 문서 | 변경 | 이유 |
|
|
|----------|------|------|
|
|
| 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 |
|