๐Ÿ‡ฐ๐Ÿ‡ท ํ•œ๊ตญ์–ด ยท ๐Ÿ‡บ๐Ÿ‡ธ English

PATCH ๋งค๋‰ด์–ผ ๊ฐœ์ •์ด๋ ฅ

v1.3.0 โ€” 2026-03-22

FAQยทํ™ˆ ํŽ˜์ด์ง€ยท๋ฌธ์„œ ์ •๋น„

FAQ ํŽ˜์ด์ง€ (์‹ ๊ทœ)

  • 50+ ์งˆ๋ฌธ์„ ํŽ˜๋ฅด์†Œ๋‚˜๋ณ„๋กœ ๋ถ„๋ฅ˜ (์ฒ˜์Œ ์‚ฌ์šฉยทO&M ๊ด€๋ฆฌ์‚ฌยทEPC ์‹œ๊ณต์‚ฌยท๋ฐœ์ „์†Œ ์†Œ์œ ์ฃผยท๊ณตํ†ต)
  • ์‹ค์‹œ๊ฐ„ ๊ฒ€์ƒ‰ ํ•„ํ„ฐ (ํ‚ค์›Œ๋“œ ์ž…๋ ฅ ์‹œ Q&A + ์นดํ…Œ๊ณ ๋ฆฌ ํ—ค๋” ์ž๋™ ์ˆจ๊น€)
  • ๊ฐ ๋‹ต๋ณ€์— ๊ด€๋ จ ๋งค๋‰ด์–ผ ํŽ˜์ด์ง€ ๋ฒ„ํŠผ 54๊ฐœ ์—ฐ๊ฒฐ

ํ™ˆ ํŽ˜์ด์ง€ ๋ฆฌ๋””์ž์ธ

  • ํ‚ฌ๋Ÿฌ ํƒœ๊ทธ๋ผ์ธ: "๋ฐœ์ „์†Œ๊ฐ€ ์•„๋‹ˆ๋ผ, ํŒจ๋„ ํ•˜๋‚˜ํ•˜๋‚˜๋ฅผ ๋ด…๋‹ˆ๋‹ค"
  • ์™€์šฐ ํฌ์ธํŠธ 4๊ฐœ + ๊ณ ๊ฐ ์‹œ๋‚˜๋ฆฌ์˜ค 3๊ฐœ (O&MยทEPCยท์†Œ์œ ์ฃผ)
  • ๋ฐ˜์‘ํ˜• CSS

์‹ ๊ทœ step 3๊ฐœ

  • A.2 ํšŒ์›๊ฐ€์ž…, A.3 ๋น„๋ฐ€๋ฒˆํ˜ธ ์žฌ์„ค์ •, H.1 ์•Œ๋ฆผ ํ™•์ธํ•˜๊ธฐ

์ฝ˜ํ…์ธ  ๋ณด๊ฐ•

  • ์ด์ƒ๊ฐ์ง€ 12์ข… ์šฉ์–ด์‚ฌ์ „ ๋“ฑ๋ก (์ด 50๊ฐœ ์šฉ์–ด)
  • D.1 ํŒจ๋„ ํด๋ฆญ ํŒ์—…, E.1 ๋Œ“๊ธ€ ํŽธ์ง‘/์‚ญ์ œ โ‹ฎ ๋ฉ”๋‰ด ์Šคํฌ๋ฆฐ์ƒท ์ถ”๊ฐ€
  • C.1 ์ •๋ณด ํŒจ๋„ โ“˜ ์ ‘๊ธฐ, ์ฃผ์†Œโ†’์ง€๋„, ์ž„์‹œ ๋งํฌ, ๋ณด๊ณ ์„œ ๋‚ ์งœ ์„ ํƒ ์„ค๋ช… ๋ณด๊ฐ•

์‹œ์Šคํ…œ

  • annotation์— selector ํ•„๋“œ ์ „๋‹ฌ
  • CLAUDE.md ์ค‘๋ณต ์ œ๊ฑฐยท์ •๋ฆฌ
  • README ์ „๋ฉด ์žฌ์ž‘์„ฑ (ํŒŒ์ดํ”„๋ผ์ธ ๋‹ค์ด์–ด๊ทธ๋žจ + FAQ)
  • simpleMarkdownToHtml์— ์ธ๋ผ์ธ ๋งํฌยทโ†’ ์ ‘๋‘์‚ฌ ํŒŒ์‹ฑ ์ถ”๊ฐ€

์ˆ˜์น˜

  • step: 23 โ†’ 26๊ฐœ (+3)
  • ์ด๋ฏธ์ง€: 37 โ†’ 42๊ฐœ (+5)
  • ์šฉ์–ด: 38 โ†’ 50๊ฐœ (+12)
  • FAQ: 0 โ†’ 50+๊ฐœ (์‹ ๊ทœ)

v1.2.0 โ€” 2026-03-22

ํ™ˆ ํŽ˜์ด์ง€ ๋ฆฌ๋””์ž์ธ + ์‹ ๊ทœ step 3๊ฐœ + ์šฉ์–ด์‚ฌ์ „ ํ™•์žฅ

ํ™ˆ ํŽ˜์ด์ง€ ๋ฆฌ๋””์ž์ธ

  • ํ‚ฌ๋Ÿฌ ํƒœ๊ทธ๋ผ์ธ: "๋ฐœ์ „์†Œ๊ฐ€ ์•„๋‹ˆ๋ผ, ํŒจ๋„ ํ•˜๋‚˜ํ•˜๋‚˜๋ฅผ ๋ด…๋‹ˆ๋‹ค"
  • ์™€์šฐ ํฌ์ธํŠธ 4๊ฐœ: ํŒจ๋„ ๋‹จ์œ„ ๋ชจ๋‹ˆํ„ฐ๋ง, ์ดˆ ๋‹จ์œ„ ๋ฐ์ดํ„ฐ, 12์ข… ์ด์ƒ ์ž๋™ ๊ฐ์ง€, ํ˜„์žฅ-์‚ฌ๋ฌด์‹ค ์—ฐ๊ฒฐ
  • ๊ณ ๊ฐ ์œ ํ˜•๋ณ„ ์‹œ๋‚˜๋ฆฌ์˜ค 3๊ฐœ: O&M ๊ด€๋ฆฌ์‚ฌ, EPC ์‹œ๊ณต์‚ฌ, ๋ฐœ์ „์†Œ ์†Œ์œ ์ฃผ
  • ๋ฐ˜์‘ํ˜• CSS (๋ชจ๋ฐ”์ผ 1์—ด ์ „ํ™˜)

์‹ ๊ทœ step

  • A.2 ํšŒ์›๊ฐ€์ž…ํ•˜๊ธฐ (start-002-signup) โ€” ์Šคํฌ๋ฆฐ์ƒท ํฌํ•จ
  • A.3 ๋น„๋ฐ€๋ฒˆํ˜ธ ์žฌ์„ค์ •ํ•˜๊ธฐ (start-003-password-reset) โ€” ์Šคํฌ๋ฆฐ์ƒท ํฌํ•จ
  • H.1 ์•Œ๋ฆผ ํ™•์ธํ•˜๊ธฐ (account-002-notifications) โ€” ์•Œ๋ฆผ ํŒจ๋„ ์Šคํฌ๋ฆฐ์ƒท ํฌํ•จ

๊ธฐ์กด step ๋ณด๊ฐ•

  • D.1 ํŒจ๋„ ํด๋ฆญ ํŒ์—… ์Šคํฌ๋ฆฐ์ƒท ์ถ”๊ฐ€ (์ขŒํ‘œยท์ŠคํŠธ๋งยท์ถœ๋ ฅยท์ „๋ฅ˜ยท์ „์•• ์ƒ์„ธ)
  • E.1 ๋Œ“๊ธ€ ์ƒ์„ธ โ‹ฎ ๋ฉ”๋‰ด(ํŽธ์ง‘/์‚ญ์ œ) ์Šคํฌ๋ฆฐ์ƒท + step4 ์ƒ์„ธํ™”
  • F.2 ๋ณด๊ณ ์„œ ํŒจ๋„ ๋‹จ์œ„ ํ˜„ํ™ฉ ๋‚ ์งœ ์„ ํƒ ์„ค๋ช… ์ถ”๊ฐ€
  • C.1 ์ •๋ณด ํŒจ๋„ โ“˜ ์ ‘๊ธฐ/ํŽผ์น˜๊ธฐ ์„ค๋ช… ์ถ”๊ฐ€
  • C.1 ์ฃผ์†Œโ†’๋„ค์ด๋ฒ„ ์ง€๋„ ์™ธ๋ถ€ ๋งํฌ ์•ˆ๋‚ด
  • H. ์ž„์‹œ ๋งํฌ ์„ค๋ช… ๋ณด๊ฐ• (ํด๋ฆฝ๋ณด๋“œ ๋ณต์‚ฌ ๋™์ž‘)

์šฉ์–ด์‚ฌ์ „

  • ์ด์ƒ๊ฐ์ง€ 12์ข… ์šฉ์–ด ์ถ”๊ฐ€ (์œ„ํ—˜ 6 + ๊ฒฝ๊ณ„ 3 + ๊ด€์‹ฌ 3)
  • ์ด 50๊ฐœ ์šฉ์–ด (๊ธฐ์กด 38 โ†’ 50)

์ˆ˜์น˜

  • step: 23 โ†’ 26๊ฐœ
  • ์ด๋ฏธ์ง€: 37 โ†’ 42๊ฐœ
  • ์šฉ์–ด: 38 โ†’ 50๊ฐœ

v1.1.0 โ€” 2026-03-21

๋‹ค๊ตญ์–ด ์ง€์› + PATCH ํ˜„์žฅ ๋ณด๊ฐ•

๋‹ค๊ตญ์–ด

  • ์˜์–ด ๋ฒ„์ „ ์™„์„ฑ (en.json 170+ keys, 32 ์˜์–ด UI ์Šคํฌ๋ฆฐ์ƒท)
  • ์–ธ์–ด ์ „ํ™˜ UI: ๋ชจ๋“  ํŽ˜์ด์ง€์—์„œ ๐Ÿ‡ฐ๐Ÿ‡ท/๐Ÿ‡บ๐Ÿ‡ธ ํด๋ฆญ์œผ๋กœ ๊ฐ™์€ ํŽ˜์ด์ง€์˜ ๋‹ค๋ฅธ ์–ธ์–ด๋กœ ์ด๋™
  • ๋นŒ๋“œ: web/ko/, web/en/ ๋ถ„๋ฆฌ ์ถœ๋ ฅ, ์ด๋ฏธ์ง€๋„ ์–ธ์–ด๋ณ„ ๋ถ„๋ฆฌ (web/ko/images/, web/en/images/)
  • UI ํ…์ŠคํŠธ ์ „๋ฉด i18nํ™”: ์‚ฌ์ด๋“œ๋ฐ”ยท์„น์…˜ ์ œ๋ชฉยทstep ๋ผ๋ฒจยทํ™ˆ ํŽ˜์ด์ง€ยท์šฉ์–ด์‚ฌ์ „ ๋ชจ๋‘ ์˜์–ด
  • step ์ฝ˜ํ…์ธ  i18nํ™”: Goal/When to use/Preconditions/Troubleshoot ๋ชจ๋‘ i18n ํ‚ค ์ฐธ์กฐ
  • ์ด๋ฏธ์ง€ ์บก์…˜ยทregion description ์˜์–ด ๋ฒˆ์—ญ (capture_purpose_en, description_en)
  • ์šฉ์–ด์‚ฌ์ „ ์˜์–ด definition (definition_en) + ์˜์–ด glossary ํŽ˜์ด์ง€
  • bbox ์–ธ์–ด๋ณ„ ๋ถ„๋ฆฌ: interactions.jsonl์— bbox_en ํ•„๋“œ, ๋นŒ๋“œ ์‹œ ์ž๋™ ์„ ํƒ

PATCH ํ˜„์žฅ (I-L)

  • fielder-001: ๋ฐœ์ „์†Œ ์„ ํƒ โ†’ ๋ ˆ์ด์•„์›ƒ ๋งต โ†’ ํ•„ํ„ฐ โ†’ ํ…Œ์ด๋ธ” ๋ทฐ (4 ์Šคํฌ๋ฆฐ์ƒท)
  • fielder-002: ํ˜„์žฅ ๋Œ“๊ธ€ ์ž‘์„ฑยท์™„๋ฃŒ ํ•„ํ„ฐ (1 ์Šคํฌ๋ฆฐ์ƒท)
  • fielder-003: ๋””๋ฐ”์ด์Šค(MLPE) ๋“ฑ๋ก ์ง„์ž… (1 ์Šคํฌ๋ฆฐ์ƒท, NEW)
  • ๋ฐœ์ „์†Œ ์„ ํƒ ๋ชฉ๋ก, ์ธก์ •๊ฐ’ ์ฝค๋ณด ๋“œ๋กญ๋‹ค์šด ์Šคํฌ๋ฆฐ์ƒท ์ถ”๊ฐ€

์‹œ์Šคํ…œ ๊ฐœ์„ 

  • ๊ฐœ์ •์ด๋ ฅ ํŽ˜์ด์ง€ ์ถ”๊ฐ€ (์‚ฌ์ด๋“œ๋ฐ” ๐Ÿ“‹ ๊ฐœ์ •์ด๋ ฅ/Changelog)
  • ํ™ˆ ํŽ˜์ด์ง€: PATCH/PATCH Field ์„น์…˜ ์„ค๋ช… ์ถ”๊ฐ€, Field ํ•ญ๋ชฉ์— step ์ˆ˜ badge
  • ์‚ฌ์ด๋“œ๋ฐ” ์„œ๋ธŒํƒ€์ดํ‹€ ์ œ๊ฑฐ (๋ถˆํ•„์š”)
  • ์ด๋ฏธ์ง€ ๊ฒฝ๋กœ ์ˆ˜์ •: ../images/ (ngrok ํ˜ธํ™˜)
  • ์šฉ์–ด์‚ฌ์ „ tooltip ์ค‘์ฒฉ ๋ฐฉ์ง€ (placeholder ๋ฐฉ์‹)
  • ์Šคํฌ๋ฆฐ์ƒท ๊ธฐ์ค€ ๋ทฐํฌํŠธ 1280ร—900 ํ†ต์ผ

๋ฌธ์„œํ™”

  • CLAUDE.md: ์บก์ฒ˜ ๊ทœ์น™, bbox ์ธก์ • ๊ตํ›ˆ, ๋‹ค๊ตญ์–ด ๋นŒ๋“œ ๊ทœ์น™, ์„œ๋ธŒ์—์ด์ „ํŠธ ๊ฒ€์ฆ ์ ˆ์ฐจ ์ถ”๊ฐ€
  • ์‹œํ–‰์ฐฉ์˜ค ๊ตํ›ˆ 12๊ฐœ ํ•ญ๋ชฉ ์ •๋ฆฌ (์ค‘๋ณต ์ œ๊ฑฐ, ์ผ๊ด€์„ฑ ํ™•๋ณด)

v1.0.0 โ€” 2026-03-21

ํ•œ๊ตญ์–ด ๋ฒ„์ „ ๋Ÿฐ์นญ

์ฝ˜ํ…์ธ 

  • A~H ์ „ ์„น์…˜ 18๊ฐœ step + I-L ํ˜„์žฅ 2๊ฐœ step = ์ด 20๊ฐœ step
  • 32๊ฐœ ์Šคํฌ๋ฆฐ์ƒท (๋ชจ๋‘ Playwright ์บก์ฒ˜ + bbox ์‹ค์ธก)
  • 30๊ฐœ ์šฉ์–ด์‚ฌ์ „ ํ•ญ๋ชฉ
  • ๋„๋ฉ”์ธ ๊ฐœ๋… ๋ธ”๋ก (A ์„น์…˜: ๋ฐœ์ „์†Œ ๊ณ„์ธต, ์ด์ƒ๊ฐ์ง€ ๋“ฑ๊ธ‰, ์†์‹ค ์œ ํ˜• ๋“ฑ)

์‹œ์Šคํ…œ

  • ๋นŒ๋“œ ์Šคํฌ๋ฆฝํŠธ: TOC โ†’ ์„น์…˜/์Šคํ… HTML ์ž๋™ ์ƒ์„ฑ
  • ํ•ซ์ŠคํŒŸ ์˜ค๋ฒ„๋ ˆ์ด: interactions.jsonl ๊ธฐ๋ฐ˜ percentage CSS
  • ์ด๋ฏธ์ง€ max-width 700px, ๋ทฐํฌํŠธ ๋ฌด๊ด€ ๋น„๋ก€ ๋ Œ๋”๋ง
  • ์šฉ์–ด tooltip: glossary.json โ†’ step ๋ณธ๋ฌธ ์ž๋™ ์‚ฝ์ž…
  • ์šฉ์–ด์‚ฌ์ „ ํŽ˜์ด์ง€: DataTables ๊ฒ€์ƒ‰/์ •๋ ฌ + step ์—ญ์ฐธ์กฐ
  • Conalog ๋กœ๊ณ  ์ธ๋ผ์ธ SVG
  • ์‚ฌ์ด๋“œ๋ฐ” PATCH/PATCH ํ˜„์žฅ ๊ทธ๋ฃน ํ—ค๋”
  • ํ™ˆ ํŽ˜์ด์ง€: ๊ธฐ๋Šฅ ์นด๋“œ 4๊ฐœ + ํ€ต ๋งํฌ

๋Œ€์ƒ ์•ฑ ๋ฒ„์ „

  • PATCH: v20260320-8d01858
  • PATCH ํ˜„์žฅ: v0.4.15