DOCS/journey/troubleshooting/260326_principle_improvements.md
happybell80 886bd42ae3 docs: 신규 스킬 7개 SKILL.md + 원칙 문서 중복 제거 + 구현 결과 문서
- 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>
2026-03-26 01:23:15 +09:00

1.6 KiB

date, subject, status
date subject status
2026-03-26 260325-26 세션에서 발견된 원칙 개선사항 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