
HolidayKit | ๊ฒจ์ธ ์ฐ๋ง ์ํผ ํ๋กฌํํธ ์นด๋ 48์ฅ
HolidayKit: ํฌ๋ฆฌ์ค๋ง์ค์ ์ํด ์ํผ ์์ด๋์ด ์นด๋ 48์ฅ
ํ๋์ ๋ณด๊ธฐ
HolidayKit์ ํฌ๋ฆฌ์ค๋ง์ค, ์ํด, ๊ฒจ์ธ ์์ฆ ์ํผ ์์์ ๋ง๋ค ๋ ๋ฐ๋ก ๊บผ๋ด ์ธ ์ ์๋ ํ ์คํธ ์นด๋ 48์ฅ์ ๋๋ค. ์นด๋๋ง๋ค ์ฒซ 2์ด ํ , 6์ปท ํ์๋ผ์ธ, ์ฌ์ด๋ ๋ ธํธ, ์์ด AI ์์ ํ๋กฌํํธ(ํน์ ๋๊ตฌ์ ๋ฌถ์ด์ง ์์ ๋ฒ์ฉ ๋ฌธ์ฅ), ์์ดยทํ๊ตญ์ด ์บก์ ๋ ๊ฐ์ง, ํด์ํ๊ทธ 8๊ฐ, ์ดฌ์ ์ฒดํฌ๋ฆฌ์คํธ, ์์ ยท๊ณต๊ฐ ์๋ด๊ฐ ๋ค์ด ์์ต๋๋ค. ์ ๋ชฉ, ํ , ์บก์ ์ ํ๊ตญ์ด๋ก๋ ์ ๊ณตํฉ๋๋ค.
- 4๊ฐ ์นดํ ๊ณ ๋ฆฌ 48์ฅ: ์ฝ์งยทASMR 16์ฅ, ์ ๋ฌ์ฉ 16์ฅ(ํ๋ก๋ชจ์ 8์ฅ, ์ํด 8์ฅ), ์ค๋ฆฌ์ง๋ ์บ๋ฆญํฐ ๊ฐ์กฑ ์ด์ผ๊ธฐ 8์ฅ, ์ธ์ฌ ์นด๋ 8์ฅ
- ๊ธธ์ด: 10์ด 6์ฅ, 12์ด 12์ฅ, 15์ด 15์ฅ, 20์ด 10์ฅ, 25์ด 3์ฅ, 30์ด 2์ฅ
- ์ ๋ฌ ์นด๋์ ์๋ฆฌํ์์ ์ธ ๊ฐ: [PRODUCT], [PRICE], [OFFER]. ์ค์ ๊ฐ์ ๋ฃ์ผ๋ฉด ์นด๋๋ฅผ ๋ง๋ค์ด ์ฃผ๊ณ , ๋ค๋ฅธ ๊ธ์ก์ด ์์ด์ง ์์๋์ง ๊ฒ์ฌํด ์ค๋๋ค.
- ๋ก์ปฌ์์ ๋๋ Node.js ๋๊ตฌ 3๊ฐ (Node 18 ์ด์): build-card, lint-cards, fact-lock. ๋คํธ์ํฌ๋ฅผ ์ฐ์ง ์์ต๋๋ค.
- ์๋ ํ
์คํธ 336๊ฐ๊ฐ ํจ๊ป ๋ค์ด ์๊ณ , ํจํค์ง ๋ฃจํธ์์
node --testํ ๋ฒ์ผ๋ก ์คํ๋ฉ๋๋ค. - ์ฑ์ธ ์ ์์์ฉ์ด๋ฉฐ ๊ฐ์กฑ ์นํ์ ์ธ ์ผ๋ฐ ์์ฒญ์์ฉ ์ฝํ ์ธ ๋ฅผ ์ ์ ๋ก ํฉ๋๋ค. ํน์ ๋ฏธ์ฑ๋ ์๋ฅผ ๊ฒจ๋ฅํ๊ฑฐ๋ ๋ฑ์ฅ์ํค์ง ์์ต๋๋ค.
- ๋ค์ด๋ก๋ ๋ฐฉ์ ํจํค์ง์ ๋๋ค. ๋งํฌ๋ค์ด ์นด๋, Node ์คํฌ๋ฆฝํธ, ์ฐธ๊ณ ๋ฌธ์, ํ ์คํธ๋ก ์ด๋ฃจ์ด์ ธ ์๊ณ ์์, ์ด๋ฏธ์ง, ์ค๋์ค ํ์ผ์ ์์ต๋๋ค. ์ด๋๋ก๋ ๋ฐ์ดํฐ๋ฅผ ๋ณด๋ด์ง ์์ต๋๋ค.
- ์ผํ์ฑ ๊ฐ๊ฒฉ: US$9.99
์ด ํคํธ๋ ์์ ์์ฑ๊ธฐ๊ฐ ์๋๋ฉฐ, ์์ ์์ฌ๋ ๋ค์ด ์์ง ์๊ณ , ์กฐํ์๋ ํ๋ก์, ํ๋งค ๊ฒฐ๊ณผ์ ๋ํด ์๋ฌด๊ฒ๋ ์ฝ์ํ์ง ์์ต๋๋ค. ๋น ํ๋ฉด ์์์ ๋งํ๋ ์๊ฐ์ ์ค์ฌ ์ฃผ๋ ์ ๋ฆฌ๋ ์ถ๋ฐ์ ์ด๊ณ , ๊ฐ๊ฒฉ๊ณผ ํํ ๋ฌธ๊ตฌ๋ฅผ ์ ํํ๊ฒ ์งํค๊ณ ์ถ์ ์ ๋ฌ๋ฅผ ์ํ ์์ ์ฅ์น ๋ช ๊ฐ์ง๋ฅผ ๋ํ ๊ฒ์ ๋๋ค.
์ ๋ง๋ค์๋
์ฐ๋ง ์ฝํ ์ธ ๋ ๋ฌ๋ ฅ์ด ์งง์ต๋๋ค. 11์ ๋ง๋ถํฐ 1์ ์ด๊น์ง ๋ง์ ํฌ๋ฆฌ์์ดํฐ์ ์์ ๊ฐ๊ฒ๊ฐ ๋ฉฐ์น ์ ํ ๋ฒ์ฉ ๋ฐ๋ปํ๊ณ ๋จ์ํ๊ณ ์ ์งํ ์์์ ์ฌ๋ฆฌ๊ณ ์ถ์ด ํฉ๋๋ค. ์ด๋ ค์ด ๋ถ๋ถ์ ์นด๋ฉ๋ผ๋ณด๋ค ๊ธฐํ์ธ ๊ฒฝ์ฐ๊ฐ ๋ง์ต๋๋ค. ์ฒซ ์ฅ๋ฉด์ ๋ฌด์์ผ๋ก ํ ์ง, ๊ฐ ์ปท์ ๋ช ์ด๋ก ํ ์ง, ์ด๋ค ์๋ฆฌ๋ฅผ ๊น์ง, ์๋์ ๋ฌด์จ ๊ธ์ ์ธ์ง, ๊ทธ๋ฆฌ๊ณ ์ฆ๋ช ํ ์ ์๋ ๋ง์ ํ์ง ์์ผ๋ ค๋ฉด ์ด๋ป๊ฒ ํ ์ง๋ฅผ ๋งค๋ฒ ์๋ก ์ ํด์ผ ํ๊ธฐ ๋๋ฌธ์ ๋๋ค.
HolidayKit์ ์ด ์ง๋ฌธ๋ค์ ๋ฏธ๋ฆฌ ๋ตํด ๋ ์นด๋ ๋ชจ์์ ๋๋ค. ๋ชจ๋ ์นด๋์๋ ๊ธธ์ด๊ฐ ์นด๋ ์ ์ฒด ์๊ฐ๊ณผ ๋ง์๋จ์ด์ง๋ 6๊ฐ ์ปท, 2์ด ์์ ๋งํ๊ฑฐ๋ ๋ณด์ฌ ์ค ์ ์๋ ์งง์ ํ , ๋ ์ธ์ด ์บก์ , ์ค์ ์ดฌ์ ์ฒดํฌ๋ฆฌ์คํธ๊ฐ ์์ต๋๋ค. ์ ๋ฌ ์นด๋์๋ ์ผ๋ฐ ์์ด๋์ด ๋ชฉ๋ก์์ ๋ณด๊ธฐ ์ด๋ ค์ด ์ฅ์น๊ฐ ํ๋ ๋ ์์ต๋๋ค. ํ๊ตญ์ด ๋ฌธ์ฅ์ ํฌํจํ ๋ชจ๋ ์ค์์ ์ค์ ๊ฐ๊ฒฉ๊ณผ ์ค์ ํํ์ ์ ํํ ์ ์งํ๋๋ก ๋๋ ๋๊ตฌ์ ๋๋ค.
๋๊ตฌ๋ฅผ ์ํ ํคํธ์ธ๊ฐ
์ํผ ํฌ๋ฆฌ์์ดํฐ
์ธ๋กํ ์งง์ ์์์ ๊พธ์คํ ์ฌ๋ฆฌ๋ฉด์ ๊ฒจ์ธ ์๋ฆฌ์ฆ๋ฅผ ๋ง๋ค๊ณ ์ถ์ ๋ถ์ ์ํ ํคํธ์ ๋๋ค. ์ฝ์ง ์นด๋ 16์ฅ์ ๊น, ๋, ์ข ์ด, ๋ฆฌ๋ณธ, ๋์๊ธฐ, ๋ํธ์ฒ๋ผ ์ดฌ์ํ๊ธฐ ์ฝ๊ณ ์์ ๋๊ตฌ์ ์ค๋ช ํ๊ธฐ๋ ์ฌ์ด ์ง๊ฐ์ ์ค์ฌ์ผ๋ก ๋ง๋ค์์ต๋๋ค. 10์ด์์ 15์ด ์นด๋๊ฐ ๋ง์์ ์งง์ ํ์์ ์ ๋ง์ต๋๋ค. ์นด๋๋ฅผ ์ค์ ์ดฌ์์ฉ ์ท ๋ฆฌ์คํธ๋ก ์จ๋ ๋๊ณ , ํ๋กฌํํธ๋ฅผ ์ด๋ฏธ ์ฐ๊ณ ์๋ ์์ ๋๊ตฌ์ ๋ฃ์ด ์นด๋์ ํ์๋ผ์ธ๋๋ก ์ด์ด ๋ถ์ฌ๋ ๋ฉ๋๋ค.
์์๊ณต์ธ ์ ๋ฌ
์์ด, ๊ฐ์, ๋ฌธ๊ตฌ, ์๊ณต์ํ, ๋์งํธ ์ํ์ ํ๋ฉด์ ์ค์ ๊ฐ๊ฒฉ๊ณผ ์ค์ ํํ์ด ๋ค์ด๊ฐ ํ๋ณด ์์์ ๋ง๋ค๊ณ ์ถ์ ๋ถ์ ์ํ ์นด๋์ ๋๋ค. ์ ๋ฌ ์นด๋ 16์ฅ(hk-017๋ถํฐ hk-032๊น์ง)์ [PRODUCT], [PRICE], [OFFER]๋ฅผ ์ค์ฌ์ผ๋ก ์ฐ์ฌ ์์ต๋๋ค. ๊ฐ์ด ํ๋๋ผ๋ ๋น์ด ์์ผ๋ฉด ๋๊ตฌ๊ฐ ์นด๋๋ฅผ ๋ง๋ค์ง ์๊ณ , fact-lock์ ์ถ๋ ฅ์ ๋ค์ด๊ฐ ๋ค๋ฅธ ๊ธ์ก์ด๋ ํผ์ผํธ๋ฅผ ์ฐพ์์ ์๋ ค ์ค๋๋ค. ํํ์ด ์ฌ์ค์ด๋ผ๋ ์ ๊น์ง ์ฆ๋ช ํด ์ฃผ์ง๋ ์์ง๋ง, ์์ ๊ฐ๊ฒฉ์ด ์บก์ ์ ๋จ์ ์๋ ๊ฒ ๊ฐ์ ์ค์๋ ๋ง์ ์ค๋๋ค.
๊ต์ฌ์ ๋ถ๋ชจ ์ ์์
๊ต์ค ์์ ํ์ด์ง, ๊ฐ์กฑ ์ฑ๋, ์ง์ญ ์์์ง์ ์ฌ๋ฆด ์ฐจ๋ถํ๊ณ ๊ฐ์กฑ ์นํ์ ์ธ ์์์ ๋ง๋๋ ์ฑ์ธ ์ ์์๋ฅผ ์ํ ์นด๋์ ๋๋ค. ๊ฐ์กฑ ์ด์ผ๊ธฐ ์นด๋ 8์ฅ์ ์ค๋ฆฌ์ง๋ ๋๋ฌผ ์บ๋ฆญํฐ๋ฅผ ์ฐ๊ณ , ์ธ์ฌ ์นด๋ 8์ฅ์ ๊ฐ์ฌ์ ๋๋ด์ ๋ค๋ฃน๋๋ค. ์ด ์นด๋๋ค์ ์ฑ์ธ ์ ์์๋ฅผ ์ํ ๊ฒ์ด๋ฉฐ ํน์ ๋ฏธ์ฑ๋ ์๋ฅผ ๊ฒจ๋ฅํ์ง ์์ต๋๋ค. ์ด ์นด๋๋ก ๋ง๋ ์์์ ์๋ณ ๊ฐ๋ฅํ ๋ฏธ์ฑ๋ ์๋ฅผ ๋ฑ์ฅ์ํค์ง ๋ง์ธ์.
์๊ท๋ชจ ํ
๋์ธ ๋ช
์์ ๋ค์ฏ ๋ช
์ ๋์ ํ์ INDEX ํ๋ฅผ ๊ณต๋ ๊ธฐํํ๋ก ์ธ ์ ์์ต๋๋ค. ์นด๋๋ง๋ค ID(hk-001๋ถํฐ hk-048), ์นดํ
๊ณ ๋ฆฌ, ๊ธธ์ด, ์๋ฆฌํ์์ ์ด์ด ์์ด ์ผ์ ๋๋๊ธฐ ์ฝ์ต๋๋ค. ์๋ฅผ ๋ค๋ฉด "๋ฏผ์๋ hk-004, ์ค์ ๊ฐ๊ฒ ๊ฐ์ผ๋ก hk-021์ ๋ง๋ ๋ค" ๊ฐ์ ์์
๋๋ค. ํ์ด ์คํ๋ ๋์ํธ๋ก ์ผํ๋ค๋ฉด build-card์ --format csv ์ต์
์ผ๋ก ์นด๋๋ฅผ ํ ์ค์ ํ๋ ํ๋์ฉ ๋ด๊ธด ํ์ผ๋ก ๋ง๋ค ์ ์์ต๋๋ค.
๋ง์ผํฐ
๋ธ๋๋๋ ๊ณ ๊ฐ์ฌ์ ์์ฆ ์บ ํ์ธ์ ์ง๋ฉด์ ์ผ๊ด๋ ์ ํ์ง๊ฐ ๋นจ๋ฆฌ ๋ง์ด ํ์ํ ๋ถ๊ป ๋ง์ต๋๋ค. ์นด๋๋ ํน์ ๋๊ตฌ์ ๋ธ๋๋์์ ์ค๋ฆฝ์ ์ ๋๋ค. ๋ก๊ณ ๋, ๋ณดํธ๋ฐ๋ ์บ๋ฆญํฐ๋, ๋๊ตฌ ์ด๋ฆ๋ ์์ต๋๋ค. ๊ฐ ํ์ผ๋ง ๋ฐ๊ฟ์ ๊ฐ์ ์ ๋ฌ ์นด๋๋ฅผ ์ฌ๋ฌ ์ํ์ ๋๋ ค ์ธ ์ ์์ต๋๋ค. ๋ค๋ง ์ด ํคํธ๋ ์์ฅ ์กฐ์ฌ๊ฐ ์๋๋ฉฐ ์ฑ๊ณผ์ ๋ํด ์ด๋ค ์ฃผ์ฅ๋ ํ์ง ์์ต๋๋ค.
์ด๋ฐ ๋ถ์๊ฒ๋ ๋ง์ง ์์ต๋๋ค
์์ฑ๋ ์์, ์คํก ์์, ์์ ์ด ํ์ํ๋ค๋ฉด ์ด ํคํธ๊ฐ ์๋๋๋ค. ํน์ ์์ ์๋น์ค์ ์ฐ๋๋๋ ๋๊ตฌ๋ฅผ ์ฐพ๋๋ค๋ฉด ๊ทธ๊ฒ๋ ์๋๋๋ค. ์์ด๋์ด๊ฐ ์๋ ๊ฐ๋ง ํ์ํ๋ค๋ฉด ๋ฌด๋ฃ ๋ชฉ๋ก์ผ๋ก๋ ์ถฉ๋ถํ ์ ์์ต๋๋ค.
๊ตฌ์ฑ
ํจํค์ง๋ ์ด๋ค ํ ์คํธ ํธ์ง๊ธฐ๋ก๋ ์ด ์ ์๋ ํด๋์ ๋๋ค.
SKILL.md: ์์ด์ ํธ ํด๋ผ์ด์ธํธ๊ฐ ์ฝ๋ ์งง์ ์์ ์์content/INDEX.md: ์นด๋ 48์ฅ ๋ชฉ๋ก ํcontent/cards/hk-001.md๋ถํฐhk-048.md๊น์ง: ์นด๋ ํ ์ฅ๋น ๋งํฌ๋ค์ด ํ์ผ ํ๋scripts/build-card.mjs,scripts/lint-cards.mjs,scripts/fact-lock.mjs์ ์์scripts/lib/ํด๋references/: ์นด๋ ๊ตฌ์กฐ, ํ๋กฌํํธ ์์น, ์์ ยท๊ณต๊ฐ, ์ ๋ฌ ํ๋ก๋ชจ์ ๊ท์น ์๋ด 4๊ฐtests/: ์๋ ํ ์คํธ (ํจํค์ง ๋ฃจํธ์์node --test)
๋ค ๊ฐ์ง ์นดํ ๊ณ ๋ฆฌ
์ฝ์งยทASMR (hk-001~hk-016, 16์ฅ). ๋ ๋ด๋ฆฌ๋ ์ฐฝ๊ฐ, ์ฟ ํค ๊ตฝ๋ ์๋ฆฌ, ๋ฌดํ์ผ ์บ๋ค๊ณผ ๋ด์์ ์ ๋ , ํซ์ฝ์ฝ์ ๊น, ์ ๋ฌผ ํฌ์ฅํ๋ ์๊ธธ, ๋ฐค ํ๊ด์ ๋ํด, ์ค๋ ธ๋ณผ, ๋ฆฌ๋ณธ ๋ง๋ฆฌ๋ ์๋ฆฌ, ์ ๋ ์์ ๋ฐ๊ฑธ์, ๋ฌ๋ ฅ์ ์ํด๋ก ๋๊ธฐ๋ ์ฅ๋ฉด, ๋ฌด์์ฝ์ฌ ๊ฑด๋ฐฐ์ฒ๋ผ ์ง๊ฐ์ด ์ค์ฌ์ธ ์กฐ์ฉํ ๊ฒจ์ธ ์ฅ๋ฉด์ ๋๋ค. ๊ฐ์ ๋ฃ์ ํ์๊ฐ ์์ต๋๋ค.
์ ๋ฌ (hk-017~hk-032, 16์ฅ). ์ฐ๋ง ์ธ์ผ ๊ธฐ๊ฐ์ฉ ํ๋ก๋ชจ์ ์นด๋ 8์ฅ(์ธ์ผ ๊ณต๊ฐ, ์ ๋ฌผ ์ธํธ ํฌ์ฅ, ๊ธฐ๊ฐ ํ์ ํํ ์นด์ดํธ๋ค์ด, ๊ฐ๊ฒฉํ ๋๊ธฐ๊ธฐ, ์ ๋ฌผ ํฌ์ฅ ์๋น์ค ์๋ด, ์ฃผ๋ฌธ ๋ง๊ฐ ์๋ด ๋ฑ)๊ณผ ์ํด์ฉ ์นด๋ 8์ฅ(์ํด ์ธ์ผ ์์, ์ฌ์ ๊ณ ์๋ด, ์ ๋ ๋ฒ๋ค ์ธ๋ฐ์ฑ, ์ฌ ํ ํด ๊ฐ์ฌ ์ธ์ฌ, ์ง์ด๋ ์ ๋ฆฌ, ๊ฐ๊ฒฉ ๋ณด๋, ์ฌํด ์ฒซ ์ฃผ๋ฌธ ํฌ์ฅ, ์ฃผ๋ฌธ ์ฌ๊ฐ ์๋ด)์ผ๋ก ๋๋ฉ๋๋ค. 16์ฅ ๋ชจ๋ PRODUCT, PRICE, OFFER๊ฐ ํ์ํฉ๋๋ค.
๊ฐ์กฑ ์ด์ผ๊ธฐ (hk-033~hk-040, 8์ฅ). ์ฌ๋นผ๋ฏธ ํฐํ, ๋ฌํฝ์ด ๋ชจ์ค, ๊ณ ์ด๋์น ํ ๊ฐ์ ์ค๋ฆฌ์ง๋ ๋๋ฌผ ์บ๋ฆญํฐ๊ฐ ๋์ค๋ ์งง์ ๋ํํ ์ฅ๋ฉด์ ๋๋ค. ์ ๋ค๊ธฐ ์ ์ฒ๋ผ ๋๋ฆฐ ์๋์ ๊ฒจ์ธ ์ด์ผ๊ธฐ์ด๋ฉฐ, ์ฐจ๋ถํ ์ผ๋ฐ ์์ฒญ์์ฉ ์์์ ๋ง๋ค๊ณ ์ถ์ ์ฑ์ธ ์ ์์๋ฅผ ์ํ ์นด๋์ ๋๋ค. ๊ฐ์ ๋ฃ์ ํ์๊ฐ ์์ต๋๋ค.
์ธ์ฌ (hk-041~hk-048, 8์ฅ). ํ๊ด ์ ์ํด ์ธ์ฌ, ์ด์์๊ฒ ์ ํ๋ ์ฐ๋ง ๊ฐ์ฌ, ํ ํ ์ด๋ธ์ ๊ฐ์ฌ, ์ํด ์ฒซ ํด๋์ด์ ์์, ์ข ์ด๋ณ ๊ฐ์ฌ ์ฌ์ฌ, ์์ ํญ์๋ฆฌ, ๊ธด ์ํ ์์ ๊ฐ์ฌ, ์ฐ๋ง ์ฌ์ง ๋ฒฝ ํ์ด๋ณด๊ธฐ๋ฅผ ๋ค๋ฃน๋๋ค. ๊ฐ์ ๋ฃ์ ํ์๊ฐ ์์ต๋๋ค.
์นด๋ 48์ฅ ์ ์ฒด ๋ชฉ๋ก
| ID | ์ ๋ชฉ | ์๋ฌธ ์ ๋ชฉ | ๊ธธ์ด | ์ ํ |
|---|---|---|---|---|
| hk-001 | ๋ ๋ด๋ฆฌ๋ ์ฐฝ๊ฐ์ ์์นจ | Snowfall Window Morning | 15์ด | ์ฝ์งยทASMR |
| hk-002 | ์ฟ ํค ๊ตฝ๋ ์๋ฆฌ | Cookie Baking Sounds | 20์ด | ์ฝ์งยทASMR |
| hk-003 | ๋ฌดํ์ผ ์บ๋ค๊ณผ ๋ด์์ ์ ๋ | Flameless Candle and Blanket Evening | 15์ด | ์ฝ์งยทASMR |
| hk-004 | ํซ์ฝ์ฝ์ ๊น ํด๋ก์ฆ์ | Hot Cocoa Steam Close-up | 12์ด | ์ฝ์งยทASMR |
| hk-005 | ์ ๋ฌผ ํฌ์ฅํ๋ ์๊ธธ | Gift Wrapping Hands | 20์ด | ์ฝ์งยทASMR |
| hk-006 | ๋ฒฝ๋๋ก ์ ๋ฐ ์ ์๊ฐ์ง ๊ฐ๋๋ | Pine Garland on a Mantel | 15์ด | ์ฝ์งยทASMR |
| hk-007 | ๋ฐค ํ๊ด์ ๋ํด ๋ถ๋น | Porch Lanterns at Night | 12์ด | ์ฝ์งยทASMR |
| hk-008 | ์ ๋ฐ ์ ์ค๋ ธ๋ณผ | Snow Globe on the Shelf | 10์ด | ์ฝ์งยทASMR |
| hk-009 | ์ฑ ์ ์ ์๊ธ์จ ์นด๋ | Handwritten Cards at the Desk | 20์ด | ์ฝ์งยทASMR |
| hk-010 | ์ฅ์ ์์ ์ฌ๋ ์๋ฆฌ | Ornament Box Unboxing Sounds | 15์ด | ์ฝ์งยทASMR |
| hk-011 | ๋ ์ค๋ ๋ ์ ๋นต์ง ์ฐฝ | Bakery Window in the Snow | 15์ด | ์ฝ์งยทASMR |
| hk-012 | ์๋ฆฌ ๋ ์ฐฝ๊ฐ์ ์ฐจ ํ ์ | Tea Pour by a Frosted Window | 12์ด | ์ฝ์งยทASMR |
| hk-013 | ๋ฆฌ๋ณธ ๋ง๋ฆฌ๋ ์๋ฆฌ | Ribbon Curl ASMR | 10์ด | ์ฝ์งยทASMR |
| hk-014 | ์ ๋ ์์ ๋ฐ๊ฑธ์ | Fresh Snow Footsteps | 12์ด | ์ฝ์งยทASMR |
| hk-015 | ํ์ ๋ฌ๋ ฅ ์ํด๋ก ๋๊ธฐ๊ธฐ | Desk Calendar Flip to New Year | 15์ด | ์ฝ์งยทASMR |
| hk-016 | ๋ฌด์์ฝ์ฌ ์คํํด๋ง ๊ฑด๋ฐฐ | Sparkling Juice Toast for Two Glasses | 12์ด | ์ฝ์งยทASMR |
| hk-017 | ์ฐ๋ง ์ธ์ผ ๊ณต๊ฐ | Holiday Sale Reveal | 15์ด | ์ ๋ฌ ํ๋ก๋ชจ์ |
| hk-018 | ์ ๋ฌผ ์ธํธ ํฌ์ฅ ๊ณผ์ | Gift Bundle Pack-Up | 20์ด | ์ ๋ฌ ํ๋ก๋ชจ์ |
| hk-019 | ๊ธฐ๊ฐ ํ์ ํํ ์นด์ดํธ๋ค์ด | Limited Offer Countdown Card | 12์ด | ์ ๋ฌ ํ๋ก๋ชจ์ |
| hk-020 | ์นด์ดํฐ ๋ค ์ฃผ๋ฌธ ์ค๋น | Behind the Counter Order Prep | 20์ด | ์ ๋ฌ ํ๋ก๋ชจ์ |
| hk-021 | ๊ฐ๊ฒฉํ ๋๊ธฐ๊ธฐ | Price Tag Flip | 10์ด | ์ ๋ฌ ํ๋ก๋ชจ์ |
| hk-022 | ์ ๋ฌผ ํฌ์ฅ ์๋น์ค ์๋ด | Gift Wrap Service Announcement | 15์ด | ์ ๋ฌ ํ๋ก๋ชจ์ |
| hk-023 | ์ฃผ๋ฌธ ๋ง๊ฐ ์๋ด | Order Deadline Reminder | 12์ด | ์ ๋ฌ ํ๋ก๋ชจ์ |
| hk-024 | ํ๋ฐฐ ์ ๊ฐ์ฌ ์นด๋ | Thank-You Note in the Parcel | 15์ด | ์ ๋ฌ ํ๋ก๋ชจ์ |
| hk-025 | ์ํด ์ธ์ผ ์์ ์๋ฆผ | New Year Sale Kickoff | 15์ด | ์ ๋ฌ ์ํด |
| hk-026 | ์ฌ์ ๊ณ ์๋ด | Back in Stock Announcement | 12์ด | ์ ๋ฌ ์ํด |
| hk-027 | ์ ๋ ๋ฒ๋ค ์ธ๋ฐ์ฑ | New Year Bundle Unbox | 20์ด | ์ ๋ฌ ์ํด |
| hk-028 | ์ฌ ํ ํด ๊ฐ์ฌ ์ธ์ฌ | Thank You for This Year | 15์ด | ์ ๋ฌ ์ํด |
| hk-029 | ์ ์ถ๋ฐ ์ง์ด๋ ์ ๋ฆฌ | Fresh Start Shelf Restock | 25์ด | ์ ๋ฌ ์ํด |
| hk-030 | ์ํด ๊ฐ๊ฒฉ ๋ณด๋ | New Year Price Board | 10์ด | ์ ๋ฌ ์ํด |
| hk-031 | ์ฌํด ์ฒซ ์ฃผ๋ฌธ ํฌ์ฅ | First Orders of the Year Packing | 30์ด | ์ ๋ฌ ์ํด |
| hk-032 | ์ํด ์ฃผ๋ฌธ ์ฌ๊ฐ ์๋ด | Open for Orders Again | 12์ด | ์ ๋ฌ ์ํด |
| hk-033 | ๊ฐ๋ก๋ฑ ๋ถ๋น์ ์งํค๋ ์ฌ๋นผ๋ฏธ ํฐํ | Tuft Lights the Last Lamp | 12์ด | ๊ฐ์กฑ ์ด์ผ๊ธฐ |
| hk-034 | ๋๊ธธ ํธ์ง๋ฅผ ๋๋ฅด๋ ๋ฌํฝ์ด ๋ชจ์ค | Moss the Snail and the Snow Letters | 15์ด | ๊ฐ์กฑ ์ด์ผ๊ธฐ |
| hk-035 | ์๋ฆฌ ๊ณ ์ฌ๋ฆฌ ๋ฑ๋ถ ์ด์ผ๊ธฐ | The Frost Fern Lanterns | 20์ด | ๊ฐ์กฑ ์ด์ผ๊ธฐ |
| hk-036 | ํธ์ฅ๊ฐ ๋ค๋ฆฌ | The Mitten Bridge | 15์ด | ๊ฐ์กฑ ์ด์ผ๊ธฐ |
| hk-037 | ํ๋ฐค์ ์๋๋ฌด ๋ถ๋น๊ณผ ๊ณ ์ด๋์น ํ | Pim and the Midnight Pine Lights | 25์ด | ๊ฐ์กฑ ์ด์ผ๊ธฐ |
| hk-038 | ๋์ก์ด๋ฅผ ์ธ๋ ์ฌ๋นผ๋ฏธ | Tuft Counts the Snowflakes | 10์ด | ๊ฐ์กฑ ์ด์ผ๊ธฐ |
| hk-039 | ์ฃผ์ ์ ์ค๋๋ง์ ์๋ | The Kettle Cottage Visit | 20์ด | ๊ฐ์กฑ ์ด์ผ๊ธฐ |
| hk-040 | ๋๋๋ฏธ ์์ ์์ ์ข | The Bell in the Snowdrift | 30์ด | ๊ฐ์กฑ ์ด์ผ๊ธฐ |
| hk-041 | ํ๊ด ์ ์ํด ์ธ์ฌ | Doorstep New Year Greeting | 12์ด | ์ธ์ฌ |
| hk-042 | ์ด์์๊ฒ ์ ํ๋ ์ฐ๋ง ๊ฐ์ฌ | Year-End Thanks to the Neighbors | 15์ด | ์ธ์ฌ |
| hk-043 | ํ ํ ์ด๋ธ์์ ์ ํ๋ ๊ฐ์ฌ | Thank You from the Team Table | 20์ด | ์ธ์ฌ |
| hk-044 | ์ํด ์ฒซ ํด๋์ด์ ์์ | First Sunrise Wish | 12์ด | ์ธ์ฌ |
| hk-045 | ์ข ์ด๋ณ ๊ฐ์ฌ ์ฌ์ฌ | Paper Star Thank-You Chain | 15์ด | ์ธ์ฌ |
| hk-046 | ์ํด ์์ ํญ์๋ฆฌ | The New Year Wish Jar | 20์ด | ์ธ์ฌ |
| hk-047 | ๊ธด ์ํ ์์ ๊ฐ์ฌ | Gratitude at the Long Table | 25์ด | ์ธ์ฌ |
| hk-048 | ์ฐ๋ง ์ฌ์ง ๋ฒฝ ํ์ด๋ณด๊ธฐ | Year-End Photo Wall Glide | 10์ด | ์ธ์ฌ |
๊ธธ์ด๋ณ ์ฅ์๋ 10์ด 6์ฅ, 12์ด 12์ฅ, 15์ด 15์ฅ, 20์ด 10์ฅ, 25์ด 3์ฅ, 30์ด 2์ฅ์ ๋๋ค.
์นด๋ ๊ตฌ์กฐ
๋ชจ๋ ์นด๋๋ ๊ฐ์ ์์์ ๊ฐ์ ํญ๋ชฉ์ผ๋ก ์ด๋ฃจ์ด์ง ๋งํฌ๋ค์ด ํ์ผ ํ ๊ฐ์ ๋๋ค. ํ ๋ฒ ์ตํ๋ฉด ์ด๋ ์นด๋๋ ๊ฐ์ ๋ฐฉ์์ผ๋ก ์ฝ์ ์ ์์ต๋๋ค.
- ๋จธ๋ฆฌ๋ง(front matter). ์นด๋ ID, ์นดํ ๊ณ ๋ฆฌ, ์ ์ฒด ๊ธธ์ด(์ด)
- ์ ๋ชฉ(์์ดยทํ๊ตญ์ด)
- ํ (์ฒซ 2์ด). ์์ด ํ ์ค(12๋จ์ด ์ดํ, ๋ฆฐํฐ๊ฐ ํ์ธ)๊ณผ ํ๊ตญ์ด ํ ์ค. ์์ํ์๋ง์ ๋งํ๊ฑฐ๋ ๋ณด์ฌ ์ค๋๋ค.
- ํ์๋ผ์ธ(6์ปท).
S2 | 2-5s | 3s | ์ค๋ชํ์์ ์ ํํ ์ฌ์ฏ ์ค. ๊ตฌ๊ฐ์ด ๋๊น ์์ด ์ด์ด์ง๊ณ ๊ธธ์ด์ ํฉ์ด ์นด๋ ๊ธธ์ด์ ๊ฐ์ต๋๋ค. ๋ฆฐํฐ๊ฐ ์ด ๊ณ์ฐ์ ํ์ธํฉ๋๋ค. - ์ฌ์ด๋ ๋ ธํธ. ๋ฌด์์ ๋ น์ํ๊ฑฐ๋ ์์์ง, ์ด๋์ ์กฐ์ฉํ ๋์ง. ์ฝ์ง ์นด๋ ์๋น์๋ ์๋ฆฌ๋ฅผ ์ค์ฌ์ ๋ก๋๋ค.
- ์์ด AI ์์ ํ๋กฌํํธ. 60๋จ์ด ์ด์์ด๋ฉฐ ํน์ ๋๊ตฌ์ ๋ฌถ์ด์ง ์์ต๋๋ค. ์นด๋ฉ๋ผ์ ๋ณด์ด๋ ๊ฒ, ๊ณง ์ฃผ์ , ๋ฐฐ๊ฒฝ, ๋น, ์นด๋ฉ๋ผ ์์ง์, ์ง๊ฐ, ๋ถ์๊ธฐ, ๊ทธ๋ฆฌ๊ณ ๊ธ์ ์์ยท๋ก๊ณ ์์ ๊ฐ์ ์ ์ธ ์กฐ๊ฑด์ ์ ์ต๋๋ค.
- ์บก์ . A, B ๋ ๊ฐ์ง์ด๋ฉฐ ๊ฐ๊ฐ ์์ด์ ํ๊ตญ์ด
- ํด์ํ๊ทธ. ์ ํํ 8๊ฐ
- ์ดฌ์ ์ฒดํฌ๋ฆฌ์คํธ. ์ค์ ์ดฌ์์ด๋ ํธ์ง์์ ์ธ ์ค์ฉ ํญ๋ชฉ ์ธ ๊ฐ ์ด์
- ์์ ยท๊ณต๊ฐ ์๋ด. ์นด๋๋ณ ์์ ๋ฌธ์ฅ, ํ๋ซํผ๋ณ AI ์์ฑ๋ฌผ ํ์ ์ ์ฑ ์ ํ์ธํ๋ผ๋ ์๋ด, ์ฑ์ธ ์ ์์์ฉ ๋ฌธ๊ตฌ
ํ๋กฌํํธ๋ references/ai-video-prompt-principles.md์ ์ ์ด ๋ ์์น์ ๋ฐ๋ฆ
๋๋ค. ์ฃผ์ ๋ฅผ ๋จผ์ ์ฐ๊ณ , ์์ฒญ์๊ฐ ๋ณด๋ ์์๋ก ์ฅ๋ฉด์ ๋ฌ์ฌํ๊ณ , ๋น๊ณผ ์์ ์ฐ๊ณ , ์ปท๋ง๋ค ์นด๋ฉ๋ผ ์์ง์์ ํ๋๋ง ์ฐ๊ณ , ์์ง์์ ์๊ณ ์์ฐ์ค๋ฝ๊ฒ ๋๊ณ , ์ง๊ฐ ๋จ์ด๋ฅผ ๋ฃ๊ณ , ์ ์ธ ์กฐ๊ฑด์ผ๋ก ๋๋ด๊ณ , ํน์ ๋๊ตฌ์ ๊ธฐ๋ฅ์ ๊ฐ์ ํ์ง ์๊ณ , ๋๊ตฌ๊ฐ ์งง์ ํด๋ฆฝ์ ๋ ์ ๋ฐ์ํ๋ฉด ์ปท์ ๋๋ ์์ฑํ๊ณ , ๋ฐ๋ณตํ ๋๋ ํ ๋ฒ์ ํ ๊ฐ์ง๋ง ๋ฐ๊พธ๊ณ , ๊ฒฐ๊ณผ๋ ๋ฐ๋์ ์ง์ ๊ฒํ ํ๋ค๋ ์์น์
๋๋ค.
์ํ ์นด๋
์๋ ์ํ์ ํจํค์ง์ ์ค์ ์นด๋ ํ์ผ์์ ํ๊ตญ์ด๋ก ์ ๊ณต๋๋ ๋ถ๋ถ(์ ๋ชฉ, ํ , ์บก์ A์ B)๋ง ๊ทธ๋๋ก ์ฎ๊ธด ๊ฒ์ ๋๋ค. ํ์๋ผ์ธ, ์ฌ์ด๋ ๋ ธํธ, ์์ด ํ๋กฌํํธ, ์ฒดํฌ๋ฆฌ์คํธ ์ ๋ฌธ์ ์์ด ์ค๋ช ์ ์ํ 6์ฅ์ ์์ต๋๋ค.
hk-001 ๋ ๋ด๋ฆฌ๋ ์ฐฝ๊ฐ์ ์์นจ (15์ด, ์ฝ์งยทASMR)
- ์ฒซ 2์ด ํ : ์ ๋ฆฌ์ฐฝ ๋ฐ์ผ๋ก ๋์ด ํ๋ฌ๊ฐ๊ณ , ๋ฐฉ ์์ ๋ฐ๋ปํฉ๋๋ค.
- ์บก์ A: ์ด๋ค ์์นจ์ ๋๊ณผ ์ฐฝ๋ฌธ, ๋ฐ๋ปํ ํ ์์ด๋ฉด ์ถฉ๋ถํด์.
- ์บก์ B: ๋ณผ๋ฅจ์ ์ด์ง ์ฌ๋ฆฌ๊ณ ๊ณ ์ํจ์ ๋ค์ฌ๋ณด๋ด ๋ณด์ธ์.
hk-004 ํซ์ฝ์ฝ์ ๊น ํด๋ก์ฆ์ (12์ด, ์ฝ์งยทASMR)
- ์ฒซ 2์ด ํ : ์ฒซ ํ ์์ ๋ฐ๋ฅด๋ ์๊ฐ, ํผ์ด์ค๋ฅด๋ ๊น์ ๋ณด์ธ์.
- ์บก์ A: ๋ถ๊ณ , ์ ๊ณ , ์จ์ ๊ณ ๋ฅด์ธ์. ๋ง์์ด ํ๋ฆด ๋๊น์ง์.
- ์บก์ B: ํ๋ฃจ์ ์๋๋ฅผ ๋ฆ์ถฐ ์ค 12์ด์ ๊น.
hk-014 ์ ๋ ์์ ๋ฐ๊ฑธ์ (12์ด, ์ฝ์งยทASMR)
- ์ฒซ 2์ด ํ : ๋ฝ๋๋ฝ๋, ์ ๋ ์์ ์ฒซ ๋ฐ๊ฑธ์.
- ์บก์ A: ์ฒ์ ๋ฐ์ ๋๋ง ๋ค๋ฆฌ๋ ์๋ฆฌ๊ฐ ์์ด์.
- ์บก์ B: ์ ๋, ๋ง์ ๊ณต๊ธฐ, ๊ณ ์ํ ๋จธ๋ฆฌ.
hk-017 ์ฐ๋ง ์ธ์ผ ๊ณต๊ฐ (15์ด, ์ ๋ฌ ํ๋ก๋ชจ์ )
- ์ฒซ 2์ด ํ : [PRODUCT]๋ฅผ ์๊ฐํฉ๋๋ค. [PRICE]์ [OFFER].
- ์บก์ A: [PRODUCT] ๋ง๋ ๋ณด์ธ์. [PRICE]์ [OFFER].
- ์บก์ B: ์ฌํด ์ฐ๋ง ์ถ์ฒ์ [PRODUCT], [PRICE]์ ๋๋ค. [OFFER].
hk-025 ์ํด ์ธ์ผ ์์ ์๋ฆผ (15์ด, ์ ๋ฌ ์ํด)
- ์ฒซ 2์ด ํ : ์ํด ์ฒซ ์์, [PRODUCT]๋ฅผ [PRICE]์ ๋ง๋์.
- ์บก์ A: ์ํด์ ์๋กญ๊ฒ ๋ง๋๋ [PRODUCT]. [PRICE]์ [OFFER].
- ์บก์ B: ์ฌํด์ ์์์ [PRODUCT]์ ํจ๊ป, [PRICE]์ ๋๋ค. ์๋ด: [OFFER].
hk-033 ๊ฐ๋ก๋ฑ ๋ถ๋น์ ์งํค๋ ์ฌ๋นผ๋ฏธ ํฐํ (12์ด, ๊ฐ์กฑ ์ด์ผ๊ธฐ)
- ์ฒซ 2์ด ํ : ์์ ์ฌ๋นผ๋ฏธ๊ฐ ๋ง์ง๋ง ๊ฐ๋ก๋ฑ์ ๋ถ์ ๋ฐํ๋๋ค.
- ์บก์ A: ๋ถ๋น์ ์ง์ผ ์ฃผ๋ ๋๊ตฐ๊ฐ๊ฐ ๋ชจ๋ ๊ณจ๋ชฉ์๋ ํ์ํด์.
- ์บก์ B: ๋ง์ง๋ง ๊ฐ๋ก๋ฑ์ ์ฌ๋นผ๋ฏธ, ํฐํ๋ฅผ ์๊ฐํฉ๋๋ค.
์ ๋ฌ ์นด๋(hk-017, hk-025)์ ๋๊ดํธ ์๋ฆฌํ์์๋ ๋ฐ์ผ์๋ ๊ทธ๋๋ก์ ๋ชจ์ต์ ๋๋ค. ์ฌ์ฉํ ๋๋ ๋ณธ์ธ์ ๊ฐ์ผ๋ก ๋ฐ๊ฟ๋๋ค.
์ฌ์ฉ ๋ฐฉ๋ฒ (๋ค์ด๋ก๋ ํจํค์ง)
์ด ์ํ์ ๋ค์ด๋ก๋ ๋ฐฉ์์ ๋๋ค. ํจํค์ง ํ์ผ์ ๋ด๋ ค๋ฐ์ ์์ถ์ ํ๊ณ , ๋ณธ์ธ ์ปดํจํฐ์์ ๋ณธ์ธ์ด ์ฐ๋ ์์ด์ ํธ ํด๋ผ์ด์ธํธ์ ํจ๊ป ์ฌ์ฉํฉ๋๋ค. ์๊ฒฉ ์๋น์ค์์ ์คํ๋๋ ๊ฒ์ ์์ผ๋ฉฐ, ์ด ๋๊ตฌ๋ค์ ์นด๋๋ ์ํ ๊ฐ์ ์ด๋๋ก๋ ๋ณด๋ด์ง ์์ต๋๋ค.
- ๋ค์ด๋ก๋์ ์์ถ ํด์ . ๊ตฌ๋งค ํ ์ํ ํ์ด์ง์์ ํจํค์ง๋ฅผ ๋ด๋ ค๋ฐ์ ์์ถ์ ํ๋๋ค. ์์ถ ํ์ผ ์ต์์์
SKILL.md,content/,scripts/,references/,tests/,package.json์ด ์์ต๋๋ค. - ์์ด์ ํธ ํด๋ผ์ด์ธํธ๊ฐ ์คํฌ์ ์ฝ๋ ์์น์ ํด๋๋ฅผ ๋ก๋๋ค. ์์น๋ ์ฐ๋ ํด๋ผ์ด์ธํธ๋ง๋ค ๋ค๋ฅด๋ ํด๋น ํด๋ผ์ด์ธํธ์ ๋ฌธ์๋ฅผ ํ์ธํ์ธ์. ๊ทธ๋ฅ ์๋ฌด ํธ์ง๊ธฐ๋ก ๋งํฌ๋ค์ด ํ์ผ์ ์ด์ด ๋ณต์ฌํด ์จ๋ ๋ฉ๋๋ค.
- ์นด๋๋ฅผ ๊ณ ๋ฆ
๋๋ค.
content/INDEX.md๋ฅผ ์ฝ์ต๋๋ค. ์ฝ์ง, ๊ฐ์กฑ ์ด์ผ๊ธฐ, ์ธ์ฌ ์นด๋๋ ๊ฐ์ด ํ์ ์๊ณ ์ ๋ฌ ์นด๋๋ PRODUCT, PRICE, OFFER๊ฐ ํ์ํฉ๋๋ค. - ์
๋ฌ ์นด๋๋ผ๋ฉด ๊ฐ ํ์ผ์ ๋ง๋ญ๋๋ค. ์:
{"PRODUCT": "์ํ ์ด๋ฆ", "PRICE": "์ ํํ ๊ฐ๊ฒฉ", "OFFER": "์ ํํ ํํ"}. ์ค์ ๊ฐ๊ฒฉ๊ณผ ์ค์ ํํ์ ์ฐ์ธ์. ์๋ ํ ์ธ, ๋ ์ง, ์ฌ๊ณ ํ์ ์ ์ง์ด๋ด์ง ๋ง์ธ์. - ๋ง๋ญ๋๋ค.
node scripts/build-card.mjs hk-017 values.json --out my-card.md. ์คํ๋ ๋์ํธ์ฉ ํ์ผ์--format csv๋ฅผ ๋ถ์ ๋๋ค. ํ์ํ ๊ฐ์ด ์๊ฑฐ๋ ๋น์ด ์์ผ๋ฉด ๋ง๋ค์ง ์์ต๋๋ค. - ๋ฆฐํธํฉ๋๋ค.
node scripts/lint-cards.mjs my-card.md --built. ์ข ๋ฃ ์ฝ๋ 0์ด๋ฉด ์ค๋ฅ๊ฐ ์๋ ๊ฒ์ ๋๋ค. - fact-lock์ ๋๋ฆฝ๋๋ค(์
๋ฌ ์นด๋).
node scripts/fact-lock.mjs my-card.md values.json - ํ๋กฌํํธ๋ฅผ ๋ณต์ฌํฉ๋๋ค. "Generic AI video prompt" ํญ๋ชฉ์ ๊ธ์ ์ฐ๋ ์์ ๋๊ตฌ์ ๋ฃ๊ณ , ๊ทธ ๋๊ตฌ์ ํ๊ณ์ ๋ง๊ฒ ๊ณ ์นฉ๋๋ค.
- ์ฌ๋ฆฌ๊ธฐ ์ ์ ์ดฌ์ ์ฒดํฌ๋ฆฌ์คํธ์ ์์ ยท๊ณต๊ฐ ์๋ด๋ฅผ ํ์ธํฉ๋๋ค.
Node.js๋ฅผ ์ธ ์ ์์ด๋ ์นด๋๋ ์์ผ๋ก ์ธ ์ ์์ต๋๋ค. ์ด๋๋ ์ ๊ฒ์ ์ง์ ํ๊ณ ์์ ์์ "์๋ ์ ๊ฒ ๋ฏธ์คํ"์ด๋ผ๊ณ ์ ์ด ๋๋ผ๊ณ ํจํค์ง์ ์๋ด๋์ด ์์ต๋๋ค. ํ๊ตญ์ด ์ค์ ํฌํจํ ๋ชจ๋ ํญ๋ชฉ์ ์๋ฆฌํ์์๋ฅผ ์ง์ ๋ฐ๊พธ๊ณ , ๋๊ดํธ ์๋ฆฌํ์์๊ฐ ๋จ์ง ์์๋์ง ๋ณด๊ณ , ์ฌ์ฏ ์ปท ๊ธธ์ด์ ํฉ์ ๊ณ์ฐํ๊ณ , ํด์ํ๊ทธ 8๊ฐ๋ฅผ ์ธ๊ณ , ๊ฐ๊ฒฉ๊ณผ ํํ์ ์คํ ์ด ํ์ด์ง์ ๊ธ์ ํ๋ํ๋ ๋ง์ถฐ ๋ด ๋๋ค.
ํ์ํ ๊ฒ: ์คํฌ๋ฆฝํธ์ฉ Node.js 18 ์ด์. ์ค์นํ ํจํค์ง, ๊ณ์ , ๋คํธ์ํฌ ์ ์, API ํค๋ ํ์ ์์ต๋๋ค.
์ ๋ฌ์ฉ ์๋ฆฌํ์์, fact-lock, build-card
์ ๋ฌ ์นด๋๋ ๋จ์ํ ํ๋กฌํํธ ๋ชฉ๋ก๊ณผ ์กฐ๊ธ ๋ค๋ฅด๊ฒ ๋์ํฉ๋๋ค.
์ธ ๊ฐ์ง ๊ฐ. PRODUCT๋ ์คํ ์ด ํ์ด์ง์ ์ ํ ์ ํํ ์ํ๋ช , PRICE๋ ํตํ๊ฐ ๋ถ์ ์ ํํ ๊ฐ๊ฒฉ, OFFER๋ ์งง๊ณ ์ฌ์ค์ ์ธ ํํ ๋ฌธ๊ตฌ์ ๋๋ค. ๊ฐ ๊ฐ์ ํ ์ค์ด๋ฉฐ 120์ ์ดํ์ด๊ณ ๋๊ดํธ๊ฐ ๋ค์ด๊ฐ๋ฉด ์ ๋ฉ๋๋ค.
build-card. ์นด๋๋ฅผ ์ฝ์ด์ ๋ชจ๋ ํญ๋ชฉ(ํ
, ์ปท, ํ๋กฌํํธ, ๋ ์ธ์ด ์บก์
)์ ์๋ฆฌํ์์๋ฅผ ๋ฐ๊พธ๊ณ built: true๊ฐ ๋ถ์ ์นด๋๋ฅผ ์๋๋ค. ๊ฐ์ด ์๊ฑฐ๋ ๋น์ด ์์ผ๋ฉด ์ด๋ค ๊ฐ์ด ๋น ์ก๋์ง ์๋ ค ์ฃผ๊ณ ๋ฉ์ถฅ๋๋ค. --format csv๋ก CSV ์ถ๋ ฅ๋ ๊ฐ๋ฅํฉ๋๋ค.
lint-cards --built. ๋ง๋ค์ด์ง ์นด๋์์๋ ๋จ์ ์๋ฆฌํ์์๊ฐ ๊ฒฝ๊ณ ๊ฐ ์๋๋ผ ์ค๋ฅ๊ฐ ๋ฉ๋๋ค. ๋ฆฐํฐ๋ ํ์๋ผ์ธ ๊ณ์ฐ, ํ
๊ธธ์ด, ํ๋กฌํํธ ๊ธธ์ด, ํด์ํ๊ทธ ๊ฐ์, ํ๊ตญ์ด ํญ๋ชฉ๋ ํ์ธํ๊ณ , ๋ณดํธ๋ฐ๋ ์บ๋ฆญํฐ, ์ค์กด ์ธ๋ฌผ, ๊ฒฐ๊ณผ๋ฅผ ์ฝ์ํ๋ ํํ, ์ํํ ํ๋, ๋ฏธ์ฑ๋
์ ๊ด๋ จ ์ฉ์ด์ ๋ํ ์งง์ ํค์๋ ๋ชฉ๋ก๋ ํ์ธํฉ๋๋ค. ์์ ๋ง์ผ ๋ฟ ์ ์ฑ
์น์ธ์ด ์๋๋๋ค.
fact-lock. ์ ๋ ฅํ PRODUCT, PRICE, OFFER๊ฐ ์ถ๋ ฅ์ ๊ทธ๋๋ก ๋ค์ด ์๋์ง ํ์ธํ๊ณ , ๊ทธ ๋ฐ์ ๊ธ์ก์ด๋ ํผ์ผํธ๊ฐ ์์ผ๋ฉด ํ์ํฉ๋๋ค. ๋ง๋ ๋ค์ ๊ฐ๊ฒฉ์ ์์ผ๋ก ๋ฐ๊พธ๋ฉด ๋จ์ ๊ธ์ก์ ์๋ ค ์ฃผ๊ณ ์ค๋ฅ๋ก ๋๋ฉ๋๋ค. ํํ์ด ์ฌ์ค์ธ์ง๋ ํ์ธํ ์ ์๊ณ , ๊ทธ ์ฑ ์์ ์ฌ์ฉ์์๊ฒ ์์ต๋๋ค.
์ค์ ์คํ ๊ฒฐ๊ณผ. ์๋ ๊ทธ๋ฆผ์ ๊ฐ์์ ์ํ ์ํ("Pine Candle Set", "$18", "Free gift wrap")์ผ๋ก hk-017์ ๋ง๋ ๊ฒฐ๊ณผ์
๋๋ค. ๋ง๋ค๊ธฐ, --built ๋ฆฐํธ, fact-lock์ด ๋ชจ๋ ์ข
๋ฃ ์ฝ๋ 0์ผ๋ก ๋๋ฌ๊ณ , ์ ํ ๋ฌธ์ฅ์ ์ค์ ํ์ผ์์ ์ฝ์์ต๋๋ค. ํ๊ตญ์ด ํ
"Pine Candle Set๋ฅผ ์๊ฐํฉ๋๋ค."๋ฅผ ๋ณด๋ฉด ์ํ๋ช
์ ๋ง์ถ ์กฐ์ฌ ๊ต์ ์ด ๋์ด ์์ง ์์ต๋๋ค. ๊ทธ๋์ ๋ง๋ ๋ค์๋ ํ๊ตญ์ด ์ค์ ์ง์ ์ฝ์ด ๋ณด๋ผ๊ณ ์๋ดํฉ๋๋ค.
์นด๋ 48์ฅ ๋ฆฐํธ ๊ฒฐ๊ณผ. ๋๋ด๋ ์นด๋์ node scripts/lint-cards.mjs๋ฅผ ์คํํ๋ฉด ํ์ผ 48๊ฐ, ์ค๋ฅ 0๊ฑด, ๊ฒฝ๊ณ 16๊ฑด์ด ๋์ต๋๋ค. ๊ฒฝ๊ณ 16๊ฑด์ ๋ชจ๋ ์
๋ฌ ์นด๋ 16์ฅ์ ์๋ฆฌํ์์๊ฐ ์์ง ์ฑ์์ง์ง ์์๋ค๋ PLACEHOLDER_PRESENT ์๋ฆผ์ด๋ฉฐ ์์๋ ๊ฒฐ๊ณผ์
๋๋ค.
์์ฆ ์ ๋ก๋ ์ผ์ ๊ฐ์ด๋
์ผ๋ฐ์ ์ธ ๊ธฐํ ์์น์ด๋ฉฐ ์ฑ๊ณผ๋ฅผ ๋งํ๋ ๊ฒ์ด ์๋๋๋ค. ์ด๋ค ๊ฒ์๋ฌผ์ด ์ด๋ค ๋ฐ์์ ์ป์์ง๋ ์ ์ ์๊ณ , ์ด ํญ๋ชฉ์ ๋ฐ๋ฅด๋ฉด ์กฐํ์๋ ํ๋ก์, ํ๋งค๊ฐ ๋์ด๋๋ค๋ ๋ป์ด ์๋๋๋ค.
- ์๊ฐ๋ณด๋ค ์ผ์ฐ ์์ํ์ธ์. ์ดฌ์๊ณผ ํธ์ง์ด ๋ค์ด๊ฐ๋ฉด ์ฐ๋ง ์ฝํ ์ธ ๋ ์์๋ณด๋ค ์ค๋ ๊ฑธ๋ฆฝ๋๋ค. ์ฒซ ๊ฒ์๋ฌผ ๋ช ์ฃผ ์ ์ ํ ๋ฌถ์์ ๋ฏธ๋ฆฌ ์ค๋นํด ๋๋ ๋ฐฉ์์ด ํํฉ๋๋ค.
- ์ธ ๋จ๊ณ๋ก ๋๋๋๋ค. ๋จผ์ ํฌ๋ฆฌ์ค๋ง์ค์ ๊ฒจ์ธ ๋ถ์๊ธฐ(์ฝ์ง, ๊ฐ์กฑ ์ด์ผ๊ธฐ), ๋ค์์ ์ฐ๋ง ๊ฐ์ฌ(์ธ์ฌ ์นด๋, ์ ๋ฌ ๊ฐ์ฌ ์นด๋), ๊ทธ๋ค์์ ์ํด(์ํด ์ ๋ฌ ์นด๋, ๋ฌ๋ ฅ ๋๊ธฐ๊ธฐ, ์์)์ ๋๋ค.
- ์นดํ ๊ณ ๋ฆฌ๋ฅผ ์์ผ์ธ์. ์ ๋ฌ๋ผ๋ฉด ํ๋ก๋ชจ์ ์นด๋ ์ฌ์ด์ฌ์ด์ ์ฝ์ง๋ ์ธ์ฌ ์นด๋๋ฅผ ๋ฃ์ด์ ๋ชจ๋ ๊ฒ์๋ฌผ์ด ๊ด๊ณ ์ฒ๋ผ ๋ณด์ด์ง ์๊ฒ ํฉ๋๋ค. ํ๋ก๋ชจ์ ์นด๋๋ ํํ์ด ์ฌ์ค์ด๊ณ ์คํ ์ด ํ์ด์ง์ ์ค์ ์ข ๋ฃ์ผ์ด ์ ํ ์์ ๋ ์ฐ์ธ์.
- ๋ณธ์ธ์ ๋ฌ๋ ฅ์ ํ์ธํ์ธ์. ๋ช ์ ์ ๋๋ผ์ ์ง์ญ๋ง๋ค ๋ค๋ฆ ๋๋ค. ์ด ์นด๋๋ ํฌ๋ฆฌ์ค๋ง์ค, ์ํด, ๊ฒจ์ธ ๋ถ์๊ธฐ๋ฅผ ๋ค๋ฃน๋๋ค. ๋ค๋ฅธ ๋ฌ๋ ฅ์ ๋ฐ๋ฅธ๋ค๋ฉด ์ฝ์ง์ ์ธ์ฌ ์นด๋๋ฅผ ๋ฐํ์ผ๋ก ๋ฌธ๊ตฌ๋ฅผ ๊ณ ์ณ ์ฐ์ธ์.
- ๊ธฐ๋ก์ ๋จ๊ธฐ์ธ์. ์ด๋ค ์นด๋๋ฅผ, ์ด๋ค ๋๊ตฌ๋ก, ์ด๋ป๊ฒ ํธ์งํ๊ณ ๋ฌด์์ ๋ฐ๊พธ๊ณ ์ถ์์ง ์ ์ด ๋ก๋๋ค. ์นด๋๋ ํ ๋ฒ์ ํ ๊ฐ์ง์ฉ ๋ฐ๊พธ๋๋ก ์ค๊ณ๋์ด ์์ต๋๋ค.
- ํ๋ฐฐ์ฌ๊ฐ ์ ํ๋ ๋ฐฐ์ก์ผ์ ์ฝ์ํ์ง ๋ง์ธ์. ์ฃผ๋ฌธ ๋ง๊ฐ์ผ์ ์บก์ ์๋ง ๋์ง ๋ง๊ณ ์คํ ์ด ํ์ด์ง์ ์ ์ผ์ธ์.
- ์ฌ์ด ๊ฐ๋ ๊ด์ฐฎ์ต๋๋ค. ๊ท์น์ ์ธ ๋ฆฌ๋ฌ์ ์งง๊ณ ์ฐจ๋ถํ ์๋ฆฌ์ฆ๊ฐ ๋งค์ผ ๋ชฐ์์น๋ ๊ฒ๋ณด๋ค ์ค๋ ์ด์ด ๊ฐ๊ธฐ ์ฝ์ต๋๋ค.
ํ ๋ฌ ๊ณํ์ ์์๋ ์์ด๋์ด๋ฅผ ๋ณด์ฌ ์ฃผ๋ ์ฉ๋์ผ ๋ฟ์ ๋๋ค. ์ฒซ์งธ ์ฃผ์๋ ์ฝ์ง ์นด๋ ๋ ์ฅ๊ณผ ์ด์ผ๊ธฐ ์นด๋ ํ ์ฅ, ๋์งธ ์ฃผ์๋ ์ ๋ฌ ํ๋ก๋ชจ์ ์นด๋ ํ ์ฅ๊ณผ ์ฝ์ง ์นด๋ ํ ์ฅ, ์ ์งธ ์ฃผ์๋ ํฌ์ฅ์ด๋ ๋ง๊ฐ ์๋ด ์นด๋ ํ ์ฅ๊ณผ ์ธ์ฌ ์นด๋ ํ ์ฅ, ๋ท์งธ ์ฃผ์๋ ์ฐ๋ง ๊ฐ์ฌ์ ๋ฌ๋ ฅ ๋๊ธฐ๊ธฐ, ์ํด ์ฒซ ์ฃผ์๋ ์ํด ์ ๋ฌ ์นด๋ ํ ์ฅ๊ณผ ์์ ์นด๋ ํ ์ฅ์ ๋๋ค. ์์ ๋กญ๊ฒ ๋ฐ๊ฟ ์ฐ์ธ์.
์์ ๊ณผ ๊ณต๊ฐ ์๋ด
HolidayKit์ ๊ฐ์กฑ ์นํ์ ์ธ ์ผ๋ฐ ์์ฒญ์์ฉ ์ฝํ ์ธ ๋ฅผ ๋ง๋๋ ์ฑ์ธ ์ ์์, ์ ๋ฌ, ๊ต์ฌ, ๋ถ๋ชจ๋ฅผ ์ํ ๊ฒ์ ๋๋ค.
- ๋ฏธ์ฑ๋ ์. ํน์ ๋ฏธ์ฑ๋ ์๋ฅผ ๊ฒจ๋ฅํ ๋ฌธ๊ตฌ, ํ , ๊ด๊ณ ๋ฅผ ์ฐ์ง ๋ง๊ณ , ์๋ณ ๊ฐ๋ฅํ ๋ฏธ์ฑ๋ ์๋ฅผ ๋ณด์ฌ ์ฃผ๊ฑฐ๋ ๋ฌ์ฌํ์ง ๋ง์ธ์.
- ํผํด์ผ ํ ์ฃผ์ . ์ํํ ํ๋์ด๋ ๊ณก์, ์์์ด ์๋ ๋ฌผ๊ฑด์ ์๋ฅด๊ฑฐ๋ ๋จน๋ ํ๋, ๋ฐฉ์น๋ ๋ถ๊ฝ(์นด๋๋ ๋ฌดํ์ผ ์บ๋ค์ ์ฐ์ ํฉ๋๋ค), ํ์ ์ํ์ด ์๋ ๋จ๊ฑฐ์ด ์๋ฃ(์นด๋๋ ๋ฐ๋ปํ ์๋ฃ๋ฅผ ์๋๋ค), ์ (๊ฑด๋ฐฐ ์นด๋๋ ๋ฌด์์ฝ์ฌ ์๋ฃ๋ฅผ ์๋๋ค), ๋ณดํธ๋ฐ๋ ์บ๋ฆญํฐ์ ๋ธ๋๋ ํ์, ์ํ, ์ค์กด ์ธ๋ฌผ์ด๋ ๋ฎ์ ์ธ๋ฌผ
- ํํ. ์กฐํ์, ํ๋ก์, ํ๋งค์ ๋ํ ์ฝ์์ ํ์ง ์์ต๋๋ค. ๊ธฐ๊ฐ ํ์ ์ด๋ ์ฌ๊ณ ํํ์ ์ฌ์ค์ด์ด์ผ ํฉ๋๋ค. ํ๋ฐฐ์ฌ๊ฐ ์ ํ๋ ๋ฐฐ์ก์ผ์ ์ฝ์ํ์ง ๋ง์ธ์.
- ๊ฐ์ธ์ ๋ณด. ์ด๋ฆ, ์ฃผ์, ์ฃผ๋ฌธ ๋ฒํธ, ํ๋ฉด์ ํ๋ฆฌ๊ฒ ํ๊ฑฐ๋ ์ง์ด๋ธ ๊ฒ์ผ๋ก ๋ฐ๊พธ์ธ์. ์ ํํ ์ง ๋ฒํธ์ ๊ณ ๊ฐ ์ ๋ณด๋ ํ๋ฉด์ ๋์ค์ง ์๊ฒ ํ๊ณ , ๊ฐ๊ฒ ์์ด๋ ๊ทผ์ฒ์์ ์ดฌ์ํ๊ธฐ ์ ์๋ ํ๋ฝ์ ๊ตฌํ์ธ์.
- AI ํ์. AI ์์ฑ๋ฌผ์ด๋ AI ๋ณด์กฐ ์์์ ํ์ ๋ฐฉ์์ ํ๋ซํผ๋ง๋ค ๋ค๋ฅด๊ณ ๊ท์ ๋ ๋ฐ๋๋๋ค. ์ฌ๋ฆฌ๊ธฐ ์ ์ ์ฐ๋ ํ๋ซํผ์ ์ต์ ์ ์ฑ ์ ํ์ธํ๊ณ ์๊ตฌํ๋ ํ์๋ ์ค์ ์ ์ผ์ธ์. ์ง์ ์ดฌ์ํ ์์์ด๋ผ๋ฉด ํ์๊ฐ ํ์ ์์ ์๋ ์๊ณ , ์ผ๋ถ๋ผ๋ AI๋ก ๋ง๋ค์๋ค๋ฉด ํ๋ซํผ ๊ท์ ์ ๋ฐ๋ฅด์ธ์. ํ์คํ์ง ์์ผ๋ฉด ํ์ํ์ธ์. ํน์ ํ๋ซํผ์ด ์ค๋ ๋ฌด์์ ์๊ตฌํ๋์ง๋ ์ ํฌ๊ฐ ์๋ ค ๋๋ฆด ์ ์์ต๋๋ค.
- ๋ฆฐํฐ์ ํ๊ณ. ๋ฆฐํฐ๋ ์งง์ ํค์๋ ๋ชฉ๋ก์ ์๋๋ค. ๋งฅ๋ฝ์ ํ๋จํ์ง ๋ชปํ๊ณ ๋ชจ๋ ๋ณดํธ ๋์ ์ด๋ฆ์ ์ฐพ์๋ด์ง๋ ๋ชปํฉ๋๋ค. ๋ฆฐํธ๋ฅผ ํต๊ณผํ๋ค๊ณ ๋ฒ์ ๊ฒํ ๋ ์ ์ฑ ์น์ธ์ด ๋๋ ๊ฒ์ด ์๋๋๋ค. ์ต์ข ๋ฌธ์ฅ์ ์ง์ ์ฝ์ด ๋ณด์ธ์.
์ผ๋ฐ ํ๋กฌํํธ ๋ชจ์๊ณผ ๋ฌด์์ด ๋ค๋ฅธ๊ฐ
ํน์ ์ํ์ด ์๋๋ผ ํํ ๋ณผ ์ ์๋ ๋จ์ ํ๋กฌํํธ ๋ชฉ๋ก๊ณผ ์ ์งํ๊ฒ ๋น๊ตํ ํ์ ๋๋ค. HolidayKit์ ์ฝ์ ๋ ๋ฃ์์ต๋๋ค.
| ํญ๋ชฉ | ํํ ๋จ์ ํ๋กฌํํธ ๋ชฉ๋ก | HolidayKit | HolidayKit์ ์ฝ์ |
|---|---|---|---|
| ๊ตฌ์กฐ | ์์ด๋์ด๋น ํ๋กฌํํธ ํ๋ ๊ฐ | ํ , 6์ปท ํ์๋ผ์ธ, ์ฌ์ด๋ ๋ ธํธ, ํ๋กฌํํธ, ๋ ์ธ์ด ์บก์ , ํด์ํ๊ทธ, ์ฒดํฌ๋ฆฌ์คํธ, ์์ ์๋ด | ์์ด๋์ด๋น ์ฝ์ ๋ถ๋์ด ๋ง์์ ํ ์ค ํ๋กฌํํธ๋ง ์ํ๋ค๋ฉด ๊ณผํฉ๋๋ค |
| ์ ๋ฌ ์ฌ์ฉ | ์๋ฆฌํ์์๊ฐ ๋๋ฌพ | PRODUCT, PRICE, OFFER ์ ๋ฌ ์นด๋ 16์ฅ๊ณผ build-card, fact-lock | ์๋ฆฌํ์์๋ ์ธ ๊ฐ๋ฟ์ด๊ณ ์ํ ๋ฐ์ดํฐ๋ฒ ์ด์ค๋ ์คํ ์ด ์ฐ๋์ ์์ต๋๋ค |
| ์ ๊ฒ | ์์ | ๋ฆฐํฐ, fact-lock, ๋๊ตฌ์ฉ ํ ์คํธ 336๊ฐ | ํค์๋ ๊ธฐ๋ฐ์ด๋ผ ๋งฅ๋ฝ์ ํ๋จํ์ง ๋ชปํ๊ณ ์ ์ฑ ์น์ธ์ด ์๋๋๋ค |
| ์ธ์ด | ๋ณดํต ํ ๊ฐ์ง | ์์ด ํ๋กฌํํธ, ํ๊ตญ์ด ์ ๋ชฉยทํ ยท์บก์ | ํ๋กฌํํธ๋ ์์ด๋ฟ์ด๊ณ ๋ง๋ ๋ค ํ๊ตญ์ด ์กฐ์ฌ๋ฅผ ์ง์ ํ์ธํด์ผ ํฉ๋๋ค |
| ๋ฏธ๋์ด | ์ํ ์์์ด๋ ์ด๋ฏธ์ง๊ฐ ์๋ ๊ฒฝ์ฐ๋ ์์ | ์์ | ์์, ์ด๋ฏธ์ง, ์ค๋์ค ํ์ผ์ด ์ ํ ์์ต๋๋ค |
| ๋ฒ์ | ํ ๊ฐ์ง ๋ช ์ ์ธ ๊ฒฝ์ฐ๊ฐ ๋ง์ | ํฌ๋ฆฌ์ค๋ง์ค, ์ํด, ๊ฒจ์ธ ๋ถ์๊ธฐ | ๋ค๋ฅธ ๋ช ์ ์ ๋ค๋ฃจ์ง ์์ต๋๋ค |
| ๋ถ๋ | ์งง์ ํ๋กฌํํธ ์๋ฐฑ ๊ฐ๋ ๊ฐ๋ฅ | ์์ธํ ์นด๋ 48์ฅ | ์์ฃผ ํฐ ํ๋กฌํํธ ๋ชฉ๋ก๋ณด๋ค ์์ด๋์ด ์๊ฐ ์ ์ต๋๋ค |
| ๋๊ตฌ ์ข ์ | ํ ๋๊ตฌ์ฉ์ผ๋ก ์ฐ์ธ ๊ฒฝ์ฐ๊ฐ ๋ง์ | ํน์ ๋๊ตฌ์ ๋ฌถ์ด์ง ์์ ํ๋กฌํํธ | ์ด๋ค ๋๊ตฌ์๋ ๋ง์ถฐ ํ๋๋์ง ์์์ ๋๊ตฌ๋ง๋ค ์๋ด์ผ ํ ์ ์์ต๋๋ค |
| ์ฌํ์ฑ | ํด๋น ์์ | ๋คํธ์ํฌ ์์ด ๋ชจ๋ ๋ก์ปฌ์์ ์คํ | ์คํฌ๋ฆฝํธ์๋ Node.js 18 ์ด์์ด ํ์ํฉ๋๋ค |
| ์ฑ๊ณผ ๊ทผ๊ฑฐ | ๋ค์ํจ | ์ฃผ์ฅํ์ง ์์ | ์กฐํ์๋ ํ๋งค์ ๋ํ ์ฃผ์ฅ์ ํ์ง ์์ต๋๋ค |
๊ฐ๊ฒฉ
HolidayKit์ ์ผํ์ฑ US$9.99์ ๋๋ค. ๊ตฌ๋ ๋ ์๊ณ ์ด ํจํค์ง์์ ๋๊ฐ๋ ์ฌ์ฉ๋ ๊ณผ๊ธ๋ ์์ต๋๋ค. ์นด๋ 48์ฅ์ผ๋ก ๋๋๋ฉด ํ ์ฅ๋น ์ฝ US$0.21์ ๋๋ค. ์ด ๊ฐ๊ฒฉ์๋ ์นด๋, ๋๊ตฌ ์ธ ๊ฐ, ์๋ด ๋ฌธ์ ๋ค ๊ฐ, ํ ์คํธ๊ฐ ํฌํจ๋ฉ๋๋ค. ์์ ์์ฑ, ์คํก ์์ฌ, ํ๋กฌํํธ์ ํจ๊ป ์ฐ๋ ค๊ณ ๊ณ ๋ฅธ ์ธ๋ถ ๋๊ตฌ์ ๋น์ฉ์ ํฌํจ๋์ง ์์ผ๋ฉฐ ๊ทธ ๋น์ฉ์ ์ฐ๋ ๋๊ตฌ์ ๋ฐ๋ผ ๋ฐ๋ก ๋ญ๋๋ค.
์์ฃผ ๋ฌป๋ ์ง๋ฌธ
๋ฌด์์ ๋ฐ๋์? ๋งํฌ๋ค์ด ์นด๋ 48์ฅ, ๋ก์ปฌ Node.js ์คํฌ๋ฆฝํธ 3๊ฐ(build-card, lint-cards, fact-lock), ์๋ด ๋ฌธ์ 4๊ฐ, ๋ชฉ์ฐจ, ์๋ ํ ์คํธ 336๊ฐ์ ๋๋ค. ์์, ์ด๋ฏธ์ง, ์ค๋์ค ํ์ผ์ ์์ต๋๋ค.
์์์ ๋ง๋ค์ด ์ฃผ๋์? ์๋์. ์นด๋๋ง๋ค ๋ฒ์ฉ AI ์์ ํ๋กฌํํธ๋ฅผ ํฌํจํ ์นด๋ ํ ์คํธ๋ฅผ ๋๋ฆฝ๋๋ค. ์นด๋ฉ๋ผ, ํธ์ง ์ฑ, ์์ ๋๊ตฌ๋ ์ง์ ์ค๋นํ์ ์ผ ํฉ๋๋ค.
์ด๋ค AI ์์ ๋๊ตฌ์์๋ ๋๋์? ํ๋กฌํํธ๋ ํน์ ๋๊ตฌ์ ๋ฌถ์ด์ง ์๊ณ ์นด๋ฉ๋ผ์ ๋ณด์ด๋ ๊ฒ์ ๋ฌ์ฌํ๋๋ก ์ผ์ต๋๋ค. ๋๊ตฌ๋ง๋ค ์ดํดํ๋ ๋ฐฉ์์ด ๋ค๋ฅด๊ณ ํด๋ฆฝ ๊ธธ์ด ์ ํ๋ ์์ด์ ๋ฌธ์ฅ์ ์๋ด์ผ ํ๊ฑฐ๋ ์ปท์ ๋ฐ๋ก ์์ฑํด์ผ ํ ์ ์์ต๋๋ค.
์ค๋งํธํฐ์ผ๋ก ์ง์ ์ดฌ์ํด๋ ๋๋์? ๋ฉ๋๋ค. ์นด๋๋ง๋ค ์๊ฐ์ด ์ ํ ์ท ๋ฆฌ์คํธ, ์ฌ์ด๋ ๋ ธํธ, ์ดฌ์ ์ฒดํฌ๋ฆฌ์คํธ๊ฐ ์์ด์ ์ค์ ์ดฌ์์๋ ์ธ ์ ์์ต๋๋ค.
์ค์นํด์ผ ํ๋ ๊ฒ์ด ์๋์? ์คํฌ๋ฆฝํธ๋ฅผ ๋๋ฆฌ๋ ค๋ฉด Node.js 18 ์ด์์ด ํ์ํฉ๋๋ค. ๋ฐ๋ก ์ค์นํ ์์กด ํจํค์ง๋ ์์ต๋๋ค.
๋คํธ์ํฌ๋ก ๋ฌด์ธ๊ฐ ์ ์ก๋๋์? ์๋์. ์คํฌ๋ฆฝํธ๋ ๋คํธ์ํฌ๋ฅผ ์ฐ์ง ์๊ณ , ๋คํธ์ํฌ๋ ํ์ ํ๋ก์ธ์ค ๋ชจ๋์ ๋ถ๋ฌ์ค์ง ์๋์ง ํ์ธํ๋ ํ ์คํธ๋ ์์ต๋๋ค.
๊ณ์ ์ด๋ API ํค๊ฐ ํ์ํ๊ฐ์? ํ์ ์์ต๋๋ค. ํจํค์ง ์์ฒด์๋ ๊ณ์ , ๋ก๊ทธ์ธ, ํค ์๊ตฌ๊ฐ ์์ต๋๋ค.
๊ฐ์ ๋ฃ์ด์ผ ํ๋ ์นด๋๋ ์ด๋ ๊ฒ์ธ๊ฐ์? ์ ๋ฌ ์นด๋ 16์ฅ(hk-017~hk-032)๋ง ํด๋นํ๋ฉฐ PRODUCT, PRICE, OFFER๊ฐ ํ์ํฉ๋๋ค.
๊ฐ์ ํ๋ ๋นผ๋จน์ผ๋ฉด ์ด๋ป๊ฒ ๋๋์? build-card๊ฐ ์ด๋ค ๊ฐ์ด ๋น ์ก๋์ง ์๋ ค ์ฃผ๊ณ ๋ฉ์ถฅ๋๋ค. ๋น ์๋ฆฌํ์์๊ฐ ๋จ์ ์นด๋๋ ๋ง๋ค์ง ์์ต๋๋ค.
fact-lock์ด ํํ์ด ์ฌ์ค์ด๋ผ๋ ๊ฒ๊น์ง ํ์ธํด ์ฃผ๋์? ์๋์. ์ธ ๊ฐ์ด ์ ๋ ฅํ ๊ทธ๋๋ก ๋ค์ด ์๋์ง, ๊ทธ ๋ฐ์ ๊ธ์ก์ด๋ ํผ์ผํธ๊ฐ ์๋์ง๋ง ๋ด ๋๋ค. ํํ์ด ์ค์ ๋ก ์กด์ฌํ๋์ง๋ ์ฌ์ฉ์์ ์ฑ ์์ ๋๋ค.
ํ๊ตญ์ด ๋ฌธ์ฅ์ด ๋ชจ๋ ์ํ๋ช ์ ์์ฐ์ค๋ฝ๊ฒ ๋ง๋์? ์๋์ผ๋ก๋ ๋ง์ง ์์ต๋๋ค. ๋ฅผ/์, ๊ฐ/์ด ๊ฐ์ ์กฐ์ฌ๋ ์ด๋ฆ์ ๋ง์ง๋ง ์๋ฆฌ์ ๋ฐ๋ผ ๋ฌ๋ผ์ง๋๋ฐ build-card๋ ์กฐ์ฌ๋ฅผ ๋ฐ๊พธ์ง ์์ต๋๋ค. ๋ง๋ ๋ค ํ๊ตญ์ด ์ค์ ์ฝ์ด ๋ณด์ธ์.
์นด๋๋ฅผ ๊ณ ์ณ ์จ๋ ๋๋์? ๋ค. ๊ณ ์น ๋ค์๋ node scripts/lint-cards.mjs content/cards/hk-001.md๋ก ๊ตฌ์กฐ๋ฅผ ํ์ธํ์ธ์. ๋ฆฐํฐ๊ฐ ๊ณ์ ํต๊ณผํ๋ ค๋ฉด ๊ธธ์ด์ ํฉ์ด ๋ง๋ ์ฌ์ฏ ์ปท, ํ
, ํด์ํ๊ทธ 8๊ฐ ๊ตฌ์กฐ๋ฅผ ์ ์งํ์ธ์.
์คํ ๋ฆฌ ์นด๋์ ์บ๋ฆญํฐ๋ ์ํ๋ ์ ์๊ถ ๋ฌธ์ ๊ฐ ์๋์? ํฐํ(์ฌ๋นผ๋ฏธ), ๋ชจ์ค(๋ฌํฝ์ด), ํ(๊ณ ์ด๋์น)์ ์ค๋ฆฌ์ง๋ ๋๋ฌผ ๋ชจํฐํ๋ก ์ฐ์๊ณ , ์นด๋์๋ ๊ธฐ์กด ๋ธ๋๋๋ ํ๋์ฐจ์ด์ฆ ์์๋ฅผ ๋ฃ์ง ๋ง๋ผ๋ ์๋ด๊ฐ ์์ต๋๋ค. ๋ค๋ฅธ ๊ณณ์ ๋ฎ์ ์บ๋ฆญํฐ๊ฐ ์๋์ง๋ ์ ํฌ๊ฐ ํ์ธํ์ง ๋ชปํ์ผ๋ ์ง์ ํ๋จํด ์ฃผ์ธ์.
์์ฑํ ์์์ SNS์ ์ฌ๋ ค๋ ๋๋์? ์ฌ์ฉ์์ ๊ฐ ํ๋ซํผ์ ๊ท์ ์ ๋ฌ๋ฆฐ ๋ฌธ์ ์ ๋๋ค. ์ฌ๋ฆฌ๊ธฐ ์ ์ ํ๋ซํผ๋ณ AI ์์ฑ๋ฌผ ํ์ ์ ์ฑ ์ ํ์ธํ๊ณ ํ์ํ๋ฉด ํ์ํ์ธ์.
์ด๋ฆฐ์ด์ฉ์ธ๊ฐ์? ์๋๋๋ค. ๊ฐ์กฑ ์นํ์ ์ธ ์ฝํ ์ธ ๋ฅผ ๋ง๋๋ ์ฑ์ธ์ ์ํ ๋๊ตฌ์ด๋ฉฐ, ์นด๋๋ ํน์ ๋ฏธ์ฑ๋ ์๋ฅผ ๊ฒจ๋ฅํ๊ฑฐ๋ ๋ฑ์ฅ์ํค์ง ์์ต๋๋ค. ๊ทธ๋ฐ ์ฉ๋๋ก ์ฐ์ง ๋ง์ธ์.
์กฐํ์๋ ๋งค์ถ์ด ๋์ด๋๋์? ์ ํฌ๋ ์ ์ ์๊ณ ํจํค์ง๋ ๊ทธ๋ฐ ์ฃผ์ฅ์ ํ์ง ์์ต๋๋ค. ๊ธฐํ ์๊ฐ์ ์ค์ด๊ณ ๊ฐ๊ฒฉ๊ณผ ํํ ๋ฌธ๊ตฌ๋ฅผ ์ ํํ๊ฒ ์งํค๋ ๋ฐ ๋์์ ์ค๋๋ค.
์์ ์ด๋ ์๋ฆฌ ํ์ผ์ด ์๋์? ์์ต๋๋ค. ์ฌ์ด๋ ๋ ธํธ๋ ๋ฌด์์ ๋ น์ํ๊ฑฐ๋ ์์์ง ์ค๋ช ํ ๋ฟ์ด๊ณ ์ค๋์ค๋ ์ง์ ์ค๋นํ์ ์ผ ํฉ๋๋ค.
์ ๋ฐ์ดํธ๊ฐ ์๋์? ๋ด๋ ค๋ฐ๋ ํจํค์ง๊ฐ ์ด ์ค๋ช ์ ์ ํ ํจํค์ง์ ๋๋ค. ์ด ์ค๋ช ์์ ํฅํ ์ ๋ฐ์ดํธ๋ฅผ ์ฝ์ํ์ง ์์ต๋๋ค.
์คํฌ๋ฆฝํธ๊ฐ ๋์๊ฐ์ง ์์ผ๋ฉด์? ์นด๋๋ฅผ ์์ผ๋ก ์ฐ๋ฉด ๋ฉ๋๋ค. ์๋ฆฌํ์์๋ฅผ ์ง์ ๋ฐ๊พธ๊ณ , ์ปท ๊ธธ์ด๋ฅผ ๋ํ๊ณ , ํด์ํ๊ทธ๋ฅผ ์ธ๊ณ , ๊ฐ๊ฒฉ๊ณผ ํํ์ ์คํ ์ด ํ์ด์ง์ ๋์กฐํ๋ ์๋ ์ ์ฐจ๊ฐ ์์ ์์์ ๋ค์ด ์์ต๋๋ค.
๋ฆฐํธ๋ ๋๋ด๋ ์นด๋๋ก ํต๊ณผํ๋์? ๋ค. 48์ฅ์์ ์ค๋ฅ 0๊ฑด, ๊ฒฝ๊ณ 16๊ฑด์ด๋ฉฐ ๊ฒฝ๊ณ ๋ ์ ๋ฌ ์นด๋์ ๋ฏธ์ ๋ ฅ ์๋ฆฌํ์์ ์๋ฆผ์ ๋๋ค.
ํ๊ณ
- ๋ฏธ๋์ด๊ฐ ์์ต๋๋ค. ํจํค์ง์ ์์, ์ด๋ฏธ์ง, ์ค๋์ค๊ฐ ์์ต๋๋ค. ์ด ํ์ด์ง์ ๋ฏธ๋ฆฌ๋ณด๊ธฐ ๊ทธ๋ฆผ์ ์นด๋ ํ ์คํธ์ ๋๊ตฌ ์ถ๋ ฅ์ ๋ ๋๋งํ ๊ฒ์ด๋ฉฐ ์ํ ์์์ด ์๋๋๋ค.
- ์ธ๋ถ ๋๊ตฌ ๋น์ฉ์ ๋ฐ๋ก์ ๋๋ค. ์์ ์์ฑ ๋๊ตฌ, ํธ์ง ์ฑ, ์์ ์์ค๋ ๋น์ฉ์ด ๋ค ์ ์๊ณ ํคํธ ๊ฐ๊ฒฉ์ ํฌํจ๋์ง ์์ต๋๋ค.
- ์์ ๋๊ตฌ๋ง๋ค ๊ฒฐ๊ณผ๊ฐ ๋ค๋ฆ ๋๋ค. ํ๋กฌํํธ๋ ๋ฒ์ฉ์ ๋๋ค. ๊ฐ์ ํ๋กฌํํธ๋ ๋๊ตฌ์ ๋ฐ๋ผ ์ ํ ๋ค๋ฅธ ํด๋ฆฝ์ด ๋์ฌ ์ ์๊ณ , ์ด๋ค ๋๊ตฌ๋ ์์ง์, ์, ๊ธ์๋ฅผ ์ ๋ชป ๋ค๋ฃน๋๋ค. ๊ฒฐ๊ณผ๋ ๋ฐ๋์ ์ง์ ๊ฒํ ํ์ธ์.
- ์นด๋ ์์ฌ์ ์๋ณธ์ฑ์ ๊ฒ์ฆํ์ง ๋ชปํ์ต๋๋ค. ์นด๋์ ์บ๋ฆญํฐ๋ฅผ ์ค๋ฆฌ์ง๋๋ก ์ผ์ง๋ง ๋น์ทํ ์์ด๋์ด๋ ๋ฎ์ ์บ๋ฆญํฐ๊ฐ ๋ค๋ฅธ ๊ณณ์ ์๋์ง๋ ํ์ธํ์ง ๋ชปํ์ต๋๋ค.
- ๋ฆฐํฐ๋ ํค์๋ ์์ ๋ง์ ๋๋ค. ๊ตฌ์กฐ์ ์งง์ ํค์๋ ๋ชฉ๋ก๋ง ํ์ธํ๋ฉฐ ๋งฅ๋ฝ์ ํ๋จํ์ง ๋ชปํ๊ณ , ๋ฒ์ ๊ฒํ ๋ ์ ์ฑ ์น์ธ์ด ์๋๋๋ค.
- fact-lock์ ๋ฌธ์ฅ์ ํ์ธํ ๋ฟ ์ฌ์ค์ ํ์ธํ์ง ์์ต๋๋ค. ํํ์ด ์ค์ ์ธ์ง๋ ์ ์ ์์ต๋๋ค.
- ํ๊ตญ์ด ์กฐ์ฌ๋ ์๋ ๊ต์ ๋์ง ์์ต๋๋ค. ์ ๋ฌ ์นด๋๋ฅผ ๋ง๋ ๋ค ์ง์ ํ์ธํ์ธ์.
- ๋ฒ์. ํฌ๋ฆฌ์ค๋ง์ค, ์ํด, ๊ฒจ์ธ ๋ถ์๊ธฐ๋ง ๋ค๋ฃน๋๋ค. ๋ค๋ฅธ ๋ช ์ ์ ์์ต๋๋ค.
- Node.js 18 ์ด์์ด ์์ด์ผ ์คํฌ๋ฆฝํธ๋ฅผ ์ธ ์ ์์ต๋๋ค. ์์ผ๋ฉด ์ ๊ฒ์ ์ง์ ํฉ๋๋ค.
- ์ฑ๊ณผ์ ๋ํ ์ฃผ์ฅ์ ์์ต๋๋ค. ์กฐํ์, ํ๋ก์, ํ๋งค์ ๋ํด ์๋ฌด๊ฒ๋ ์ฃผ์ฅํ์ง ์์ต๋๋ค.
- ํ๋ซํผ ๊ท์ ์ ๋ฐ๋๋๋ค. AI ํ์์ ๊ด๊ณ ๊ท์ ์ ํ๋ซํผ๋ง๋ค ๋ค๋ฅด๊ณ ์๊ฐ์ ๋ฐ๋ผ ๋ฐ๋๋ ์ต์ ์ ์ฑ ์ ์ง์ ํ์ธํ์ธ์.


