08-research-vault โ HWPX ์ฐ๊ตฌ์๋ฃ ๋์ ๊ด๋ฆฌ ์ ์ฅ์
HWPX ํ์ผ(ํ๊ธ ๋ฌธ์)์ ๋ถ์ํ์ฌ ์ฃผ์ ๋ณ๋ก ์ฐ๊ตฌ ๊ฒฐ๊ณผ๋ฅผ ๋์ ๊ด๋ฆฌํ๋ ์ค์ ํ๋ธ.
ํต์ฌ ๊ฐ๋
HWPX ํ์ผ ์
์ โ ๋ถ์ ์นด๋ ์์ฑ โ ์ฃผ์ ํด๋์ ๋์ โ ์ข
ํฉ ๋ฌธ์ ๊ฐฑ์
- ์ฃผ์ (Topic): ์ฐ๊ตฌ์ ํฐ ์นดํ ๊ณ ๋ฆฌ (์: ์ ๋ณด๋ณด์, ํ์ ๋ฒ, AI ์ ์ฑ )
- ๋ถ์ ์นด๋(Analysis): HWPX 1๊ฑด ๋ถ์ ๊ฒฐ๊ณผ๋ฌผ
- ์ข ํฉ(Synthesis): ๋์ผ ์ฃผ์ ๋ถ์๋ค์ ๋์ ํตํฉํ ์ต์ข ์ ๋ฆฌ ๋ฌธ์
ํด๋ ๊ตฌ์กฐ
08-research-vault/
โโโ README.md โ ์ด ํ์ผ (์ฌ์ฉ ๊ฐ์ด๋ + ํ ํฝ ์ธ๋ฑ์ค)
โโโ _TOPIC_TEMPLATE.md โ ์ฃผ์ ํด๋ ์ด๊ธฐํ ์ ๋ณต์ฌํ ์ธ๋ฑ์ค ํ
ํ๋ฆฟ
โโโ _ANALYSIS_TEMPLATE.md โ ๊ฐ๋ณ ๋ถ์ ์นด๋ ํ
ํ๋ฆฟ
โโโ {topic-slug}/ โ ์ฃผ์ ๋ณ ํด๋ (kebab-case)
โ โโโ _INDEX.md โ ์ฃผ์ ๊ฐ์ + ๋ถ์ ์ด๋ ฅ ์ธ๋ฑ์ค (๋์ )
โ โโโ sources/ โ ์๋ณธ HWPX ํ์ผ ๋ณด๊ด
โ โโโ analyses/ โ ๊ฐ๋ณ ๋ถ์ ์นด๋ (YYYY-MM-DD-{title}.md)
โ โโโ synthesis/ โ ์ข
ํฉ ๋ถ์ ๋ฌธ์ (๋์ ํต์ฐฐ, ๋น๊ต, ๊ฒฐ๋ก )
์ํฌํ๋ก์ฐ
1. ์ ์ฃผ์ ์์ฑ
# ์ฃผ์ ํด๋ ์์ฑ
mkdir -p 08-research-vault/{topic-slug}/{sources,analyses,synthesis}
# _TOPIC_TEMPLATE.md โ {topic-slug}/_INDEX.md ๋ณต์ฌ ํ ํธ์ง
2. HWPX ํ์ผ ๋ถ์
- HWPX ํ์ผ์
{topic-slug}/sources/์ ๋ณด๊ด _ANALYSIS_TEMPLATE.md๋ณต์ฌ โ{topic-slug}/analyses/YYYY-MM-DD-{title}.md- ๋ถ์ ์นด๋ ์์ฑ (์์ฝ, ํต์ฌ ๋ด์ฉ, ์ธ์ฌ์ดํธ, ํค์๋)
{topic-slug}/_INDEX.md์ธ๋ฑ์ค ํ ์ด๋ธ์ 1ํ ์ถ๊ฐ
3. ์ข ํฉ ๋ฌธ์ ๊ฐฑ์
๋ถ์์ด 3๊ฑด ์ด์ ๋์ ๋๋ฉด synthesis/ ์ ์ข
ํฉ ๋ฌธ์ ์์ฑ:
- ์ข ํฉ ์์ฝ: ์ ์ฒด ๋ถ์์ ๊ดํตํ๋ ํต์ฌ ๊ฒฐ๋ก
- ์ฃผ์ ๊ฐ ๊ต์ฐจ ๋ถ์: ๋ถ์ ์นด๋ ๊ฐ ๊ณตํต์ /์ฐจ์ด์
- ์๊ณ์ด ๋ณํ: ์๊ฐ์ ๋ฐ๋ฅธ ๋ณํ ์ถ์
- ๋ฏธํด๊ฒฐ ์ง๋ฌธ: ์ถ๊ฐ ์ฐ๊ตฌ๊ฐ ํ์ํ ์์ญ
์ข ํฉ ๋ฌธ์๋ ๋ถ์์ด ์ถ๊ฐ๋ ๋๋ง๋ค ๊ฐฑ์ ํ๋ค.
๋ถ์ ์ํ
| ์ํ | ์๋ฏธ |
|---|---|
PENDING | HWPX ํ์ผ ์ ์, ๋ถ์ ์ |
ANALYZED | ๋ถ์ ์นด๋ ์์ฑ ์๋ฃ |
SYNTHESIZED | ์ข ํฉ ๋ฌธ์์ ๋ฐ์ ์๋ฃ |
ํ์ผ๋ช ๊ท์น
์ฃผ์ ํด๋: {topic-slug}/ ์: information-security/
์๋ณธ ํ์ผ: sources/{์๋ณธํ์ผ๋ช
}.hwpx ์: sources/2026๋
-๋ณด์-๊ฐ์ฌ-๋ณด๊ณ ์.hwpx
๋ถ์ ์นด๋: analyses/YYYY-MM-DD-{title}.md ์: analyses/2026-03-25-๋ณด์๊ฐ์ฌ๋ณด๊ณ ์.md
์ข
ํฉ ๋ฌธ์: synthesis/YYYY-MM-DD-{title}.md ์: synthesis/2026-03-25-๋ณด์์ ์ฑ
-์ข
ํฉ.md
ํ ํฝ ์ธ๋ฑ์ค
์ฃผ์ ๋ณ๋ก ์ ๋ฆฌ. ์ ์ฃผ์ ์ถ๊ฐ ์ ํด๋น ํ ์ด๋ธ์ 1ํ ์ถ๊ฐ.
| ์ฃผ์ | ์ฌ๋ฌ๊ทธ | ๋ถ์ ์ | ์ต๊ทผ ๋ถ์ | ์ข ํฉ ๋ฌธ์ | ์ํ |
|---|---|---|---|---|---|
| โ | โ | โ | โ | โ | โ |
๊ด๋ จ ๋๊ตฌ/์คํฌ
| ๋๊ตฌ | ์ฐ๊ณ ๋ฐฉ์ |
|---|---|
hwpx_generator.py | HWPX ํ์ผ ์์ฑ ์ ํธ (02-reusable-code-python/utils/) |
hwpx.ts | HWPX ๋ด๋ณด๋ด๊ธฐ ์ ํธ (02-reusable-code/03-utils/export/) |
/kdywave | ๋ฆฌ์์น ์ค์ผ์คํธ๋ ์ด์ โ vault์ ๋ถ์ ์ ์ฅ |
/kdyspike | ๊ธฐ์ ์ฌ์ ์ฐ๊ตฌ โ vault์ ์คํ์ดํฌ ๊ฒฐ๊ณผ ์ ์ฅ |
/kdynotebook | NotebookLM ๋ฆฌ์์น โ vault์ ๊ฒฐ๊ณผ ์ฐ๋ |
/kdyintel | ๋ด์ค ์ธํ ๋ฆฌ์ ์ค โ vault ์ฃผ์ ์ ๊ต์ฐจ ์ฐธ์กฐ |
/kdyidea | ์์ด๋์ด ๊ธฐํ ์ vault ์ฐ๊ตฌ์๋ฃ ์ฐธ์กฐ |
/kdynext | ๊ฑด๊ฐ ์ง๋จ ์ vault ์ ๊ฒ |
ํ์ฉ ํ
- ์ฃผ์ ๋ ๋๊ฒ, ๋ถ์์ ์ข๊ฒ: ์ฃผ์ ๋ "์ ๋ณด๋ณด์" ๊ฐ์ ํฐ ์นดํ ๊ณ ๋ฆฌ, ๋ถ์ ์นด๋๋ ๊ฐ๋ณ ๋ฌธ์ ๋จ์
- ํค์๋ ํ๊ทธ ํ์ฉ: ๋ถ์ ์นด๋์
tagsํ๋๋ก ์ฃผ์ ๊ฐ ๊ต์ฐจ ๊ฒ์ ๊ฐ๋ฅ - ์ข ํฉ ๋ฌธ์ ๋ฒ์ ๊ด๋ฆฌ: ๊ฐฑ์ ์ ์ด์ ๋ฒ์ ์ ๋ฎ์ด์ฐ์ง ๋ง๊ณ ๋ ์ง๋ณ ์ ๊ท ํ์ผ ์์ฑ
- Git ์ถ์ : sources/ ๋ด HWPX ํ์ผ์ ๋ฐ์ด๋๋ฆฌ์ด๋ฏ๋ก .gitignore์ ์ถ๊ฐ ๊ณ ๋ ค