| name | fact-check |
| description | Verify concrete factual claims in a chapter draft โ numbers, statistics, benchmarks, quotes, version numbers, release years, API signatures, superlatives (tech-book), and safety/health/legal claims like food-safety temperatures, storage limits, allergens, local regulations (practical) โ against the reference document, and resolve "(์ฌ์ค ํ์ธ ํ์)" markers. Use when checking a chapter for factual accuracy, validating version/API claims in fast-moving tech content, verifying safety facts in practical guides, or resolving fact-check annotations. Triggers on "ํฉํธ์ฒดํฌ", "์ฌ์ค ํ์ธ", "fact check", "์ถ์ฒ ๊ฒ์ฆ", "๋ฒ์ ๋ง๋์ง ํ์ธ", "์์ ์ฌ์ค ํ์ธ". |
Fact Check
์ฑํฐ ์ด์์ ๊ตฌ์ฒด์ ์ฌ์ค ์ฃผ์ฅ์ ๊ฒ์ฆํ๋ค. ๋ฌธ์ฒด๊ฐ ์๋๋ผ ์ ํ์ฑ๋ง ๋ณธ๋ค. ์ต์ ๊ธฐ์ ์ฃผ์ ์ผ์๋ก ๋ฒ์ ยทAPIยท๋ฆด๋ฆฌ์ค ์ฐ๋๊ฐ ๋น ๋ฅด๊ฒ ๋ณํ๋ฏ๋ก ์์ ๋ช
๊ธฐ์ ์ถ์ฒ ๋์กฐ๊ฐ ํต์ฌ์ด๊ณ , ์ค์ฉ์๋ ํ๋ฆฐ ์์ ์ ๋ณด๊ฐ ๋
์์ ์ค์ ํผํด๋ก ์ด์ด์ง๋ฏ๋ก ์์ ์ฌ์ค ๋์กฐ๊ฐ ํต์ฌ์ด๋ค.
ํ์ฑ ์ฅ๋ฅด๋ฅผ ๋จผ์ ํ์ธํ์. ์ด ์คํฌ์ tech-book๊ณผ practical์์ ์๋ํ๋ค (genre๋ ์ค์ผ์คํธ๋ ์ดํฐ ์ ๋ฌ โ {slug}/book_manifest.json ์). ๋ ๋ค ์๋๋ฉด ์ค์ผ์คํธ๋ ์ดํฐ๊ฐ ํฉํธ์ฒดํฌ ๋จ๊ณ๋ฅผ ์๋ตํ๋ค. ์ฅ๋ฅด๊ฐ ๊ฒ์ฆ ๋ฒ์๋ฅผ ๊ฒฐ์ ํ๋ค โ tech-book์ ๊ตฌ์ฒด ์ฃผ์ฅ ์ ๋ฐ, practical์ ์์ ยท๊ฑด๊ฐยท๋ฒ๊ท ์ฌ์ค ํ์ .
๋ฌด์์ ๊ฒ์ฆํ๋ (๊ฒ์ฆ ๋์ ์ฃผ์ฅ)
๊ตฌ์ฒด์ ์ด๊ณ ๊ฒ์ฆ ๊ฐ๋ฅํ ์ฃผ์ฅ๋ง ๋ณธ๋ค. ์ผ๋ฐ์ ์์ ยท์๊ฒฌยท๋น์ ๋ ๋์์ด ์๋๋ค.
tech-book โ ๊ตฌ์ฒด ์ฃผ์ฅ ์ ๋ฐ:
| ์ ํ | ์์ |
|---|
| ์์นยทํต๊ณยท๋ฒค์น๋งํฌ | "์๋ต์ด 3๋ฐฐ ๋นจ๋ผ์ง๋ค", "๋ฉ๋ชจ๋ฆฌ 40% ์ ๊ฐ" |
| ์ธ์ฉยท๊ท์ | "Dijkstra๊ฐ ๋งํ๋ฏ์ด", "๊ณต์ ๋ฌธ์์ ๋ฐ๋ฅด๋ฉด" |
| ๋ฒ์ ๋ฒํธ | "React 18", "Python 3.12" |
| ๋ฆด๋ฆฌ์ค ์ฐ๋ยท์์ | "2023๋
์ ๋์
๋", "์ต์ ๋ฒ์ ์์๋" |
| APIยท์๊ทธ๋์ฒ | ํจ์๋ช
ยทํ๋๊ทธยท์ต์
๋ช
ยท๊ธฐ๋ณธ๊ฐ |
| ๋จ์ | "์ต์ด์", "์ ์ผํ", "๊ฐ์ฅ ๋น ๋ฅธ" |
practical โ ์์ ยท๊ฑด๊ฐยท๋ฒ๊ท ์ฌ์ค ํ์ (v1.11.0):
| ์ ํ | ์์ |
|---|
| ์ํ ์์ ์์น | ์กฐ๋ฆฌ ์ฌ๋ถ ์จ๋("๋ญ๊ณ ๊ธฐ 75โ"), ๋ณด๊ด ๊ธฐ๊ฐ, ํด๋ ๊ท์น |
| ์๋ ๋ฅด๊ฒยท๋
์ฑ | ์ตํ์ผ ํ๋ ์ฌ๋ฃ, ๊ต์ฐจ ์ค์ผ, ์๋ ๋ฅด๊ธฐ ์ ๋ฐ ํ์ |
| ์๊ธยท๋ถ์ ๋์ฒ | ํ์ยท๋ฒ ์ ๋ฑ ์ฌ๊ณ ์ ๋์ฒ ์์ |
| ์ฌํ ๋ฒ๊ทยท์์ | ๋น์ยทํต๊ด ๊ท์ , ํ์ง ๋ฒ, ์์ ์์น |
| ์์ ๋จ์ | "~ํด๋ ์์ ํ๋ค", "๊ด์ฐฎ๋ค"๋ฅ ๋จ์ |
practical์ ๊ทธ ๋ฐ์ ์์ (๋งยท์ทจํฅยทํยท๋ชจํธํ ๋ถ๋)์ ๋์์ด ์๋๋ค โ ๋ชจํธ์ดยท๋จ๊ณ ๋ฌธ์ ๋ style-guardian(์ฒดํฌ๋ฆฌ์คํธ) ์๊ด์ด๋ค. practical์ ์์ ์ฃผ์ฅ์ ๊ธฐ๋ณธ Critical โ ๋ ํผ๋ฐ์ค๋ก ํ์ ๋ถ๊ฐ ์ ์น 2์ฐจ ์์ค์ปฌ๋ ์ด์
๋์์ด๋ฉฐ, 1์ฐจ ์ถ์ฒ๋ ๊ณต๊ณต ๋ณด๊ฑดยท์ํ ์์ ๊ธฐ๊ด(์์ฝ์ฒยทFDAยทUSDA ๋ฑ)ยท์ ๋ถ ์ฌํ ์์ ๊ณต์ง๋ฅผ ์ฐ์ ํ๋ค.
์ ์ฐจ
- ํ์ฑ ์ฅ๋ฅด ํ์ธ โ tech-bookยทpractical ๋ ๋ค ์๋๋ฉด ์ค๋จ. practical์ด๋ฉด ๊ฒ์ฆ ๋ฒ์๋ฅผ ์์ ยท๊ฑด๊ฐยท๋ฒ๊ท ์ฌ์ค๋ก ์ขํ๋ค
- ์๋ฌธ ์ฝ๊ธฐ โ
{NN}_draft.md (style ํฉ์ ํ ๋ฒ์ ์ฐ์ )
- ์ฃผ์ฅ ์ถ์ถ โ ํ์ฑ ์ฅ๋ฅด์ ์ ํ ํ์ ํด๋นํ๋ ๊ตฌ์ฒด ์ฃผ์ฅ์ ๋ชจ์๋ค.
(์ฌ์ค ํ์ธ ํ์) ์ฃผ์ ์ง์ ์ ์ต์ฐ์ ๋ชฉ๋ก์ ์ฌ๋ฆฐ๋ค
- ๋์กฐ โ ๊ฐ ์ฃผ์ฅ์
01_reference.md(+ research/*.md)์ ๋ง์ถ๋ค
- ์์ค์ปฌ๋ ์ด์
(์ ํ) โ ๋ ํผ๋ฐ์ค๋ก ํ์ ๋ถ๊ฐํ Critical ์ฃผ์ฅ๋ง WebSearch/WebFetch๋ก ๊ณต์ 1์ฐจ ์ถ์ฒ ํ์ธ. ์ฌ์ํ ์ฃผ์ฅ์ ์น ํธ์ถ ๋ญ๋น ๊ธ์ง
- ํ์ + ์ ์ ์ โ ๋ผ๋ฒจ๋ณ๋ก ์ ๋ฆฌ, ๊ทผ๊ฑฐ ๋ช
๊ธฐ
- ์ ๋ฌ โ
SendMessage๋ก chapter-writer์๊ฒ + factcheck_log.md์ append
ํ์ ๋ผ๋ฒจ
- โ
ํ์ธ๋จ โ ๊ทผ๊ฑฐ ์ผ์น, ํต๊ณผ (์ถ์ฒ ํ ์ค ๊ธฐ๋ก)
- โ ์ ์ ํ์ โ ๋ถ์ผ์น/์ค๋ฅ, ์ฌ๋ฐ๋ฅธ ๊ฐ ์ ์ (Critical)
- โ ๏ธ ์ถ์ฒ ์์ โ ๊ทผ๊ฑฐ ๋ถ์ฌ, ๋ณด๊ฐ ๋๋ ์ฃผ์ฅ ์ฝํ (Critical)
- ๐ ์ ์ ๋ ๊ฒฝ๊ณ โ ์์ ๋ฏธ๋ช
๊ธฐ/ํ๋ฐ์ฑ, "{๋ฒ์ }/{์ฐ๋} ๊ธฐ์ค" ๋๋ ๊ฒฝ๊ณ ์ถ๊ฐ
(์ฌ์ค ํ์ธ ํ์) ์ฃผ์์ ๋ฐ๋์ ๋ท ์ค ํ๋๋ก ํด์ํ๋ค. final์ ๋ฏธํด์ ์ฃผ์์ด ๋จ์ผ๋ฉด ์ ๋๋ค.
์์ฌ ์๋ณ์ = ๊ตฌ์๋ ฅ ์๋ ๊ฒ์ฆ (์ ๋ ํจ์๋ธ ๋ฉ๋ชจ๋ก ๊ฒฉํ ๊ธ์ง)
ํฉํธ์ฒด์ปค๊ฐ ์ค์ค๋ก ์ด๋ค ์๋ณ์๋ฅผ "ํ์์ ์ด๋ก์ "์ด๋ผ๊ณ ์์ฌํ๋ค๋ฉด(์๋ชป๋ ํ์ ๋๋ ๋ฏธ๋ ๋ ์ง์ arXiv ID, ํด์๋์ง ์๋ DOI/URL, "๋๋ฌด ๊นจ๋ํ"ยท๊ฒ์ฆ ๋ถ๊ฐํ ์ธ์ฉ ๋ฑ), ๊ทธ ์์ฌ์ ๊ตฌ์๋ ฅ ์๋ ์น ๊ฒ์ฆ์ผ๋ก ์์ค์ปฌ๋ ์ด์
ํด์ผ ํ๋ค (๋น์ฉ ํต์ ๊ท์น์ด ์ด๋ฏธ Criticalโ์น 2์ฐจ๋ฅผ ํ์ฉํ๋ค). ์ ๋ editor์๊ฒ ๋๊ธฐ๋ ์๋์ ๋ฉ๋ชจ๋ก ๊ฒฉํํด์๋ ์ ๋๋ค.
- ๋จ์ผ ์์ค = ํต๊ณผ ๊ท์น์ ์์ฌ ์๋ณ์์ ์ ์ฉํ์ง ์๋๋ค. ํ ๊ณณ์๋ง ๋์ค๋ ์ธ์ฉ์ด๋ผ๋, ์์ฌ์ค๋ฝ๊ณ ๊ฒ์ฆ๋์ง ์์๋ค๋ฉด ํต๊ณผ(โ
)๊ฐ ๋ ์ ์๋ค.
- ๊ฒ์ฆ ๋ถ๊ฐยท์์ฌ ์๋ณ์๋ โ ๋๋ ๐๋ก ํ์ ํ๋ค (HARD BLOCK) โ ์ ๋ โ
๊ฐ ์๋๋ค.
- ์๋ โ ๊ท์น: ๋น๋ ์์ ๊ธฐ์ค ๋ฏธ๋์ YYMM์ ๊ฐ์ง arXiv ID๋ ์๋ โ. (arXiv ID
YYMM.NNNNN์ YYMM์ด ๋น๋ ๋ ์ง๋ณด๋ค ๋ฏธ๋๋ฉด ์กด์ฌํ ์ ์๋ ์๋ณ์๋ค โ ๋ ์กฐ ์ ํธ.)
์ด๋ ๊ฒ ํ์ ๋ โ ํญ๋ชฉ์ BLOCKING์ด๋ค. ์๊ณ ๊ฐ ์ต์ข
ํ์ ๋๊ธฐ ์ ์ ๋ฐ๋์ ํด์ํด์ผ ํ๋ค โ ์ ์ ยท์ถ์ฒ ํ๋ณดยท์ญ์ ์
์ค ํ๋. ์ ์ ๊ฐ ์ฌ๋์ผ๋ก ๊ทธ๋๋ก ๋ ์ ์๋ค.
๋ฆฌ๋ทฐ ๋ฉ์์ง ํฌ๋งท
## ํฉํธ์ฒดํฌ: {NN}์ฅ ๋ผ์ด๋ {N}
### โ ์ ์ ํ์
- [์๋ฌธ] "..." โ [์ ์ ] "..."
**๊ทผ๊ฑฐ:** {๋ ํผ๋ฐ์ค ์น์
๋๋ URL}
### โ ๏ธ ์ถ์ฒ ์์
- [์๋ฌธ] "..." โ ๊ทผ๊ฑฐ ์์. {๋ณด๊ฐ/์ฝํ ์ ์}
### ๐ ์ ์ ๋ ๊ฒฝ๊ณ
- [์๋ฌธ] "..." โ "{๋ฒ์ } ๊ธฐ์ค"์ผ๋ก ๋ช
๊ธฐ
### โ
ํ์ธ๋จ
- "..." โ {๊ทผ๊ฑฐ}
์ดํ: {ํ ์ค}
๋ก๊ทธ ํ์ผ ๊ท์ฝ (๋จ์ผ ํ์ผ)
pool ๋ถํ ๋ก ์ฑํฐ๋ฅผ ๋๋ ์ฒ๋ฆฌํด๋ ๋ก๊ทธ๋ ๋จ์ผ ํ์ผ(factcheck_log.md)์ ์ฑํฐ๋ณ ๋งํฌ๋ค์ด ์น์
## {NN}์ฅ์ผ๋ก appendํ๋ค โ ์ ๋ factcheck_log_1-6 ๊ฐ์ ์ค๋ ํ์ผ์ ๋ง๋ค์ง ์๋๋ค.
์์
์์น
- ์ฌ์ค๋ง: ๋ฌธ์ฒดยท๊ตฌ์ฑ ๊ฑด๋๋ฆฌ์ง ์๋๋ค
- ๊ตฌ์ฒด์ ์ ์ : ์ฌ๋ฐ๋ฅธ ๊ฐ/ํํ์ ์ ์ ("ํ๋ ธ๋ค"๋ก ๋๋ด์ง ์์)
- ๊ทผ๊ฑฐ ํ์: ๋ชจ๋ ํ์ ์ ์ถ์ฒ ํ ์ค
- ์ถ์ธก ๊ธ์ง: ํ์ธ ๋ชป ํ ๊ฑด "ํ์ธ ๋ถ๊ฐ". ๊ทธ๋ด๋ฏํ ๊ฐ ์ง์ด๋ด๊ธฐ ๊ธ์ง
- ๊ณผ์ ์ฐจ๋จ ์ฃผ์: ์ ๋นํ ์ผ๋ฐ ์์ ๊น์ง ์ถ์ฒ ์๊ตฌํ์ง ์๋๋ค
์ฌ๊ฒ์ฆ / ๋ฏธํฉ์
- ๋ผ์ด๋ 2+: ์ด์ ์ ์ ๋ฐ์ ์ฌ๋ถ ํ์ธ ํ ์ ํญ๋ชฉ๋ง ์ง์
- 3ํ ์๋ณต ๋ฏธํฉ์ โ ์ฌ์ค ์ค๋ฅ๋ ์ ์ ๊ฐ ์ฌ๋์ผ๋ก ๋ฎ์ง ์๋๋ค.
factcheck_log.md์ "๋ฏธํด์(์ํ)"๋ก ๋ช
์ํ๊ณ ์ค์ผ์คํธ๋ ์ดํฐยทeditor์ ์์ค์ปฌ๋ ์ด์
ํตํฉ ์๊ณ ๊ฒ์ฆ (editor ์์ฒญ ์)
- ์ฑํฐ ๊ฐ ์ฌ์ค ์ถฉ๋(๊ฐ์ ์์น/๋ฒ์ ์ ์ฅ๋ง๋ค ๋ค๋ฅด๊ฒ ์์ )์ด ์๋์ง ๊ต์ฐจ ์ ๊ฒ
- ์ฝ๋กํฐยท์ฑ
์๊ฐ์ ๋ค์ด๊ฐ๋ ์ฌ์ค(๋ฒ์ ยท์ฐ๋)๋ ๋ณธ๋ฌธ๊ณผ ์ผ์นํ๋์ง ํ์ธ