chore: 저장소 구조 정리 및 문서화, 첫 커밋

- src/dist 산출물 분리 원칙 정리(.gitignore, .gitattributes)
- 루트 및 주요 폴더(config/scripts/prompts/tests/src, 런타임 폴더 5종)에
  안내용 README.md 추가
- CHANGELOG.md, LICENSE, docs/ops/05-release-and-versioning.md 추가
- docs/README.md 문서 지도 갱신
This commit is contained in:
Yun Chan 2026-09-04 09:25:44 +09:00
commit 56a6e2da93
159 changed files with 145825 additions and 0 deletions

13
prompts/README.md Normal file
View file

@ -0,0 +1,13 @@
# `prompts/` — AI 요약 프롬프트 템플릿
`agy`를 이용한 **요약용 AI 계층**(수집용 AGY와는 다르다, `docs/research/05a-agy-cli-ssot.md`
참고) 호출에 쓰는 템플릿이다. 이 계층은 완전히 선택 기능이며, 실패해도 리포트 생성을
막지 않는다(요구 R4.4).
| 파일 | 역할 |
|---|---|
| `daily_briefing.md` | 그날의 diff·지표를 채워 넣는 단일 프롬프트. "JSON 객체 하나만 출력" 강제 문구를 포함한다 — `agy``--json-schema` 결과는 신뢰하지 않고 응답 본문에서 직접 JSON을 추출·검증하기 때문이다 |
| `daily_briefing.schema.json` | 위 응답을 검증하는 자체 jsonschema. 이 검증을 통과하지 못한 응답은 버려지고 리포트는 AI 코멘트 없이 생성된다 |
렌더링 로직은 `src/dmf_crawler/agy/prompt.py`, 추출·검증 로직은
`src/dmf_crawler/agy/extract.py`다.