Docs ยท Cocode ADE ยท ๋ถ„์„ ยท ์„ค๊ณ„ ๋ฌธ์„œ

Cocode ADE ยท 12

Decision Log โ€” ๊ฒฐ์ • ๊ธฐ๋ก

๋ช…์„ธ๋ฅผ ๋‹ค๋“ฌ์œผ๋ฉฐ ๋‚ด๋ฆฐ ๊ฒฐ์ •์„ ์‹œ๊ฐ„ ์ˆœ์„œ๋กœ ์Œ“์€ ๊ธฐ๋ก

๋ชฉ์ฐจ

Records all key decisions made during the spec clarification process. Uses an append-only markdown log instead of Ouroboros Event Sourcing.

Decision List

D-001: MVP ๋Œ€์ƒ ์ˆœ์„œ โ€” ๊ฐœ๋ฐœ์ž ์šฐ์„ , ๋“œ๋ฆฌ๋จธ ๋ชจ๋“œ๋Š” ์ดํ›„

  • Date: 2026-08-25
  • Context: Discovery ๋‹จ๊ณ„์—์„œ "1์ฐจ ์‚ฌ์šฉ์ž๊ฐ€ ๊ฐœ๋ฐœ์ž์ธ์ง€ ๋น„๊ฐœ๋ฐœ์ž(๋„๋ฉ”์ธ ์ „๋ฌธ๊ฐ€/์‹œ๋‹ˆ์–ด/๋“œ๋ฆฌ๋จธ)์ธ์ง€"๊ฐ€ ๋ฏธํ™•์ •์œผ๋กœ ๋‚จ์•˜๊ณ , Socratic ์ธํ„ฐ๋ทฐ Level 1~2์—์„œ๋„ "๊ฐœ๋ฐœ์ž๋ฅผ ํƒ€๊ฒŸ์œผ๋กœ ์ ์—ˆ์œผ๋‚˜ ๋ชฉ์ ์€ ๋ˆ„๊ตฌ๋‚˜"๋ผ๋Š” ๋ชจํ˜ธํ•œ ๋‹ต์ด ๋‚˜์™€ Level 3์—์„œ ์ •๋ฉด์œผ๋กœ ์ถฉ๋Œ(C-01)ํ•จ
  • Options:
    1. ๊ฐœ๋ฐœ์žยท๋“œ๋ฆฌ๋จธ ๋‘ ์ธํ„ฐํŽ˜์ด์Šค๋ฅผ ์ถœ์‹œ์ผ๋ถ€ํ„ฐ ๋™์‹œ์— 1๊ธ‰์œผ๋กœ ์ œ๊ณต โ€” ์‹œ์žฅ ์ปค๋ฒ„๋ฆฌ์ง€๋Š” ๋„“์ง€๋งŒ UX ์„ค๊ณ„ ํ‘œ๋ฉด์ด ๋‘ ๋ฐฐ๋กœ ๋Š˜์–ด๋‚˜ MVP ์ง€์—ฐ ์œ„ํ—˜
    2. ๊ฐœ๋ฐœ์ž ์ธํ„ฐํŽ˜์ด์Šค๋ฅผ ๋จผ์ € ์ถœ์‹œํ•˜๊ณ  ๋“œ๋ฆฌ๋จธ ๋ชจ๋“œ๋Š” ํ›„์† ์—…๋ฐ์ดํŠธ๋กœ ์ˆœ์—ฐ โ€” ์› ์„ค๊ณ„ ๋…ธํŠธ์˜ ์—๋””ํ„ฐ ์ฝ”์–ด ์ค‘์‹ฌ ๋กœ๋“œ๋งต๊ณผ ์ •ํ•ฉ์ 
  • Decision: ์˜ต์…˜ 2 โ€” MVP๋Š” ๊ฐœ๋ฐœ์ž์šฉ ์ธํ„ฐํŽ˜์ด์Šค๋กœ ์ง„ํ–‰, ๋“œ๋ฆฌ๋จธ ๋ชจ๋“œ๋Š” ์ดํ›„ ์—…๋ฐ์ดํŠธ
  • Rationale: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ๋ช…์‹œ์  ํ™•๋‹ต("์ดˆ๊ธฐ ๋ฒ„์ „์€ ๊ฐœ๋ฐœ์ž ์ธํ„ฐํŽ˜์ด์Šค๋กœ ์ง„ํ–‰๋˜์–ด์•ผํ•ด"). Discovery ๋กœ๋“œ๋งต 1~2๋‹จ๊ณ„(์—๋””ํ„ฐ ์ฝ”์–ด ์„ฑ๋Šฅ/ํ•œ๊ธ€ IME ๊ฒ€์ฆ, ๋ชจ๋…ธ๋ ˆํฌ ๊ณจ๊ฒฉ)๊ฐ€ ํ˜•์‹ ์ ˆ์ฐจ๊ฐ€ ์•„๋‹ˆ๋ผ MVP์˜ ์‹ค์งˆ์  ์šฐ์„ ์ˆœ์œ„๋กœ ํ™•์ •๋จ
  • Impact: Seed spec C-01/AC-03/AC-04. Planning ๋‹จ๊ณ„ PRD์˜ ์Šค์ฝ”ํ”„๋ฅผ ๊ฐœ๋ฐœ์ž์šฉ ๊ธฐ๋Šฅ์œผ๋กœ ํ•œ์ •
  • Source: Socratic Interview (Level 3, C-01)

D-002: ๊ฒฝ์Ÿ ํฌ์ง€์…”๋‹ โ€” Orca ๋Œ€๋น„ Dart/Flutter ํŠนํ™” ์ˆ˜์ง ๋”ฅ IDE

  • Date: 2026-08-25
  • Context: Discovery๋Š” Zed/Cursor๋ฅผ "์ •๋ฉด ์Šน๋ถ€ ๊ธˆ์ง€" ๋Œ€์ƒ์œผ๋กœ ์ง€๋ชฉํ–ˆ์œผ๋‚˜, Socratic ์ธํ„ฐ๋ทฐ Level 4(B-02)์—์„œ ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ๊ฐ€ ์‹ค์ œ๋กœ ์ธ์ง€ํ•˜๋Š” ๊ฒฝ์Ÿ์ž๋Š” Orca(Stably AI)์ž„์ด ๋“œ๋Ÿฌ๋‚จ. ๋ณด๊ฐ• ์กฐ์‚ฌ ๊ฒฐ๊ณผ Orca๋Š” MIT ์˜คํ”ˆ์†Œ์Šค, โ˜…2๋งŒ+, 27๊ฐœ+ CLI ์—์ด์ „ํŠธ๋ฅผ ๊ฒฉ๋ฆฌ worktree์—์„œ ๋ณ‘๋ ฌ ์‹คํ–‰ํ•˜๋Š” ๋ฒ”์šฉ ADE๋กœ ํ™•์ธ๋จ
  • Options:
    1. Orca์™€ ๋™์ผํ•œ ์ถ•(์–ธ์–ด ๋ฌด๊ด€ ๋ฉ€ํ‹ฐ ์—์ด์ „ํŠธ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜)์—์„œ ์ •๋ฉด ๊ฒฝ์Ÿ
    2. Orca์™€ ๋‹ค๋ฅธ ์ถ•(Dart/Flutter ํŠนํ™” ์ˆ˜์ง ๋”ฅ IDE โ€” ๊ฒฐ์ •๋ก ์  ์Šค์บํด๋”ฉ, ๋Ÿฐํƒ€์ž„ ์ƒํƒœ ์ธ์ง€)์œผ๋กœ ํฌ์ง€์…”๋‹
  • Decision: ์˜ต์…˜ 2. ๋‹จ, ์žฅ๊ธฐ์ ์œผ๋กœ๋Š” Orca๊ธ‰ ๊ธฐ๋Šฅ ํญ(๋ฉ€ํ‹ฐ ์—์ด์ „ํŠธ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ ๋“ฑ)๊นŒ์ง€ ์ปค๋ฒ„ํ•˜๋˜, ๊ตฌํ˜„ยทUX๋Š” ๋๊นŒ์ง€ Dart/Flutter ์ „์šฉ์„ ์œ ์ง€
  • Rationale: Orca์—๋Š” ๊ฒฐ์ •๋ก ์  ์Šค์บํด๋”ฉ(bricks)๋„ Flutter ๋Ÿฐํƒ€์ž„ ์ƒํƒœ ์ธ์ง€(์œ„์ ฏ ํŠธ๋ฆฌยทํ•ซ ๋ฆฌ๋กœ๋“œ)๋„ ์—†์Œ โ€” ์–ธ์–ด ํŠนํ™”๊ฐ€ ๋ฐฉ์–ด ๊ฐ€๋Šฅํ•œ ์ฐจ๋ณ„ํ™” ์ถ•. ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•์ธ: "Dart/Flutter ํŠนํ™” ๋”ฅ IDE ํฌ์ง€์…”๋‹์ด ๋งž์•„"
  • Impact: Seed spec C-03/AC-05. Discovery์˜ "ZedยทCursor ์ •๋ฉด ์Šน๋ถ€ ๊ธˆ์ง€" ๊ฒฝ๊ณ ๋Š” ์œ ์ง€ํ•˜๋˜, ์‹ค์ œ ๊ฒฝ์Ÿ ๋ถ„์„์˜ 1์ˆœ์œ„ ๋Œ€์ƒ์„ Orca๋กœ ๊ต์ฒด ํ•„์š”(Planning ๋‹จ๊ณ„์—์„œ ๊ฒฝ์Ÿ ๋ถ„์„ ๊ฐฑ์‹ )
  • Source: Socratic Interview (Level 4, B-02) + ๋ณด๊ฐ• ์กฐ์‚ฌ(WebSearch, 2026-08-25)

D-003: ๋กค๋ฐฑ + diff ๋ฆฌ๋ทฐ๋ฅผ MVP ํ•„์ˆ˜ ์•ˆ์ „๋ง์œผ๋กœ ํ™•์ •

  • Date: 2026-08-25
  • Context: ๋น„๋™๊ธฐ ์œ„์ž„(๋งก๊ธฐ๊ณ  ๋– ๋‚˜๊ธฐ) ๋ชจ๋ธ(A-04)์ด ํ™•์ •๋˜๋ฉด์„œ, ์—์ด์ „ํŠธ๊ฐ€ ์‚ฌ๋žŒ ์—†์ด ์ž˜๋ชป๋œ ๋ฐฉํ–ฅ์œผ๋กœ ์ง„ํ–‰ํ•  ์œ„ํ—˜์„ ์–ด๋–ป๊ฒŒ ์ฒ˜๋ฆฌํ• ์ง€๊ฐ€ Level 4 ๊ฒฝ๊ณ„ ์งˆ๋ฌธ(B-01)์œผ๋กœ ์ œ๊ธฐ๋จ
  • Options:
    1. MVP๋Š” ์ตœ์†Œ ๊ธฐ๋Šฅ์œผ๋กœ ์ถœ์‹œํ•˜๊ณ  ์•ˆ์ „๋ง(๋กค๋ฐฑ/diff)์€ ์ดํ›„ ์ถ”๊ฐ€
    2. ๋กค๋ฐฑ + diff ๋ฆฌ๋ทฐ๋ฅผ MVP ํ•„์ˆ˜ ์š”๊ตฌ์‚ฌํ•ญ์œผ๋กœ ํฌํ•จ
  • Decision: ์˜ต์…˜ 2
  • Rationale: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ๊ฐ•ํ•œ ํ™•์–ธ("ADE๋ฉด ๋‹น์—ฐํ•ด ๋กค๋ฐฑ๋„ ๊ฐ€๋Šฅํ•˜๊ณ  diff๋„ ์ œ๊ณตํ•ด์•ผ์ง€!"). Lumide์˜ local_history(ํŒŒ์ผ ๋ฒ„์ „ ์Šค๋ƒ…์ƒท, ์ตœ๋Œ€ 50๋ฒ„์ „/5MB) ์„ค๊ณ„์™€ ๊ฐ™์€ ์ถ•์œผ๋กœ, ์› ์„ค๊ณ„ ๋…ธํŠธ์—์„œ๋„ "์—์ด์ „ํŠธ๊ฐ€ ํŒŒ์ผ์„ ๊ฐˆ์•„์—Ž๋Š” ์‹œ๋Œ€์˜ ์•ˆ์ „๋ง"์œผ๋กœ ์ด๋ฏธ ์ง€๋ชฉ๋œ ํ•ญ๋ชฉ
  • Impact: Seed spec C-02/AC-01/AC-02, ๋„๋ฉ”์ธ ์—”ํ‹ฐํ‹ฐ EditSnapshot ์‹ ์„ค. Design ๋‹จ๊ณ„ ์•„ํ‚คํ…์ฒ˜์—์„œ ๋กœ์ปฌ ํžˆ์Šคํ† ๋ฆฌ ์ €์žฅ ๋ฐฉ์‹ ๊ตฌ์ฒดํ™” ํ•„์š”
  • Source: Socratic Interview (Level 4, B-01)

D-004: ๋ฐฐ์ œ ์นดํ…Œ๊ณ ๋ฆฌ ์—†์Œ โ€” ๋‹จ MVP ๋ฒ”์œ„๋Š” ๋ณ„๋„๋กœ ํ•œ์ •

  • Date: 2026-08-25
  • Context: "Dart๋กœ ๋ชป ๋งŒ๋“œ๋Š” ์†Œํ”„ํŠธ์›จ์–ด๋Š” ์—†๋‹ค"(A-05)๋Š” ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ์˜ ๊ฐ•ํ•œ ์ž…์žฅ๊ณผ, Discovery๊ฐ€ ์ด๋ฏธ ํ™•์ธํ•œ cocode ADE ์ž์ฒด ๊ตฌํ˜„ ๋ฆฌ์Šคํฌ(์—๋””ํ„ฐ ์ฝ”์–ด ์„ฑ๋Šฅ, ํ•œ๊ธ€ IME) ์‚ฌ์ด์˜ ์ธต์œ„ ๊ตฌ๋ถ„์ด ํ•„์š”ํ–ˆ์Œ(C-02 ๋ชจ์ˆœ ๊ฒ€์ฆ)
  • Options:
    1. "Dart๋กœ ๋ชป ๋งŒ๋“œ๋Š” ๊ฒŒ ์—†๋‹ค"๋ฅผ cocode ADE ์ž์ฒด ๊ตฌํ˜„ ๋ฒ”์œ„์—๋„ ๊ทธ๋Œ€๋กœ ์ ์šฉํ•ด, ๋ฆฌ์Šคํฌ ์ŠคํŒŒ์ดํฌ๋ฅผ ํ˜•์‹ ์ ˆ์ฐจ๋กœ ์ทจ๊ธ‰
    2. ์ด ๋ฏฟ์Œ์„ "์‚ฌ์šฉ์ž๊ฐ€ ๋งŒ๋“œ๋Š” ๊ฒฐ๊ณผ๋ฌผ"์˜ ์—ญ๋Ÿ‰ ๋ฒ”์œ„์— ๋Œ€ํ•œ ๊ฒƒ์œผ๋กœ ํ•œ์ •ํ•˜๊ณ , cocode ADE ์ž๊ธฐ ์ž์‹ ์˜ ๊ตฌํ˜„ ๋ฆฌ์Šคํฌ(์—๋””ํ„ฐ ์ฝ”์–ด)๋Š” ๋ณ„๋„๋กœ ๊ณ„์† ๊ฒŒ์ดํŒ… ๋ฆฌ์Šคํฌ๋กœ ๊ด€๋ฆฌ
  • Decision: ์˜ต์…˜ 2. ๋ฐฐ์ œ ์นดํ…Œ๊ณ ๋ฆฌ๋Š” ๋‘์ง€ ์•Š๋˜(๊ฒŒ์ž„ยท์ž„๋ฒ ๋””๋“œ ํฌํ•จ, B-03), MVP ๋ฒ”์œ„ ์ž์ฒด๋Š” D-001๋กœ ๋ณ„๋„ ํ•œ์ •๋จ
  • Rationale: ๋‘ ์ฃผ์žฅ์ด ์„œ๋กœ ๋‹ค๋ฅธ ์ธต์œ„(์ œํ’ˆ์ด ๋งŒ๋“ค ์ˆ˜ ์žˆ๋Š” ๊ฒƒ vs ์ œํ’ˆ ์ž์‹ ์„ ๋งŒ๋“œ๋Š” ๋ฆฌ์Šคํฌ)์ž„์„ ๋ช…ํ™•ํžˆ ๋ถ„๋ฆฌํ•ด์•ผ Discovery์˜ ๋ฆฌ์Šคํฌ ๊ด€๋ฆฌ๊ฐ€ ๋ฌดํšจํ™”๋˜์ง€ ์•Š์Œ. ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ๋„ ์ž์‹ ์˜ 7๋…„ ๊ฒฝ๋ ฅ์„ ๊ทผ๊ฑฐ๋กœ ๋ณ„๋„ ํ™•์–ธ
  • Impact: Seed spec C-05/AC-07, A-05/A-06/A-07(๋ณ„๊ฐœ ํ•ญ๋ชฉ์œผ๋กœ ์œ ์ง€)
  • Source: Socratic Interview (Level 3, C-02 / Level 4, B-03)

D-005: 1์ฐจ ๊ณ ๊ฐ์„ ์™ธ๋ถ€ Dart/Flutter ๊ฐœ๋ฐœ์ž ์‹œ์žฅ์œผ๋กœ ํ™•์ •

  • Date: 2026-08-25
  • Context: Discovery ยงRecommendations 1๋ฒˆ์ด "P1(์ฝ”์ฝ”๋“œ ๋‚ด๋ถ€ ๋„๊ทธํ‘ธ๋”ฉ) vs P2(์™ธ๋ถ€ ํŒ๋งค) vs ์ˆœ์ฐจ"๋ฅผ ๋ฏธํ•ด๊ฒฐ๋กœ ๋‚จ๊ฒผ๊ณ , ๋…๋ฆฝ Contrarian ๊ฒ€ํ† ๊ฐ€ ์ด๋ฅผ Critical ๋ฐ˜๋ก  CH-001/CH-027๋กœ ์ง€๋ชฉํ–ˆ๋‹ค โ€” C-01(๊ฐœ๋ฐœ์ž ์šฐ์„ )๊ณผ C-03(ํฌ์ง€์…”๋‹)์ด ๋ชจ๋‘ ์ด ๋ฏธํ•ด๊ฒฐ ์ž…๋ ฅ ์œ„์— ์„ธ์›Œ์ง„ ๋ถˆ๋ณ€ ์ œ์•ฝ์ด๋ผ๋Š” ์ง€์ 
  • Options:
    1. ์ฝ”์ฝ”๋“œ ๋‚ด๋ถ€ ๋„๊ทธํ‘ธ๋”ฉ ์šฐ์„  โ€” MVP ๋ฒ”์œ„๊ฐ€ ์ข์•„์ง€๊ณ  ๋ฆฌ์Šคํฌ๊ฐ€ ์ค„์ง€๋งŒ ์ถœ์‹œ๊ฐ€ ๋Šฆ์–ด์ง
    2. ์ฒ˜์Œ๋ถ€ํ„ฐ ์™ธ๋ถ€ ๊ฐœ๋ฐœ์ž ์‹œ์žฅ ๋Œ€์ƒ โ€” ๋„“์€ ์‹œ์žฅ์„ ๊ฒจ๋ƒฅํ•˜๋˜ ๊ฒ€์ฆ๋˜์ง€ ์•Š์€ ์™ธ๋ถ€ ์ˆ˜์š”์— ๋…ธ์ถœ
    3. ๊ตฌ๋ถ„ํ•˜์ง€ ์•Š์Œ โ€” CH-001์ด ์ง€์ ํ•œ ๋ชจํ˜ธํ•จ์ด ๊ทธ๋Œ€๋กœ ๋‚จ์Œ
  • Decision: ์˜ต์…˜ 2 โ€” ์ฒ˜์Œ๋ถ€ํ„ฐ ์™ธ๋ถ€ Dart/Flutter ๊ฐœ๋ฐœ์ž ์‹œ์žฅ
  • Rationale: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต(2026-08-25). Socratic ์ธํ„ฐ๋ทฐ A-01("์ฃผ ๊ณ ๊ฐ์€ ๊ฐœ๋ฐœ์ž")๊ณผ๋„ ์ผ๊ด€๋˜๋ฉฐ, Discovery๊ฐ€ ๋ถ„์„ํ•œ "๊ฐ€๊ฒฉ์˜ ๋นˆ ๊ตฌ๊ฐ„($5~9/์›”)"๊ณผ "Flutter ์ „์šฉ ํ™˜๊ฒฝ ๋ถ€์žฌ" ์‹œ์žฅ ๊ฐญ ๋…ผ๋ฆฌ๊ฐ€ ๋ชจ๋‘ ์™ธ๋ถ€ ์‹œ์žฅ์„ ์ „์ œ๋กœ ํ•œ ๊ฒƒ์ด์—ˆ์Œ
  • Impact: Seed spec v1.1.0 C-01์— 1์ฐจ ๊ณ ๊ฐ ์ •์˜ ํฌํ•จ, A-01 ํ™•์ • ์ƒํƒœ๋กœ ์ „ํ™˜. Contrarian CH-001/CH-027 ํ•ด์†Œ
  • Source: Contrarian Review (CH-001, CH-027) + ์‚ฌ์šฉ์ž ํ™•๋‹ต

D-006: MVP๋Š” agent์™€ acp๋ฅผ ๋ชจ๋‘ ํฌํ•จํ•œ๋‹ค

  • Date: 2026-08-25
  • Context: AC-06์ด "์ž์ฒด ๋Ÿฐํƒ€์ž„๊ณผ ์™ธ๋ถ€ ACP ํ˜ธ์ŠคํŒ… ๋‘˜ ๋‹ค MVP ํ•„์ˆ˜"๋กœ ๊ทœ์ •ํ–ˆ์œผ๋‚˜, Discovery์˜ 6๋‹จ๊ณ„ ๋กœ๋“œ๋งต์€ ACP๋ฅผ 3๋‹จ๊ณ„ยท์ž์ฒด ๋Ÿฐํƒ€์ž„์„ 5๋‹จ๊ณ„์— ๋ฐฐ์น˜ํ•ด MVP ์‹œ์ ์— agent๊ฐ€ ์—†๋‹ค๋Š” ๋ชจ์ˆœ์ด Contrarian CH-025(Critical)๋กœ ์ง€์ ๋จ
  • Options:
    1. acp๋งŒ์œผ๋กœ ๋จผ์ € ์ถœ์‹œ โ€” Discovery ๋กœ๋“œ๋งต๊ณผ ์ผ์น˜, ๋ชจ๋ธ ๊ณ„์•ฝ ์—†์ด ๋น ๋ฅธ ์ถœ์‹œ, ๋‹ค๋งŒ "๋ฉ€ํ‹ฐ LLM ์„ ํƒ"์ด๋ผ๋Š” ํ•ต์‹ฌ ๊ฐ€์น˜์ œ์•ˆ์ด MVP์— ๋ถ€์žฌ
    2. ๋‘˜ ๋‹ค MVP๋ถ€ํ„ฐ ํ•„์ˆ˜ โ€” ๊ฐœ๋ฐœ ๊ธฐ๊ฐ„์ด ๋Š˜์ง€๋งŒ ์ฒซ ์ถœ์‹œ๋ถ€ํ„ฐ ์™„์ „ํ•œ ๊ฐ€์น˜์ œ์•ˆ ์ œ๊ณต
  • Decision: ์˜ต์…˜ 2 โ€” ๋‘˜ ๋‹ค MVP ํ•„์ˆ˜. Seed spec์ด ์ง€๋ฐฐํ•˜๋ฉฐ, Discovery์˜ ๋‹จ๊ณ„ ์ˆœ์„œ๋Š” ๊ตฌํ˜„ ์ˆœ์„œ ์ œ์•ˆ์ผ ๋ฟ MVP ๋ฒ”์œ„ ์ •์˜๊ฐ€ ์•„๋‹˜์„ ๋ช…ํ™•ํžˆ ํ•จ
  • Rationale: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต(2026-08-25). Discovery๊ฐ€ ์ด๋ฏธ ๋ถ„์„ํ–ˆ๋“ฏ ACP ํ”„๋กœํ† ์ฝœ๋งŒ์œผ๋กœ๋Š” "OpenAI/Claude/Grok์„ ํ•œ ๋“œ๋กญ๋‹ค์šด์—์„œ" ๊ณ ๋ฅด๋Š” ๊ฒƒ์ด ๊ตฌ์กฐ์ ์œผ๋กœ ๋ถˆ๊ฐ€๋Šฅํ•˜๋ฏ€๋กœ(์—์ด์ „ํŠธ๊ฐ€ ๋…ธ์ถœํ•œ ๋ชฉ๋ก ์•ˆ์—์„œ๋งŒ ์„ ํƒ ๊ฐ€๋Šฅ), agent ์—†์ด๋Š” ๋ฉ€ํ‹ฐ LLM ๊ฐ€์น˜์ œ์•ˆ ์ž์ฒด๊ฐ€ ์„ฑ๋ฆฝํ•˜์ง€ ์•Š์Œ
  • Impact: Seed spec v1.1.0 AC-06์— ๊ฒ€์ฆ ๊ฐ€๋Šฅํ•œ ์ตœ์†Œ ์š”๊ฑด ๋ช…์‹œ(agent ํ”„๋กœ๋ฐ”์ด๋” 2๊ฐœ ์ด์ƒ, acp ์—์ด์ „ํŠธ 1๊ฐœ ์ด์ƒ). Planning ๋‹จ๊ณ„์—์„œ ๋กœ๋“œ๋งต ์ˆœ์„œ ์žฌ์กฐ์ • ํ•„์š”
  • Source: Contrarian Review (CH-025) + ์‚ฌ์šฉ์ž ํ™•๋‹ต

D-007: "์™„๋ฃŒ" ์ „์ด์— ์‚ฌ๋žŒ์˜ diff ์Šน์ธ์„ ์š”๊ตฌํ•˜์ง€ ์•Š๋Š”๋‹ค

  • Date: 2026-08-25
  • Context: Contrarian CH-004(Critical)๊ฐ€ "๋ฌด์ธ ์ž‘์—…์ด ์‚ฌ๋žŒ ๊ฒ€ํ†  ์—†์ด ์™„๋ฃŒ์— ๋„๋‹ฌํ•  ์ˆ˜ ์žˆ๋Š”์ง€" ์ŠคํŽ™์ด ์นจ๋ฌตํ•œ๋‹ค๊ณ  ์ง€์ . ์ด๋Š” C-02(diff/๋กค๋ฐฑ)์™€ C-04(๋น„๋™๊ธฐ ์œ„์ž„)์˜ ๊ด€๊ณ„๋ฅผ ์ •์˜ํ•˜๋Š” ๋ฌธ์ œ
  • Options:
    1. ์ž๊ฐ€ ๊ฒ€์ฆ๋งŒ์œผ๋กœ ์™„๋ฃŒ ๊ฐ€๋Šฅ โ€” C-04์˜ "์ž๋ฆฌ๋ฅผ ๋น„์šธ ์ˆ˜ ์žˆ๋‹ค"์™€ ์ •ํ•ฉ, diff๋Š” ์‚ฌํ›„ ์•ˆ์ „๋ง
    2. ์‚ฌ๋žŒ์˜ diff ์Šน์ธ์ด ์™„๋ฃŒ์˜ ์„ ํ–‰ ์กฐ๊ฑด โ€” ๋” ์•ˆ์ „ํ•˜๋‚˜ ๋น„๋™๊ธฐ ์œ„์ž„์˜ ํ•ต์‹ฌ ๊ฐ€์น˜๊ฐ€ ๋ฌด๋ ฅํ™”๋จ("์‚ฌ๋žŒ์ด ์ž๋ฆฌ๋ฅผ ๋น„์šฐ๋ฉด ์ž‘์—…์ด ๋ฉˆ์ถค")
  • Decision: ์˜ต์…˜ 1 โ€” ์ž๊ฐ€ ๊ฒ€์ฆ๋งŒ์œผ๋กœ ์™„๋ฃŒ ๊ฐ€๋Šฅ. diff ๋ฆฌ๋ทฐ๋Š” ์‚ฌํ›„ ์•ˆ์ „๋ง์ด๋ฉฐ ์„ ํ–‰ ๊ฒŒ์ดํŠธ๊ฐ€ ์•„๋‹˜
  • Rationale: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต(2026-08-25). ์˜ต์…˜ 2๋Š” C-04๊ฐ€ ๊ทœ์ •ํ•œ ๋น„๋™๊ธฐ ์œ„์ž„ ๋ชจ๋ธ๊ณผ ์ง์ ‘ ์ถฉ๋Œํ•˜๋ฉฐ, ๊ทธ๋ ‡๊ฒŒ ํ•˜๋ฉด ์ œํ’ˆ์˜ ํ•ต์‹ฌ ์ƒํ˜ธ์ž‘์šฉ์ด ๋™๊ธฐ ํŽ˜์–ดํ”„๋กœ๊ทธ๋ž˜๋ฐ์œผ๋กœ ๋˜๋Œ์•„๊ฐ. ๋Œ€์‹  ์•ˆ์ „์„ฑ์€ ๋‹ค๋ฅธ ๊ฒฝ๋กœ๋กœ ํ™•๋ณดํ•œ๋‹ค โ€” ์žฌ์‹œ๋„ ์ƒํ•œ(D-008), ๋กค๋ฐฑ ์›์ž์„ฑยท์ถฉ๋Œ ๊ฐ์ง€, ์ž๊ฐ€ ๊ฒ€์ฆ ์‹ ๋ขฐ๋„ ์‹ค์ธก(A-02 ์ŠคํŒŒ์ดํฌ)
  • Impact: Seed spec v1.1.0 DelegatedTask ๋ถˆ๋ณ€์‹ 2๋ฒˆ์— ๋ช…์‹œ. Contrarian CH-004 ํ•ด์†Œ, CH-012(๋™๊ธฐ ์šฐ์„  ๋Œ€์•ˆ)๋Š” ์ด ๊ฒฐ์ •์œผ๋กœ ๋ฐ˜๋ ค
  • Source: Contrarian Review (CH-004, CH-012) + ์‚ฌ์šฉ์ž ํ™•๋‹ต

D-008: ์ž๊ฐ€ ๊ฒ€์ฆ ์žฌ์‹œ๋„ ์ƒํ•œ์„ 3ํšŒ๋กœ ํ™•์ •

  • Date: 2026-08-25
  • Context: Contrarian CH-010(Critical)์ด "์žฌ์‹œ๋„ ํšŸ์ˆ˜ยทํƒ€์ž„์•„์›ƒยท๋น„์šฉ ํ•œ๋„๊ฐ€ ์–ด๋””์—๋„ ์—†์–ด, ๋ฌด์ธ ์ƒํƒœ์—์„œ ๋ฌดํ•œ์ • ์ž์›์„ ์†Œ๋ชจํ•  ์ˆ˜ ์žˆ๋‹ค"๊ณ  ์ง€์ . D-007๋กœ ์‚ฌ๋žŒ ๊ฒŒ์ดํŠธ๋ฅผ ์ œ๊ฑฐํ–ˆ๊ธฐ์— ์ด ์ƒํ•œ์ด ์œ ์ผํ•œ ์•ˆ์ „์žฅ์น˜๊ฐ€ ๋จ
  • Options:
    1. ์ตœ๋Œ€ 3ํšŒ ์žฌ์‹œ๋„ ํ›„ "์‹คํŒจ" ์ „์ด + ์—์Šค์ปฌ๋ ˆ์ด์…˜
    2. ์‹œ๊ฐ„ ๊ธฐ์ค€ ์ œํ•œ(์˜ˆ: 30๋ถ„)
  • Decision: ์˜ต์…˜ 1 โ€” ์ตœ๋Œ€ 3ํšŒ
  • Rationale: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต(2026-08-25). cc-product BMAD ์„ค์ •(references/bmad-config.md์˜ feedback.maxRetries: 3)๊ณผ ์ผ๊ด€๋˜๋ฉฐ, 3ํšŒ๋ฅผ ๋„˜์œผ๋ฉด ๋ฌธ๊ตฌ ์ˆ˜์ •์ด ์•„๋‹ˆ๋ผ ๋ฌธ์ œ ์ •์˜๋ฅผ ๋‹ค์‹œ ์žก์„ ์‹ ํ˜ธ๋กœ ๋ณด๋Š” ๋™์ผํ•œ ๋…ผ๋ฆฌ๊ฐ€ ์ ์šฉ๋จ
    • ์ •์ •(2026-08-26): ์ตœ์ดˆ ๊ธฐ์žฌ๋Š” ์ด ์„ ๋ก€๋ฅผ "cc-spec ์ž์ฒด์˜ ์ •์ฑ…(bmad.json)"์œผ๋กœ ๊ท€์†ํ–ˆ์œผ๋‚˜, 4์ฐจ ๊ฐ์‚ฌ ํ™•์ธ ๊ฒฐ๊ณผ bmad.json ํŒŒ์ผ์€ ์กด์žฌํ•˜์ง€ ์•Š์œผ๋ฉฐ ํ•ด๋‹น ์„ค์ •์€ cc-product์˜ ์ฐธ์กฐ ๋ฌธ์„œ์— ์ •์˜๋˜์–ด ์žˆ๋‹ค. ์„ ๋ก€ ์ž์ฒด๋Š” ์‹ค์žฌํ•˜๋ฏ€๋กœ ๊ทผ๊ฑฐ๋Š” ์œ ์ง€ํ•˜๋˜ ์ถœ์ฒ˜๋ฅผ ์ •์ •ํ•œ๋‹ค
  • Impact: Seed spec v1.1.0 C-04 ํ›„๋‹จ + DelegatedTask์— "์‹คํŒจ" ์ƒํƒœ ์‹ ์„ค + AC-07. Contrarian CH-010/CH-021 ํ•ด์†Œ
  • Source: Contrarian Review (CH-010, CH-021) + ์‚ฌ์šฉ์ž ํ™•๋‹ต

D-009: Simplifier ์ œ์•ˆ 3๊ฑด ์ „๋Ÿ‰ ์ˆ˜์šฉ

  • Date: 2026-08-25
  • Context: ๋…๋ฆฝ Simplifier ๊ฒ€ํ†  ๊ฒฐ๊ณผ v1.0.0 ๋ณต์žก๋„ 29.5(Caution, Excessive ์ž„๊ณ„ 31 ๊ทผ์ ‘). ์„ธ ๊ฑด์˜ ๋‹จ์ˆœํ™” ์ œ์•ˆ์ด ์ œ์‹œ๋จ
  • Options: ๊ฐ ์ œ์•ˆ๋ณ„ Accept / Reject / Defer
  • Decision: S-001(๋ฐฐ์ œ ์นดํ…Œ๊ณ ๋ฆฌ ์—†์Œ ํด๋Ÿฌ์Šคํ„ฐ ์ œ๊ฑฐ โ€” C-05/AC-07/A-05), S-002(๋“œ๋ฆฌ๋จธ ๋ชจ๋“œ ์šด์˜ ๋ชจ๋ธ ๊ฐ€์ • A-02 ์ œ๊ฑฐ), S-003(AgentBackend ์—”ํ‹ฐํ‹ฐ๋ฅผ DelegatedTask๋กœ ํ†ตํ•ฉ) ์ „๋Ÿ‰ Accept
  • Rationale: ์„ธ ์ œ์•ˆ ๋ชจ๋‘ Contrarian Critical/Major ๋ฐ˜๋ก ๊ณผ ์ •ํ™•ํžˆ ๊ฐ™์€ ํ•ญ๋ชฉ์„ ์ง€๋ชฉํ–ˆ๋‹ค โ€” S-001์€ CH-013(Critical), S-002๋Š” CH-028(Critical), S-003์€ CH-026(Major)์˜ ์ง์ ‘ ํ•ด์†Œ์ฑ…. ์ฆ‰ ๋‹จ์ˆœํ™”์™€ ์•ˆ์ „์„ฑ ๊ฐœ์„ ์ด ๊ฐ™์€ ๋ฐฉํ–ฅ์ด์—ˆ์Œ. ์„ธ ์ œ์•ˆ ๋ชจ๋‘ ํ•ต์‹ฌ ๊ฐ€์น˜ ํด๋Ÿฌ์Šคํ„ฐ(๋น„๋™๊ธฐ ์œ„์ž„ + diff/๋กค๋ฐฑ ์•ˆ์ „๋ง)๋ฅผ ๊ฑด๋“œ๋ฆฌ์ง€ ์•Š์Œ
  • Impact: ์—”ํ‹ฐํ‹ฐ 4โ†’3, ๋ถˆ๋ณ€ ์ œ์•ฝ 5โ†’4, ๋ฏธ๊ฒ€์ฆ ๊ฐ€์ • 5โ†’4. ๋‹จ Critical ๋ฐ˜๋ก  ํ•ด์†Œ๋ฅผ ์œ„ํ•ด ๋ถˆ๋ณ€์‹ยทACยทNFR์„ ์ถ”๊ฐ€ํ•œ ๊ฒฐ๊ณผ ์ตœ์ข… ๋ณต์žก๋„๋Š” 34.5๋กœ ์˜คํžˆ๋ ค ์ƒ์Šน โ€” ์ด๋Š” ๊ธฐ๋Šฅ ์ถ”๊ฐ€๊ฐ€ ์•„๋‹ˆ๋ผ ๊ธฐ์กด ์š”๊ตฌ์˜ ๊ฒ€์ฆ ๊ฐ€๋Šฅํ•œ ๋ถ„ํ•ด์ด๋ฏ€๋กœ ์˜๋„๋œ ์ฆ๊ฐ€๋กœ ํŒ๋‹จ(docs/simplifier-review-cocode.md ๋ง๋ฏธ ์ฐธ๊ณ )
  • Source: Simplifier Suggestion (S-001, S-002, S-003)

D-010: ๋ฏธ๊ฒ€์ฆ ๋ฏฟ์Œ์„ ๋ถˆ๋ณ€ ์ œ์•ฝ์—์„œ ๋ถ„๋ฆฌํ•ด ๊ฐ€์ •์œผ๋กœ ๊ฒฉํ•˜

  • Date: 2026-08-25
  • Context: Contrarian CH-011/CH-030(๋‘˜ ๋‹ค Critical)์ด "A-04๊ฐ€ ์Šค์Šค๋กœ '๊ธฐ์ˆ  ๊ฒ€์ฆ ๋ฏธ์™„๋ฃŒ'๋ผ ์ธ์ •ํ•˜๋Š”๋ฐ๋„ C-04๋ผ๋Š” ๋ถˆ๋ณ€ ์ œ์•ฝ์œผ๋กœ ์Šน๊ฒฉ๋๊ณ , ์—์ด์ „ํŠธ๊ฐ€ ์ž๊ธฐ ๊ฒ€์ฆ์„ ํ˜•์‹์ ์œผ๋กœ ํ†ต๊ณผ์‹œํ‚ค๋Š” ์‹คํŒจ ๋ชจ๋“œ๋ฅผ ์•„๋ฌด๋„ ๋‹ค๋ฃจ์ง€ ์•Š๋Š”๋‹ค"๊ณ  ์ง€์ 
  • Options:
    1. C-04๋ฅผ ๊ทธ๋Œ€๋กœ ๋‘๊ณ  ๋ฆฌ์Šคํฌ๋ฅผ ์ธ์ˆ˜
    2. ์ œ์•ฝ๊ณผ ๋ฏฟ์Œ์„ ๋‘ ์ธต์œ„๋กœ ๋ถ„๋ฆฌ โ€” ์ œ์•ฝ์€ ๊ฒ€์ฆ ๊ฐ€๋Šฅํ•œ ํ–‰์œ„๋งŒ ๊ทœ์ •ํ•˜๊ณ , ๊ฒ€์ฆ๋˜์ง€ ์•Š์€ ๋ฏฟ์Œ์€ ๊ฐ€์ •์œผ๋กœ ๊ฒฉํ•˜ํ•ด ์‹ค์ธก ๊ณ„ํš์„ ๋ถ™์ž„
  • Decision: ์˜ต์…˜ 2
  • Rationale: ๋ถˆ๋ณ€ ์ œ์•ฝ์€ ์ž ๊ธˆ ํ›„ ์ˆ˜์ • ๋ถˆ๊ฐ€ํ•˜๋ฏ€๋กœ, ๋ฏธ๊ฒ€์ฆ ๋ฏฟ์Œ์ด ๊ทธ ์•ˆ์— ์„ž์ด๋ฉด ๋‚˜์ค‘์— ๋ฐ˜์ฆ๋ผ๋„ ๊ณ ์น  ์ˆ˜ ์—†๋‹ค. C-04๋Š” "์ž๊ฐ€ ๊ฒ€์ฆ์„ ํ•œ๋‹ค + ๋ฐฉ๋ฒ•์€ 4์ข… ํ์‡„ ์ง‘ํ•ฉ + ์žฌ์‹œ๋„ 3ํšŒ"๋ผ๋Š” ๊ฒ€์ฆ ๊ฐ€๋Šฅํ•œ ํ–‰์œ„๋งŒ ๊ทœ์ •ํ•˜๊ณ , "์ž๊ฐ€ ๊ฒ€์ฆ์ด ์‚ฌ๋žŒ ํŒ๋‹จ์„ ๋Œ€์ฒดํ•  ๋งŒํผ ์‹ ๋ขฐํ•  ์ˆ˜ ์žˆ๋Š”๊ฐ€"๋Š” ๊ฐ€์ • A-02๋กœ ๋ถ„๋ฆฌํ•ด Design ๋‹จ๊ณ„ ์ด์ „ ์ŠคํŒŒ์ดํฌ(์˜๋„์  ๊ฒฐํ•จ N๊ฑด ์œ„์ž„ โ†’ ๊ฒ€์ถœ๋ฅ  ์‹ค์ธก)๋ฅผ ๋ฐฐ์ •ํ–ˆ๋‹ค
  • Impact: Seed spec v1.1.0 C-04(ํ–‰์œ„ ๊ทœ์ •) / A-02(๋ฏฟ์Œ + ๊ฒ€์ฆ ๋ฐฉ๋ฒ•) ๋ถ„๋ฆฌ. Contrarian CH-011/CH-030 ํ•ด์†Œ. ์ด ์›์น™์€ A-03(re_editor ์„ฑ๋Šฅ), A-04(ํ•œ๊ธ€ IME), A-05(ACP v1/v2)์—๋„ ๋™์ผํ•˜๊ฒŒ ์ ์šฉ๋จ
  • Source: Contrarian Review (CH-011, CH-030)

D-011: C-03 ํฌ์ง€์…”๋‹์˜ ๊ณ ๊ฐ ๋ฏธ๊ฒ€์ฆ ์‚ฌ์‹ค์„ ์ธ์ •ํ•˜๊ณ  ์œ„ํ—˜ ์ธ์ˆ˜

  • Date: 2026-08-26
  • Context: ์ ๋Œ€์  ๊ฐ์‚ฌ๊ฐ€ Contrarian ๋ณด๊ณ ์„œ์˜ CH-009 "ํ•ด์†Œ" ์ฃผ์žฅ์„ ๊ธฐ๊ฐํ–ˆ๋‹ค. ๊ฐ์‚ฌ ํŒ์ •: v1.1.0์ด C-03์— ์ถ”๊ฐ€ํ•œ "๋น„-Dart ํŒŒ์ผ ํŽธ์ง‘ ํ—ˆ์šฉ" ์กฐํ•ญ์€ CH-007(ํŒŒ์ผ ์ˆ˜์ค€ ๊ฒฝ๊ณ„)์„ ๊ณ ์นœ ๊ฒƒ์ด๋ฉฐ, CH-009๊ฐ€ ์ง€์ ํ•œ ์ง„์งœ ๋ฌธ์ œ โ€” ์ˆ˜์ง ๊นŠ์ด ํฌ์ง€์…”๋‹์ด ๊ณ ๊ฐ ๋ฆฌ์„œ์น˜๊ฐ€ ์•„๋‹ˆ๋ผ ์˜ค๋„ˆ ๊ฐœ์ธ ํŒ๋‹จ์— ๊ทผ๊ฑฐํ•œ๋‹ค๋Š” ์ธ์‹๋ก ์  ๊ณต๋ฐฑ โ€” ๋Š” ์†๋Œ€์ง€ ์•Š์€ ์ฑ„ "์˜ค๋„ˆ๊ฐ€ ๊ฒฐ์ •ํ–ˆ๋‹ค"๋กœ ์žฌ์ฒœ๋ช…ํ–ˆ์„ ๋ฟ์ด๋ผ๋Š” ๊ฒƒ. ๊ฐ™์€ ๋ณด๊ณ ์„œ๊ฐ€ ๊ตฌ์กฐ์ ์œผ๋กœ ๋™์ผํ•œ CH-008์„ "์œ„ํ—˜ ์ธ์ˆ˜"๋กœ ์ •์งํ•˜๊ฒŒ ๋ถ„๋ฅ˜ํ•œ ๊ฒƒ๊ณผ ๋Œ€๋น„๋œ๋‹ค๋Š” ์ง€์ ๋„ ํ•จ๊ป˜ ๋ฐ›์•˜๋‹ค
  • Options:
    1. Resolved ์ฃผ์žฅ์„ ์œ ์ง€ โ€” ๊ฐ์‚ฌ ํŒ์ •์„ ๋ฌด์‹œํ•˜๊ฒŒ ๋˜๋ฉฐ, ๊ทผ๊ฑฐ ์—†๋Š” ํ•ด์†Œ ์ฃผ์žฅ์ด ๊ฒŒ์ดํŠธ ์‚ฐ์ถœ๋ฌผ์— ๋‚จ์Œ
    2. Accepted(์œ„ํ—˜ ์ธ์ˆ˜)๋กœ ์žฌ๋ถ„๋ฅ˜ํ•˜๊ณ , ๋ฏธ๊ฒ€์ฆ ์‚ฌ์‹ค์„ C-03 ๋ณธ๋ฌธ๊ณผ ๊ฐ€์ • ๋ชฉ๋ก์— ๋ช…์‹œ
    3. C-03 ์ž ๊ธˆ์„ ๋ณด๋ฅ˜ํ•˜๊ณ  ๊ณ ๊ฐ ๊ฒ€์ฆ ํ›„ ์žฌ๊ฒฐ์ • โ€” MVP ์ฐฉ์ˆ˜๊ฐ€ ๋ฆฌ์„œ์น˜ ์™„๋ฃŒ๊นŒ์ง€ ์ง€์—ฐ๋จ
  • Decision: ์˜ต์…˜ 2 โ€” CH-009๋ฅผ Accepted๋กœ ์žฌ๋ถ„๋ฅ˜. C-03 ๋ณธ๋ฌธ์— "์ด ํฌ์ง€์…”๋‹์€ ๊ณ ๊ฐ ๋ฆฌ์„œ์น˜๊ฐ€ ์•„๋‹ˆ๋ผ ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ์˜ ํŒ๋‹จ์— ๊ทผ๊ฑฐํ•œ๋‹ค"๋ฅผ ๊ฒฝ๊ณ  ํ‘œ์‹œ์™€ ํ•จ๊ป˜ ๋ช…์‹œํ•˜๊ณ , ๋ณ„๋„ ๊ฐ€์ • A-07("Dart/Flutter ๊ฐœ๋ฐœ์ž๊ฐ€ ์ˆ˜ํ‰์  ๋„“์ด๋ณด๋‹ค ์ˆ˜์ง์  ๊นŠ์ด๋ฅผ ์„ ํ˜ธํ•œ๋‹ค")์„ ์‹ ์„คํ•ด MVP ์ถœ์‹œ ํ›„ ๊ฒ€์ฆ ๋Œ€์ƒ์œผ๋กœ ์ถ”์ 
  • Rationale: ์˜ต์…˜ 1์€ ์ •์งํ•˜์ง€ ์•Š๋‹ค โ€” ๊ฐ์‚ฌ์˜ ํŒ์ •์ด ์ •ํ™•ํ–ˆ๋‹ค. ์˜ต์…˜ 3์€ ๊ณผ์ž‰ ๋Œ€์‘์ด๋‹ค: ์ด ํ”„๋กœ์ ํŠธ๋Š” ์˜ค๋„ˆ์˜ ํ™•์‹ ์ด ๊ณง ์ฐฉ์ˆ˜ ๊ทผ๊ฑฐ์ธ ๋‹จ๊ณ„์ด๋ฉฐ, ๊ณ ๊ฐ ๊ฒ€์ฆ์„ ์„ ํ–‰ ์กฐ๊ฑด์œผ๋กœ ๊ฑธ๋ฉด ์•„๋ฌด๊ฒƒ๋„ ์‹œ์ž‘ํ•  ์ˆ˜ ์—†๋‹ค. ์œ„ํ—˜์„ ์ธ์ˆ˜ํ•˜๋˜ ๊ทธ ์œ„ํ—˜์ด ๋ฌด์—‡์ธ์ง€ ๋ฌธ์„œ์— ๋‚จ๊ธฐ๋Š” ๊ฒƒ์ด ์˜ฌ๋ฐ”๋ฅธ ์ฒ˜๋ฆฌ๋‹ค. ์ด๋Š” CH-008(๊ฒฝ์Ÿ์‚ฌ๊ฐ€ Flutter ๊นŠ์ด๋ฅผ ๋”ฐ๋ผ์˜ฌ ์œ„ํ—˜)์„ ์ด๋ฏธ ๊ฐ™์€ ๋ฐฉ์‹์œผ๋กœ ์ฒ˜๋ฆฌํ•œ ๊ฒƒ๊ณผ ์ผ๊ด€๋œ๋‹ค
  • Impact: Seed spec v1.2.0 C-03 ๊ฒฝ๊ณ  ๋ฌธ๊ตฌ + A-07 ์‹ ์„ค. Contrarian ๋ณด๊ณ ์„œ์˜ CH-009 ํŒ์ •์„ Resolved โ†’ Accepted๋กœ ์ •์ •
  • Source: ์ ๋Œ€์  ๊ฐ์‚ฌ (2026-08-26) โ€” Contrarian ๋ณด๊ณ ์„œ CH-009 ์žฌ๊ฒ€ํ† 

D-012: A-02 ์‹คํŒจ ์‹œ ์‚ฌ๋žŒ ์Šน์ธ ๋ชจ๋“œ๋กœ ์ž๋™ ์ „ํ™˜ํ•˜๋Š” ์กฐํ•ญ์„ ์ž ๊ธˆ ์ „์— ๋ช…์‹œ

  • Date: 2026-08-26
  • Context: ์ ๋Œ€์  ๊ฐ์‚ฌ๊ฐ€ CH-011/CH-030์˜ "ํ•ด์†Œ" ์ฃผ์žฅ๋„ ๊ธฐ๊ฐํ–ˆ๋‹ค. ๊ฐ์‚ฌ ํŒ์ •: v1.1.0์€ ๋ฏธ๊ฒ€์ฆ ๋ฏฟ์Œ์„ ๊ฐ€์ • A-02๋กœ ๋ถ„๋ฆฌํ–ˆ๋‹ค๊ณ  ์ฃผ์žฅํ–ˆ์ง€๋งŒ, ์ •์ž‘ ๊ทธ ๋ฏฟ์Œ์ด ๋’ท๋ฐ›์นจํ•˜๋Š” ํ–‰๋™(๋น„๋™๊ธฐยท์ž๊ฐ€๊ฒ€์ฆ๋งŒ์œผ๋กœ ์™„๋ฃŒยท์‚ฌ๋žŒ ๊ฒŒ์ดํŠธ ์—†์Œ)์€ C-04(๋ถˆ๋ณ€ ์ œ์•ฝ)์™€ DelegatedTask ๋ถˆ๋ณ€์‹(์ถ”๊ฐ€๋งŒ ํ—ˆ์šฉ) ์–‘์ชฝ์— ๊ทธ๋Œ€๋กœ ์ž ๊ธด ์ƒํƒœ๋‹ค. A-02 ์ŠคํŒŒ์ดํฌ๊ฐ€ ์‹คํŒจํ•ด๋„ ๊ทธ ์„ค๊ณ„๋ฅผ ๋˜๋Œ๋ฆด ์žฅ์น˜๊ฐ€ ์—†์œผ๋ฏ€๋กœ, ๋ฐ˜๋ก ์ด ๊ฒฝ๊ณ ํ•œ ์ž ๊ธˆ ์‹คํŒจ ๋ชจ๋“œ๋ฅผ ํ•ด์†Œํ•œ ๊ฒŒ ์•„๋‹ˆ๋ผ ์žฌํ˜„ํ–ˆ๋‹ค๋Š” ๊ฒƒ
  • Options:
    1. ๋Œ€๋น„์ฑ… ์—†์ด ๊ฐ์ˆ˜ โ€” ์ž๊ฐ€ ๊ฒ€์ฆ์ด ๋œ๋‹ค๋Š” ์ชฝ์— ๊ฑธ๊ณ , ์‹คํŒจ ์‹œ ๋ถˆ๋ณ€ ์ œ์•ฝ์„ ์œ„๋ฐ˜ํ•˜๋ฉฐ ์ŠคํŽ™์„ ๊ณ ์นจ
    2. C-04์— ์ „ํ™˜ ์กฐํ•ญ์„ ๋ฏธ๋ฆฌ ์จ๋„ฃ์Œ โ€” ์ŠคํŒŒ์ดํฌ ๋ฏธ๋‹ฌ ์‹œ "์‚ฌ๋žŒ diff ์Šน์ธ ํ›„ ์™„๋ฃŒ" ๋ชจ๋“œ๋กœ ์ž๋™ ์ „ํ™˜ํ•œ๋‹ค๊ณ  ์ž ๊ธˆ ์ „์— ๊ทœ์ •
    3. ์ž‘์—… ์œ ํ˜•๋ณ„ ์ฐจ๋“ฑ โ€” ํ…Œ์ŠคํŠธ ์ปค๋ฒ„๋ฆฌ์ง€๊ฐ€ ์žˆ๋Š” ์ž‘์—…๋งŒ ์ž๊ฐ€ ๊ฒ€์ฆ์œผ๋กœ ์™„๋ฃŒ
  • Decision: ์˜ต์…˜ 2 โ€” ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต(2026-08-26)
  • Rationale: ์˜ต์…˜ 1์€ ๊ฐ์‚ฌ๊ฐ€ ์ง€์ ํ•œ ๋ฐ”๋กœ ๊ทธ ์‹คํŒจ ๋ชจ๋“œ๋‹ค. ์˜ต์…˜ 2์˜ ํ•ต์‹ฌ์€ ์ „ํ™˜์ด ์ œ์•ฝ ์œ„๋ฐ˜์ด ์•„๋‹ˆ๋ผ ์ œ์•ฝ์ด ๋ฏธ๋ฆฌ ๊ทœ์ •ํ•œ ๋™์ž‘์ด ๋œ๋‹ค๋Š” ์ ์ด๋‹ค โ€” ๋ถˆ๋ณ€ ์ œ์•ฝ์˜ ์ทจ์ง€(ํ•จ๋ถ€๋กœ ๋ฐ”๊พธ์ง€ ๋ชปํ•˜๊ฒŒ ํ•จ)๋ฅผ ์ง€ํ‚ค๋ฉด์„œ๋„ ๋ฏธ๊ฒ€์ฆ ๊ฐ€์ • ์œ„์— ๋˜๋Œ๋ฆด ์ˆ˜ ์—†๋Š” ์„ค๊ณ„๋ฅผ ์–น์ง€ ์•Š๋Š”๋‹ค. ์˜ต์…˜ 3์€ ๋” ์ •๊ตํ•˜๋‚˜ ์ŠคํŽ™ ๋ณต์žก๋„๋ฅผ ๋†’์ด๊ณ , ์ „ํ™˜ ์กฐํ•ญ์œผ๋กœ๋„ ๊ฐ™์€ ์•ˆ์ „์„ฑ์„ ํ™•๋ณดํ•  ์ˆ˜ ์žˆ๋‹ค
  • Impact: Seed spec v1.2.0 C-04 ์ „ํ™˜ ์กฐํ•ญ + DelegatedTask์— completion_mode ์†์„ฑ ๋ฐ "์‚ฌ๋žŒ์Šน์ธ๋Œ€๊ธฐ" ์ƒํƒœ ์‹ ์„ค + AC-10(๊ฒ€์ถœ๋ฅ  30๊ฑด/80% ๊ธฐ์ค€). Contrarian ๋ณด๊ณ ์„œ CH-011/CH-030 ํ•ด์†Œ
  • Source: ์ ๋Œ€์  ๊ฐ์‚ฌ (2026-08-26) + ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต

D-013: ๊ทผ๊ฑฐ ์—†๋Š” ์„ฑ๋Šฅ ๋ชฉํ‘œ์น˜(NFR-01)๋ฅผ ๊ฐ€์ •์œผ๋กœ ๊ฐ•๋“ฑ

  • Date: 2026-08-26
  • Context: ์ ๋Œ€์  ๊ฐ์‚ฌ๊ฐ€ v1.1.0์˜ ์‹ ๊ทœ ๊ฒฐํ•จ์œผ๋กœ ์ง€์  โ€” NFR-01์˜ ์ˆ˜์น˜(์„ค์น˜ 150MB / ์ฝœ๋“œ ์Šคํƒ€ํŠธ 2์ดˆ / ์œ ํœด ๋ฉ”๋ชจ๋ฆฌ 400MB)๋Š” ๋ฌธ์„œ ์ „์ฒด ์–ด๋””์—๋„ ๊ทผ๊ฑฐยท๊ธฐ์ค€์„ ยท๊ฒ€์ฆ ๋ฐฉ๋ฒ•์ด ์—†์ด ๊ณง๋ฐ”๋กœ Must ์š”๊ตฌ์‚ฌํ•ญ์œผ๋กœ ์ž ๊ฒผ๋‹ค. ํ˜•์ œ ํ•ญ๋ชฉ์ธ NFR-02/NFR-03์ด ๊ฐ๊ฐ ์ถ”์ ๋œ ๊ฐ€์ •(A-03/A-04)๊ณผ ์ŠคํŒŒ์ดํฌ ๊ณ„ํš์— ์—ฐ๊ฒฐ๋œ ๊ฒƒ๊ณผ ๋Œ€์กฐ์ ์ด๋ฉฐ, ๊ฐ์‚ฌ๋Š” ์ด๋ฅผ "๋‹ค๋ฅธ ๊ณณ์—์„œ๋Š” Critical๋กœ ์ทจ๊ธ‰ํ•˜๋Š” ๋ฐ”๋กœ ๊ทธ ํŒจํ„ด(๊ฒ€์ฆ๋˜์ง€ ์•Š์€ ์ˆ˜์น˜๋ฅผ ์ž ๊ธด ๊ฒŒ์ดํŠธ๋กœ ์Šน๊ฒฉ)"์ด๋ผ๊ณ  ํŒ์ •ํ–ˆ๋‹ค. ์ด ์ˆ˜์น˜๋“ค์€ ์ž‘์„ฑ์ž(Claude)๊ฐ€ ์ถ”์ •์œผ๋กœ ๋งŒ๋“ค์–ด๋‚ธ ๊ฒƒ์ด๋ฉฐ ์‚ฌ์šฉ์ž๊ฐ€ ์ œ์‹œํ•œ ๊ฐ’์ด ์•„๋‹ˆ๋‹ค
  • Options:
    1. ๊ฐ€์ •์œผ๋กœ ๊ฐ•๋“ฑ ํ›„ ์ŠคํŒŒ์ดํฌ๋กœ ํ™•์ • โ€” NFR-01์€ "A-06 ์ŠคํŒŒ์ดํฌ์—์„œ ํ™•์ •ํ•œ ๋ชฉํ‘œ์น˜๋ฅผ ์ถฉ์กฑํ•œ๋‹ค"๋กœ ๋ฐ”๊พธ๊ณ , ์‹ค์ธก ํ›„ ์ˆ˜์น˜๋ฅผ ์ฑ„์›€
    2. ์ œ์•ˆ๋œ ์ˆ˜์น˜ ์œ ์ง€ โ€” 150MB/2์ดˆ/400MB๋ฅผ ๊ฒฝ์Ÿ ์•ฝ์†์œผ๋กœ ๋ฐ›์•„๋“ค์ž„
    3. ์˜ค๋„ˆ๊ฐ€ ์ง์ ‘ ์ˆ˜์น˜ ์ง€์ •
  • Decision: ์˜ต์…˜ 1 โ€” ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต(2026-08-26)
  • Rationale: ๊ฒ€์ฆ๋˜์ง€ ์•Š์€ ์ˆซ์ž๋ฅผ ์ž ๊ทธ๋Š” ๊ฒƒ์€ ์ด ์ŠคํŽ™์ด ๋‹ค๋ฅธ ๊ณณ(CH-013, CH-033, CH-034)์—์„œ ์ผ๊ด€๋˜๊ฒŒ ๊ฑฐ๋ถ€ํ•ด ์˜จ ํŒจํ„ด์ด๋‹ค. Lumide ์‹ค์ธก 55.8MB๊ฐ€ ํ•˜ํ•œ ์ฐธ์กฐ์ ์œผ๋กœ ์กด์žฌํ•˜์ง€๋งŒ, cocode ADE๋Š” ์ž์ฒด ์—์ด์ „ํŠธ ๋Ÿฐํƒ€์ž„์„ ํฌํ•จํ•˜๋ฏ€๋กœ ๊ทธ ๊ฐ’์„ ๊ทธ๋Œ€๋กœ ๋ชฉํ‘œ๋กœ ์‚ผ์„ ๊ทผ๊ฑฐ๊ฐ€ ์—†๋‹ค. ๋กœ๋“œ๋งต 1๋‹จ๊ณ„์—์„œ ์ตœ์†Œ ์…ธ์„ ์กฐ๋ฆฝํ•œ ๋’ค ์‹ค์ธกํ•˜๊ณ , ๊ทธ ๊ฒฐ๊ณผ๋ฅผ ๊ทผ๊ฑฐ๋กœ ๋ชฉํ‘œ๋ฅผ ํ™•์ •ํ•˜๋Š” ๊ฒƒ์ด ์ด ๋ฌธ์„œ์˜ ๋‹ค๋ฅธ NFR๊ณผ ์ผ๊ด€๋œ ์ฒ˜๋ฆฌ๋‹ค
  • Impact: Seed spec v1.2.0 NFR-01์„ A-06 ์ฐธ์กฐ๋กœ ๋ณ€๊ฒฝ + A-06 ์‹ ์„ค(์šฉ๋Ÿ‰ยท์„ฑ๋Šฅ ๋ชฉํ‘œ ๋ฏธํ™•์ •, ๋กœ๋“œ๋งต 1๋‹จ๊ณ„ ์ŠคํŒŒ์ดํฌ๋กœ ํ™•์ •)
  • Source: ์ ๋Œ€์  ๊ฐ์‚ฌ (2026-08-26) + ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต

D-014: ์—์ด์ „ํŠธ์˜ ๊ธฐ์กด ํ…Œ์ŠคํŠธ ์ˆ˜์ •์„ ๊ธˆ์ง€ํ•œ๋‹ค

  • Date: 2026-08-26
  • Context: ์ ๋Œ€์  ๊ฐ์‚ฌ๊ฐ€ CH-030์„ 3์ฐจ์—์„œ๋„ ๋ฏธํ•ด์†Œ๋กœ ํŒ์ •ํ–ˆ๋‹ค. ํŒ์ • ์š”์ง€: AC-10(๋‹น์‹œ)์€ ์ œ3์ž๊ฐ€ ์ฃผ์ž…ํ•œ ๊ฒฐํ•จ์˜ ๊ฒ€์ถœ๋ฅ ์„ ์žฌ๋Š”๋ฐ, CH-030์ด ์ง€์ ํ•œ ์‹คํŒจ ๋ชจ๋“œ๋Š” ๋‚ด์ƒ์ ์ด๋‹ค โ€” ์—์ด์ „ํŠธ๊ฐ€ ๋ณ€๊ฒฝ๊ณผ ๊ทธ ๊ฒ€์ฆ์„ ๋ชจ๋‘ ์ž‘์„ฑํ•˜๋ฉด์„œ ๊ฒ€์ฆ์ด ํ†ต๊ณผํ•˜๋„๋ก ๋ชจ์–‘์„ ๋งž์ถ”๋Š” ๊ฒƒ(๋‹จ์–ธ ์•ฝํ™”, ์ž๊ธฐ ๋ฒ„๊ทธ๋ฅผ ๊ทธ๋Œ€๋กœ ์ธ์ฝ”๋”ฉํ•œ ํ…Œ์ŠคํŠธ ์ž‘์„ฑ, ์ผ€์ด์Šค ๋ˆ„๋ฝ). ์ฃผ์ž… ๊ฒฐํ•จ ๊ฒ€์ถœ๋ฅ ์ด 100%์—ฌ๋„ ์ž๊ธฐ ์‚ฐ์ถœ๋ฌผ์— ๋Œ€ํ•ด์„œ๋Š” ์—ฌ์ „ํžˆ ๋ฌด๋ ฅํ•  ์ˆ˜ ์žˆ๋‹ค๋Š” ์‹คํ—˜ ์„ค๊ณ„์ƒ์˜ ์ง€์ ์ด๋ฉฐ, ํƒ€๋‹นํ•˜๋‹ค
  • Options:
    1. ๊ธฐ์กด ํ…Œ์ŠคํŠธ ์ˆ˜์ • ๊ธˆ์ง€ โ€” ์—์ด์ „ํŠธ๋Š” ํ…Œ์ŠคํŠธ๋ฅผ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์œผ๋‚˜ ์•ฝํ™”ยท๋น„ํ™œ์„ฑํ™”ยท์‚ญ์ œํ•  ์ˆ˜ ์—†๊ณ , ๊ธฐ์กด ํ…Œ์ŠคํŠธ ๋ณ€๊ฒฝ์€ ์‚ฌ๋žŒ ์Šน์ธ ํ•„์š”
    2. ํ…Œ์ŠคํŠธ ๋ณ€๊ฒฝ์„ diff์—์„œ ๊ฐ•์กฐ ํ‘œ์‹œ๋งŒ โ€” ์ œํ•œํ•˜์ง€ ์•Š๊ณ  ์‚ฌํ›„ ๋ฆฌ๋ทฐ ์‹œ ๋ˆˆ์— ๋„๊ฒŒ ํ•จ
    3. Planning์œผ๋กœ ๋ฏธ๋ฃธ
  • Decision: ์˜ต์…˜ 1 โ€” ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต(2026-08-26)
  • Rationale: ์˜ต์…˜ 2๋Š” ๋น„๋™๊ธฐ ์œ„์ž„์˜ ์ „์ œ(์‚ฌ๋žŒ์ด ์ž๋ฆฌ๋ฅผ ๋น„์šด๋‹ค)์™€ ์ถฉ๋Œํ•œ๋‹ค โ€” ๊ฐ•์กฐ ํ‘œ์‹œ๋Š” ๋ณด๋Š” ์‚ฌ๋žŒ์ด ์žˆ์„ ๋•Œ๋งŒ ์ž‘๋™ํ•œ๋‹ค. ์˜ต์…˜ 1์€ ๋‹จ์ˆœํ•˜๊ณ  ๊ธฐ๊ณ„์ ์œผ๋กœ ๊ฒ€์ฆ ๊ฐ€๋Šฅํ•˜๋ฉฐ(ํ…Œ์ŠคํŠธ ํŒŒ์ผ ๋ณ€๊ฒฝ์„ ๊ฐ์ง€ํ•ด ์ฐจ๋‹จ), C-04 โ‘ก(ํ…Œ์ŠคํŠธ ํ†ต๊ณผ)๋ฅผ ์ž๊ฐ€ ๊ฒ€์ฆ ๋ฐฉ๋ฒ•์œผ๋กœ ์œ ์ง€ํ•˜๋Š” ๋ฐ ํ•„์š”ํ•œ ์ตœ์†Œํ•œ์˜ ๋ณดํ˜ธ๋‹ค. ํ…Œ์ŠคํŠธ ์ถ”๊ฐ€๋Š” ํ—ˆ์šฉํ•˜๋ฏ€๋กœ ์—์ด์ „ํŠธ์˜ ์ •์ƒ์  ์ž‘์—…์„ ๋ง‰์ง€ ์•Š๋Š”๋‹ค
  • Impact: Seed spec v2.0.0 C-05 ์‹ ์„ค + AC-10. A-02์˜ ๊ฒ€์ฆ ๋ฐฉ๋ฒ•์— "์—์ด์ „ํŠธ ์ž์‹ ์ด ๋งŒ๋“  ๊ฒฐํ•จ์— ๋Œ€ํ•œ ๊ฒ€์ถœ๋ฅ "์„ ๋ณ„๋„ ์ธก์ • ํ•ญ๋ชฉ์œผ๋กœ ์ถ”๊ฐ€
  • Source: ์ ๋Œ€์  ๊ฐ์‚ฌ 3์ฐจ (2026-08-26) + ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต

D-015: Seed Spec์„ ์ตœ์†Œ ํ•ต์‹ฌ์œผ๋กœ ์‚ญ๊ฐ ์žฌ์ž‘์„ฑ(v2.0.0)

  • Date: 2026-08-26
  • Context: v1.0.0 โ†’ v1.1.0 โ†’ v1.2.0 ๋‘ ์ฐจ๋ก€ ๊ฐœ์ •์ด ๋ชจ๋“  ์ง€ํ‘œ๋ฅผ ์•…ํ™”์‹œ์ผฐ๋‹ค โ€” ๋ชจํ˜ธ์„ฑ 0.625 โ†’ 0.4125 โ†’ 0.47, ๋ณต์žก๋„ 29.5 โ†’ 34.5 โ†’ 42.5(Excessive ์ž„๊ณ„ 31), ๋‚ด๋ถ€ ๋ชจ์ˆœ 11๊ฑด, ๋ฏธํ•ด์†Œ Critical 6๊ฑด. (v1.1.0 ๋ณต์žก๋„๋Š” 34.5๋‹ค โ€” docs/simplifier-review-cocode.md 64ํ–‰. ์ตœ์ดˆ ๊ธฐ์žฌ์˜ 36.5๋Š” ์˜ค๊ธฐ์ด๋ฉฐ 4์ฐจ ๊ฐ์‚ฌ ์ง€์ ์œผ๋กœ ์ •์ •) 3์ฐจ ์ ๋Œ€์  ๊ฐ์‚ฌ๊ฐ€ ์›์ธ์„ ์ •ํ™•ํžˆ ์ง€๋ชฉํ–ˆ๋‹ค: "v1.2.0์€ NFR-01์—์„œ ๊ทผ๊ฑฐ ์—†๋Š” ์ˆซ์ž 3๊ฐœ๋ฅผ ์ œ๊ฑฐํ•˜๋ฉด์„œ ๊ฐ™์€ ๊ฐœ์ •์—์„œ ์ƒˆ ์ˆซ์ž 6๊ฐœ๋ฅผ ๋„์ž…ํ–ˆ๋‹ค. D-013 ์ž์‹ ์ด '๊ฒ€์ฆ๋˜์ง€ ์•Š์€ ์ˆซ์ž๋ฅผ ์ž ๊ทธ๋Š” ๊ฒƒ์€ ์ด ์ŠคํŽ™์ด ์ผ๊ด€๋˜๊ฒŒ ๊ฑฐ๋ถ€ํ•ด ์˜จ ํŒจํ„ด'์ด๋ผ๊ณ  ์ผ๋Š”๋ฐ, ๋ฐ”๋กœ ๊ทธ ๋ฌธ์žฅ์„ ์“ด ๊ฐœ์ •์ด ์ƒˆ ๋ฏธ๊ฒ€์ฆ ์ˆซ์ž๋ฅผ ๋„์ž…ํ–ˆ๋‹ค." ๋˜ํ•œ cc-spec ํ”„๋กœํ† ์ฝœ์˜ ์ˆ˜์ •ยท์žฌํ‰๊ฐ€ ๋ฃจํ”„ ์ƒํ•œ(bound: 2)์„ ์ด๋ฏธ ์†Œ์ง„ํ•œ ์ƒํƒœ์˜€๊ณ , ํ”„๋กœํ† ์ฝœ์€ ์ด ๊ฒฝ์šฐ "๋ฌธ๊ตฌ๊ฐ€ ์•„๋‹ˆ๋ผ ๋ฌธ์ œ ์ •์˜๋ฅผ ๋‹ค์‹œ ์žก์„ ์‹ ํ˜ธ"๋กœ ๋ณด๊ณ  ์—์Šค์ปฌ๋ ˆ์ด์…˜ํ•˜๋ผ๊ณ  ๊ทœ์ •ํ•œ๋‹ค
  • Options:
    1. ์ตœ์†Œ ํ•ต์‹ฌ์œผ๋กœ ์‚ญ๊ฐ ์žฌ์ž‘์„ฑ โ€” ์ •๋ง ์•ˆ ๋ฐ”๋€Œ๋Š” ๊ฒƒ๋งŒ ๋‚จ๊ธฐ๊ณ  ๊ตฌํ˜„ ์„ธ๋ถ€๋ฅผ Planning์œผ๋กœ ์ด๊ด€
    2. v1.3.0์œผ๋กœ ๊ณ„์† ํŒจ์น˜ โ€” ์ง€์  ํ•ญ๋ชฉ์„ ํ•˜๋‚˜์”ฉ ์ˆ˜์ •
    3. ํ˜„์žฌ ์ƒํƒœ๋กœ ์ž ๊ธˆ ํ›„ ์ง„ํ–‰ โ€” ๋ฏธํ•ด์†Œ ํ•ญ๋ชฉ์„ ๊ณต๊ฐœ ๋ฏธ๊ฒฐ ๊ณผ์ œ๋กœ ๊ธฐ๋ก
  • Decision: ์˜ต์…˜ 1 โ€” ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต(2026-08-26)
  • Rationale: ์˜ต์…˜ 2๋Š” ์ง€๋‚œ ๋‘ ๋ผ์šด๋“œ๊ฐ€ ์ด๋ฏธ ์‹คํŒจ๋ฅผ ์ฆ๋ช…ํ•œ ๋ฐฉ์‹์ด๋‹ค โ€” ์š”๊ตฌ์‚ฌํ•ญ์„ "๊ฒ€์ฆ ๊ฐ€๋Šฅํ•˜๊ฒŒ" ๋งŒ๋“ค๋ ค๊ณ  ํ•ญ๋ชฉ์„ ์ถ”๊ฐ€ํ•  ๋•Œ๋งˆ๋‹ค ๊ทผ๊ฑฐ ์—†๋Š” ์ž„๊ณ„๊ฐ’์ด ํ•„์š”ํ–ˆ๊ณ , ๊ทธ๊ฒƒ์ด ๋‹ค์‹œ ๋ถˆ๋ณ€ ์ธต์œ„๋กœ ๋ฐ€๋ ค ์˜ฌ๋ผ๊ฐ”๋‹ค. ๊ทผ๋ณธ ์›์ธ์€ Seed Spec์— Planning/Design ์ธต์œ„์˜ ๊ตฌํ˜„ ์„ธ๋ถ€(์žฌ์‹œ๋„ ํƒ€์ž„์•„์›ƒ, ๋ฒค์น˜๋งˆํฌ ๊ทœ๋ชจ, ๊ฒ€์ถœ๋ฅ  ๊ธฐ์ค€)๋ฅผ ๋‹ด์œผ๋ ค ํ•œ ๊ฒƒ์ด๋‹ค. ์˜ต์…˜ 3์€ Specification Gate๋ฅผ ๋ฏธํ†ต๊ณผ ์ƒํƒœ๋กœ ๋‚จ๊ฒจ ํ›„์† ๋‹จ๊ณ„๊ฐ€ ํ”๋“ค๋ฆฌ๋Š” ๊ธฐ๋ฐ˜ ์œ„์— ์„œ๊ฒŒ ๋œ๋‹ค. v2.0.0์˜ ์›์น™์€ ์„ธ ๊ฐ€์ง€๋‹ค: โ“ ์ถœ์ฒ˜ ์—†๋Š” ์ˆซ์ž๋ฅผ ์“ฐ์ง€ ์•Š๋Š”๋‹ค โ“‘ ์ •๋ง ์•ˆ ๋ฐ”๋€Œ๋Š” ๊ฒƒ๋งŒ ยง2์— ๋‘”๋‹ค โ“’ ์‹๋ณ„์ž ์ฒด๊ณ„๋ฅผ ํ•˜๋‚˜๋กœ ํ†ต์ผํ•œ๋‹ค
  • Impact: Seed spec v2.0.0 โ€” ๋ถˆ๋ณ€ ์ œ์•ฝ 5๊ฐœ, ์—”ํ‹ฐํ‹ฐ 3๊ฐœ, ์ธ์ˆ˜ ๊ธฐ์ค€ 15๊ฐœ(์ „๋Ÿ‰ AC-NN), ๊ฐ€์ • 7๊ฐœ. ์ง€์–ด๋‚ธ ์ˆ˜์น˜ 6๊ฐœ ์ œ๊ฑฐ(30๊ฑด/80%/10๋ถ„/3๋งŒ~5๋งŒ ์ค„/200~400๊ฐœ/5๊ฐœ), ๋‚ด๋ถ€ ๋ชจ์ˆœ 11๊ฑด ํ•ด์†Œ, ๊นจ์ง„ ์ธ์šฉ 2๊ฑด ์ •์ •. ์‚ด์•„๋‚จ์€ ์ˆ˜์น˜๋Š” ์ „๋ถ€ ์ถœ์ฒ˜๋ฅผ ๋ช…์‹œ(์˜ค๋„ˆ ๊ฒฐ์ •ยท์™ธ๋ถ€ ์‹ค์ธกยท์—…๊ณ„ ํ‘œ์ค€)
  • Source: ์ ๋Œ€์  ๊ฐ์‚ฌ 3์ฐจ (2026-08-26) + cc-spec ํ”„๋กœํ† ์ฝœ L-spec.evaluate-outer-fix-reevaluate exhaust ์กฐํ•ญ + ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต

D-016: MVP ๋Œ€์ƒ ํ”Œ๋žซํผ 3์ข…, ๋‹จ ํ•œ๊ธ€ IME ๊ฒŒ์ดํŒ… ๊ฒ€์ฆ์€ macOS ์šฐ์„ 

  • Date: 2026-08-26
  • Context: Seed spec v2.0.1์ด Planning ํ•„์ˆ˜ ์ž…๋ ฅ 9๊ฑด์„ ๋‚จ๊ฒผ๊ณ , ๊ทธ์ค‘ ๋Œ€์ƒ ํ”Œ๋žซํผ์ด ๊ฐ€์žฅ ์ƒ์œ„ ๊ฒฐ์ •์ด์—ˆ๋‹ค(AC-14 ์ธก์ • ํ™˜๊ฒฝยทAC-15 ์ž…๋ ฅ๊ธฐ ์กฐํ•ฉยทA-06 ์šฉ๋Ÿ‰ ๋ชฉํ‘œ๊ฐ€ ๋ชจ๋‘ ์—ฌ๊ธฐ์„œ ํŒŒ์ƒ). ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ๊ฐ€ macOSยทWindowsยทLinux 3์ข…์„ ์„ ํƒํ–ˆ์œผ๋‚˜, ์ด๋Š” A-04(ํ•œ๊ธ€ IME)์— ๊ทธ๋Œ€๋กœ ๊ณฑํ•ด์ง„๋‹ค โ€” ์„ธ ํ”Œ๋žซํผ์˜ ํ•œ๊ธ€ ์ž…๋ ฅ ๊ฒฝ๋กœ๊ฐ€ ์™„์ „ํžˆ ๋‹ค๋ฅด๊ณ (macOS 2-set / Windows MS-IME / Linux ibusยทfcitx), Lumide๋Š” ํ•œ ํ”Œ๋žซํผ์—์„œ๋„ ์ด ๋ฒ„๊ทธ(์ด์Šˆ #64)๋ฅผ ์•„์ง ๋ชป ๊ณ ์ณค๋‹ค
  • Options:
    1. ๋ฐฐํฌ 3์ข… ์œ ์ง€ + ๊ฒŒ์ดํŒ… ์ŠคํŒŒ์ดํฌ๋Š” macOS ๋จผ์ €, ๋‚˜๋จธ์ง€ ์ˆœ์ฐจ
    2. ์„ธ ํ”Œ๋žซํผ ๋™์‹œ ๊ฒ€์ฆ โ€” ๋ฆฌ์Šคํฌ๋ฅผ ์•ž๋‹น๊ธฐ์ง€๋งŒ 1๋‹จ๊ณ„ ์ŠคํŒŒ์ดํฌ ๊ธฐ๊ฐ„์ด ํฌ๊ฒŒ ๋Š˜์–ด๋‚จ
    3. MVP ๋ฐฐํฌ ์ž์ฒด๋ฅผ macOS๋กœ ์ถ•์†Œ
  • Decision: ์˜ต์…˜ 1 โ€” ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต(2026-08-26)
  • Rationale: macOS์—์„œ ์•ˆ ๋˜๋ฉด ๋‚˜๋จธ์ง€๋ฅผ ๋ณผ ์ด์œ ๊ฐ€ ์—†๋‹ค. ๊ฒŒ์ดํŒ… ๋ฆฌ์Šคํฌ์˜ ๋ชฉ์ ์€ "๋˜๋Š”์ง€ ์•„๋‹Œ์ง€๋ฅผ ๊ฐ€์žฅ ์‹ธ๊ฒŒ ํŒ๋ณ„ํ•˜๋Š” ๊ฒƒ"์ด๋ฏ€๋กœ, ํ•œ ํ”Œ๋žซํผ์œผ๋กœ ํŒ๋ณ„ํ•˜๊ณ  ๋‚˜๋จธ์ง€๋Š” ํ†ต๊ณผ ํ›„ ์ˆœ์ฐจ๋กœ ๊ฐ€๋Š” ๊ฒƒ์ด ์˜ณ๋‹ค. ๋ฐฐํฌ ๋Œ€์ƒ์„ ์ถ•์†Œํ•˜์ง€ ์•Š์€ ๊ฒƒ์€ ์•„ํ‚คํ…์ฒ˜ ๊ฒฐ์ •(Flutter ๋ฐ์Šคํฌํ†ฑ 3์ข… ์ง€์›)์ด ์ŠคํŒŒ์ดํฌ ๊ฒฐ๊ณผ์™€ ๋…๋ฆฝ์ ์ด๊ธฐ ๋•Œ๋ฌธ
  • Impact: Seed spec v2.1.0 AC-15์— "1๋‹จ๊ณ„ ๊ฒŒ์ดํŒ… ์ŠคํŒŒ์ดํฌ๋Š” macOS๋งŒ" ๋ช…์‹œ, A-04 ๊ฒ€์ฆ ๋ฐฉ๋ฒ•์— ์ˆœ์ฐจ ๊ณ„ํš ๋ฐ˜์˜
  • Source: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต + Seed spec ยง4 Planning ์ž…๋ ฅ 1ยท2๋ฒˆ

D-017: agent๋Š” Anthropic + OpenAI ํ˜ธํ™˜ ๊ฒŒ์ดํŠธ์›จ์ด 2๊ฒฝ๋กœ

  • Date: 2026-08-26
  • Context: AC-06์ด "LLM ํ”„๋กœ๋ฐ”์ด๋” 2๊ฐœ ์ด์ƒ"์„ Must๋กœ ๊ทœ์ •ํ•˜๋Š”๋ฐ, ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ์˜ ์ตœ์ดˆ ์„ ํƒ์€ Anthropic ๋‹จ๋…์ด์—ˆ๋‹ค. ์ŠคํŽ™ ์œ„๋ฐ˜์ด๋ฏ€๋กœ ํ™•์ธ์ด ํ•„์š”ํ–ˆ๋‹ค
  • Options:
    1. Anthropic + OpenAI ํ˜ธํ™˜ ๊ฒŒ์ดํŠธ์›จ์ด โ€” SDK ํ•˜๋‚˜ + ํ˜ธํ™˜ ๊ณ„์ธต ํ•˜๋‚˜
    2. Anthropic ๋‹จ๋…์œผ๋กœ ๊ฐ€๊ณ  AC-06์„ "1๊ฐœ ์ด์ƒ"์œผ๋กœ ๋‚ฎ์ถค (๋ฉ€ํ‹ฐ LLM์€ acp๊ฐ€ ๋‹ด๋‹นํ•˜๋Š” ๊ฒƒ์œผ๋กœ ์žฌ์ •์˜)
    3. anthropic_sdk_dart + openai_dart ๋‘ SDK ๋ชจ๋‘ ์ง์ ‘ ๊ตฌํ˜„
  • Decision: ์˜ต์…˜ 1 โ€” ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต(2026-08-26)
  • Rationale: OpenAI ํ˜ธํ™˜ ์—”๋“œํฌ์ธํŠธ ๊ณ„์ธต ํ•˜๋‚˜๋กœ GrokยทMistralยทOllamaยทOpenRouter๊ฐ€ ํ•จ๊ป˜ ๋“ค์–ด์˜ค๋ฏ€๋กœ ๊ตฌํ˜„ ๋ถ€๋‹ด ๋Œ€๋น„ ์ปค๋ฒ„๋ฆฌ์ง€๊ฐ€ ๊ฐ€์žฅ ํฌ๋‹ค. ์˜ต์…˜ 2๋Š” Discovery๊ฐ€ ๋ถ„์„ํ•œ ํ•ต์‹ฌ ๊ฐ€์น˜์ œ์•ˆ(์ž์ฒด ๋Ÿฐํƒ€์ž„์—์„œ์˜ ๋ชจ๋ธ ์„ ํƒ)์„ ํฌ๊ธฐํ•˜๊ฒŒ ๋˜๊ณ , ์˜ต์…˜ 3์€ ๋ฒค๋” ๊ณ ์œ  ๊ธฐ๋Šฅ๊นŒ์ง€ ์“ธ ์ˆ˜ ์žˆ์œผ๋‚˜ ์œ ์ง€ ๋ถ€๋‹ด์ด ํฌ๋‹ค
  • Impact: Seed spec v2.1.0 AC-06์„ ํ™•์ •๊ฐ’์œผ๋กœ ๊ฐฑ์‹ . AC-06 ์œ„๋ฐ˜ ํ•ด์†Œ
  • Source: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต + Seed spec ยง4 Planning ์ž…๋ ฅ 3๋ฒˆ

D-018: AC-13 ํ—ˆ์šฉ ํ˜ธ์ŠคํŠธ๋ฅผ ์‹ค์ธก ๊ธฐ๋ฐ˜์œผ๋กœ ํ™•์ • (์› ์ œ๋ชฉ: "11์ข…์œผ๋กœ ํ™•์ •" โ€” ๊ฐœ์ˆ˜๋Š” ์ •๋ณธ์ด ์•„๋‹ˆ๋‹ค, D-051)

  • Date: 2026-08-26
  • Context: v2.0.1์ด AC-13์˜ ํ—ˆ์šฉ ํ˜ธ์ŠคํŠธ๋ฅผ "์นดํ…Œ๊ณ ๋ฆฌ ์„œ์ˆ "๋กœ๋งŒ ๋‘์–ด, 4์ฐจ ๊ฐ์‚ฌ๊ฐ€ "๋‹ซํžŒ ์ง‘ํ•ฉ์ด ์•„๋‹ˆ๋ผ ๊ธฐ๊ณ„์ ์œผ๋กœ ๊ฒ€์ฆ ๋ถˆ๊ฐ€"๋ผ๊ณ  ์ง€์ ํ–ˆ๋‹ค. ๋˜ํ•œ v1.2.0 ์‹œ์ ์—๋Š” pub.dev๋งŒ ์˜ˆ์™ธ๋กœ ๋‘์–ด Android/iOS ๋นŒ๋“œ๊ฐ€ ์›์ฒœ ๋ถˆ๊ฐ€๋Šฅํ•œ ๋ชจ์ˆœ๋„ ์žˆ์—ˆ๋‹ค
  • Options: ์กฐ์‚ฌ๋กœ ์‹ค์ œ ํ˜ธ์ŠคํŠธ ์ง‘ํ•ฉ์„ ํ™•์ • / ์นดํ…Œ๊ณ ๋ฆฌ ์„œ์ˆ  ์œ ์ง€
  • Decision: ์‹ค์ธก์œผ๋กœ ํ™•์ • โ€” ํ•„์ˆ˜ ํ˜ธ์ŠคํŠธ + ์ฐจ๋‹จ ๊ฐ€๋Šฅ ํ˜ธ์ŠคํŠธ + ์บ์‹œ ๋””๋ ‰ํ„ฐ๋ฆฌ ์˜ˆ์™ธ์˜ ๋ชฉ๋ก. โš ๏ธ ์›๋ฌธ์€ ๊ฐ๊ฐ "์ตœ์†Œ 11์ข… ยท 4์ข… ยท 6์ข…"์œผ๋กœ ๊ฐœ์ˆ˜๋ฅผ ์ ์—ˆ์œผ๋‚˜ ๊ทธ ์ˆ˜๋Š” ์ •๋ณธ์ด ์•„๋‹ˆ๋‹ค(D-051) โ€” ์ •๋ณธ์€ docs/planning-inputs-cocode.md ยง2.1ยทยง2.3ยทยง2.4 ์˜ ํ‘œ์™€ ๊ทธ๊ฒƒ์„ ๊ทธ๋Œ€๋กœ ์˜ฎ๊ธด SandboxDefaults ๋‹ค. ์ด ํ•ญ๋ชฉ์ด ์„ธ์šด ๊ฒƒ์€ ใ€Œ์นดํ…Œ๊ณ ๋ฆฌ ์„œ์ˆ ์ด ์•„๋‹ˆ๋ผ ์‹ค์ธก๋œ ๋ชฉ๋กใ€์ด๋ผ๋Š” ํ˜•ํƒœ์ด๋ฉฐ, ๊ทธ ํ˜•ํƒœ๋Š” ์œ ํšจํ•˜๋‹ค
  • Rationale: Flutter 3.47.0 SDK ์†Œ์Šค(http_host_validator.dart, cache.dart, FlutterPluginConstants.kt, Android ํ…œํ”Œ๋ฆฟ), ์ด ๋จธ์‹ ์˜ Gradle origin ์ธ๋ฑ์Šค(resource-at-url.bin โ€” ๊ณผ๊ฑฐ ๋นŒ๋“œ๊ฐ€ ์‹ค์ œ๋กœ ๋ฐ›์•„์˜จ URL ๊ธฐ๋ก), ๋ผ์ด๋ธŒ ๋ฆฌ๋‹ค์ด๋ ‰ํŠธ probe๋กœ ๊ต์ฐจ ๊ฒ€์ฆํ–ˆ๋‹ค. ํŠนํžˆ ์ˆœ์ง„ํ•œ ํ—ˆ์šฉ ๋ชฉ๋ก์„ ๊นจ๋Š” 3๊ฐ€์ง€๋ฅผ ์‹ค์ธก์œผ๋กœ ํ™•์ธ: โ‘ services.gradle.org๋Š” zip์„ ์„œ๋น™ํ•˜์ง€ ์•Š๊ณ  release-assets.githubusercontent.com๊นŒ์ง€ 307 ์ฒด์ธ โ‘กplugins.gradle.org๋„ 303 ๋ฆฌ๋‹ค์ด๋ ‰ํŠธ โ‘ขGradle google()์€ maven.google.com์ด ์•„๋‹ˆ๋ผ dl.google.com/dl/android/maven2/(origin ์ธ๋ฑ์Šค 3,060๊ฑด vs 0๊ฑด)
  • Impact: Seed spec v2.1.0์— ํ—ˆ์šฉ ํ˜ธ์ŠคํŠธ ํ‘œยท์บ์‹œ ๋””๋ ‰ํ„ฐ๋ฆฌ ํ‘œยทํ•จ์ • 3๊ฐ€์ง€ ๋ช…์‹œ. ๋‹น์‹œ AC-13(์ƒŒ๋“œ๋ฐ•์Šค)์„ ๊ธฐ๊ณ„์ ์œผ๋กœ ๊ฒ€์ฆ ๊ฐ€๋Šฅํ•œ ํ˜•ํƒœ๋กœ ์ „ํ™˜
    • ์ •์ •(2026-09-13): ์ด ํ•ญ๋ชฉ์˜ ๊ฐœ์ˆ˜ "11์ข…"์€ ์ •๋ณธ์ด ์•„๋‹ˆ๋‹ค(D-051 โ€” ์˜ค๋„ˆ ๊ฒฐ์ • #109). #38 ์˜ 3-OS ์‹ค์ธก์ด ยง2.1 ํ‘œ์— ์—†๋˜ api.github.com ์„ ๊ด€์ธกํ•ด 11 ๋„ 12 ๋„ ์ธก์ •๊ณผ ์–ด๊ธ‹๋‚ฌ๊ณ , ๊ทธ๋ž˜์„œ ๊ฐœ์ˆ˜๊ฐ€ ์•„๋‹ˆ๋ผ ๋ชฉ๋ก์ด ๋‹จ์ผ SSOT ๋กœ ํ™•์ •๋๋‹ค. ์•„๋ž˜ "์ถ”์ถœ ์•Œ๊ณ ๋ฆฌ์ฆ˜์€ ์—ฌ์ „ํžˆ Planning ๋ฏธ๊ฒฐ" ๋„ ํ•ด์†Œ๋๋‹ค โ€” D-050 โ‘ (lock ์šฐ์„  ยท ์ „์ด ํฌํ•จ ยท ๊ฒŒ์ดํŠธ ์‹œ์  ์žฌ๊ณ„์‚ฐ ยท ์„ธ์…˜ ๊ณ ์ •)
    • ์ •์ •(2026-08-26): v3.0.0์—์„œ ยง4๊ฐ€ ์žฌ์ž‘์„ฑ๋˜๋ฉฐ ์ƒŒ๋“œ๋ฐ•์Šค ๊ธฐ์ค€์€ AC-14๋กœ, ํ—ˆ์šฉ ํ˜ธ์ŠคํŠธ ํ‘œ๋Š” docs/planning-inputs-cocode.md ยง2๋กœ ์ด๋™ํ–ˆ๋‹ค. ํ˜„์žฌ AC-13์€ brick ์Šค์บํด๋”ฉ ์›์ž์„ฑ์ด๋‹ค. ๋˜ํ•œ v3.0.0 ๊ฐ์‚ฌ๊ฐ€ ์ง€์ ํ–ˆ๋“ฏ ์ด ํ•ญ๋ชฉ์ด ์ฃผ์žฅํ•œ "๊ธฐ๊ณ„์ ์œผ๋กœ ๊ฒ€์ฆ ๊ฐ€๋Šฅ"์€ ๊ณผ์žฅ์ด์—ˆ๋‹ค โ€” ํ—ˆ์šฉ ์ง‘ํ•ฉ์— ์‚ฌ์šฉ์ž ์ถ”๊ฐ€๋ถ„๊ณผ ์˜์กด์„ฑ ํŒŒ์ƒ๋ถ„์ด ํฌํ•จ๋˜๋ฏ€๋กœ ์™„์ „ํ•œ ๋‹ซํžŒ ์ง‘ํ•ฉ์ด ์•„๋‹ˆ๋ฉฐ, ์ถ”์ถœ ์•Œ๊ณ ๋ฆฌ์ฆ˜์€ ์—ฌ์ „ํžˆ Planning ๋ฏธ๊ฒฐ์ด๋‹ค(ยง2.5)
  • ํ•œ๊ณ„: ํ”„๋กœ์ ํŠธ๋ณ„ git: ์˜์กด์„ฑ๊ณผ podspec ์™ธ๋ถ€ ์†Œ์Šค๋Š” ๋„๊ตฌ ๊ธฐ๋ณธ๊ฐ’์—์„œ ๋„์ถœ ๋ถˆ๊ฐ€ โ€” ๊ตฌํ˜„์ด ์›Œํฌ์ŠคํŽ˜์ด์Šค์˜ ์„ ์–ธ๋œ ์˜์กด์„ฑ์—์„œ ํ˜ธ์ŠคํŠธ๋ฅผ ์ถ”์ถœํ•ด ์„ธ์…˜ ํ—ˆ์šฉ ๋ชฉ๋ก์— ์ถ”๊ฐ€ํ•˜๋Š” ๋ฐฉ์‹์ด์–ด์•ผ ํ•œ๋‹ค๊ณ  AC-13์— ๊ทœ์ •
  • Source: ์กฐ์‚ฌ(Flutter 3.47.0 ์‹ค์ธก) + Seed spec ยง4 Planning ์ž…๋ ฅ 4๋ฒˆ

D-019: A-03 ์ฐธ์กฐ ์›Œํฌ์ŠคํŽ˜์ด์Šค๋กœ coco-de/unibook ์ฑ„ํƒ, ACP ๊ฒ€์ฆ ๋Œ€์ƒ 4์ข… ์„ ์ •, v1 ์ „์šฉ ์ถœ์‹œ

  • Date: 2026-08-26
  • Context: Planning ์ž…๋ ฅ 5ยท6ยท7๋ฒˆ. ์ฐธ์กฐ ์›Œํฌ์ŠคํŽ˜์ด์Šค์™€ ACP ๊ฒ€์ฆ ๋Œ€์ƒ์„ ๊ทผ๊ฑฐ ์—†์ด ๊ณ ๋ฅด๋ฉด ์ด์ „์— ๋ฐ˜๋ณตํ•œ "์ง€์–ด๋‚ธ ๊ฐ’" ํŒจํ„ด์ด ๋˜๋ฏ€๋กœ ์‹ค์ œ ์กฐ์‚ฌ๋กœ ํ›„๋ณด๋ฅผ ํ‰๊ฐ€ํ–ˆ๋‹ค
  • Decision:
    • ์ฐธ์กฐ ์›Œํฌ์ŠคํŽ˜์ด์Šค: coco-de/unibook์„ ๋ถˆ๋ณ€ ํƒœ๊ทธ ๋˜๋Š” ์ปค๋ฐ‹ SHA๋กœ ๊ณ ์ •
    • ACP ๊ฒ€์ฆ ๋Œ€์ƒ: Claude Agent ยท Codex ยท Gemini CLI ยท Copilot CLI 4์ข…
    • ACP ๋ฒ„์ „: v1 ์ „์šฉ์œผ๋กœ ์ถœ์‹œ, v2๋Š” ๋ผ์šฐํŒ… seam๋งŒ ๋‘๊ณ  ํ”Œ๋ž˜๊ทธ ๋’ค๋กœ
  • Rationale:
    • unibook์€ org ๋‚ด ์œ ์ผํ•˜๊ฒŒ ๊ทœ๋ชจยทํ˜•ํƒœ๋ฅผ ๋™์‹œ์— ๋งŒ์กฑํ•œ๋‹ค โ€” Dart ํŒŒ์ผ 9,931๊ฐœ(~55.8MB), ์ƒ์„ฑ ํŒŒ์ผ 712๊ฐœ git ์ถ”์ , workspace: ๋ฉค๋ฒ„ 141๊ฐœ. ์ฐจ์ˆœ์œ„ good-teacher๋Š” ๊ทœ๋ชจ๊ฐ€ 1/3.5 ์ˆ˜์ค€
    • ACP 4์ข…์€ ๋Šฅ๋ ฅ ์ŠคํŽ™ํŠธ๋Ÿผ์„ ๋ฎ๋Š”๋‹ค: Claude Agent(fork+resume ์ตœ๋Œ€ ์ง‘ํ•ฉ) / Codex(resume ์žˆ๊ณ  fork ์—†์Œ โ€” fork๊ฐ€ resume์„ ํ•จ์˜ํ•œ๋‹ค๊ณ  ๊ฐ€์ •ํ•œ ์ฝ”๋“œ๋ฅผ ์žก์Œ) / Gemini CLI(loadSession๋งŒ, ํŒŒ์ผ IO๋ฅผ ํด๋ผ์ด์–ธํŠธ๋กœ ๋˜๋Œ๋ ค fs/* ๊ตฌํ˜„์„ ๊ฐ•์ œ) / Copilot CLI(๋„ค์ดํ‹ฐ๋ธŒ ์„œ๋ฒ„)
    • v2 ๋ฐฐ์ œ ๊ทผ๊ฑฐ: 2026-08-25 ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ ๋ผ์ด๋ธŒ probe 32์ข… ์ค‘ 31์ข…์ด v1 negotiateํ–ˆ๊ณ , flagship ์–ด๋Œ‘ํ„ฐ 2์ข…์„ ๋””์ปดํŒŒ์ผํ•ด protocolVersion: 1 ํ•˜๋“œ์ฝ”๋”ฉยทv2 ์ฐธ์กฐ 0๊ฑด์„ ํ™•์ธํ–ˆ๋‹ค. v2๋Š” 2026-07-20 ๊ณต๊ฐœ๋œ draft์ด๋ฉฐ ์Šค์Šค๋กœ wire format ๋ถˆ์•ˆ์ •์„ ์„ ์–ธํ•œ๋‹ค
  • Impact: Seed spec v2.1.0 AC-14ยทA-03ยทA-05 ๊ฐฑ์‹ 
    • ์ •์ •(2026-08-26): ๋‹น์‹œ A-05 ์ƒํƒœ๋ฅผ "๋ถ€๋ถ„ ๊ฒ€์ฆ๋จ"์œผ๋กœ ์ ์—ˆ์œผ๋‚˜ ์ด๋Š” Seed Spec ์Šคํ‚ค๋งˆ์˜ ํ—ˆ์šฉ ๊ฐ’(Verified/Unverified/Disproved)์ด ์•„๋‹ˆ๋‹ค. v3.0.0์—์„œ Unverified๋กœ ๊ต์ •ํ–ˆ๋‹ค โ€” ๊ทผ๊ฑฐ ์ž๋ฃŒ๋Š” ํ™•๋ณด๋์œผ๋‚˜ ์‹ค์ œ ๊ตฌํ˜„์œผ๋กœ ๊ฒ€์ฆ๋œ ๋ฐ” ์—†์œผ๋ฏ€๋กœ Unverified๊ฐ€ ๋งž๋‹ค
  • ํ•œ๊ณ„(์ŠคํŽ™์— ๋ช…์‹œ): unibook์€ ๋น„๊ณต๊ฐœ ์ €์žฅ์†Œ์ด๋ฉฐ ์ตœ๊ทผ 30์ผ 100+ ์ปค๋ฐ‹์œผ๋กœ ํ™œ๋ฐœํ•˜๋‹ค โ€” ๋ถˆ๋ณ€ ๊ณ ์ •์ด ํ•„์ˆ˜์ด๊ณ , ๋ฒค์น˜๋งˆํฌ๋ฅผ ์™ธ๋ถ€ ๊ณต๊ฐœํ•  ๊ณ„ํš์ด๋ผ๋ฉด ๋Œ€์ฒด ์›Œํฌ์ŠคํŽ˜์ด์Šค๊ฐ€ ํ•„์š”ํ•˜๋‹ค. org ์ „์ฒด์— .freezed.dart๊ฐ€ ํ•˜๋‚˜๋„ ์—†์–ด freezed ์ƒ์„ฑ ํŒŒ์ผ์„ ์ƒ์ •ํ•œ๋‹ค๋ฉด ๋ณ„๋„ ํ”ฝ์Šค์ฒ˜๊ฐ€ ํ•„์š”ํ•˜๋‹ค
  • Source: ์กฐ์‚ฌ(GitHub APIยทACP ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ probeยท์–ด๋Œ‘ํ„ฐ ๋””์ปดํŒŒ์ผ) + Seed spec ยง4 Planning ์ž…๋ ฅ 5ยท6ยท7๋ฒˆ

D-020: ์‹œ๊ฐ„ ์ƒํ•œ ๊ธฐ๋ณธ๊ฐ’๊ณผ A-02 ํ•ฉ๊ฒฉ ๊ธฐ์ค€์€ ์ŠคํŒŒ์ดํฌ ํ›„๋กœ ์œ ์ง€

  • Date: 2026-08-26
  • Context: Planning ์ž…๋ ฅ 8ยท9๋ฒˆ. ๋‘ ๊ฐ’ ๋ชจ๋‘ "์ง€๊ธˆ ์ •ํ•˜๋ผ"๋Š” ์„ ํƒ์ง€๊ฐ€ ์žˆ์—ˆ์œผ๋‚˜ ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ๊ฐ€ ๋ณด๋ฅ˜๋ฅผ ํƒํ–ˆ๋‹ค
  • Decision: ๋‘ ๊ฐ’ ๋ชจ๋‘ ์ŠคํŒŒ์ดํฌ ์‹ค์ธก ํ›„ ๊ฒฐ์ •. ์ŠคํŽ™์—๋Š” ๊ฐ’ ๋Œ€์‹  "์ƒํ•œ์ด ์กด์žฌํ•˜๊ณ  ์ดˆ๊ณผ ์‹œ ์‹คํŒจ ์ฒ˜๋ฆฌ๋œ๋‹ค"(AC-07)์™€ ์•ˆ์ „ ๊ธฐ๋ณธ๊ฐ’(C-04 ์ „ํ™˜ ์กฐํ•ญ)๋งŒ ๊ทœ์ •
  • Rationale: ์ด ํ”„๋กœ์ ํŠธ๊ฐ€ ์„ธ ์ฐจ๋ก€ ๋ฐ˜๋ณตํ•œ ์‹คํŒจ ํŒจํ„ด์ด ์ •ํ™•ํžˆ "๊ทผ๊ฑฐ ์—†๋Š” ์ž„๊ณ„๊ฐ’์„ ์ง€์–ด๋‚ด ๋ถˆ๋ณ€ ์ธต์œ„์— ์ž ๊ทธ๊ธฐ"์˜€๋‹ค(D-013, D-015). ์‹ค์ธก ๋ถ„ํฌ๋ฅผ ๋ณด๊ธฐ ์ „์— ์ˆซ์ž๋ฅผ ์ •ํ•˜๋ฉด ๊ฐ™์€ ํŒจํ„ด์ด๋‹ค.
  • Impact: Seed spec v2.1.0 Planning ํ™•์ •ํ‘œ์— "์ŠคํŒŒ์ดํฌ ํ›„" ์ƒํƒœ๋กœ ๊ธฐ๋ก
  • โš ๏ธ ์ •์ • (2026-08-26, 5์ฐจ ๊ฐ์‚ฌ ์ง€์ ): ์ด ํ•ญ๋ชฉ์˜ ์ตœ์ดˆ ๊ทผ๊ฑฐ ์„œ์ˆ ์€ ์‚ฌ์‹ค์ด ์•„๋‹ˆ์—ˆ๋‹ค. "AC-07์€ ๊ฐ’ ์—†์ด๋„ ํŒ์ • ๊ฐ€๋Šฅํ•œ ํ˜•ํƒœ"๋ผ๊ณ  ์ ์—ˆ์œผ๋‚˜, v2.0.1์ด AC-07์—์„œ ์‹œ๊ฐ„ ์ƒํ•œ ์กฐ๊ฑด์ ˆ์„ ์ œ๊ฑฐํ–ˆ์œผ๋ฏ€๋กœ(Evolution Log v2.0.1 โ‘ฆ) AC-07์€ ์žฌ์‹œ๋„ ํšŸ์ˆ˜๋งŒ ๊ทœ์ •ํ•œ๋‹ค. ๋”ฐ๋ผ์„œ ์ž๊ฐ€ ๊ฒ€์ฆ์ด ์‹คํŒจ๋„ ์„ฑ๊ณต๋„ ํ•˜์ง€ ์•Š๊ณ  ๋งค๋‹ฌ๋ฆฐ ๊ฒฝ์šฐ๋ฅผ ํŒ์ •ํ•  ์ธ์ˆ˜ ๊ธฐ์ค€์ด ํ˜„์žฌ ์กด์žฌํ•˜์ง€ ์•Š๋Š”๋‹ค. ๋‘ ๋ณด๋ฅ˜ ํ•ญ๋ชฉ ์ค‘ A-02๋งŒ์ด ์•ˆ์ „ ๊ธฐ๋ณธ๊ฐ’(C-04 ์ „ํ™˜ ์กฐํ•ญ)์œผ๋กœ ๋ณดํ˜ธ๋˜๋ฉฐ, ์‹œ๊ฐ„ ์ƒํ•œ์€ ๋ณดํ˜ธ๋˜์ง€ ์•Š๋Š”๋‹ค. ๊ฐ’ ํ™•์ •๊ณผ ๋ณ„๊ฐœ๋กœ AC ๋ณต์›์ด ํ•„์š”ํ•˜๋‹ค โ€” ์ด๋Š” v2.2.0 ์ดํ›„์˜ ๋ฏธ๊ฒฐ ๊ณผ์ œ๋กœ ๋‚จ๊ธด๋‹ค
  • Source: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต + Seed spec ยง4 Planning ์ž…๋ ฅ 8ยท9๋ฒˆ

D-021: ์ธ์ˆ˜ ๊ฒฝ๊ณ„๋ฅผ ๋ฒ”์œ„ ๊ฒฝ๊ณ„๋กœ ํ™˜์›ํ•˜๊ณ  ์ธก์ • ์ž๋ฃŒ๋ฅผ Planning ์ž…๋ ฅ์œผ๋กœ ๋ถ„๋ฆฌ (v3.0.0)

  • Date: 2026-08-26
  • Context: ๋‹ค์„ฏ ๋ฒˆ์งธ ๋…๋ฆฝ ํ‰๊ฐ€์—์„œ ๋ชจํ˜ธ์„ฑ์ด 0.4075 โ†’ 0.4975๋กœ ๋‹ค์‹œ ์•…ํ™”ํ–ˆ๋‹ค. ์ „์ฒด ๊ถค์ ์€ 0.625 โ†’ 0.4125 โ†’ 0.47 โ†’ 0.4075 โ†’ 0.4975 โ€” ๊ฐœ์„ ์ด ์•„๋‹ˆ๋ผ ์ง„๋™์ด๋‹ค. 5์ฐจ ๊ฐ์‚ฌ๊ฐ€ ๋‚ด๋ถ€ ๋ชจ์ˆœ 17๊ฑด, ํŒ์ • ๋ถˆ๊ฐ€ AC 5๊ฑด, ๊ทธ๋ฆฌ๊ณ  ๋ฌธ์„œ๊ฐ€ ์ž๊ธฐ ์•ˆ์ „ ์†์„ฑ์„ ์‹ค์ œ๋ณด๋‹ค ๋‚ซ๊ฒŒ ๊ธฐ์ˆ ํ•œ ํ—ˆ์œ„ ์„œ์ˆ  1๊ฑด์„ ํ™•์ธํ–ˆ๋‹ค(v2.0.1์ด AC-07์—์„œ ์‹œ๊ฐ„ ์ƒํ•œ ์กฐ๊ฑด์ ˆ์„ ์ œ๊ฑฐํ–ˆ๋Š”๋ฐ v2.1.0์ด ๊ทธ๊ฒƒ์ด ๋‚จ์•„ ์žˆ๋‹ค๊ณ  ์„œ์ˆ  โ€” ๊ฒฐ๊ณผ์ ์œผ๋กœ ์ž๊ฐ€ ๊ฒ€์ฆ์ด ๋งค๋‹ฌ๋ฆฐ ๊ฒฝ์šฐ๋ฅผ ํŒ์ •ํ•  AC๊ฐ€ ๋ถ€์žฌ). ๊ฐ์‚ฌ๋Š” ๊ฒฐํ•จ์˜ ์žฌ๋ฐœ ์–‘์ƒ๋„ ๋ช…์‹œํ–ˆ๋‹ค: "v2.0.1์ด ๊ณ ์ณค๋‹ค๊ณ  ์ฃผ์žฅํ•œ ๋ฐ”๋กœ ๊ทธ ์ธ์šฉ ์˜ค๋ฅ˜ ์œ ํ˜•์˜ ์žฌ๋ฐœ", "v2.1.0 ์žฌ์ž‘์„ฑ์ด ๋„์ž…ํ•œ ๊ธฐ์กด ๊ฒฐํ•จ ์œ ํ˜•์˜ ์ƒˆ ์‚ฌ๋ก€"
  • ์ง„๋‹จ: ์ ์ˆ˜๊ฐ€ ๋ฌธ์„œ ํ’ˆ์งˆ์ด ์•„๋‹ˆ๋ผ ๋ฌธ์„œ ํ‘œ๋ฉด์ ๊ณผ ์ƒ๊ด€ํ•œ๋‹ค. ๊ทผ๋ณธ ์›์ธ์€ ๊ณ„์ธต ์ฐฉ์˜ค โ€” ยง4 ์ธ์ˆ˜ ๊ฒฝ๊ณ„๊ฐ€ ์ž„๊ณ„๊ฐ’ยท์ธก์ • ํ™˜๊ฒฝยทํ”ฝ์Šค์ฒ˜๊นŒ์ง€ ๊ฐ–์ถ˜ ํ…Œ์ŠคํŠธ ๋ช…์„ธ๊ฐ€ ๋˜๋ ค ํ–ˆ๊ณ , ๊ทธ ๊ฒฐ๊ณผ ์•„์ง ๋งŒ๋“ค์ง€ ์•Š์€ ๋ฌผ๊ฑด์˜ ์ธก์ • ์กฐ๊ฑด์„ ๋ฏธ๋ฆฌ ์ ์–ด์•ผ ํ–ˆ๋‹ค. ์ฑ„์šธ ๊ทผ๊ฑฐ๊ฐ€ ์—†์œผ๋‹ˆ ๊ฐ’์„ ์ง€์–ด๋ƒˆ๊ณ , ์ง€์–ด๋‚ธ ๊ฐ’์ด ๋‹ค์‹œ ๋ถˆ๋ณ€ ์ธต์œ„์— ์ž ๊ฒผ๋‹ค. ํŒŒ์ดํ”„๋ผ์ธ ์„ค๊ณ„์ƒ BDD ์ธ์ˆ˜ ์กฐ๊ฑด์€ Planning ๋‹จ๊ณ„์˜ ์‚ฐ์ถœ๋ฌผ์ด๋ฏ€๋กœ, Specification ๋‹จ๊ณ„๊ฐ€ ๊ทธ ์ผ์„ ๋ฏธ๋ฆฌ ํ•œ ๊ฒƒ์ด ๋ฌธ์ œ์˜€๋‹ค
  • Options:
    1. ยง4๋ฅผ ๋ฒ”์œ„ ๊ฒฝ๊ณ„๋กœ ํ™˜์›ํ•˜๊ณ  ์ธก์ • ์ž๋ฃŒ๋ฅผ Planning ์ž…๋ ฅ ๋ฌธ์„œ๋กœ ๋ถ„๋ฆฌ
    2. v2.2.0์œผ๋กœ ๊ณ„์† ํŒจ์น˜ โ€” ์ง€๋‚œ ๋„ค ๋ผ์šด๋“œ๊ฐ€ ์‹คํŒจ๋ฅผ ์ฆ๋ช…ํ•œ ๋ฐฉ์‹
    3. ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ๊ฐ€ ์ง์ ‘ ๊ฒ€ํ† ยท์ •๋ฆฌ
    4. ํ˜„ ์ƒํƒœ๋กœ Planning ์ง„ํ–‰
  • Decision: ์˜ต์…˜ 1 โ€” ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต(2026-08-26)
  • Rationale: ๋‹ค๋ฅธ ๋ผ์šด๋“œ์™€ ์„ฑ๊ฒฉ์ด ๋‹ค๋ฅด๋‹ค. ์ด์ „ ๊ฐœ์ •๋“ค์€ ๊ฐ™์€ ๊ณ„์ธต ์•ˆ์—์„œ ๋ฌธ๊ตฌ๋ฅผ ๊ณ ์ณค๊ณ  ๋งค๋ฒˆ ์ƒˆ ํ‘œ๋ฉด์„ ๋งŒ๋“ค์—ˆ๋‹ค. ์ด๋ฒˆ์€ ์ž˜๋ชป๋œ ๊ณ„์ธต์— ์žˆ๋˜ ๋‚ด์šฉ์„ ์˜ณ์€ ๊ณ„์ธต์œผ๋กœ ์˜ฎ๊ธฐ๋Š” ๊ฒƒ์ด๋ฏ€๋กœ, ยง4์˜ ๊ฒ€์ฆ ํ‘œ๋ฉด ์ž์ฒด๊ฐ€ ์ค„์–ด๋“ ๋‹ค. ์กฐ์‚ฌํ•œ ์‹ค์ธก ์ž๋ฃŒ(ํ—ˆ์šฉ ํ˜ธ์ŠคํŠธ ๋ชฉ๋ก, ์ฐธ์กฐ ์›Œํฌ์ŠคํŽ˜์ด์Šค ๋ถ„์„, ACP ์—์ด์ „ํŠธ ์„ ์ • ๊ทผ๊ฑฐ)๋Š” ๊ทผ๊ฑฐ๊ฐ€ ํ™•์ธ๋œ ๊ฒƒ์ด๋ฏ€๋กœ ํ๊ธฐํ•˜์ง€ ์•Š๊ณ  docs/planning-inputs-cocode.md๋กœ ์ด๊ด€ํ–ˆ๋‹ค โ€” โš ๏ธ ์›๋ฌธ์€ "ํ—ˆ์šฉ ํ˜ธ์ŠคํŠธ 12์ข…"์œผ๋กœ ๊ฐœ์ˆ˜๋ฅผ ์ ์—ˆ์œผ๋‚˜ ๊ทธ ์ˆ˜๋Š” ์ •๋ณธ์ด ์•„๋‹ˆ๋‹ค(D-051, 2026-09-13 ์ •์ •). ์ด๊ด€๋œ ๊ฒƒ์€ ยง2.1 ํ‘œ์ด๊ณ  ์ •๋ณธ์€ ๊ทธ ํ–‰ ์ง‘ํ•ฉ์ด๋‹ค
  • Impact:
    • Seed spec v3.0.0 โ€” ยง4๊ฐ€ 16๊ฐœ ๋ฒ”์œ„ ๊ฒฝ๊ณ„๋กœ ์žฌ์ž‘์„ฑ๋จ. ์ž„๊ณ„๊ฐ’ยท์ธก์ • ํ™˜๊ฒฝยทํ”ฝ์Šค์ฒ˜ ์ „๋Ÿ‰ ์ด๊ด€
    • docs/planning-inputs-cocode.md ์‹ ์„ค โ€” ํ™•์ • ๊ฒฐ์ • 6๊ฑด, ํ—ˆ์šฉ ํ˜ธ์ŠคํŠธยท์บ์‹œ ๊ฒฝ๋กœ, ์ฐธ์กฐ ์›Œํฌ์ŠคํŽ˜์ด์Šค ๋ถ„์„๊ณผ ์ฃผ์˜์‚ฌํ•ญ, ACP ์—์ด์ „ํŠธ ์„ ์ • ๊ทผ๊ฑฐ, Planning ํ™•์ • ๋Œ€๊ธฐ ํ•ญ๋ชฉ 5๊ฑด
    • 5์ฐจ ๊ฐ์‚ฌ๊ฐ€ ์ง€์ ํ•œ ๋ชจ์ˆœ 17๊ฑด์„ ํ•จ๊ป˜ ์ฒ˜๋ฆฌ: ์‹œ๊ฐ„ ์ƒํ•œ AC ๋ณต์›(AC-08), ํ…Œ์ŠคํŠธ ์Šน์ธ์„ completion_mode์™€ ๋ฌด๊ด€ํ•˜๊ฒŒ ์ ์šฉ, AC-06์—์„œ ํ”„๋กœํ† ์ฝœ ๋ฒ„์ „ ์ œ๊ฑฐ, EditSnapshot ์ž‘์—… ์‹œ์ž‘ ์ƒํƒœ ์ •์˜ ์ˆ˜์ •, Workspace allowed_hosts ์‹ ์„ค, MVP ํ”Œ๋žซํผ์„ C-01์— ๋ช…์‹œ, 1๊ธ‰ ํ”„๋กœ์ ํŠธ ํƒ€์ž… ์ •์˜, ์‹๋ณ„์ž ์žฌ์‚ฌ์šฉ ๋Œ€์‘ํ‘œ, ์ถœ์ฒ˜ํ‘œ ์ผ์น˜, Evolution Log ์ •๋ ฌ, A-05 ์ƒํƒœ enum ๊ต์ •
  • ํ•œ๊ณ„: ์ด ์ ‘๊ทผ์ด ์ˆ˜๋ ดํ•œ๋‹ค๋Š” ๋ณด์žฅ์€ ์—†๋‹ค. ์ž‘์„ฑ์ž๋Š” ์ด์ „ ๋„ค ๋ผ์šด๋“œ์—์„œ๋„ "์ด๋ฒˆ์€ ๋‹ค๋ฅด๋‹ค"๊ณ  ํŒ๋‹จํ–ˆ๊ณ  ๋„ค ๋ฒˆ ๋‹ค ํ‹€๋ ธ๋‹ค. ํŒ๋‹จ ๊ทผ๊ฑฐ๋Š” ์žฌํ‰๊ฐ€ ๊ฒฐ๊ณผ๋กœ๋งŒ ํ™•์ธ ๊ฐ€๋Šฅํ•˜๋‹ค
  • Source: 5์ฐจ ์ ๋Œ€์  ๊ฐ์‚ฌ (2026-08-26) + ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต

D-022: Flutter master ์ฑ„๋„ ์ฑ„ํƒ โ€” ๋„ค์ดํ‹ฐ๋ธŒ ์œˆ๋„์ž‰ API ์‚ฌ์šฉ

  • Date: 2026-08-26
  • Context: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ๊ฐ€ Flutter 3.47.0 ์˜ ๋ฐ์Šคํฌํ†ฑ ์ฐฝ ๋ถ„๋ฆฌ ๊ธฐ๋Šฅ์„ IDE ์— ์ ์šฉํ•˜์ž๊ณ  ์ œ์•ˆํ–ˆ๋‹ค. ์†Œ์Šค๋ฅผ ์ง์ ‘ ํ™•์ธํ•œ ๊ฒฐ๊ณผ API ๋Š” ์‹ค์žฌํ•˜๋‚˜ ์ฑ„๋„ ๊ฒŒ์ดํŒ…์ด ์žˆ์—ˆ๋‹ค:
    • windowingFeature(flutter_tools/lib/src/features.dart:257)๊ฐ€ master: FeatureChannelSetting(available: true) ๋งŒ ์„ ์–ธํ•˜๊ณ  stable: ํ•ญ๋ชฉ์ด ์—†๋‹ค
    • FeatureChannelSetting ๊ธฐ๋ณธ๊ฐ’์ด available = false ์ด๋ฉฐ ์ฃผ์„์ด "์•„๋ž˜์˜ ์–ด๋–ค ์„ค์ •์œผ๋กœ๋„ ์ผค ์ˆ˜ ์—†๋‹ค" ๊ณ  ๋ช…์‹œ
    • flutter_features.dart:99 ์˜ isEnabled ๊ฐ€ if (!featureSetting.available) return false; ๋กœ config ๋ฅผ ์ฝ๊ธฐ๋„ ์ „์— ์ข…๋ฃŒ
    • ์‹คํ—˜: stable 3.47.0 ์—์„œ flutter config --enable-windowing ์€ ์„ฑ๊ณตํ•œ ๊ฒƒ์ฒ˜๋Ÿผ ์‘๋‹ตํ•˜์ง€๋งŒ ์œ„ ๋กœ์ง์ƒ ๊ฐ’์ด ์ฝํžˆ์ง€ ์•Š๋Š”๋‹ค โ€” "์ง€์›๋˜๋Š” ๊ฒƒ ๊ฐ™๋‹ค"๊ณ  ๋ณด์ด๋Š” ์›์ธ
    • API ์ž์ฒด๋Š” @internal ์ด๋ฉฐ _window.dart(๋น„๊ณต๊ฐœ)์— ์žˆ๊ณ , ์›๋ฌธ์ด "ํŒจ์น˜ ๋ฒ„์ „์—์„œ๋„ breaking change ๋ฅผ ๋งŒ๋“ค ๊ฒƒ" ์ด๋ผ ์˜ˆ๊ณ 
  • ์ถ”๊ฐ€ ํ™•์ธ (์˜ค๋„ˆ ์ œ๋ณด): ํ”Œ๋žซํผ๋ณ„ ์ปจํŠธ๋กค๋Ÿฌ๊ฐ€ windowHandle ์„ ๋…ธ์ถœํ•œ๋‹ค โ€” ffi.Pointer<ffi.Void> ๋กœ ๋„ค์ดํ‹ฐ๋ธŒ ํ•ธ๋“ค(Linux GtkWindow, macOS NSWindow, Win32 HWND)์— ์ง์ ‘ ์ ‘๊ทผํ•  ์ˆ˜ ์žˆ๋‹ค(_window_linux.dart:208, _window_macos.dart:200). WindowControllerLinux/WindowControllerMacOS ์ธํ„ฐํŽ˜์ด์Šค๋กœ ์ œ๊ณต๋˜๋ฉฐ, Windows ๋„ค์ดํ‹ฐ๋ธŒ ๋„ํ‚น ๊ฐ™์€ ๊ณ ๊ธ‰ ํ†ตํ•ฉ์ด ๊ฐ€๋Šฅํ•ด์ง„๋‹ค.
  • Options:
    1. ์ถ”์ƒํ™” ๋’ค์— ๋‘๊ณ  window_manager ๋กœ ๊ตฌํ˜„ โ€” stable ์œ ์ง€, ๋„ค์ดํ‹ฐ๋ธŒ ์œˆ๋„์ž‰์ด stable ์— ์˜ค๋ฉด ๊ตฌํ˜„์ฒด ๊ต์ฒด
    2. master ์ฑ„๋„๋กœ ๊ฐ€๊ณ  ๋„ค์ดํ‹ฐ๋ธŒ API ์‚ฌ์šฉ
    3. ๊ตฌํ˜„์ฒด 2๊ฐœ๋ฅผ ํ”Œ๋ž˜๊ทธ๋กœ ๋ณ‘ํ–‰
    4. MVP ์—์„œ ์ฐฝ ๋ถ„๋ฆฌ ์ œ์™ธ
  • Decision: ์˜ต์…˜ 2 โ€” master ์ฑ„๋„ + ๋„ค์ดํ‹ฐ๋ธŒ ์œˆ๋„์ž‰ API. ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต(2026-08-26, ๋‘ ์ฐจ๋ก€ ํ™•์ธ ํ›„)
  • Rationale: windowHandle ๋กœ ์—ด๋ฆฌ๋Š” ๋„ค์ดํ‹ฐ๋ธŒ ๋„ํ‚น์€ window_manager ๋กœ ๋Œ€์ฒดํ•  ์ˆ˜ ์—†๋Š” ๋Šฅ๋ ฅ์ด๋ฉฐ, C-03 ์ด ์ž ๊ทผ "Dart/Flutter ์ „์šฉ ์ˆ˜์ง ๊นŠ์ด" ํฌ์ง€์…”๋‹์— ์ง์ ‘ ๊ธฐ์—ฌํ•œ๋‹ค. Orca(์ˆ˜ํ‰์  ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ดํ„ฐ)๊ฐ€ ๊ฐ–์ง€ ๋ชปํ•˜๋Š” ์ข…๋ฅ˜์˜ ์ฐจ๋ณ„ํ™”๋‹ค.
  • ์ธ์ˆ˜ํ•œ ์œ„ํ—˜ (๋ช…์‹œ):
    • master ์ฑ„๋„์€ ์œˆ๋„์ž‰๋งŒ์ด ์•„๋‹ˆ๋ผ ์ œํ’ˆ ๋นŒ๋“œ ๊ธฐ๋ฐ˜ ์ „์ฒด์— ์ ์šฉ๋œ๋‹ค. stable ์ด ์•„๋‹Œ ํŠธ๋ฆฌ ์œ„์—์„œ ์ œํ’ˆ์„ ๋นŒ๋“œํ•˜๊ฒŒ ๋œ๋‹ค
    • Flutter ๊ฐ€ ์ด API ์— ํŒจ์น˜ ๋ฒ„์ „์—์„œ๋„ breaking change ๋ฅผ ์˜ˆ๊ณ ํ–ˆ๋‹ค โ€” ์—…์ŠคํŠธ๋ฆผ ๋ณ€๊ฒฝ์ด ๊ณง๋ฐ”๋กœ ๋นŒ๋“œ๋ฅผ ๊นจ๋œจ๋ฆด ์ˆ˜ ์žˆ๋‹ค
    • @internal API ์ด๋ฏ€๋กœ ๊ณต๊ฐœ API ์•ˆ์ •์„ฑ ๋ณด์žฅ ๋Œ€์ƒ์ด ์•„๋‹ˆ๋‹ค
    • CIยท๊ฐœ๋ฐœ ํ™˜๊ฒฝ ์ „์ฒด๊ฐ€ master ์ฑ„๋„๋กœ ๊ณ ์ •๋ผ์•ผ ํ•˜๋ฉฐ, cob doctor ๋“ฑ ๋„๊ตฌ ์ฒด์ธ๋„ ์ด๋ฅผ ์ „์ œํ•ด์•ผ ํ•œ๋‹ค
  • ์™„ํ™”: ์ฐฝ ๊ด€๋ฆฌ ํ˜ธ์ถœ์„ ์–‡์€ ์ž์ฒด ์ธํ„ฐํŽ˜์ด์Šค ๋’ค์— ๋‘์–ด, ์—…์ŠคํŠธ๋ฆผ ๋ณ€๊ฒฝ ์‹œ ์ˆ˜์ • ์ง€์ ์„ ํ•œ ๊ณณ์œผ๋กœ ๋ชจ์€๋‹ค. ์ด๋Š” ์˜ต์…˜ 1 ์˜ ์ถ”์ƒํ™”์™€ ๊ฐ™์€ ๊ตฌ์กฐ์ด๋‚˜ ๊ตฌํ˜„์ฒด๋Š” ๋„ค์ดํ‹ฐ๋ธŒ API ๋ฅผ ์ง์ ‘ ์“ด๋‹ค.
  • Impact: ์•„ํ‚คํ…์ฒ˜ ๋ฌธ์„œ์˜ ํ”Œ๋žซํผ ๊ณ„์ธต, cob doctor ์ฑ„๋„ ์ ๊ฒ€, CI ์›Œํฌํ”Œ๋กœ Flutter ์„ค์น˜ ๋‹จ๊ณ„. A-03(์—๋””ํ„ฐ ์„ฑ๋Šฅ) ์ŠคํŒŒ์ดํฌ๋„ master ์ฑ„๋„์—์„œ ์ธก์ •ํ•ด์•ผ ํ•œ๋‹ค
  • Source: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต + Flutter 3.47.0 ์†Œ์Šค ์ง์ ‘ ๊ฒ€์ฆ

D-023: ํ”„๋กœ์ ํŠธ ์ดˆ๊ธฐ ์„ธํŒ…์€ cob ๋กœ ์ˆ˜ํ–‰

  • Date: 2026-08-26
  • Context: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ๊ฐ€ ์ดˆ๊ธฐ ์„ธํŒ…์— cob(co-bricks CLI)๋ฅผ ์“ฐ๋„๋ก ์ง€์‹œํ–ˆ๋‹ค. cob doctor ์‹คํ–‰ ๊ฒฐ๊ณผ dartยทflutterยทmelosยทgcloudยทfirebaseยทghยทbricks ์ „ ํ•ญ๋ชฉ ํ†ต๊ณผ๋ฅผ ํ™•์ธํ–ˆ๋‹ค(/Users/dongwoo/.pub-cache/bin/cob, ์ €์žฅ์†Œ /Users/dongwoo/orca/co-bricks).
  • Decision: cocode ADE ๋ชจ๋…ธ๋ ˆํฌ์˜ ์ดˆ๊ธฐ ์ƒ์„ฑ๊ณผ ์ดํ›„ ๊ธฐ๋Šฅ ์ถ”๊ฐ€๋ฅผ cob ๋กœ ์ˆ˜ํ–‰ํ•œ๋‹ค.
  • ํ™•์ธ๋œ cob ๋Šฅ๋ ฅ (cob --help ์‹คํ–‰ ๊ฒฐ๊ณผ):
    • cob create / cob create-from-config โ€” Mason brick ๊ธฐ๋ฐ˜ ์‹ ๊ทœ ํ”„๋กœ์ ํŠธ ์ƒ์„ฑ
    • cob generate โ€” project.yaml ์‚ฌ์–‘์œผ๋กœ ๋ชจ๋…ธ๋ ˆํฌ + ๊ธฐ๋Šฅ ์ผ๊ด„ ์ƒ์„ฑ
    • cob compose / cob add / cob feature โ€” ๊ธฐ๋Šฅ ๊ณจ๊ฒฉ ์ƒ์„ฑ ๋ฐ ์ฆ๋ถ„ ์ถ”๊ฐ€(usecaseยทblocยทwidgetยทendpoint)
    • cob apply โ€” ๊ธฐ์กด ๋ชจ๋…ธ๋ ˆํฌ์— ๊ธฐ๋Šฅ brick ์ ์šฉ
    • cob diff / cob catalog / cob list-features โ€” ์ฐจ์ด ๊ฒ€์ถœยทbrick ๋ชฉ๋ก
    • cob doctor / cob preflight โ€” ๋„๊ตฌ ์ฒด์ธ ์ ๊ฒ€
    • cob plan โ€” PRD ์˜ FR/AC ์ปค๋ฒ„๋ฆฌ์ง€๋ฅผ capability ์ œ์•ˆ๊ณผ ๋Œ€์กฐ(๊ณ ์•„ FR ์€ hard-fail)
  • ์ฃผ๋ชฉํ•  ์ : cob plan ์ด PRD ์˜ FR/AC ๋ฅผ ๊ฒŒ์ดํŒ…ํ•œ๋‹ค. ์ด ํ”„๋กœ์ ํŠธ๋Š” docs/prd-cocode.md ์™€ docs/bdd-cocode.md ๋ฅผ ์ด๋ฏธ ๊ฐ–๊ณ  ์žˆ์œผ๋ฏ€๋กœ, Breakdown ๋‹จ๊ณ„์—์„œ ์ด ๋ช…๋ น์ด ์ปค๋ฒ„๋ฆฌ์ง€ ๊ฒ€์ฆ์— ์“ฐ์ผ ์ˆ˜ ์žˆ๋‹ค.
  • Impact: ์•„ํ‚คํ…์ฒ˜ ๋ฌธ์„œ์˜ ํ”„๋กœ์ ํŠธ ๋ถ€ํŠธ์ŠคํŠธ๋žฉ ์ ˆ, Scaffold ๋‹จ๊ณ„(ํŒŒ์ดํ”„๋ผ์ธ 4.5๋‹จ๊ณ„)์˜ ์‹คํ–‰ ์ˆ˜๋‹จ
  • ๋ฏธ๊ฒฐ: cocode ADE ๋Š” ์•ฑ์ด ์•„๋‹ˆ๋ผ ๋ฐ์Šคํฌํ†ฑ IDE ์ด๊ณ  Serverpod ๋ฐฑ์—”๋“œ๊ฐ€ ์—†๋‹ค. ๊ธฐ์กด brick ์ด ์ด ํ˜•ํƒœ๋ฅผ ์ง€์›ํ•˜๋Š”์ง€, ์ƒˆ brick ์ด ํ•„์š”ํ•œ์ง€๋Š” Scaffold ๋‹จ๊ณ„์—์„œ cob list-features ๋กœ ํ™•์ธํ•ด์•ผ ํ•œ๋‹ค
  • Source: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ์ง€์‹œ + cob --helpยทcob doctor ์‹คํ–‰ ํ™•์ธ

โš ๏ธ D-112(2026-11-18) ์ฐธ๊ณ  โ€” ์ด ๊ฒฐ์ •์€ ๋Œ€์ฒด๋˜์ง€ ์•Š์•˜๋‹ค. ์ด ๊ฒฐ์ •์€ ํŒ€์ด cocode ๋ชจ๋…ธ๋ ˆํฌ๋ฅผ ๋งŒ๋“ค ๋•Œ ๊ฐœ๋ฐœ ๋„๊ตฌ๋กœ cob ์„ ์“ฐ๋Š” ๊ฒƒ์ด๊ณ  ๊ทธ๋Œ€๋กœ๋‹ค. D-112 ๊ฐ€ ์—†์•ค ๊ฒƒ์€ ์ถœํ•˜๋œ IDE ๊ฐ€ ์‚ฌ์šฉ์ž ๊ธฐ๊ธฐ์—์„œ cob ์„ ์‹คํ–‰ํ•˜๋˜ ๊ธธ(D-091 ยท D-092)์ด๋‹ค.

D-024: ๋ธŒ๋žœ์น˜ ํ† ํด๋กœ์ง€ โ€” development ์‹ ์„ค, PR ์€ development ๋กœ

  • Date: 2026-08-27
  • Context: /cc-product:develop ์ฐฉ์ˆ˜ ์‹œ๋„์—์„œ ์„ธ ๊ฐ€์ง€๊ฐ€ ๋ง‰๊ณ  ์žˆ์Œ์„ ํ™•์ธํ–ˆ๋‹ค. main ์ด 0 ํŒŒ์ผ์ด๋ผ Story ๋ธŒ๋žœ์น˜๋ฅผ ๋”ธ ๊ธฐ์ค€์ด ์—†์—ˆ๊ณ , development ๋ธŒ๋žœ์น˜๊ฐ€ ์•„์˜ˆ ์—†์—ˆ์œผ๋ฉฐ, PR #1 ์ด base=main + head=feature ๋ธŒ๋žœ์น˜๋ผ ๋ฆด๋ฆฌ์Šค ์ปท์˜คํ”„ ๊ฐ€๋“œ(.github/scripts/check_release_branch.py)์— ์ •ํ™•ํžˆ ๋ง‰ํ˜€ ํ•˜์œ„ CI ์žก 7๊ฐœ๊ฐ€ ์ „๋ถ€ skipped ์˜€๋‹ค. CI ์š”์•ฝ์€ ๊ทธ skip ์„ "๊ฒ€์ฆ ๋Œ€์ƒ ์—†์Œ์ด ์•„๋‹ˆ๋ผ ๋ฏธ๊ฒ€์ฆ"์œผ๋กœ ์‹คํŒจ ์ฒ˜๋ฆฌํ•œ๋‹ค.
  • Decision: main ์—์„œ development ๋ฅผ ์‹ ์„คํ•˜๊ณ  PR #1 ์˜ base ๋ฅผ development ๋กœ ๋ณ€๊ฒฝํ•œ๋‹ค. ๊ณ„์ธต์€ CLAUDE.md ๊ทœ์•ฝ๋Œ€๋กœ main โ† release/YYYY-MM-DD โ† development โ† project/* โ†’ epic/* โ†’ story/*.
  • ๊ฒฐ๊ณผ: ์ปท์˜คํ”„ ๊ฐ€๋“œ ํ†ต๊ณผ(๐Ÿšฆ ๋ฆด๋ฆฌ์Šค ์ปท์˜คํ”„ ๊ฐ€๋“œ: success). PR #1 ์„ squash ๋กœ ๋จธ์ง€(7c886a3) โ€” development 10,214 ํŒŒ์ผ.
  • ๋ถ€์ˆ˜ ํšจ๊ณผ: squash ๋กœ b8289d0(58MB main.dill blob)ยทff5d7f9 ๊ฐ€ development ์˜ ์กฐ์ƒ์ด ์•„๋‹ˆ๊ฒŒ ๋๋‹ค. ํžˆ์Šคํ† ๋ฆฌ ์žฌ์ž‘์„ฑ ์—†์ด ํ•ด์†Œ๋˜์–ด #13 ์˜ "์žฌ์ž‘์„ฑ ์—ฌ๋ถ€ ๊ฒฐ์ •" AC ๊ฐ€ ๋ถˆํ•„์š”ํ•ด์กŒ๋‹ค.
  • Impact: ์ดํ›„ ๋ชจ๋“  Story ๋ธŒ๋žœ์น˜์˜ ๊ธฐ์ค€. project/2-cocode-ade-mvpยทepic/3-scaffold-baseline ์ƒ์„ฑ ์™„๋ฃŒ
  • Source: CI ์‹คํ–‰ ๋กœ๊ทธ(run 33021528438) + .github/scripts/check_release_branch.py ์ง์ ‘ ํ™•์ธ

D-025: Flutter 3.47.0 stable ์œ ์ง€ โ€” D-022 ๋ฅผ ๋’ค์ง‘๋Š”๋‹ค

๐Ÿ“Œ ํŒจ์น˜ ์ƒํ–ฅ (2026-09-10) โ€” .fvmrc ๋ฅผ 3.47.0 โ†’ 3.47.3 ์œผ๋กœ ์˜ฌ๋ ธ๋‹ค(ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ์ง€์‹œ). ์ด ๊ฒฐ์ •์„ ๋ฐ”๊พธ์ง€ ์•Š๋Š”๋‹ค โ€” ์ฑ„๋„์€ ์—ฌ์ „ํžˆ stable ์ด๊ณ  D-022(master ์ฑ„๋„ ์š”๊ตฌ)๋Š” ๋’ค์ง‘ํžŒ ์ฑ„๋‹ค. ๊ฐ™์€ minor ์•ˆ์˜ ํŒจ์น˜ ์ด๋™์ด๋ผ ^3.47.0 ์บ๋Ÿฟ ์ œ์•ฝ(rootยทapp/cocodeยทapp/cocode_consoleยทapp/cocode_widgetbookยทshared/dependencies)์€ ๊ทธ๋Œ€๋กœ ์œ ํšจํ•ด pubspec 5๊ณณ์€ ์†๋Œ€์ง€ ์•Š์•˜๋‹ค. ๊ฒ€์ฆ: dart pub get ์„ฑ๊ณต ยท core ํ…Œ์ŠคํŠธ 125๊ฑด ํ†ต๊ณผ ยท check_flutter_stable_pin.py ํ†ต๊ณผ. ํ•จ๊ป˜ ๋งž์ถ˜ ํ•˜๋“œ์ฝ”๋”ฉ: build.desktop.yaml ยท warm-flutter-sdk.yml ยท README ยท CLAUDE.md ยท SCAFFOLD.md. โš ๏ธ docs/*.md ์˜ ยซFlutter 3.47.0 ๊ธฐ์ค€ ์‹ค์ธกยป ๊ธฐ๋ก์€ ๊ทธ๋Œ€๋กœ ๋‘”๋‹ค โ€” ๊ทธ ์‹œ์ ์˜ ์‚ฌ์‹ค์ด๋‹ค.

๐Ÿ“Œ ํŒจ์น˜ ์ƒํ–ฅ (2026-10-02, #483) โ€” .fvmrc ๋ฅผ 3.47.3 โ†’ 3.47.6 ์œผ๋กœ ์˜ฌ๋ ธ๋‹ค(ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ์ง€์‹œ โ€” ์ฒ˜์Œ์—” CI flutter-setup ๊ธฐ๋ณธ๊ฐ’(#478)์ธ 3.47.5 ๋กœ ๋งž์ถ”๋ ค ํ–ˆ์œผ๋‚˜, 2026-10-01 ์— ๋‚˜์˜จ ์ตœ์‹  stable 3.47.6 ์œผ๋กœ ์ •ํ–ˆ๋‹ค). CI flutter-setup ๊ธฐ๋ณธ๊ฐ’๋„ ๊ฐ™์€ 3.47.6 ์œผ๋กœ ์˜ฌ๋ ค ๋กœ์ปฌ(fvm ยท lefthook with-fvm.sh)๊ณผ CI ์˜ ํŒจ์น˜ ๋ฒ„์ „์„ ๋‹ค์‹œ ํ•˜๋‚˜๋กœ ๋งž์ท„๋‹ค. ์ด ๊ฒฐ์ •์„ ๋ฐ”๊พธ์ง€ ์•Š๋Š”๋‹ค โ€” ์ฑ„๋„์€ ์—ฌ์ „ํžˆ stable ์ด๋‹ค. ^3.47.0 ์บ๋Ÿฟ ์ œ์•ฝ์€ ๊ทธ๋Œ€๋กœ ์œ ํšจํ•ด pubspec ์€ ์†๋Œ€์ง€ ์•Š์•˜๋‹ค. ๊ฒ€์ฆ: flutter pub get ์„ฑ๊ณต(lock ๋ณ€ํ™” ์—†์Œ) ยท core ํ…Œ์ŠคํŠธ 485๊ฑด ํ†ต๊ณผ ยท check_flutter_stable_pin.py ํ†ต๊ณผ. ํ•จ๊ป˜ ๋งž์ถ˜ ํ•˜๋“œ์ฝ”๋”ฉ: flutter-setup/action.yaml ยท build.desktop.yaml ยท warm-flutter-sdk.yml ยท README ยท CLAUDE.md ยท SCAFFOLD.md ยท run_all_scenarios.sh ์ฃผ์„. โš ๏ธ docs/*.md ์˜ ยซ3.47.3 ์—์„œ ์ธก์ •ยป ๊ธฐ๋ก(AC-15ยทA-06ยทAC-16 ๋“ฑ)์€ ๊ทธ๋Œ€๋กœ ๋‘”๋‹ค โ€” ์œ„ ์„ ๋ก€์™€ ๊ฐ™์€ ์ด์œ ๋‹ค.

๐Ÿ“Œ ํŒจ์น˜ ์ƒํ–ฅ (2026-10-28, #1437) โ€” .fvmrc ๋ฅผ 3.47.6 โ†’ 3.47.8 ์œผ๋กœ ์˜ฌ๋ ธ๋‹ค(2026-10-23 ์— ๋‚˜์˜จ ์ตœ์‹  stable 3.47.8 ยท Dart 3.13.5 โ†’ 3.13.7 โ€” ์กฐ์ง์˜ fvm ๋ ˆํฌ ์ผ๊ด„ ์ƒํ–ฅ #1437 ์˜ ์ผ๋ถ€). CI flutter-setup ๊ธฐ๋ณธ๊ฐ’๋„ ๊ฐ™์€ 3.47.8 ๋กœ ์˜ฌ๋ ค ๋กœ์ปฌ(fvm ยท lefthook with-fvm.sh)๊ณผ CI ์˜ ํŒจ์น˜ ๋ฒ„์ „์„ ํ•˜๋‚˜๋กœ ๋งž์ท„๋‹ค. ์ด ๊ฒฐ์ •์„ ๋ฐ”๊พธ์ง€ ์•Š๋Š”๋‹ค โ€” ์ฑ„๋„์€ ์—ฌ์ „ํžˆ stable ์ด๋‹ค. ^3.47.0 ์บ๋Ÿฟ ์ œ์•ฝ์€ ๊ทธ๋Œ€๋กœ ์œ ํšจํ•ด pubspec ์€ ์†๋Œ€์ง€ ์•Š์•˜๋‹ค. ๊ฒ€์ฆ: flutter pub get ์„ฑ๊ณต(lock ๋ณ€ํ™” ์—†์Œ) ยท core ํ…Œ์ŠคํŠธ 485๊ฑด ํ†ต๊ณผ(skip 3) ยท check_flutter_stable_pin.py ํ†ต๊ณผ. ํ•จ๊ป˜ ๋งž์ถ˜ ํ•˜๋“œ์ฝ”๋”ฉ: flutter-setup/action.yaml ยท build.desktop.yaml ยท warm-flutter-sdk.yml ยท README ยท CLAUDE.md ยท SCAFFOLD.md ยท run_all_scenarios.sh ์ฃผ์„. โš ๏ธ docs/*.md ์™€ ์ด์šฉ ๊ฐ€์ด๋“œ(site/manual)์— ์ ํžŒ ยซ3.47.6 ์—์„œ ์ธก์ •ยทํ™•์ธยป ๊ธฐ๋ก์€ ๊ทธ๋Œ€๋กœ ๋‘”๋‹ค โ€” ์œ„ ์„ ๋ก€์™€ ๊ฐ™์€ ์ด์œ ๋‹ค. โš ๏ธ ๋Ÿฌ๋„ˆ ํ˜ธ์ŠคํŠธ(M2 Ultra ยท M4 Max)์— ~/fvm/versions/3.47.8 ์ด ๋จผ์ € ์žˆ์–ด์•ผ ํ•œ๋‹ค โ€” pages.yaml ์˜ ยซ๐Ÿ”— FVM SDK ๋งํฌยป ๊ฐ€ .fvmrc ๋ฒ„์ „์„ ๊ฑฐ๊ธฐ์„œ ์ฐพ๊ณ  ์—†์œผ๋ฉด ์‹คํŒจํ•œ๋‹ค(๋‘ ํ˜ธ์ŠคํŠธ ๋ชจ๋‘ ์„ค์น˜ ์™„๋ฃŒ, fvm global ๋„ 3.47.8).

๐Ÿ“Œ minor ์ƒํ–ฅ (2026-11-16, #1609) โ€” .fvmrc ๋ฅผ 3.47.9 โ†’ 3.50.0 ์œผ๋กœ ์˜ฌ๋ ธ๋‹ค(์˜ค๋„ˆ ์ง€์‹œ โ€” ๋ฉ€ํ‹ฐ์œˆ๋„์šฐ์— ๋” ์ ๊ทน์ ์œผ๋กœ ๋Œ€์‘ํ•˜๊ธฐ ์œ„ํ•ด. 2026-11-09 stable ยท Dart 3.13.7 โ†’ 3.14.0). ํŒจ์น˜๊ฐ€ ์•„๋‹ˆ๋ผ minor ์ด๋™์ด๋ผ ๋ฃจํŠธ pubspec.yaml ์˜ flutter: ๋ฅผ ^3.47.0 โ†’ ^3.50.0 ์œผ๋กœ ํ•จ๊ป˜ ์˜ฌ๋ ธ๋‹ค(ํŒจํ‚ค์ง€๋ณ„ ^3.47.0 ์€ ํ•ด์„์— ํ•„์š”ํ•˜์ง€ ์•Š์•„ ๊ทธ๋Œ€๋กœ ๋’€๋‹ค). ์ด ๊ฒฐ์ •์„ ๋ฐ”๊พธ์ง€ ์•Š๋Š”๋‹ค โ€” ์ฑ„๋„์€ ์—ฌ์ „ํžˆ stable ์ด๋‹ค. โš ๏ธ ์•„๋ž˜ ยซํ™•์ธ๋œ ๊ท€๊ฒฐยป ์€ 3.50.0 ์—์„œ๋„ ๊ทธ๋Œ€๋กœ๋‹ค: ~/fvm/versions/3.50.0/packages/flutter_tools/lib/src/features.dart:266 ์˜ windowingFeature ๋Š” ์—ฌ์ „ํžˆ master: ๋งŒ ์„ ์–ธํ•˜๊ณ , flutter_features.dart:106 ์ด config ๋ฅผ ์ฝ๊ธฐ ์ „์— ๋ง‰๋Š”๋‹ค. ์ฆ‰ ์ด ์ƒํ–ฅ๋งŒ์œผ๋กœ๋Š” stable ์—์„œ ์œˆ๋„์ž‰ ํ”Œ๋ž˜๊ทธ๋ฅผ ์ผค ์ˆ˜ ์—†๋‹ค โ€” ๋‹ฌ๋ผ์ง„ ๊ฒƒ์€ ํ”„๋ ˆ์ž„์›Œํฌ ์ชฝ ์‹คํ—˜ API ์˜ ๋‚ด์šฉ์ด๋‹ค(packages/flutter/lib/src/widgets/_window*.dart โ€” RegularWindow ยท RegularWindowController ๊ฐ€ Window ยท WindowController ๋กœ ์ด๋ฆ„์ด ๋ฐ”๋€Œ์—ˆ๊ณ  Win32 ยท Linux ๊ตฌํ˜„์ด ๋Š˜์—ˆ๋‹ค). ์ฐฝ ๋ถ„๋ฆฌ๋ฅผ ์‹ค์ œ๋กœ ์“ฐ๋ ค๋ฉด D-022 ์žฌ๊ฒ€ํ† (์ฑ„๋„)๊ฐ€ ์—ฌ์ „ํžˆ ํ•„์š”ํ•˜๋‹ค. ํ•จ๊ป˜ ๋งž์ถ˜ ํ•˜๋“œ์ฝ”๋”ฉ: flutter-setup/action.yaml ยท build.desktop.yaml ยท warm-flutter-sdk.yml ยท README ยท CLAUDE.md ยท SCAFFOLD.md ยท .vscode/settings.json ยท run_all_scenarios.sh ์ฃผ์„. site/ ์›Œํฌ์ŠคํŽ˜์ด์Šค๋Š” ์†๋Œ€์ง€ ์•Š์•˜๋‹ค โ€” Dart 3.14.0 ์—์„œ ํ’€๋ฆฌ์ง€ ์•Š์•„ setup-dart 3.13.7 ๊ณ ์ •(#1595)์„ ์œ ์ง€ํ•˜๋ฏ€๋กœ ๋ฃจํŠธ(Dart 3.14.0)์™€ ์‚ฌ์ดํŠธ(Dart 3.13.7)์˜ Dart ๋ฒ„์ „์ด ๊ฐˆ๋ฆฐ๋‹ค. โš ๏ธ ๋Ÿฌ๋„ˆ ํ˜ธ์ŠคํŠธ์— ~/fvm/versions/3.50.0 ์ด ๋จผ์ € ์žˆ์–ด์•ผ ํ•œ๋‹ค(pages.yaml ยซ๐Ÿ”— FVM SDK ๋งํฌยป). โš ๏ธ docs/*.md ยท ์ฝ”๋“œ ์ฃผ์„์˜ ยซ3.47.x ์—์„œ ์ธก์ • ยท ํ™•์ธยป ๊ธฐ๋ก์€ ๊ทธ๋Œ€๋กœ ๋‘”๋‹ค โ€” ์œ„ ์„ ๋ก€์™€ ๊ฐ™์€ ์ด์œ ๋‹ค.

  • Date: 2026-08-27
  • Context: D-022 ๋Š” windowHandle ๋„ค์ดํ‹ฐ๋ธŒ ๋„ํ‚น์„ ์œ„ํ•ด master ์ฑ„๋„ ์ „ํ™˜์„ ๊ฒฐ์ •ํ•˜๊ณ  ๊ทธ ์œ„ํ—˜(์ œํ’ˆ ๋นŒ๋“œ ๊ธฐ๋ฐ˜ ์ „์ฒด๊ฐ€ master ์œ„์— ์„œ๊ณ  @internal API ๊ฐ€ ํŒจ์น˜ ๋ฒ„์ „์—์„œ๋„ breaking change)์„ ์ธ์ˆ˜ํ–ˆ๋‹ค. ๊ทธ๋Ÿฌ๋‚˜ ์ „ํ™˜์€ ์‹คํ–‰๋˜์ง€ ์•Š์•˜๊ณ  .fvmrc ๋Š” 3.47.0 stable ์ด์—ˆ๋‹ค. ๊ฒฐ์ • ์ด์Šˆ #100 ์œผ๋กœ ์˜ค๋„ˆ์—๊ฒŒ ํ™•์ธํ–ˆ๋‹ค.
  • Decision: master ์ฑ„๋„๋กœ ์ „ํ™˜ํ•˜์ง€ ์•Š๋Š”๋‹ค. 3.47.0 stable ์„ ์œ ์ง€ํ•œ๋‹ค.
  • ํ™•์ธ๋œ ๊ท€๊ฒฐ โ€” ๋„ค์ดํ‹ฐ๋ธŒ ์œˆ๋„์ž‰์€ MVP ๋ฐ–: ~/fvm/versions/3.47.0/packages/flutter_tools/lib/src/features.dart:257 ์‹ค์ธก โ€”
    const windowingFeature = Feature(
                          name: 'support for windowing on macOS, Linux, and Windows',
                          configSetting: 'enable-windowing',
                          environmentOverride: 'FLUTTER_WINDOWING',
                          runtimeId: 'windowing',
                          master: FeatureChannelSetting(available: true),   // โ† master ๋งŒ ์„ ์–ธ
                        );
                        
    stable: ํ•ญ๋ชฉ์ด ์—†๊ณ  FeatureChannelSetting ๊ธฐ๋ณธ๊ฐ’์ด available: false ์ด๋ฉฐ, flutter_features.dart ๊ฐ€ if (!featureSetting.available) return false; ๋กœ config ๋ฅผ ์ฝ๊ธฐ ์ „์— ์ฐจ๋‹จํ•œ๋‹ค. flutter config --enable-windowing ๋„ FLUTTER_WINDOWING ํ™˜๊ฒฝ๋ณ€์ˆ˜๋„ stable ์—์„œ๋Š” ํšจ๊ณผ๊ฐ€ ์—†๋‹ค.
  • Impact: #9(master ์ „ํ™˜) ๋ฒ”์œ„ ๋ฐ– โ†’ ์ข…๋ฃŒ. #10(ํšŒ๊ท€ ๊ฐ€๋“œ) ๋ฐฉํ–ฅ ์ „ํ™˜ โ€” "master ์ดํƒˆ ๊ฐ์ง€". #54 ๋Š” ์ธํ„ฐํŽ˜์ด์Šค seam ๋งŒ ์œ ์ง€ํ•˜๊ณ  ๋„ค์ดํ‹ฐ๋ธŒ ๋„ํ‚น ๊ตฌํ˜„์€ MVP ๋ฐ–. ux-spec ยง2.3 ์˜ ๋‹จ์ผ ์ฐฝ ์ „์ œ๊ฐ€ ํ™•์ •๋œ๋‹ค.
  • โš ๏ธ ์ฃผ์˜: ์ด ๊ฒฐ์ •์€ ํ”„๋กœ์ ํŠธ ์ฐฉ์ˆ˜ ์‹œ์˜ ๋™๊ธฐ("๋ฐ์Šคํฌํ†ฑ ์ฐฝ๋ถ„๋ฆฌ ๊ธฐ๋Šฅ์ด ์ƒˆ๋กญ๊ฒŒ ์ง€์›๋˜์–ด์„œ IDE์— ์ ์šฉํ•˜๋ฉด ์ข‹์„๊ฒƒ ๊ฐ™์•„")์™€ ์–ด๊ธ‹๋‚œ๋‹ค. ์ฐฝ ๋ถ„๋ฆฌ๋ฅผ MVP ์— ๋„ฃ์œผ๋ ค๋ฉด D-022 ๋กœ ๋˜๋Œ์•„๊ฐ€์•ผ ํ•œ๋‹ค.
  • Source: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ๊ฒฐ์ •(#100) + Flutter 3.47.0 SDK ์†Œ์Šค ์ง์ ‘ ๊ฒ€์ฆ

D-026: ๋„๋„ˆ(unibook) ์œ ๋ž˜ ์ž์‚ฐ ์กด์น˜

  • Date: 2026-08-27
  • Status: ๋Œ€์ฒด๋จ โ€” D-087 (2026-09-28, #458). ๋ฐฑ์—”๋“œ ์กด์น˜ ๋ถ€๋ถ„๋งŒ ์œ ์ง€๋œ๋‹ค.
  • Context: SCAFFOLD.md ๊ฐ€ "ํ‘œ์ค€ ๊ตฌ์กฐ๋ฅผ ๋จผ์ € ์„ธ์šฐ๊ณ  ๊ฐœ์„ ์€ ์ดํ›„"๋กœ ํŒ๋‹จ์„ ๋ฏธ๋ค„ ๋‘” ํ•ญ๋ชฉ. ๊ฒฐ์ • ์ด์Šˆ #102 ๋กœ ์˜ค๋„ˆ์—๊ฒŒ ํ™•์ธํ–ˆ๋‹ค.
  • Decision: ์กด์น˜ํ•œ๋‹ค. ์˜ค๋„ˆ ์›๋ฌธ โ€” "์กด์น˜ ํ•ด์ค˜ ์ถ”ํ›„ ๋ฐฑ์—”๋“œ๊ฐ€ ํ•„์š”ํ• ์ˆ˜๋„ ์žˆ์–ด์„œ ๋‚จ๊ฒจ๋‘์—ˆ์–ด".
  • ์กด์น˜ ๋Œ€์ƒ ์‹ค์ธก (7c886a3): feature/console/ 38 ยท feature/common/ 9 ยท feature/application/ 6 ยท backend/{cocode_client,cocode_server} ยท app/{cocode_console,cocode_widgetbook} ยท app/cocode/{android,ios,web}
  • โš ๏ธ ์ด ๊ฒฐ์ •์ด ํ’€์ง€ ๋ชปํ•˜๋Š” ๊ฒƒ: CI ๋ฅผ ๋ง‰๋Š” ๋„๋„ˆ ๊ฐ€๋“œ๋Š” ์‹ค์žฌํ•˜์ง€ ์•Š๋Š” ํŒจํ‚ค์ง€(book_content_viewerยทmy_library)๋ฅผ ์ฐธ์กฐํ•œ๋‹ค โ€” cob create ๊ฐ€ ์• ์ดˆ์— ์ƒ์„ฑํ•˜์ง€ ์•Š์•˜๋‹ค. ์กด์น˜ํ•  ๋Œ€์ƒ ์ž์ฒด๊ฐ€ ์—†์œผ๋ฏ€๋กœ #12(๋„๋„ˆ CI ๊ฐ€๋“œ ์ •๋ฆฌ)๋Š” ๊ทธ๋Œ€๋กœ ํ•„์š”ํ•˜๋‹ค.
  • Impact: #8 ๋ฒ”์œ„ ์ „ํ™˜(์ œ๊ฑฐ โ†’ ์กด์น˜ ํ™•์ธ). #6 ์กด์น˜ ํ™•์ •. #4 ๋ฐฐ์น˜ํ‘œ๋Š” cocode_* 12์ข…์„ ๊ธฐ์กด ์ž์‚ฐ๊ณผ ๊ณต์กดํ•˜๋„๋ก ๋ฐฐ์น˜ํ•ด์•ผ ํ•œ๋‹ค. #99(SSPL-1.0 ์žฌ๋ฐฐํฌ ๊ฒ€ํ† )๊ฐ€ ๊ฐ€์ •์ด ์•„๋‹ˆ๋ผ ์‹ค์ œ ์Ÿ์ ์ด ๋๋‹ค.
  • ๋ฏธ๊ฒฐ: ๋ฐฑ์—”๋“œ๋ฅผ "์กด์น˜ํ•˜๋˜ MVP ๋ฏธ์‚ฌ์šฉ"์ธ์ง€ "MVP ์‚ฌ์šฉ"์ธ์ง€ โ€” #4 ๋ฐฐ์น˜ํ‘œ๊ฐ€ ๊ธฐ๋กํ•œ๋‹ค
  • Source: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ๊ฒฐ์ •(#102) + ํŠธ๋ฆฌ ์‹ค์ธก

D-027: architecture ยง6.1 DD-21 / 21a / 21b ์ฑ„ํƒ

  • Date: 2026-08-27
  • Context: Design ๋ฆฌ๋ทฐ๊ฐ€ C-04 โ‘ค๋ฅผ ๋„๋‹ฌ ๋ถˆ๊ฐ€๋Šฅํ•œ ์‚ฌ๋ฌธ์œผ๋กœ ํŒ์ •ํ–ˆ๋‹ค โ€” โ‘ค๋Š” โ‘ ~โ‘ฃ๊ฐ€ ๋ชจ๋‘ "๋Œ€์ƒ ์—†์Œ"์ผ ๋•Œ๋งŒ ์—ด๋ฆฌ๋Š”๋ฐ ์•„ํ‚คํ…์ฒ˜๊ฐ€ โ‘ข์„ ํ•ญ์ƒ "๋ฏธ์‹คํ–‰"์œผ๋กœ ์ฒ˜๋ฆฌํ•ด ๊ทธ ์กฐ๊ฑด์ด ์„ฑ๋ฆฝํ•  ์ˆ˜ ์—†์—ˆ๋‹ค. ์•„ํ‚คํ…์ฒ˜ ยง6.1 ์ด ํ•ด์†Œ์•ˆ์„ ๋ƒˆ์œผ๋‚˜ ์ฑ„ํƒ ํ™•์ •์ด ์‚ฌ๋žŒ ๊ฒฐ์ •์ด์—ˆ๋‹ค. ๊ฒฐ์ • ์ด์Šˆ #101 ๋กœ ํ™•์ธํ–ˆ๋‹ค.
  • Decision: ์ฑ„ํƒํ•œ๋‹ค.
    • DD-21 โ€” โ‘ ~โ‘ฃ๋Š” "์ ์šฉ ๋ถˆ๊ฐ€"๋ฅผ ํŒ์ •ํ•˜์ง€ ์•Š๊ณ  ์‹คํ–‰ํ•œ๋‹ค. {ํ†ต๊ณผ, ์‹คํŒจ, ๋Œ€์ƒ์—†์Œ} ์„ ๋ฐ˜ํ™˜ํ•˜๊ณ  ๋Œ€์ƒ์—†์Œ ์€ ํ์‡„ ์‚ฌ์œ  ์ฝ”๋“œ 4์ข…(no_target:build_no_configured_target ยท no_target:test_zero_collected ยท no_target:no_debug_session ยท no_target:file_not_analyzed)์„ ๋™๋ฐ˜ํ•œ๋‹ค.
    • DD-21a โ€” ๊ฒฐ๊ณผ ์šฐ์„ ์ˆœ์œ„ ์‹คํŒจ > ํ†ต๊ณผ. ์ดˆํŒ์€ ์ค‘์žฌ๊ฐ€ ์—†์–ด โ‘ฃ๊ฐ€ ์ƒˆ ์˜ค๋ฅ˜๋ฅผ ๋ฑ‰์–ด๋„ โ‘ ์ด ์„ฑ๊ณตํ–ˆ๋‹ค๋Š” ์ด์œ ๋กœ ์™„๋ฃŒ ์ „์ด๊ฐ€ ๊ฐ€๋Šฅํ–ˆ๋‹ค.
    • DD-21b โ€” โ‘ค๋Š” 3ํ•ญ ์ˆ ์–ด(ํŒŒ์ผ ์ฝํž˜ ยท ํŒŒ์„œ ๋ฌด์˜ค๋ฅ˜ ยท ์ •์  ๋ถ„์„ ์ƒˆ ์˜ค๋ฅ˜ ์—†์Œ). ์‹คํ–‰์ž๋Š” toolchain.
    • ์‹คํ–‰ ์ˆœ์„œ โ‘ฃ โ†’ โ‘ก โ†’ โ‘  โ†’ โ‘ข, ์กฐ๊ธฐ ์ข…๋ฃŒ๋Š” ์‹คํŒจ ํ™•์ธ ํ›„์—๋งŒ. ์ดˆํŒ์˜ "ํ†ต๊ณผ๊ฐ€ ๋‚˜์˜ค๋ฉด ๋‚˜๋จธ์ง€ ๋ฏธ์‹คํ–‰" ๊ทœ์น™์€ ์ฒ ํšŒํ•œ๋‹ค.
  • Impact: AC-09 ๊ฐ€ ๊ธฐ๊ณ„์ ์œผ๋กœ ํŒ์ • ๊ฐ€๋Šฅํ•ด์ง„๋‹ค. #63 ์ฐฉ์ˆ˜ ๊ฐ€๋Šฅ. #73 ์€ ๋Œ€์ƒ์—†์Œ(no_target)๊ณผ "ํ™˜๊ฒฝ ์‹คํŒจ"๊ฐ€ ๋‹ค๋ฅธ ์ถ•์ž„์„ ๋ช…์‹œํ•ด์•ผ ํ•œ๋‹ค.
  • ๋ง‰์ง€ ๋ชปํ•˜๋Š” ๊ฒƒ(์ •์งํ•˜๊ฒŒ): ํ†ต๊ณผํ•œ ๋ฐฉ๋ฒ•์ด ํŽธ์ง‘ ๋Œ€์ƒ์„ ์‹ค์ œ๋กœ ๊ฒ€์‚ฌํ–ˆ๋Š”์ง€๋Š” ๋ณด์žฅํ•˜์ง€ ์•Š๋Š”๋‹ค. CI yaml ํ•œ ์ค„๋งŒ ๊ณ ์นœ ์ž‘์—…๋„ โ‘ ์ด๋‚˜ โ‘ก๊ฐ€ ํ†ต๊ณผํ•ด ์™„๋ฃŒ๋  ์ˆ˜ ์žˆ๋‹ค. Seed Spec C-04/AC-09 ๋ฌธ๋ฉด์—์„œ ์˜ค๋Š” ๊ฒƒ์ด๋ผ Design ์ด ๊ฒฝ๊ณ„๋ฅผ ๋„“ํžˆ์ง€ ์•Š๊ณ ๋Š” ๊ณ ์น  ์ˆ˜ ์—†๋‹ค โ€” A-02 ์ŠคํŒŒ์ดํฌ๊ฐ€ ์ธก์ •ํ•  ์‹คํŒจ ๋ชจ๋“œ๋กœ ๋‚จ๋Š”๋‹ค.
  • Source: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ๊ฒฐ์ •(#101) + docs/architecture-cocode.md ยง6.1

D-028: ๋Œ€์šฉ๋Ÿ‰ ํŒŒ์ผ CI ๊ฐ€๋“œ ์ž„๊ณ„ 50 MiB

  • Date: 2026-08-28
  • Context: #13 ์ด index ๋‚ด ๋Œ€์šฉ๋Ÿ‰ ํŒŒ์ผ ๊ฐ€๋“œ๋ฅผ ์‹ ์„คํ•˜๋ฉฐ ์ž„๊ณ„ ๋ฐ”์ดํŠธ ๊ฐ’์„ ใ€ŒํŒ์ • ์ฃผ์ฒด: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ, ๊ฐ’ ํ™•์ • ์ „ AC ๋ฏธ์™„๋ฃŒใ€๋กœ ๋‚จ๊ฒผ๋‹ค. ์‚ฌ๋ก€๋Š” main.dill 55.64 MiB(์ปค๋ฐ‹ b8289d0), GitHub ๋Š” 50 MiB ๊ฒฝ๊ณ  ยท 100 MiB ์ฐจ๋‹จ.
  • Options:
    1. 50 MiB โ€” GitHub ๊ฒฝ๊ณ ์„  ๊ทธ๋Œ€๋กœ. main.dill ๊ธ‰์„ ์žก๊ณ  ํ˜„ํ–‰ ์ถ”์  ํŒŒ์ผ ์ตœ๋Œ€๊ฐ€ ํ›จ์”ฌ ์ž‘์•„ ์˜คํƒ ์—†์Œ
    2. 10 MiB โ€” ์ž‘์€ ์‚ฐ์ถœ๋ฌผ๋„ ์กฐ๊ธฐ ์ฐจ๋‹จํ•˜๋‚˜ ์ •๋‹นํ•œ ๋Œ€์šฉ๋Ÿ‰ ์ž์‚ฐ์ด ์ƒ๊ธฐ๋ฉด ํ—ˆ์šฉ๋ชฉ๋ก ๊ด€๋ฆฌ ํ•„์š”
    3. 25 MiB โ€” ์ ˆ์ถฉ
  • Decision: ์˜ต์…˜ 1 โ€” 50 MiB (52,428,800 B)
  • Rationale: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•์ •(2026-08-28). ์‹ค์ธก ์‚ฌ๋ก€๋ฅผ ์žก๋Š” ์ตœ์†Œ ๊ฐœ์ž…์ด๋ฉฐ ๊ฐ’ ๋ณ€๊ฒฝ์€ ์ด ๋กœ๊ทธ์— ๊ทผ๊ฑฐ๋ฅผ ๋‚จ๊ธฐ๊ณ  check_large_files.py ์˜ MAX_BYTES ๋ฅผ ์ˆ˜์ •ํ•œ๋‹ค(์ง ํ…Œ์ŠคํŠธ๊ฐ€ ์ƒ์ˆ˜ ํšŒ๊ท€๋ฅผ ๊ณ ์ •).
  • Impact: .github/scripts/check_large_files.py + ci.yml changes ์žก ๋ฐฐ์„ . #13 AC 4 ์™„๋ฃŒ ๊ฐ€๋Šฅ.
  • Source: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ๊ฒฐ์ • (#13 ์‚ฌ์ดํด ์ค‘ ํ™•์ธ)

D-029: ํžˆ์Šคํ† ๋ฆฌ ์ž”์กด main.dill blob ์ฒ˜๋ถ„ โ€” ๊ฒฐ์ • ๋Œ€๊ธฐ

  • Date: 2026-08-28 (๊ธฐ๋ก๋งŒ โ€” ๊ฒฐ์ • ์•„๋‹˜)
  • Context: #13 AC 8 ์ด ใ€Œํžˆ์Šคํ† ๋ฆฌ ์žฌ์ž‘์„ฑ ์—ฌ๋ถ€๋Š” ๋ฒ”์œ„ ๋ฐ– ยท ๊ฒฐ์ • ๋Œ€๊ธฐ๋กœ ๊ธฐ๋กใ€์„ ์š”๊ตฌํ–ˆ๋‹ค. ๋‹จ ์ „์ œ๊ฐ€ ์ด์Šˆ ์ž‘์„ฑ ์‹œ์ ๊ณผ ๋‹ฌ๋ผ์กŒ๋‹ค: ์ด์Šˆ๋Š” ใ€Œ๊ฒฐ์ • ์‹œํ•œ: PR #1 ์ด development ๋กœ ๋จธ์ง€๋˜๊ธฐ ์ „ใ€์ด๋ผ ํ–ˆ์œผ๋‚˜, PR #1 ์€ squash ๋กœ ๋จธ์ง€๋˜์–ด(7c886a3) b8289d0(blob 58,339,928 B ๋ณด์œ  ์ปค๋ฐ‹)์€ developmentยทepic ๊ณ„๋ณด์˜ ์กฐ์ƒ์ด ์•„๋‹ˆ๊ฒŒ ๋๋‹ค(git merge-base --is-ancestor b8289d0 origin/development โ†’ exit 1, ์‹ค์ธก 2026-08-28). blob ์€ ํ˜„์žฌ product-artifact-200c74e2 ๋ธŒ๋žœ์น˜ ๊ณ„๋ณด์—๋งŒ ์ž”์กดํ•œ๋‹ค.
  • Options:
    1. product-artifact-200c74e2 ์›๊ฒฉ ๋ธŒ๋žœ์น˜ ์‚ญ์ œ โ€” blob ์ด GC ๋Œ€์ƒ์ด ๋˜์–ด ์‹ ๊ทœ clone ์ด ๊ฐ€๋ฒผ์›Œ์ง. ํžˆ์Šคํ† ๋ฆฌ ์žฌ์ž‘์„ฑ ๋ถˆํ•„์š”(๋ธŒ๋žœ์น˜ ์‚ญ์ œ๋งŒ์œผ๋กœ ์ถฉ๋ถ„ํ•ด์ง โ€” ์ „์ œ ๋ณ€๊ฒฝ์˜ ์ด๋“)
    2. ๋ณด์กด โ€” ํŒŒ์ดํ”„๋ผ์ธ ์‚ฐ์ถœ ์ด๋ ฅ ๋ณด๊ด€. ๊ทธ ๋ธŒ๋žœ์น˜๋ฅผ fetch ํ•˜๋Š” clone ๋งŒ 55.64 MiB ๋ฅผ ์ถ”๊ฐ€ ์ˆ˜์‹ 
  • Decision: ๋ฏธ์ • โ€” ๊ฒฐ์ • ํ•„์š”(ํŒ์ • ์ฃผ์ฒด: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ). ๊ธฐ๋ณธ ๋ธŒ๋žœ์น˜ ๊ณ„๋ณด๊ฐ€ ์ด๋ฏธ ๊นจ๋—ํ•ด ์‹œ๊ธ‰์„ฑ์€ ์†Œ๋ฉธ โ€” ์‹œํ•œ ์—†์Œ.
  • Impact: ๊ฒฐ์ • ์ „๊นŒ์ง€ ์—†์Œ. ์žฌ์œ ์ž…์€ D-028 ๊ฐ€๋“œ + .gitignore *.dill ์ด ๋ง‰๋Š”๋‹ค.
  • Source: #13 AC 8 (์ „์ œ ๋ณ€๊ฒฝ ์‹ค์ธก ํฌํ•จ)

D-030: ์žฌ์‹œ๋„ ์‹œ ์ง์ „ ์‹œ๋„์˜ ํŽธ์ง‘ ์ฒ˜๋ถ„ โ€” ๋ˆ„์ (๋˜๋Œ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค)

  • Date: 2026-08-29
  • Context: #20 ์ด EditSnapshot ์— ์‹œ๋„ ๊ฒฝ๊ณ„ ์†์„ฑ(attempt_no)์„ ์‹ ์„คํ•˜๋ฉฐ, ๊ทธ ๊ฒฝ๊ณ„๊ฐ€ ๋ฌด์—‡์„ ๋œปํ•˜๋Š”์ง€ ์ •ํ•˜๋ ค๋ฉด ์„ ํ–‰ ๊ฒฐ์ •์ด ํ•„์š”ํ–ˆ๋‹ค โ€” ์ž๊ฐ€ ๊ฒ€์ฆ ์‹คํŒจ ํ›„ ์žฌ์‹œ๋„๊ฐ€ ์‹œ์ž‘๋  ๋•Œ ์ง์ „ ์‹œ๋„๊ฐ€ ๋‚จ๊ธด ํŒŒ์ผ ํŽธ์ง‘์„ ์ž๋™์œผ๋กœ ๋˜๋Œ๋ฆฌ๋Š”๊ฐ€. flow-permutation-cocode.md FP-103 ์ด ์ด ์ž๋ฆฌ๋ฅผ ใ€Œ์—†์Œ(๋ฏธ๊ทœ์ •)ใ€์œผ๋กœ ๊ธฐ๋กํ–ˆ๊ณ  I-5 ๋กœ ๋“ฑ๊ธ‰ํ–ˆ๋‹ค. AC-07(์žฌ์‹œ๋„ 3ํšŒ ์ƒํ•œ)์ด ์ตœ๋Œ€ 4์„ธํŠธ(์ตœ์ดˆ 1 + ์žฌ์‹œ๋„ 3)์˜ ํŽธ์ง‘์„ ๋งŒ๋“ค ์ˆ˜ ์žˆ๊ฒŒ ํ•˜๋Š”๋ฐ, ๊ทธ 4์„ธํŠธ๊ฐ€ ์‚ฌ๋žŒ์—๊ฒŒ ์–ด๋–ค ์ƒํƒœ๋กœ ๋„˜์–ด๊ฐ€๋Š”์ง€๊ฐ€ ์ •ํ•ด์ง€์ง€ ์•Š์•˜๋‹ค.
  • Options:
    1. ๋ˆ„์  โ€” ์žฌ์‹œ๋„๋Š” ์ง์ „ ํŽธ์ง‘ ์œ„์— ๊ณ„์† ์Œ“๋Š”๋‹ค. ์‹คํŒจ ํ›„ ์‚ฌ๋žŒ์ด ๋ณด๋Š” diff ์— ๋ชจ๋“  ์‹œ๋„์˜ ํ”์ ์ด ๋‚จ๊ณ , ์‹œ๋„ ๊ตฌ๋ถ„์€ attempt_no ๊ฐ€ ํ•œ๋‹ค
    2. ๋˜๊ฐ๊ธฐ โ€” ๊ฐ ์žฌ์‹œ๋„๋Š” ์ง์ „ ์‹œ๋„๋ฅผ ์ž๋™ ๋กค๋ฐฑํ•œ ๊นจ๋—ํ•œ ์ƒํƒœ์—์„œ ์‹œ์ž‘ํ•œ๋‹ค. ์ตœ์ข… diff ๋Š” ๋งˆ์ง€๋ง‰ ์‹œ๋„๋งŒ ๋‹ด์•„ ๊น”๋”ํ•˜๋‹ค
    3. ๋ˆ„์  + ํ™”๋ฉด์—์„œ ์‹คํŒจํ•œ ์‹œ๋„๋ฅผ ๊ธฐ๋ณธ ์ ‘ํž˜ ์ฒ˜๋ฆฌ (์ €์žฅ์€ 1๊ณผ ๋™์ผ, UX ์š”๊ตฌ 1๊ฑด ์ถ”๊ฐ€)
  • Decision: ์˜ต์…˜ 1 โ€” ๋ˆ„์ . ์žฌ์‹œ๋„๋Š” ์ง์ „ ์‹œ๋„์˜ ํŽธ์ง‘์„ ์ž๋™์œผ๋กœ ๋˜๋Œ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค.
  • Rationale: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•์ •(2026-08-29). ๊ทผ๊ฑฐ 3๊ฐ€์ง€ โ€” โ“ flow-permutation-cocode.md:325 B-15 ๊ฐ€ ใ€Œretry_count ๊ฐ€ 3์ธ ์‹œ์ ์˜ ํŽธ์ง‘๊ณผ 3์„ ์ดˆ๊ณผํ•œ ์‹œ์ ์˜ ํŽธ์ง‘์ด ๋ชจ๋‘ diff ์— ๋‚˜ํƒ€๋‚œ๋‹คใ€(๊ทผ๊ฑฐ AC-19 + C-02)๋ฅผ ์š”๊ตฌํ•œ๋‹ค. ๋ˆ„์ ์ด์–ด์•ผ ๊ทธ ๋ฌธ๋ฉด์ด ์„ฑ๋ฆฝํ•˜๊ณ , ๋˜๊ฐ๊ธฐ๋ฅผ ํƒํ•˜๋ฉด B-15 ์™€ ๊ทธ ๊ทผ๊ฑฐ AC ๋ฅผ ํ•จ๊ป˜ ๊ฐœ์ •ํ•ด์•ผ ํ•œ๋‹ค. โ“‘ C-02ยทEditSnapshot ๋ถˆ๋ณ€์‹ 1 ์ด ใ€Œ์—์ด์ „ํŠธ์˜ ๋ชจ๋“  ํŒŒ์ผ ํŽธ์ง‘์€ ๋Œ€์‘ํ•˜๋Š” EditSnapshot ์—†์ด ์กด์žฌํ•  ์ˆ˜ ์—†๋‹คใ€์ด๋ฏ€๋กœ ๋˜๊ฐ๊ธฐ์˜ ๋ณต์› ์“ฐ๊ธฐ ์ž์ฒด๊ฐ€ ์Šค๋ƒ…์ƒท์„ ๋‚ณ๋Š”๋‹ค โ€” 4์„ธํŠธ๊ฐ€ 8์„ธํŠธ๊ฐ€ ๋˜๊ณ  sequence_no ๊ณ„์—ด์ด ํŽธ์ง‘๊ณผ ๋ณต์›์œผ๋กœ ๋’ค์—‰ํ‚จ๋‹ค. โ“’ ๋˜๊ฐ๊ธฐ๋Š” ์‚ฌ์šฉ์ž๊ฐ€ ์š”์ฒญํ•˜์ง€ ์•Š์€ ํŒŒ์ผ ์“ฐ๊ธฐ๋ฅผ ์‹œ์Šคํ…œ์ด ์ž๋™ ์ˆ˜ํ–‰ํ•˜๋Š” ๊ฒƒ์ด๋ผ, ใ€Œ๋กค๋ฐฑ๋จ์œผ๋กœ์˜ ์ „์ด๋Š” ์‚ฌ์šฉ์ž์˜ ๋ช…์‹œ์  ๋กค๋ฐฑ ์š”์ฒญ์œผ๋กœ๋งŒ ๋ฐœ์ƒํ•œ๋‹คใ€(DelegatedTask ๋ถˆ๋ณ€์‹ 5)์™€ ๊ธด์žฅ ๊ด€๊ณ„๋‹ค. ๋Œ€๊ฐ€: ์‹คํŒจ ํ›„ ์‚ฌ๋žŒ์ด ๋ณด๋Š” diff ์— ์‹คํŒจํ•œ ์‹œ๋„์˜ ํ”์ ์ด ๋‚จ๋Š”๋‹ค โ€” ๊ทธ๊ฒƒ์„ ๊ตฌ๋ถ„ํ•˜๋Š” ๊ฒƒ์ด ๋ฐ”๋กœ ์ด Story ๊ฐ€ ์ถ”๊ฐ€ํ•˜๋Š” attempt_no ์ด๋ฉฐ, ๋˜๊ฐ๊ธฐ๊ฐ€ ใ€Œ์ง€์›Œ์„œใ€ ํ‘ธ๋Š” ๋ฌธ์ œ๋ฅผ ๋ˆ„์ ์€ ใ€Œํ‘œ์‹œํ•ด์„œใ€ ํ‘ผ๋‹ค.
  • Impact: docs/seed-spec-cocode.md ยง3 EditSnapshot โ€” attempt_no ์†์„ฑ ์‹ ์„ค + ์‹œ๋„ ๊ฒฝ๊ณ„ ๋กค๋ฐฑ ๊ทœ์น™(โ“โ“‘โ“’ 3์ข… ์งˆ์˜). DelegatedTask ๋ถˆ๋ณ€์‹ 4(:85 โ€” retry_count > 3 ์ด๋ฉด ์‹คํŒจ)์™€์˜ ๊ด€๊ณ„: ๋ˆ„์ ์ด๋ฏ€๋กœ ์‹คํŒจ ์‹œ์ ์— ์ตœ๋Œ€ 4์„ธํŠธ๊ฐ€ ๋‚จ์•„ ์žˆ๊ณ , ๊ทธ ์ „๋ถ€๊ฐ€ AC-19 ์˜ ใ€Œ์‹คํŒจํ•œ ์ž‘์—…์˜ ํŽธ์ง‘์€ ์กฐ์šฉํžˆ ํ๊ธฐ๋˜์ง€๋„ ํ™•์ •๋˜์ง€๋„ ์•Š๋Š”๋‹คใ€ ๋Œ€์ƒ์ด ๋œ๋‹ค. docs/architecture-cocode.md DD-10 ์Šค๋ƒ…์ƒท ๋ ˆ์ฝ”๋“œ์— attempt ํ•„๋“œ, DD-11 1๋‹จ๊ณ„ ๋Œ€์ƒ ์‚ฐ์ถœ ํ•จ์ˆ˜์— ๋กค๋ฐฑ ์งˆ์˜ ์ธ์ž. ๊ตฌํ˜„์€ #23(์ €์žฅ์†Œ)ยท#24(์ˆœ์ˆ˜ ํ•จ์ˆ˜) ์†Œ์œ .
  • Source: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ๊ฒฐ์ • (#20 ์‚ฌ์ดํด ์ค‘ ํ™•์ธ, 2026-08-29)

D-031: ๋„๋„ˆ ํ‘œ๋ฉด์„ ๋ถ„์„ยท๋นŒ๋“œ ๋ฒ”์œ„์—์„œ ์ œ์™ธ โ€” ใ€Œ์กด์น˜ใ€๋ฅผ ํŒŒ์ผ ๋ณด์กด๊ณผ ๋Œ€์ƒ ํฌํ•จ์œผ๋กœ ๋ถ„๋ฆฌ

  • Date: 2026-08-29
  • Status: ๋Œ€์ฒด๋จ โ€” D-087 (2026-09-28, #458). ๋„๋„ˆ ํ‘œ๋ฉด์ด ์‚ญ์ œ๋ผ excludeยทignore ๋Š” backend/cocode_server ํ•œ ์ค„๋งŒ ๋‚จ์•˜๋‹ค.
  • Context: D-026 ์€ ๋„๋„ˆ(unibook) ์ž์‚ฐ์˜ ์กด์น˜๋ฅผ ์ •ํ–ˆ์œผ๋‚˜ ๊ทธ๊ฒƒ์ด ๋นŒ๋“œยทcodegenยท๋ถ„์„ ๋Œ€์ƒ์— ํฌํ•จ๋œ๋‹ค๋Š” ๋œป์ธ์ง€๋Š” ์ •ํ•˜์ง€ ์•Š์•˜๋‹ค. ๊ทธ ๊ณต๋ฐฑ ๋•Œ๋ฌธ์— ใ€Œ์กด์น˜ใ€์™€ ใ€ŒCI greenใ€์ด ๋™์‹œ์— ์„ฑ๋ฆฝํ•˜์ง€ ์•Š์•˜๊ณ , #8 ์ด ์ด ๊ตฌ๋ถ„์˜ ํ•„์š”๋ฅผ ์ œ๊ธฐํ–ˆ์œผ๋‚˜ ๊ทธ ์ด์Šˆ๊ฐ€ ๋‹ซํžˆ๋ฉฐ ์†Œ์œ ๊ฐ€ ์œ ์‹ค๋๋‹ค. ์‹ค์ธก์œผ๋กœ ๊ทœ๋ชจ๊ฐ€ ํ™•์ธ๋๋‹ค โ€” ์›Œํฌ์ŠคํŽ˜์ด์Šค dart analyze --no-fatal-warnings โ†’ error 13,872๊ฑด / 76๊ฐœ ํŒจํ‚ค์ง€. ์ตœ๋Œ€ ์›์ธ์€ codegen ๊ฒฐ์†์ด ์•„๋‹ˆ๋‹ค: feature/application/dashboard ๋“ฑ 10๊ฐœ ํŒจํ‚ค์ง€๊ฐ€ src/di/injector.module.dart ๋ฅผ export ํ•˜๋Š”๋ฐ injectable ์€ ์ด ๋ฆฌํฌ์—์„œ ์ œ๊ฑฐ๋œ ํŒจํ‚ค์ง€(pubspec ์„ ์–ธ 0 ยท import 0)๋ผ melos run build ๋กœ๋„ ์‚ฌ๋ผ์ง€์ง€ ์•Š๋Š” ์˜๊ตฌ ๊ฒฐ์†์ด๋ฉฐ, ๋ธŒ๋ฆญ์ด ๋„๋„ˆ์™€ ๋‹ค๋ฅธ ์„ธ๋Œ€์˜ ์Šค์บํด๋“œ๋ฅผ ์ฐ์€ ๊ฒฐ๊ณผ๋‹ค.
  • Options:
    1. ๋ถ„์„ยท๋นŒ๋“œ ๋ฒ”์œ„์—์„œ ์ œ์™ธ โ€” analysis_options.yaml ์˜ exclude ์™€ melos: ignore: ์— ๋„๋„ˆ ๊ฒฝ๋กœ๋ฅผ ๋„ฃ๋Š”๋‹ค. ํŒŒ์ผ์€ ํ•œ ์ค„๋„ ์ง€์šฐ์ง€ ์•Š๋Š”๋‹ค. ์ด๋ฏธ ์ด ๋ฆฌํฌ์˜ ๊ด€์šฉ๊ตฌ(analysis_options.yaml ์ด cocode_clientยทdeploy/awsยทpdfrxยทpostal_ko ๋ฅผ ํŒจํ‚ค์ง€ ํ†ต์งธ๋กœ ๋ฐฐ์ œ ์ค‘)
    2. ๋„๋„ˆ ์ฝ”๋“œ ์ˆ˜๋ฆฌ โ€” injectable ์˜์กด 10ํŒจํ‚ค์ง€๋ฅผ GetIt ์ˆ˜๋™ ๋“ฑ๋ก์œผ๋กœ ์ „ํ™˜ + ๋ˆ„๋ฝ ๋ฐฑ์—”๋“œ ๋ชจ๋ธ 305๊ฐœ ๋ณต์› + dio/Failure ์„ธ๋Œ€์ฐจ ์ •๋ฆฌ. #8 ์˜ ์ˆ˜๋ ด ์‹คํ—˜(308โ†’61โ†’40)์ด ๋ฉˆ์ถ”์ง€ ์•Š์•˜๊ณ , ๋๊นŒ์ง€ ๊ฐ€๋ฉด ใ€ŒServerpod ๋ฐฑ์—”๋“œ๊ฐ€ ์—†๋‹คใ€๊ณ  ๋ชป๋ฐ•์€ ์ œํ’ˆ์— ์ „์ž์ฑ… ๋ฐฑ์—”๋“œ๋ฅผ ํ†ต์งธ๋กœ ๋ณต์›ํ•˜๊ฒŒ ๋œ๋‹ค
    3. ๋„๋„ˆ ์ž์‚ฐ ์ œ๊ฑฐ โ€” D-026 ๋ฒˆ๋ณต
  • Decision: ์˜ต์…˜ 1 โ€” ๋ถ„์„ยท๋นŒ๋“œ ๋ฒ”์œ„์—์„œ ์ œ์™ธ. ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•์ •(2026-08-29).
  • Rationale: D-026 ์˜ ใ€Œ์ถ”ํ›„ ๋ฐฑ์—”๋“œ๊ฐ€ ํ•„์š”ํ•  ์ˆ˜๋„ ์žˆ์–ด์„œใ€๋ผ๋Š” ์˜๋„๋ฅผ ๊ทธ๋Œ€๋กœ ์ง€ํ‚ค๋ฉด์„œ(ํŒŒ์ผ 0๊ฑด ์ˆ˜์ •) CI ๋ฅผ ๋˜์‚ด๋ฆฌ๋Š” ์œ ์ผํ•œ ๊ฒฝ๋กœ๋‹ค. ์˜ต์…˜ 2 ๋Š” ์ˆ˜์ฃผ ์ด์ƒ์ด๊ณ  cocode ADE ์ œํ’ˆ ๊ฐ€์น˜์— ๊ธฐ์—ฌํ•˜์ง€ ์•Š์œผ๋ฉฐ, ์˜ต์…˜ 3 ์€ ์˜ค๋„ˆ ๊ฒฐ์ •์„ ๋ฒˆ๋ณตํ•œ๋‹ค. ์™„์ „ ๊ฐ€์—ญ โ€” ๋‘ ๋ธ”๋ก์„ ์‚ญ์ œํ•˜๋ฉด ์›์ƒ ๋ณต๊ตฌ๋œ๋‹ค.
  • Impact: analysis_options.yaml analyzer.exclude + dart_code_metrics.exclude (๋„๋„ˆ ํ‘œ๋ฉด 11๊ฒฝ๋กœ + ๋ฃจํŠธ build/** + ๊ณ ์•„ ๋กœ์ผ€์ผ ํ…Œ์ŠคํŠธ 1๊ฑด) ยท pubspec.yaml melos: ignore: 9ํŒจํ‚ค์ง€. ์‹ค์ธก ๊ฒฐ๊ณผ dart analyze error 13,872 โ†’ 0, melos run backend:pod:generate ๋Š” ๋นˆ ์ง‘ํ•ฉ exec ์œผ๋กœ rc=0 no-op(๊ทธ ์‹คํŒจ์˜ ๊ทผ์›์€ ์ƒ๋ฅ˜ bricks#268 ์ด๊ณ  ์ด ๋ฆฌํฌ์—์„œ ๋‹ซํžˆ์ง€ ์•Š๋Š”๋‹ค). โš ๏ธ ๋ถ€์ž‘์šฉ โ€” CI ์˜ check_generated_tracked.py ๋Š” ใ€Œ์ƒ์„ฑ ํŠธ๋ฆฌ ์—†์Œ โ€” ๊ฑด๋„ˆ๋œ€ใ€์œผ๋กœ ํ†ต๊ณผํ•œ๋‹ค. ๋กœ์ปฌ(์ƒ์„ฑ๋ฌผ ๋ณด์œ )์—์„œ๋Š” ๊ณ„์† 588๊ฑด์œผ๋กœ ์‹คํŒจํ•œ๋‹ค. ์ด ๋น„๋Œ€์นญ์€ ๊ฐ€๋“œ๊ฐ€ ๋ช…์‹œ์ ์œผ๋กœ ์ถœ๋ ฅํ•˜๋ฏ€๋กœ ๋ฌด์Œ์€ ์•„๋‹ˆ์ง€๋งŒ, CI green ์„ ใ€Œ์ƒ์„ฑ ์ฝ”๋“œ๊ฐ€ ์ถ”์ ๋œ๋‹คใ€๋กœ ์ฝ์œผ๋ฉด ์•ˆ ๋œ๋‹ค(์ •์ฑ… ์ž๊ธฐ๋ชจ์ˆœ ์ž์ฒด๋Š” ์ƒ๋ฅ˜ bricks#270). โš ๏ธ app/cocode/** ๋Š” cocode_app ์ฐฉ์ง€์ ์ด๋‹ค โ€” ๊ทธ Story ์ฐฉ์ˆ˜ ์‹œ exclude ๋ฅผ lib/ ํ•˜์œ„๋กœ ์ขํ˜€์•ผ ํ•œ๋‹ค.
  • Source: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ๊ฒฐ์ • (2026-08-29) ยท ์‹ค์ธก ๊ทผ๊ฑฐ๋Š” #141

๐Ÿ“Œ ์˜จ๋””์Šคํฌยทํ‘œ๊ธฐ ๊ฐœ๋ช… โ€” .coco/ โ†’ .cocode/, ใ€Œcoco ADEใ€ โ†’ ใ€Œcocode ADEใ€ (#296, 2026-09-16) โ€” #294 ๊ฐ€ ใ€Œ์ผ๋ถ€๋Ÿฌ ๋‘๊ณ  ์˜จ ๊ฒƒใ€ โ‘กโ‘ข ์œผ๋กœ ๋‚จ๊ธด ๋‘ ์ถ•์„ ๋‹ซ๋Š”๋‹ค. ์ด๋กœ์จ cocode ๋„ค์ž„์ŠคํŽ˜์ด์Šค ์ •๋ ฌ์€ #293(ํŒจํ‚ค์ง€) โ†’ #294(์‹ฌ๋ณผ) โ†’ #296(์˜จ๋””์Šคํฌยทํ‘œ๊ธฐ) ์„ธ ๋‹จ๊ณ„๋กœ ๋๋‚œ๋‹ค.

โ‘  .coco/ โ†’ .cocode/ (DD-08ยทDD-09 ๊ฐœ์ •). ์›Œํฌ์ŠคํŽ˜์ด์Šค ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ ๋””๋ ‰ํ„ฐ๋ฆฌ์™€ ๊ทธ ๋„ค์ž„์ŠคํŽ˜์ด์Šค๋ฅผ ๊ณต์œ ํ•˜๋˜ ๋Ÿฐํƒ€์ž„ ์ ‘๋‘์‚ฌ 4์ข…์„ ํ•จ๊ป˜ ์˜ฎ๊ฒผ๋‹ค:

์˜ฎ๊ธด ๊ฒƒ ์ž๋ฆฌ
.coco/ โ†’ .cocode/ CocodeLayout.cocodeDirName ยท SandboxWritePathPolicy.deniedDirName
.coco-staging-<id> โ†’ .cocode-staging-<id> scaffold_engine.dart (DD-13a ์›์ž์„ฑ)
.<name>.coco-tmp-โ€ฆ โ†’ .cocode-tmp-โ€ฆ atomic_replace.dart
.<name>.coco-rollback-โ€ฆ โ†’ .cocode-rollback-โ€ฆ rollback_engine.dart
coco.<ns>.<key> โ†’ cocode.<ns>.<key> ui ์œ„์ ฏ Key 16 ๋„ค์ž„์ŠคํŽ˜์ด์Šค ยท ์ปค๋งจ๋“œ id ยท ํƒ€์ž„๋ผ์ธ id

์™œ ์ง€๊ธˆ์ธ๊ฐ€ โ€” ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ๋น„์šฉ์ด 0์ธ ๋งˆ์ง€๋ง‰ ๊ตฌ๊ฐ„์ด๋‹ค. ์ œํ’ˆ์ด ์•„์ง ์›Œํฌ์ŠคํŽ˜์ด์Šค๋ฅผ ์ถœํ•˜ํ•˜์ง€ ์•Š์•„ ์„ธ์ƒ์— .coco/ ๋””๋ ‰ํ„ฐ๋ฆฌ๊ฐ€ 0๊ฐœ๋‹ค. ์ถœํ•˜ ํ›„์—๋Š” ๊ฐ™์€ ๋ณ€๊ฒฝ์ด ๋ฐ์ดํ„ฐ ํฌ๋งท ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜์ด ๋œ๋‹ค.

โš ๏ธ ํ•จ๊ป˜ ์˜ฎ๊ฒจ์•ผ ํ•˜๋Š” ๊ฒƒ์ด ๋‘˜ ์žˆ์—ˆ๋‹ค. โ“ ๋Œ€์†Œ๋ฌธ์ž ํด๋”ฉ ๋ณผ๋ฅจ ๊ฑฐ๋ถ€ ํ…Œ์ŠคํŠธ์˜ .Coco/history โ€” ๊ฑฐ๋ถ€ ๋Œ€์ƒ๊ณผ ๊ฐ™์€ ์ฒ ์ž์—ฌ์•ผ ์‹œํ—˜์ด ์„ฑ๋ฆฝํ•œ๋‹ค. โ“‘ CocodeCommandAction.commandId ์˜ 'coco.$name' โ€” ์—ฌ๊ธฐ๋งŒ . ๋’ค๊ฐ€ $ ๋ผ ๋„ค์ž„์ŠคํŽ˜์ด์Šค ์ผ๊ด„ ์น˜ํ™˜์ด ๋น„๊ปด๊ฐ”๊ณ , ๋†“์ณค๋‹ค๋ฉด ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ ํ‚ค์™€ ์œ„์ ฏ Key ๊ฐ€ ๊ฐˆ๋ ค ํŒ”๋ ˆํŠธ๊ฐ€ ์กฐ์šฉํžˆ ์•„๋ฌด ์ปค๋งจ๋“œ๋„ ๋ชป ์ฐพ๊ฒŒ ๋œ๋‹ค.

โ‘ก ใ€Œcoco ADEใ€ โ†’ ใ€Œcocode ADEใ€. ์ œํ’ˆ๋ช… ํ‘œ๊ธฐ 195๊ฑด. ์‹คํ–‰์— ๋‹ฟ๋Š” ๊ฒƒ์€ ๋‘˜๋ฟ์ด์—ˆ๋‹ค โ€” app/cocode/lib/main.dart ์˜ ์ฐฝ ์ œ๋ชฉ๊ณผ .pipeline/cocode.yaml ์˜ project_name.

๊ทธ๋Œ€๋กœ ๋‘๋Š” ๊ฒƒ 3์ข… (#294 ์˜ ํŒ๋‹จ์„ ์œ ์ง€ํ•œ๋‹ค): โ‘  coco-de/* โ€” GitHub ์กฐ์ง ์Šฌ๋Ÿฌ๊ทธ. ์‹ค์ธก์œผ๋กœ ๋ถˆ๊ฐ€๋Šฅ์„ ํ™•์ธํ–ˆ๋‹ค: coco-de ๋Š” ์ด ์ €์žฅ์†Œ๋ฅผ ์†Œ์œ ํ•œ Organization(repo 16)์ด๊ณ , cocode ๋Š” ์ œ3์ž User ๊ณ„์ • (repo 17)์ด๋ฉฐ cocode/cocode ๋Š” 404 ๋‹ค. remoteยทgit ์˜์กด์„ฑ์„ cocode/* ๋กœ ๋ฐ”๊พธ๋ฉด ๋‚จ์˜ ๊ณ„์ •์„ ๊ฐ€๋ฆฌ์ผœ pub get ์ด ์ฆ‰์‹œ ๊นจ์ง€๊ณ , ๊ทธ ๊ณ„์ •์ด ๊ฐ™์€ ์ด๋ฆ„์˜ ์ €์žฅ์†Œ๋ฅผ ๋งŒ๋“ค๋ฉด ๊ณต๊ธ‰๋ง ์œ„ํ—˜์ด ๋œ๋‹ค. ์ €์žฅ์†Œ ์•ˆ์—์„œ ๊ณ ๋ฅผ ์ˆ˜ ์žˆ๋Š” ๊ฐ’์ด ์•„๋‹ˆ๋‹ค. com.coco-de.cocode (OS ์ž๊ฒฉ์ฆ๋ช… ๋„ค์ž„์ŠคํŽ˜์ด์Šค)๋„ ๊ฐ™์€ ์ด์œ ๋‹ค. โ‘ก CocoFixtureModel โ€” AC-15 ํ”ฝ์Šค์ฒ˜์˜ ์‚ฐ์ถœ๋ฌผ์ด SHA-256ยท๋ฐ”์ดํŠธยท์ค„ ์ˆ˜๋กœ ๊ณ ์ •๋ผ ์žˆ๊ณ  ๊ทธ 3๊ฐ’์€ #92 ์‹ค์ธก์˜ ์žฌํ˜„ ๊ณ„์•ฝ์ด๋‹ค ([[cocode-byte-pinned-fixtures]] ์ฐธ์กฐ โ€” #294 ์—์„œ ํ•œ ๋ฒˆ ํœฉ์“ธ๋ ค CI ๊ฐ€ ์žก์•˜๋‹ค). โ‘ข #292ยท#293ยท#294 ์˜ ๊ณผ๊ฑฐ ๊ธฐ๋ก ์ธ์šฉ โ€” ๋‹น์‹œ ์ด๋ฆ„์ด coco_*ยทCoco* ์˜€๋‹ค๋Š” ๋ฌธ์žฅ๊ณผ ๊ฑฐ๊ธฐ ์ธ์šฉ๋œ ์ •๊ทœ์‹(coco[A-Z] ๋“ฑ)์€ ์‚ฌ์‹ค์ด๋‹ค. ๊ณ ์น˜๋ฉด ๊ธฐ๋ก์ด ๊ฑฐ์ง“์ด ๋œ๋‹ค.

๐Ÿ“Œ ์‹ฌ๋ณผ ๊ฐœ๋ช… โ€” Coco*ยทcoco* โ†’ Cocode*ยทcocode* (#294, 2026-09-16) โ€” #292 ๊ฐ€ ใ€Œ์ด๋ฒˆ ๋ฒ”์œ„๊ฐ€ ์•„๋‹ˆ๋‹คใ€๋กœ ๋‚จ๊ฒจ ๋‘” ํด๋ž˜์Šคยท์ƒ์ˆ˜ยท๋ณ€์ˆ˜ยทํ…Œ์ŠคํŠธ ์ด๋ฆ„์„ ๋งˆ์ € ์˜ฎ๊ฒผ๋‹ค. ํŒจํ‚ค์ง€๋ช…์ด cocode_* ์ธ๋ฐ ๊ทธ ์•ˆ์˜ ํƒ€์ž…์ด Coco* ๋ฉด ๊ฐ™์€ ๊ฒƒ์„ ๋‘ ์ด๋ฆ„์œผ๋กœ ๋ถ€๋ฅด๊ฒŒ ๋œ๋‹ค.

์˜ฎ๊ธด ๊ฒƒ โ€” Coco[A-Z] 2,426๊ฑด ยท coco_[a-z0-9] 320๊ฑด ยท ํŒŒ์ผ๋ช… 138๊ฐœ(git mv). ๋’ค์ด์–ด ์ ‘๋‘์‚ฌ์— ๊ฐ€๋ ค ๊ฒฝ๊ณ„ ์ •๊ทœ์‹์— ๊ฑธ๋ฆฌ์ง€ ์•Š๋˜ ๊ฒƒ๋“ค๋„ ์ฐพ์•„ ์˜ฎ๊ฒผ๋‹ค: lowerCamel coco[A-Z] 224๊ฑด(cocoTestApp ๋“ฑ 36์ข…) ยท ๋น„๊ณต๊ฐœ _Coco* 13์ข… ยท ์ƒ์ˆ˜ kCoco* 5์ข… ยท CI ์ž์‚ฐ stage_coco_pure_packages.py โ†’ stage_cocode_pure_packages.py ยท verify.coco-pure-tests.yaml โ†’ verify.cocode-pure-tests.yaml(required check ๊ฐ€ ์•„๋‹ˆ๋ผ ํŒŒ์ผ๋ช… ๋ณ€๊ฒฝ์ด ์•ˆ์ „ํ•˜๋‹ค).

์ผ๋ถ€๋Ÿฌ ๋‘๊ณ  ์˜จ ๊ฒƒ 3์ข… โ€” ๊ฐœ๋ช…ํ•˜๋ฉด ๋‹ค๋ฅธ ๊ฒƒ์„ ๊ฐ€๋ฆฌํ‚ค๊ฒŒ ๋˜๋Š” ์ด๋ฆ„๋“ค์ด๋‹ค: โ‘  GitHub ์กฐ์ง ์Šฌ๋Ÿฌ๊ทธ coco-de/*(remoteยทgit ์˜์กด์„ฑ URL โ€” ์ €์žฅ์†Œ ๋ฐ–์˜ ์‚ฌ์‹ค) โ‘ก ์˜จ๋””์Šคํฌ ์›Œํฌ์ŠคํŽ˜์ด์Šค ๋””๋ ‰ํ„ฐ๋ฆฌ .coco/(DD-08 ์ด ์ •ํ•œ ๊ฒฝ๋กœ ๊ณ„์•ฝ์ด์ž ๋ฐ์ดํ„ฐ ํฌ๋งท์ด๋‹ค. ์ƒ์ˆ˜ ์ด๋ฆ„์€ cocodeDirName ์œผ๋กœ ์˜ฎ๊ฒผ์ง€๋งŒ ๊ฐ’ .coco ๋Š” ๊ทธ๋Œ€๋กœ ๋‘”๋‹ค โ€” ๋ฐ”๊พธ๋ ค๋ฉด DD-08ยทDD-09 ๋ฅผ ๊ณ ์น˜๋Š” ๋ณ„๋„ ๊ฒฐ์ •์ด ํ•„์š”ํ•˜๋‹ค) โ†’ #296 ์ด ๋‹ซ์•˜๋‹ค โ‘ข ์„œ์ˆ  ํ‘œ๊ธฐ ใ€Œcoco ADEใ€์™€ #292ยทD-026 ์˜ ๊ณผ๊ฑฐ ๊ธฐ๋ก ์ธ์šฉ(coco_* ๋กœ ์ ํžŒ ๊ทธ ๋ฌธ์žฅ๋“ค์€ ๋‹น์‹œ ์‚ฌ์‹ค์ด๋ผ ๊ณ ์น˜๋ฉด ๊ธฐ๋ก์ด ๊ฑฐ์ง“์ด ๋œ๋‹ค) โ†’ ํ‘œ๊ธฐ๋Š” #296 ์ด ๋‹ซ์•˜๊ณ , ๊ณผ๊ฑฐ ๊ธฐ๋ก ์ธ์šฉ์€ ๊ทธ๋Œ€๋กœ ๋‘”๋‹ค

โš ๏ธ CocoaยทCocoaPods(iOS/macOS ๋นŒ๋“œ ์‚ฐ์ถœ๋ฌผ 98๊ฑด)๋Š” ๊ฑด๋“œ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค โ€” ์น˜ํ™˜์‹์€ Coco ๋‹ค์Œ ๊ธ€์ž๊ฐ€ ๋Œ€๋ฌธ์ž ๋˜๋Š” _ ์ผ ๋•Œ๋งŒ ๋งค์น˜ํ•˜๋ฏ€๋กœ Cocoa(์†Œ๋ฌธ์ž a)์™€ Cocode(์†Œ๋ฌธ์ž d)๋Š” ๊ตฌ์กฐ์ ์œผ๋กœ ๊ฑธ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค. ์‹ค์ธก์œผ๋กœ๋„ 0๊ฑด ๋ณ€๊ฒฝ.

โš ๏ธ ๊ฐœ๋ช…์ด ์‹๋ณ„์ž๋ฅผ 2์ž์”ฉ ๋Š˜๋ ค lib/ 9์ค„์ด 80์ž๋ฅผ ๋„˜๊ฒผ๋‹ค โ€” dart analyze --fatal-infos lib ๊ฐ€ ๊ฒŒ์ดํŠธ๋ผ info ํ•˜๋‚˜๋กœ CI ๊ฐ€ ๋ง‰ํžŒ๋‹ค. dart format ์œผ๋กœ ์ ‘์—ˆ๋‹ค(์‹ค์ธก: 58 โ†’ 18 issues, lib/ 0๊ฑด).

๐Ÿ“Œ ๋„ค์ž„์ŠคํŽ˜์ด์Šค ์ •๋ ฌ + ๋„๋„ˆ ์œ„์ ฏ๋ถ ์ œ๊ฑฐ (#292, 2026-09-16) โ€” ์˜ค๋„ˆ ๊ฒฐ์ • 2๊ฑด.

โ‘  coco_* โ†’ cocode_*. D-026 ์ด ใ€Œcoco_* 12์ข…์„ ๊ธฐ์กด ์ž์‚ฐ๊ณผ ๊ณต์กดํ•˜๋„๋ก ๋ฐฐ์น˜ใ€๋กœ ์ ์€ ๊ทธ ๋„ค์ž„์ŠคํŽ˜์ด์Šค๋ฅผ ํ”„๋กœ์ ํŠธ ์ด๋ฆ„(cocode)์— ๋งž์ถ˜๋‹ค. ํŒจํ‚ค์ง€ 11์ข… (acpยทagentยทbricksยทcoreยทeditorยทlspยทplatformยทterminalยทtoolchainยท uiยทworkspace) ๋””๋ ‰ํ† ๋ฆฌยทpubspec name:ยทimport 509์ค„ยท์„ค์ •/CI ์ฐธ์กฐ๋ฅผ ์˜ฎ๊ฒผ๋‹ค. ํด๋ž˜์Šค๋ช…(Coco* 121์ข…)๊ณผ ใ€Œcoco ADEใ€ ์ œํ’ˆ ํ‘œ๊ธฐ๋Š” ์ด๋ฒˆ ๋ฒ”์œ„๊ฐ€ ์•„๋‹ˆ๋‹ค.

โš ๏ธ CI ์Šคํฌ๋ฆฝํŠธ 8๊ณณ์ด coco_ ๋ฅผ ์ •๊ทœ์‹ยท๊ธ€๋กญ(package/coco_[A-Za-z0-9_]+/, package/coco_*/lib/**)์œผ๋กœ ์“ฐ๊ณ  ์žˆ์–ด ๋‹จ์ˆœ ๋ฌธ์ž์—ด ์น˜ํ™˜์— ๊ฑธ๋ฆฌ์ง€ ์•Š์•˜๋‹ค โ€” ๋†“์ณค๋‹ค๋ฉด ๊ทธ ๊ฐ€๋“œ๋“ค์ด cocode ADE ์ฝ”๋“œ๋ฅผ ์กฐ์šฉํžˆ ๋ณด์ง€ ์•Š๊ฒŒ ๋œ๋‹ค. ๋ณ„๋„๋กœ ์ฐพ์•„ ๊ณ ์ณค๋‹ค.

โ‘ก app/cocode_widgetbook_donor ์ œ๊ฑฐ (687ํŒŒ์ผ ยท 8.3MB). D-031 ์ด ์˜ต์…˜ 3 ใ€Œ๋„๋„ˆ ์ž์‚ฐ ์ œ๊ฑฐ โ€” D-026 ๋ฒˆ๋ณตใ€์œผ๋กœ ๊ธฐ๊ฐํ–ˆ๋˜ ๊ฒƒ์ด๋ฉฐ, ์ด ๊ฒฐ์ •์€ ๊ทธ ๊ธฐ๊ฐ์„ ๋’ค์ง‘๋Š”๋‹ค. ๊ทผ๊ฑฐ: ๊ทธ ์•ฑ์€ ์กด์žฌํ•˜์ง€ ์•Š๋Š” ๋„๋„ˆ feature ํŒจํ‚ค์ง€์— ๋ฌถ์—ฌ ์ด ์ €์žฅ์†Œ์—์„œ ๋นŒ๋“œ๋œ ์ ์ด ์—†๊ณ (#289 ์‹ค์ธก), ์˜์กดํ•˜๋Š” ํŒจํ‚ค์ง€๊ฐ€ 0๊ฑด์ด๋ฉฐ, ์ œ๊ฑฐ ํ›„ ์œ ์ผํ•œ ์œ„์ ฏ๋ถ์€ app/cocode_widgetbook ์ด๋‹ค.

๋”ฐ๋ผ ์ •๋ฆฌํ•œ ์ฐธ์กฐ: analysis_options.yaml exclude 3๊ณณ ยท detect_console_web_impact.sh NOT_CONSOLE_REGEX ยท plan_codegen_targets.py ์ œ์™ธ ๋ชฉ๋ก ยท verify_widgetbook_coverage.sh(์ธ์ • ์œ„์น˜๊ฐ€ feature/*/*/widgetbook/ ๋งŒ ๋‚จ์Œ) ยท SCAFFOLD.md ยท package-placement-cocode.md.

๐Ÿ“Œ ๊ฒฝ๋กœ ์ด๋™ (#287, 2026-09-15) โ€” ๋„๋„ˆ ์œ„์ ฏ๋ถ์ด app/cocode_widgetbook โ†’ app/cocode_widgetbook_donor ๋กœ ์˜ฎ๊ฒจ์กŒ๋‹ค. ํ”„๋กœ์ ํŠธ ์ด๋ฆ„(cocode)์— ๋งž์ถฐ ๋ฐœํ–‰๋˜๋Š” ์œ„์ ฏ๋ถ์ด app/cocode_widgetbook ์„ ์ฐจ์ง€ํ•ด์•ผ ํ•œ๋‹ค๋Š” ์˜ค๋„ˆ ๊ฒฐ์ •์— ๋”ฐ๋ฅธ ๊ฒƒ์ด๋‹ค.

D-026ยทD-031 ์€ ๊ทธ๋Œ€๋กœ๋‹ค. ๋„๋„ˆ ํŠธ๋ฆฌ๋Š” ๋ฐ”์ดํŠธ ๋‹จ์œ„ ๋™์ผํ•˜๊ฒŒ ์ด๋™ํ–ˆ๊ณ (ํŠธ๋ฆฌ ํ•ด์‹œ ๋Œ€์กฐ), ๋„๋„ˆ ํŒŒ์ผ ์ˆ˜์ •์€ pubspec.yaml ์˜ resolution: workspace 1์ค„ ์ œ๊ฑฐ๊ฐ€ ์ „๋ถ€๋‹ค โ€” ํŒจํ‚ค์ง€๋ช…(cocode_widgetbook)์„ ๋ฐ”๊พธ๋ฉด ๋‚ด๋ถ€ import 15๊ณณ์„ ๊ณ ์ณ์•ผ ํ•ด์„œ, ๋Œ€์‹  pub workspace(= melos ์Šค์ฝ”ํ”„) ๋ฐ–์œผ๋กœ ๋นผ ์ด๋ฆ„ ์ถฉ๋Œ์„ ์—†์•ด๋‹ค. check_workspace_membership.py ๋Š” resolution: ๋ฏธ์„ ์–ธ ํŒจํ‚ค์ง€๋ฅผ ๊ฒ€์‚ฌ ๋Œ€์ƒ์—์„œ ์ œ์™ธํ•˜๋ฏ€๋กœ(#6 AC 5) ํ†ต๊ณผํ•œ๋‹ค.

๋”ฐ๋ผ ์˜ฎ๊ธด ์ฐธ์กฐ: analysis_options.yaml exclude 3๊ณณ ยท ๋ฃจํŠธ workspace: ยท melos ignore: (cocode_widgetbook ํ•ญ๋ชฉ ์ œ๊ฑฐ โ€” ๊ทธ ์ด๋ฆ„์€ ์ด์ œ ๋ถ„์„ยทํ…Œ์ŠคํŠธ ๋Œ€์ƒ์ธ cocode ADE ์œ„์ ฏ๋ถ์ด๋‹ค) ยท melos:scripts:analyze ์˜ --ignore="*cocode_widgetbook*" ์ œ๊ฑฐ(์ƒˆ ์•ฑ์„ ์‚ผํ‚จ๋‹ค) ยท scripts/verify_widgetbook_coverage.sh 5๊ณณ ยท Pages ์›Œํฌํ”Œ๋กœ(pages.cocode-widgetbook.yaml).

โš ๏ธ ์•„๋ž˜ #281 ํ‘œ์˜ verify_widgetbook_coverage.sh ํ–‰์— ์ ํžŒ app/cocode_widgetbook/ ์€ ๊ทธ ์‹œ์ ์˜ ๊ฒฝ๋กœ๋‹ค โ€” ์ง€๊ธˆ์€ _donor ๋‹ค.

๐Ÿ“Œ ํŒŒ๊ธ‰ ๋ฐ˜์˜ ์™„๋ฃŒ (#277 ยท #278 ยท #279 ยท #280 ยท #281, 2026-09-14) โ€” D-031 ์ด ๋‚จ๊ธด ใ€Œ๊ฒ€์ฆ ๋‹จ๊ณ„ ๋ฏธ๋ฐ˜์˜ใ€์„ ๋‹ซ์•˜๋‹ค.

D-031 ์€ analysis_options.yaml ๊ณผ pubspec.yaml ๋‘ ๋ธ”๋ก๋งŒ ๋ฐ”๊พธ๋ฉด ๋˜๋Š” ๊ฒฐ์ •์œผ๋กœ ์ ํ˜”์œผ๋‚˜, CI ์˜ ๊ฒ€์ฆ ์ง€์  ์•„ํ™‰ ๊ณณ์ด ๊ทธ ๊ฒฝ๊ณ„๋ฅผ ๋ชจ๋ฅธ ์ฑ„ ๋‚จ์•„ Project #2 ์ตœ์ข… PR(#273)์„ ๋ง‰์•˜๋‹ค. ์•ž์˜ ์—ฌ์„ฏ์€ ๋ถ€ํŠธ์ŠคํŠธ๋žฉ์„ ๋ง‰์•„ ํ•˜์œ„ 5์žก์„ ํ†ต์งธ๋กœ skip ์‹œ์ผฐ๊ณ , ๊ทธ๊ฒƒ์„ ํ’€์ž ๋‚˜๋จธ์ง€๊ฐ€ ๋“œ๋Ÿฌ๋‚ฌ๋‹ค. ์ฆ์ƒ์€ codegen ์‹คํŒจ๋กœ ๋ณด์˜€์ง€๋งŒ ๋ฟŒ๋ฆฌ๋Š” ํ•˜๋‚˜๋‹ค โ€” backend:pod:generate ๊ฐ€ rc=0 no-op ์ด๋ผ serverpod ํ”„๋กœํ† ์ฝœ์ด ๊ฒฐ์ฝ” ์ƒ์„ฑ๋˜์ง€ ์•Š๋Š”๋ฐ, ๊ทธ ์‚ฐ์ถœ๋ฌผ์„ ํ•„์ˆ˜๋กœ ์š”๊ตฌํ•˜๋Š” ๊ฒ€์‚ฌ๋“ค์ด ๊ทธ๋Œ€๋กœ์˜€๋‹ค.

์ž๋ฆฌ ๋ฌด์—‡์ด ์„ฑ๋ฆฝํ•˜์ง€ ์•Š์•˜๋‚˜ ์ฒ˜๋ถ„
ci.yml ใ€ˆ๋นŒ๋“œ ์•„ํ‹ฐํŒฉํŠธ ๊ฒ€์ฆใ€‰ ํ•ต์‹ฌ ํŒŒ์ผ generated/endpoints.dartยทprotocol.dart ๋Š” gitignore ๋Œ€์ƒ์ด๊ณ  ์ƒ์„ฑ๋„ ์•ˆ ๋œ๋‹ค ๋ชฉ๋ก์—์„œ ์ œ๊ฑฐ
ci.yml mocks ํ•˜ํ•œ ๊ฒ€์‚ฌ ๋ˆ„๋ฝ 2๊ฑด์ด PodServiceยทEndpointEmailยทEndpointSignupValidation ์ฆ‰ ์ƒ์„ฑ ๋ถˆ๊ฐ€ ํƒ€์ž…์„ mock SCAN_PATHS ๋ฅผ composite ๊ณผ ๋™์ผํ•˜๊ฒŒ(feature/ ์ œ์™ธ)
check_endpoint_auth_gate.py ๋“ฑ๋ก ๋ชฉ๋ก(SSOT)์ด ์ƒ์„ฑ๋˜์ง€ ์•Š์•„ ์ „์ˆ˜ ๋Œ€์กฐ ๋ถˆ๊ฐ€ ์ „์ˆ˜ ๋Œ€์กฐ๋งŒ ๊ฐ•๋“ฑ. ๊ฒŒ์ดํŠธ ์„ ์–ธ ํŒ์ • ๋ณธ์ฒด๋Š” ๊ทธ๋Œ€๋กœ ๋Œ๊ณ  ๋ฐœ๊ฒฌ๋ถ„์€ ๋งค ์‹คํ–‰ ์ „๋Ÿ‰ ์ถœ๋ ฅ
check_shared_steps.py feature/*/* 3์ถ• 244๊ฑด ์ „๋Ÿ‰์ด ๋„๋„ˆ ๋„๋„ˆ 3์ถ• ๋ณด๋ฅ˜(+ ๋ฐฐ๋Ÿด์˜ ๊ฐœ๋ช… ์ž”์žฌ 2๊ฑด์€ ์‹ค์ œ ๊ฒฐํ•จ์ด๋ผ ์‚ญ์ œ)
detect_backend_impact.sh test/unit 81๊ฑด ์ค‘ 76๊ฑด์ด ์ƒ์„ฑ ๋ถˆ๊ฐ€ ํ”„๋กœํ† ์ฝœ์„ import ๋นŒ๋“œ ๋ฒ”์œ„ ๋ฐ–์ด๋ฉด ์Šคํ‚ต
detect_console_web_impact.sh ์ฝ˜์†”์ด ์˜์กดํ•˜๋Š” ๋„๋„ˆ feature 10๊ฐœ๊ฐ€ ์ œ๊ฑฐ๋œ injectable ์˜ injector.module.dart ๋ฅผ export ํ•ด ์˜๊ตฌ ๊ฒฐ์† ๊ฐ™์Œ
verify_widgetbook_coverage.sh ์—ด๊ฑฐ ๋Œ€์ƒ(feature/)๋„ use-case ์œ„์น˜(app/cocode_widgetbook/)๋„ ์ „๋ถ€ ๋„๋„ˆ ๊ฐ™์Œ

๋ถ€ํŠธ์ŠคํŠธ๋žฉ์ด ํ’€๋ฆฌ์ž ํ•˜์œ„ 5์žก์ด ์ฒ˜์Œ ์‹คํ–‰๋๊ณ , ๋‘˜์ด ๊ฐ™์€ ์ด์œ ๋กœ ์ฃฝ์—ˆ๋‹ค (#278).

์ž๋ฆฌ ๋ฌด์—‡์ด ์„ฑ๋ฆฝํ•˜์ง€ ์•Š์•˜๋‚˜ ์ฒ˜๋ถ„
analyze_changed_packages.py โ†’ dcm analyze ๋Œ€์ƒ 128๊ฐœ ์ค‘ 109๊ฐœ๊ฐ€ ๋„๋„ˆ. dcm ์ด 41/128 ์ปจํ…์ŠคํŠธ(feature/console/console_book_registration)์—์„œ ๋‚ด๋ถ€ ํฌ๋ž˜์‹œ โ€” type 'Null' is not a subtype of type 'Element' of 'key' ์ •๋ณธ์—์„œ ์œ ๋„ํ•ด 128 โ†’ 19
test ์žก์˜ ALL_TEST_PKGS melos list ๋Š” melos: ignore: ๋งŒ ๋ด์„œ, ์ƒ์„ฑ๋˜์ง€ ์•Š๋Š” cocode_client ์— ์ „์ด ์˜์กดํ•˜๋Š” 55๊ฐœ๊ฐ€ ๋‚จ์•˜๋‹ค. package/coreยทpod_service ๊ฐ€ ClientยทNotAuthenticatedException ์ฐธ์กฐ๋กœ ์ปดํŒŒ์ผ ๋ถˆ๊ฐ€ ๊ฐ™์€ ์œ ๋„๋กœ 78 โ†’ 17
๐ŸŽญ E2E ์†Œ์Šค ์ •์  ๋ถ„์„ (#280) app/cocode/integration_test ๋ฅผ dart analyze ์— ์ง์ ‘ ์ธ์ž๋กœ ๋„˜๊ฒจ ์ œ์™ธ๋ฅผ ์šฐํšŒ โ€” ๋„๋„ˆ ์‹ฌ๋ณผ(AppRouterKeys.storeTab ๋“ฑ) 34๊ฑด. continue-on-error ๋Š” ์œ ์˜ˆ์ผ ๋ฟ์ด๊ณ  ๋’ค์˜ ๊ฒฐ๊ณผ ํ™•์ธ ์Šคํ…์ด ์ง‘ํ–‰ํ•œ๋‹ค ๊ฐ™์€ ํŒ์ • ํ†ต๊ณผ

์—ฌ๋Ÿ ๊ณณ ์ค‘ ๋งˆ์ง€๋ง‰ ๋‘˜์€ ๋ชฉ๋ก์„ ๋ฒ ๋ผ์ง€ ์•Š๊ณ  ์ •๋ณธ์—์„œ ์œ ๋„ํ•œ๋‹ค. ์žก๋งˆ๋‹ค ์†์œผ๋กœ ์ ์œผ๋ฉด ๋ฐ˜๋“œ์‹œ ๊ฐˆ๋ผ์ง€๊ณ (ci.yml ์ฃผ์„ ์ž์‹ ์ด ใ€Œ์–‘์ชฝ ์ œ์™ธ ๋ชฉ๋ก์€ ํ•ญ์ƒ ํ•จ๊ป˜ ๊ณ ์น  ๊ฒƒใ€์ด๋ผ๊ณ  ๊ฒฝ๊ณ ํ•˜๋Š” ๊ทธ ๋“œ๋ฆฌํ”„ํŠธ๋‹ค โ€” #9499 ๋•Œ shared/i10nยทshared/config 9๊ฑด์ด ๊ฒŒ์ดํŠธ ๋ฐ–์œผ๋กœ ์ƒœ๋‹ค), donor_excluded_packages.py ๊ฐ€ analysis_options.yaml ์—์„œ ์ œ์™ธ ์ ‘๋‘๋ฅผ ์ฝ์–ด ๋‘ ์žก์— ๊ณต๊ธ‰ํ•œ๋‹ค. ๋‚จ๋Š” ๋Œ€์ƒ์€ ์ „๋ถ€ cocode ADE ์ž์‹ ์˜ ์ฝ”๋“œ์ด๊ณ , shared/i10nยทshared/config ํšŒ๊ท€ ๊ฐ€๋“œ๊ฐ€ ์‚ด์•„ ์žˆ์Œ์„ ํ™•์ธํ–ˆ๋‹ค.

๊ทธ ํŒ์ •์€ ๋‘ ๋ฐฉํ–ฅ์˜ ํ•จ์ •์„ ๋‹ค ๋ง‰๋Š”๋‹ค โ€” ๊ณผ์†Œ ์ œ์™ธ๋Š” ๋นŒ๋“œ ์•ˆ ๋˜๋Š” ๋„๋„ˆ๋ฅผ ๊ฒ€์ฆํ•˜๋ ค๋‹ค CI ๋ฅผ ์ฃฝ์ด๊ณ , ๊ณผ์ž‰ ์ œ์™ธ๋Š” ์ด ์ œํ’ˆ์˜ ๊ฒ€์ฆ์„ ์กฐ์šฉํžˆ ์ฆ๋ฐœ์‹œํ‚จ๋‹ค. ๊ทธ๋ž˜์„œ ํŒŒ์ผ ๊ธ€๋กญ์„ ์ ‘๋‘๋กœ ์ฝ์ง€ ์•Š๊ณ , DCM ๊ฐœ๋ณ„ ๊ทœ์น™์˜ exclude: ๋ฅผ ์ „์—ญ ํŒจํ‚ค์ง€ ์ œ์™ธ๋กœ ์Šน๊ฒฉํ•˜์ง€ ์•Š์œผ๋ฉฐ(์Šน๊ฒฉํ•˜๋ฉด ๊ทœ์น™์— - "package/core/**" ํ•œ ์ค„ ์ ๋Š” ๊ฒƒ๋งŒ์œผ๋กœ ๊ทธ ํŒจํ‚ค์ง€๊ฐ€ ๊ฒ€์ฆ์—์„œ ์‚ฌ๋ผ์ง„๋‹ค), ์ฝ๊ธฐ ์‹คํŒจ ์‹œ์—๋Š” ์•„๋ฌด๊ฒƒ๋„ ์ œ์™ธํ•˜์ง€ ์•Š๋Š”๋‹ค.

์Šค์ฝ”ํ”„๋ฅผ ๋ฐ”๋กœ์žก์ž ๋“œ๋Ÿฌ๋‚œ ๊ฒƒ โ€” ์ด ๋ฐ˜์˜์˜ ๋ถ€์ˆ˜ ์†Œ๋“

dcm analyze ๊ฐ€ ๋„๋„ˆ 109๊ฐœ๋ฅผ ๋นผ๊ณ  ์™„์ฃผํ•˜์ž(์ข…์ „์—๋Š” 41/128 ์ปจํ…์ŠคํŠธ์—์„œ ๋‚ด๋ถ€ ํฌ๋ž˜์‹œ๋กœ ์ฃฝ์–ด ์•„๋ฌด ์‹ ํ˜ธ๋„ ์—†์—ˆ๋‹ค) cocode ADE ์ž์‹ ์˜ ์ฝ”๋“œ์— ๋Œ€ํ•œ ์‹ค์ œ ์ง€์ ์ด ๋‚˜์™”๋‹ค โ€” error 4 ยท warning 144 ยท style 2276(๊ฒŒ์ดํŠธ๋Š” error ๋งŒ ์ฐจ๋‹จ). error 4๊ฑด์€ ์ „๋ถ€ ์ด ํ”„๋กœ์ ํŠธ๊ฐ€ ์ƒˆ๋กœ ์“ด ํ…Œ์ŠคํŠธ ์ฝ”๋“œ์˜€๊ณ , ์›Œํฌ์ŠคํŽ˜์ด์Šค ๋‹จ์ผ ๋ถ„์„(#9681)์ด test/ ๊นŒ์ง€ ๋ณด๊ฒŒ ๋˜๋ฉด์„œ ์ฒ˜์Œ ๋ณด์ธ ๊ฒƒ์ด๋‹ค. ๊ทœ์น™์„ ๋˜๋Œ๋ฆฌ์ง€ ์•Š๊ณ  ์ฝ”๋“œ๋ฅผ ๊ณ ์ณค๋‹ค โ€” ๋‘ ๊ทœ์น™ ๋ชจ๋‘ ใ€Œ์ž”์—ฌ 0๊ฑดใ€์„ ๊ทผ๊ฑฐ๋กœ error ๋กœ ์Šน๊ฒฉ๋œ ๊ฒƒ์ด๋ผ(#9203 ยท #9193) ๋˜๋Œ๋ฆฌ๋ฉด ๊ทธ ๊ฒฐ์ •์„ ๋ฌด๋ฅธ๋‹ค.

ํŒŒ์ผ ๊ทœ์น™ ์ฒ˜๋ถ„
core/test/domain/task_transition_test.dart (2) avoid-shadowing where ๋žŒ๋‹ค ํŒŒ๋ผ๋ฏธํ„ฐ๊ฐ€ ๋ฐ”๊นฅ for ๋ณ€์ˆ˜๋ฅผ ๊ฐ€๋ฆผ โ†’ ๊ฐœ๋ช…
editor/test/theme/cocode_semantic_token_sink_test.dart (2) avoid-unremovable-callbacks-in-listeners ์ต๋ช… ์ฝœ๋ฐฑ โ†’ ์ด๋ฆ„ ์žˆ๋Š” ํ•จ์ˆ˜ + addTearDown ํ•ด์ œ

์ฆ‰ ๋„๋„ˆ๋ฅผ ๋ฒ”์œ„์—์„œ ๋นผ๋Š” ๊ฒƒ์€ ๊ฒ€์ฆ์„ ์ค„์ด๋Š” ์ผ์ด ์•„๋‹ˆ๋ผ, ๊ฐ€๋ ค์ ธ ์žˆ๋˜ ์ด ์ œํ’ˆ์˜ ๊ฒ€์ฆ์„ ์ฒ˜์Œ์œผ๋กœ ๋“œ๋Ÿฌ๋‚ด๋Š” ์ผ์ด์—ˆ๋‹ค. ํฌ๋ž˜์‹œ๋กœ ์ฃฝ๋˜ ์žก์€ ๋ฌด์‹ ํ˜ธ์˜€์ง€ ํ†ต๊ณผ๊ฐ€ ์•„๋‹ˆ์—ˆ๋‹ค.

์™„์ „ ๊ฐ€์—ญ์ด๋ผ๋Š” D-031 ์˜ ์„ฑ์งˆ์„ ๊ฒ€์ฆ ๋‹จ๊ณ„๊นŒ์ง€ ์—ฐ์žฅํ–ˆ๋‹ค. ์—ฌ๋Ÿ ์™„ํ™”์˜ ์Šค์œ„์น˜๋Š” ์…‹๋ฟ์ด๋‹ค โ€” melos: ignore: ์˜ cocode_serverยทcocode_console, analysis_options.yaml ์˜ feature/**. ๊ทธ์ค‘ ํ•˜๋‚˜๋ผ๋„ ๋น ์ง€๋ฉด ํ•ด๋‹น ๊ฒ€์‚ฌ๋Š” ๊ทธ ์ฆ‰์‹œ ์›๋ž˜ ์ฐจ๋‹จ์œผ๋กœ ๋ณต๊ท€ํ•˜๊ณ , ๊ฐ ํŒŒ์ผ์˜ ํšŒ๊ท€ ํ…Œ์ŠคํŠธ๊ฐ€ ๊ทธ ๋ณต๊ท€๋ฅผ ๊ณ ์ •ํ•œ๋‹ค. melos: ignore: ํŒ๋…์€ ๊นŠ์ด๋ฅผ ๊ณ ์ •ํ•œ๋‹ค โ€” melos: scripts: ์˜ ๊ฐœ๋ณ„ ignore:(format:select ๋“ฑ)๋ฅผ ์ตœ์ƒ์œ„๋กœ ์˜ค์ธํ•˜๋ฉด ์Šคํฌ๋ฆฝํŠธ ํ•˜๋‚˜๊ฐ€ cocode_server ๋ฅผ ์ ์–ด ๋‘๋Š” ๊ฒƒ๋งŒ์œผ๋กœ ์™„ํ™”๊ฐ€ ์˜๊ตฌํ™”๋˜์–ด, ๋„๋„ˆ๊ฐ€ ์ •๋ฆฌ๋œ ๋’ค์—๋„ ๊ฒ€์‚ฌ๊ฐ€ ๋Œ์•„์˜ค์ง€ ์•Š๋Š”๋‹ค.

๋งˆ์ง€๋ง‰ ์ฐจ๋‹จ์€ D-031 ์ด ์•„๋‹ˆ์—ˆ๋‹ค (#281)

์œ„ ์•„ํ™‰ ๊ณณ์„ ๋‹ซ์ž ๐Ÿ—„๏ธ ๋ฐฑ์—”๋“œ ํ†ตํ•ฉ ํ…Œ์ŠคํŠธ ํ•˜๋‚˜๊ฐ€ ๋‚จ์•˜๋Š”๋ฐ, ์›์ธ์€ ์ฝ”๋“œ๊ฐ€ ์•„๋‹ˆ๋ผ ์กด์žฌํ•˜์ง€ ์•Š๋Š” ๋Ÿฌ๋„ˆ ๋ผ๋ฒจ์ด์—ˆ๋‹ค. runs-on: [self-hosted, docker, cocode, ARM64] ์ธ๋ฐ ๋“ฑ๋ก ๋Ÿฌ๋„ˆ 16๋Œ€(์ „๋ถ€ online) ์ค‘ cocode ๋ผ๋ฒจ ๋ณด์œ ๊ฐ€ 0๋Œ€๋‹ค. ๋งค์นญ์ด 0์ด๋ฉด ์žก์€ ์‹คํŒจํ•˜์ง€ ์•Š๊ณ  ์˜์›ํžˆ queued ๋กœ ๋‚จ์•„, ๊ทธ ์žก์„ needs ๋กœ ๊ฑฐ๋Š” ๐Ÿ“Š CI ์š”์•ฝ ๊นŒ์ง€ ๋ฉˆ์ถ˜๋‹ค. ๋ถ€ํŠธ์ŠคํŠธ๋žฉ์ด ์ƒ์‹œ ์‹คํŒจํ•ด ์ด ์žก์ด ๋Š˜ skip ๋˜๋˜ ํƒ“์— ๊ทธ๋•Œ๊นŒ์ง€ ๋“œ๋Ÿฌ๋‚˜์ง€ ์•Š์•˜๋‹ค. ์ด ์žก์˜ cocode ๋งŒ ์ œ๊ฑฐํ–ˆ๋‹ค(๋งค์นญ 0 โ†’ 16๋Œ€). ์žก ์ˆ˜์ค€ skip ์€ ํƒํ•˜์ง€ ์•Š์•˜๋‹ค โ€” ๊ทธ๋Ÿฌ๋ ค๋ฉด ๐Ÿ“Š CI ์š”์•ฝ ์˜ ใ€Œ์ „ ์žก successใ€ ํŒ์ •์„ ์™„ํ™”ํ•ด์•ผ ํ•˜๋Š”๋ฐ ๊ทธ ์ž๋ฆฌ๋Š” #11121ยท#10060 ๋‘ ์‚ฌ๊ณ ์˜ ํ‰ํ„ฐ์ด๊ณ , ์ธํ”„๋ผ ๋ฒ„๊ทธ๋ฅผ ์šฐํšŒํ•˜๋ ค๊ณ  ๊ฒ€์ฆ ํŒ์ •์„ ๋ฌด๋ฅด์ง€ ์•Š๋Š”๋‹ค.

โš ๏ธ ๋‚จ์€ ๊ฒƒ โ€” ์ด ๋ฐ˜์˜์ด ๋ฎ์ง€ ์•Š๋Š”๋‹ค. ์•„๋ž˜๋Š” ์ „๋ถ€ development ์™€ ๋ฐ”์ดํŠธ ๋™์ผํ•œ ๋„๋„ˆ ๋ถ€์ฑ„์ด๊ณ  Project #2 ๊ฐ€ ๋งŒ๋“  ๊ฒƒ์ด ์•„๋‹ˆ๋‹ค. ๋ฐฑ์—”๋“œยท๋„๋„ˆ๊ฐ€ ๋ฒ”์œ„๋กœ ๋Œ์•„์˜ค๋Š” ๋‚  ํ•จ๊ป˜ ์ฒ˜๋ฆฌ ๋Œ€์ƒ์ด ๋œ๋‹ค.

ํ•ญ๋ชฉ ํ˜„์žฌ ์ฒ˜๋ถ„
์ธ์ฆ ๊ฒŒ์ดํŠธ ๋ฏธ์„ ์–ธ 3๊ฑด โ€” AppRouterEndpointยทAppleIdpEndpointยทHomeFeedEndpoint ์ฐจ๋‹จํ•˜์ง€ ์•Š๊ณ  ๋งค ์‹คํ–‰ ์ „๋Ÿ‰ ์ถœ๋ ฅ. ๋“ฑ์žฌ๋Š” ๋ณด์•ˆ ์„ ์–ธ์ด๋ผ ์˜ค๋„ˆ ํŒ๋‹จ ์˜์—ญ
๊ณต์œ  BDD step ์œ„๋ฐ˜ 244๊ฑด (feature/consoleยทfeature/application) ๋ณด๋ฅ˜
console_member_list_page.dart.dart (์ด์ค‘ ํ™•์žฅ์ž ์ž”์žฌ, ์ฐธ์กฐ 0๊ฑด) ๋‚จ๊น€ โ€” ์ง€์›Œ๋„ ์œ„์ ฏ๋ถ ์ปค๋ฒ„๋ฆฌ์ง€ ๋ˆ„๋ฝ์€ ๊ทธ๋Œ€๋กœ๋ผ ์›์ธ์ด ์•„๋‹ˆ๊ณ , ๋„๋„ˆ ํŒŒ์ผ ์‚ญ์ œ๋Š” D-026 ์— ๊ฑธ๋ฆฐ๋‹ค

์‹ค์ธก(2026-09-14): analyze ์žก 29์Šคํ… ยท format ์žก 67์Šคํ… ์ „์ˆ˜ ์Šค์œ• โ€” ๋ฐ˜์˜ ํ›„ ๋‘˜ ๋‹ค ์‹คํŒจ 0 (development ๋Š” ๊ฐ๊ฐ 11 ยท 19). ๊ฐ€๋“œ ์ž์ฒด ํ…Œ์ŠคํŠธ 5ํŒŒ์ผ ์ „๋ถ€ ํ†ต๊ณผ, 26๊ฑด ์ถ”๊ฐ€. PR #273 ์ „์ฒด ํŒŒ์ดํ”„๋ผ์ธ: ๋ฐ˜์˜ ์ „ ํ•˜์œ„ 5์žก ์ „๋ถ€ skip โ†’ ๋ฐ˜์˜ ํ›„ 8์žก ์‹คํ–‰.

D-032: ์‹คํ–‰ ์ค‘ ์ž‘์—…์˜ ์ค‘์ง€ ์ž…๋ ฅ๊ณผ ์Šน์ธ ๊ฑฐ๋ถ€ ๊ฒฝ๋กœ๋ฅผ ์‹ ์„ค โ€” status ํ์‡„ ์ง‘ํ•ฉ 7์ข… โ†’ 9์ข…

  • Date: 2026-09-10
  • Context: ์ด์Šˆ #105. flow-permutation C-5 ๊ฐ€ ๋ฌดํ•œ ์ฒด๋ฅ˜ 4์ง€์ (FP-105ยท106ยท107ยท405)์„ ์ง€์ ํ–ˆ๊ณ , UX-D-06("์ž‘์—… ์ค‘๋‹จ/์ทจ์†Œ ๋ฒ„ํŠผ์„ ๋‘์ง€ ์•Š๋Š”๋‹ค")๊ณผ ์ •๋ฉด ์ถฉ๋Œํ–ˆ๋‹ค. UX-D-06 ์ด ์•ˆ์ „ ๊ทผ๊ฑฐ๋กœ ๋“  AC-08 ์€ Given ์ด "์ž๊ฐ€ ๊ฒ€์ฆ ์‹œ๋„๊ฐ€ ์ง„ํ–‰ ์ค‘์ผ ๋•Œ"๋กœ ํ•œ์ •๋ผ(seed-spec:110) ํŽธ์ง‘ ๋‹จ๊ณ„์™€ ์ž ๊ธˆ ๋Œ€๊ธฐ๋ฅผ ๋ฎ์ง€ ๋ชปํ•œ๋‹ค.
  • Options: โ‘ ์ค‘์ง€ ์ž…๋ ฅ + ๊ฑฐ๋ถ€ status ์‹ ์„ค โ‘กUX-D-06 ์œ ์ง€(๋ฏธ๋ฎํž˜ ๊ตฌ๊ฐ„์„ ์œ„ํ—˜ ์ธ์ˆ˜๋กœ ๊ธฐ๋ก) โ‘ข๊ฑฐ๋ถ€ ๊ฒฝ๋กœ๋งŒ ์‹ ์„ค
  • Decision: ์˜ต์…˜ โ‘  โ€” ์ค‘์ง€ ์ž…๋ ฅ๊ณผ ๊ฑฐ๋ถ€ ๊ฒฝ๋กœ๋ฅผ ๋‘˜ ๋‹ค ์‹ ์„ค. ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•์ •(2026-09-10).
  • Rationale: โ‘ก๋Š” ํŽธ์ง‘ ๋‹จ๊ณ„ยท์ž ๊ธˆ ๋Œ€๊ธฐ์—์„œ ์ž๋™ ์ข…๋ฃŒ๊ฐ€ ์„ฑ๋ฆฝํ•˜๋Š” ์ด์œ ๋ฅผ AC/DD ๋ฒˆํ˜ธ๋กœ ๋…ผ์ฆํ•ด์•ผ ํ•˜๋Š”๋ฐ AC-08 ์˜ Given ์ด ๊ทธ ๊ตฌ๊ฐ„์„ ๋ฎ์ง€ ์•Š์•„ ๋…ผ์ฆ์ด ์„œ์ง€ ์•Š๋Š”๋‹ค. โ‘ข์€ ์Šน์ธ ํ๋ฆ„๋งŒ ๋‹ซ๊ณ  C-5 ์˜ ๋ฌดํ•œ ์ฒด๋ฅ˜ 4์ง€์ ์„ ๊ทธ๋Œ€๋กœ ๋‚จ๊ธด๋‹ค. ๋ง‰ํžŒ 4๊ฑด(#68 #69 #70 #71 ยท 18pt)์ด ๋ชจ๋‘ โ‘ ์—์„œ๋งŒ ํ’€๋ฆฐ๋‹ค.
  • Impact: seed-spec v3.3.0 โ€” status ๊ฐ’ ์ง‘ํ•ฉ 9์ข…(๊ฑฐ๋ถ€๋จ ยท ์ค‘์ง€๋จ ์ถ”๊ฐ€), ์ข…๊ฒฐ ์ƒํƒœ ์ •์˜ ํ™•์žฅ, AC-22(์‹คํ–‰ ์ค‘ ์ค‘์ง€) ยท AC-23(์Šน์ธ ๊ฑฐ๋ถ€) ์‹ ์„ค. ํ›„์†: docs/state-machine-cocode.md ์ „์ดํ‘œ์— ๋‘ ์ข…๊ฒฐ ์ „์ด ์ถ”๊ฐ€, AgentSession.cancel ํ˜ธ์ถœ๋ถ€, ์Šน์ธ ํยท์นด๋“œ UI(#85). UX-D-06 ์€ ์ด ๊ฒฐ์ •์œผ๋กœ ํ๊ธฐ๋œ๋‹ค โ€” docs/ux-spec-cocode.md ์ •์ • ํ•„์š”.

D-033: ์ž๊ฐ€ ๊ฒ€์ฆ ์‹œ๋„ ์‹œ๊ฐ„ ์ƒํ•œ์˜ ์ถœํ•˜ ๊ธฐ๋ณธ๊ฐ’์„ 20๋ถ„ ์ž ์ •๊ฐ’์œผ๋กœ ํ™•์ • โ€” D-020 ๋ณด๋ฅ˜ ํ•ด์ œ

  • Date: 2026-09-10
  • Context: ์ด์Šˆ #106. D-020 ์ด ์ด ๊ฐ’์„ "์ŠคํŒŒ์ดํฌ ์‹ค์ธก ํ›„"๋กœ ๋ณด๋ฅ˜ํ–ˆ์œผ๋‚˜, v3.0.0 ์ด ์‹ ์„คํ•œ AC-08 ์€ ์„ค์น˜ ์งํ›„ ์–‘์˜ ์œ ํ•œํ•œ ๊ธฐ๋ณธ๊ฐ’์ด ์กด์žฌํ•  ๊ฒƒ์„ ์š”๊ตฌํ•œ๋‹ค. ๊ฐ’์ด ์—†์œผ๋ฉด #50 #66 #67 #73 ๋„ค Story ๊ฐ€ ๊ตฌํ˜„์„ ๋งˆ์ณ๋„ ์™„๋ฃŒ ํŒ์ • ์ž์ฒด๊ฐ€ ์—ด๋ฆฌ์ง€ ์•Š๋Š”๋‹ค(์žฌ์ž‘์—…์ด ์•„๋‹ˆ๋ผ ํŒ์ • ๋ถˆ๊ฐ€).
  • Options: โ‘ ์ง€๊ธˆ ์ž ์ • ๊ธฐ๋ณธ๊ฐ’์„ ์ •ํ•˜๊ณ  "์‹ค์ธก ์ „ ์ž ์ •๊ฐ’"์œผ๋กœ ํ‘œ๊ธฐ โ‘ก์‹ค์ธก๊นŒ์ง€ ๊ฐ’์„ ๋น„์šฐ๊ณ  ๋Œ€๊ธฐ๋ฅผ ์œ„ํ—˜์œผ๋กœ ์ธ์ˆ˜
  • Decision: ์˜ต์…˜ โ‘  โ€” 20๋ถ„. ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•์ •(2026-09-10).
  • Rationale: ๊ฐ’์˜ ๊ทผ๊ฑฐ๋ฅผ ์ง€์–ด๋‚ด์ง€ ์•Š๊ณ  ์‹ค์ธก์—์„œ ๋„์ถœํ–ˆ๋‹ค โ€” job-timeout-budget B-1(์‹ค์ธก ์ตœ๋Œ€ ร— 2) ์„ ์ด ์ €์žฅ์†Œ CI ์žก ์‹ค์ธก 41๊ฑด์— ์ ์šฉ: ๐Ÿงช ๋ณ€๊ฒฝ ํŒจํ‚ค์ง€ ๋ถ„์„ยทํ…Œ์ŠคํŠธ(= C-04 โ‘กํ…Œ์ŠคํŠธ + โ‘ฃ์ •์ ๋ถ„์„) max 8.9m ร— 2 = 17.8m โ†’ 20๋ถ„ ์ ˆ์ƒ(B-3: ์ƒํ•œ์€ ๊ณผ๋Œ€์ถ”์ •์ด ์•ˆ์ „์ธก). D-013ยทD-015ยทD-020 ์ด ๊ฒฝ๊ณ„ํ•œ ํŒจํ„ด๊ณผ ๊ตฌ๋ถ„๋˜๋Š” ์ง€์ ์€ โ“์ถœ์ฒ˜ ์žˆ๋Š” ํ‘œ๋ณธ์—์„œ ๊ทœ์น™์œผ๋กœ ๋„์ถœ๋๊ณ  โ“‘๋ถˆ๋ณ€ ์ธต์œ„(ยง4)๊ฐ€ ์•„๋‹ˆ๋ผ ์กฐ์ • ๊ฐ€๋Šฅํ•œ Planning ์ธต์œ„์— ์‚ฐ๋‹ค๋Š” ๊ฒƒ์ด๋‹ค. AC-08 ๋ฌธ๋ฉด์€ ๊ฐ’์„ ๋‹ด์ง€ ์•Š๋Š”๋‹ค.
  • Impact: docs/planning-inputs-cocode.md ยง1ยทยง6ยทยง7.1 ์‹ ์„ค. C-04 ์žฌ์‹œ๋„ 3ํšŒ์™€ ๊ณฑํ•ด ์ž‘์—…๋‹น ์ž๊ฐ€ ๊ฒ€์ฆ ์ƒ๊ณ„ 60๋ถ„. AC-20 ์œ ํœด ์ƒํ•œ(#50)์ด ์ด ๊ฐ’์„ ์‹œ๋“œ๋กœ ์‚ผ๋Š”๋‹ค. ์ŠคํŒŒ์ดํฌ(#96)๊ฐ€ ์‹ค์ œ ๋ถ„ํฌ๋ฅผ ๋‚จ๊ธฐ๋ฉด B-1 ๋กœ ์žฌ์‚ฐ์ •ํ•˜๊ณ  ์ƒํ•œ 3์ข… ๊ด€๊ณ„ ๋ฌธ์žฅ์„ ํ•จ๊ป˜ ๊ฐฑ์‹ ํ•œ๋‹ค.

D-034: agent ์ž์ฒด ๋Ÿฐํƒ€์ž„์˜ ๋ชจ๋ธ ๋น„์šฉ์€ BYOK

โš ๏ธ D-111(2026-11-18)๋กœ ๋Œ€์ฒด๋๋‹ค โ€” IDE ์˜ AI ๋Š” ์„œ๋ฒ„๋กœ๋งŒ ๋Œ๊ณ , ์‚ฌ์šฉ์ž ํ‚ค ยท ๋ชจ๋ธ ์„ ํƒ์€ ์ œ๊ฑฐํ•œ๋‹ค.

  • Date: 2026-09-10
  • Context: ์ด์Šˆ #107. #45(LLM ํ”„๋กœ๋ฐ”์ด๋” 2๊ฐœ ์ด์ƒ ์—ฐ๊ฒฐ, 13pt)๊ฐ€ #52 ๋ฅผ ์„ ํ–‰์œผ๋กœ ๊ฑธ๊ณ  ์žˆ๊ณ , ์ด ๋‹ต์ด CredentialVault ์˜ "ํ‚ค ์†Œ์œ ์ž์™€ ์ฃผ์ž… ์ง€์ "์„ ์ •ํ•œ๋‹ค.
  • Options: โ‘ BYOK โ‘ก์ œํ’ˆ ์กฐ๋‹ฌยท์žฌํŒ๋งค โ‘ข์ถœ์‹œ ํ›„๋กœ ๋ณด๋ฅ˜
  • Decision: ์˜ต์…˜ โ‘  โ€” BYOK. ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•์ •(2026-09-10).
  • Rationale: ์‚ฌ์šฉ์ž ํ‚ค๋ฅผ OS ์ž๊ฒฉ์ฆ๋ช… ์ €์žฅ์†Œ์— ๋ณด๊ด€ํ•˜๋Š” ํ˜„ํ–‰ DD-23 ์„ค๊ณ„๊ฐ€ ๊ทธ๋Œ€๋กœ ์œ ํšจํ•ด ์žฌ๋ฐฐ์„ ์ด ์—†๊ณ  #45 ๊ฐ€ ์ฆ‰์‹œ ์ฐฉ์ˆ˜ ๊ฐ€๋Šฅํ•˜๋‹ค. โ‘ก๋Š” ์ฃผ์ž… ์ง€์ ยท์ฟผํ„ฐยท์š”๊ธˆ ๊ณ„๋Ÿ‰์ด ์ƒˆ๋กœ ํ•„์š”ํ•˜๊ณ  Q-03(๊ฐ€๊ฒฉ๋Œ€) ๊ฒฐ์ •์ด ์—ฐ์‡„๋กœ ์—ด๋ฆฐ๋‹ค. โ‘ข์€ PRD Q-02 ํ–‰์— ๋ณด๋ฅ˜ ํ‘œ๊ธฐ๊ฐ€ ์—†์–ด ๋ณด๋ฅ˜ ์‚ฌ์‹ค ์ž์ฒด๋ฅผ ์ƒˆ๋กœ ๊ธฐ๋กํ•ด์•ผ ํ•˜๋Š”๋ฐ, ๊ทธ ๋น„์šฉ์„ ์น˜๋ฅด๊ณ ๋„ #45 ๋Š” ๊ฒฐ๊ตญ BYOK ๋ฅผ ์ž ์ • ์ „์ œ๋กœ ์ง„ํ–‰ํ•˜๊ฒŒ ๋œ๋‹ค.
  • Impact: ๊ณผ๊ธˆยท์ •์‚ฐ ์„ค๊ณ„๊ฐ€ MVP ๋ฒ”์œ„์—์„œ ๋น ์ง„๋‹ค. #52 ๋Š” BYOK ๋กœ ๋‹ซํžˆ๊ณ  #45 ์ฐฉ์ˆ˜ ๊ฐ€๋Šฅ. #46(์ž๊ฒฉ์ฆ๋ช… ์ €์žฅ์†Œ)์€ ์›๋ž˜ ์ด ๊ฒฐ์ •์— ๋ง‰ํžˆ์ง€ ์•Š์•˜๋‹ค(#52 ์˜ AC ๊ฐ€ ๋ช…์‹œ).

๐Ÿ“Œ ํŒŒ๊ธ‰ ๋ฐ˜์˜ ์™„๋ฃŒ (#52, 2026-09-13) โ€” D-034 ๊ฐ€ ๋‚จ๊ธด ๋ฐ˜์˜์„ ๋‹ซ์•˜๋‹ค.

ํ•ญ๋ชฉ ์ฒ˜๋ถ„
ํ‚ค ์†Œ์œ ์žยท์ฃผ์ž… ์ง€์  CredentialVault(package/core/.../contracts.dart) doc ์— ๋ฐ˜์˜ โ€” ์†Œ์œ ์ž = ์‚ฌ์šฉ์ž, ์ฃผ์ž… ์ง€์  = agent ์ธํ”„๋กœ์„ธ์Šค ํ•œ ๊ณณ. ์ œํ’ˆ ํ‚ค๋ฅผ ๋ณด๊ด€ํ•˜๋Š” ์ž๋ฆฌ๊ฐ€ ์—†๋‹ค. ์ž์‹ ํ”„๋กœ์„ธ์Šค๋กœ ๊ฐ€๋Š” ํ†ต๋กœ๋„ ์—†๋‹ค(DD-23a ๊ฐ€ ์ž๊ฒฉ์ฆ๋ช…์„ฑ ๋ณ€์ˆ˜๋ฅผ ์ž๋™ ๊ฑฐ๋ถ€)
#107 ๊ฒฐ์ • ๋Œ€๊ธฐ ๋ฌธ๊ตฌ ์ œ๊ฑฐ โ€” ๊ฒฐ์ •์€ 2026-09-10 ์— ๋‚ฌ๊ณ  ๊ทธ ๋’ค๋กœ๋„ ๊ณ„์•ฝ์— ใ€Œ๋Œ€๊ธฐใ€๋กœ ๋‚จ์•„ ์žˆ์—ˆ๋‹ค
AC-06 ์˜ ์„ ํ–‰ ์กฐ๊ฑด์ด์—ˆ๋Š”๊ฐ€ ๊ทธ๋ ‡๋‹ค โ€” ๊ทธ๋ฆฌ๊ณ  ์ด๋ฏธ ํ•ด์†Œ๋๋‹ค. #45 ๊ฐ€ #52 ๋ฅผ ์„ ํ–‰ ์ž‘์—…์œผ๋กœ ๊ฑธ์—ˆ๊ณ (์ž๊ฒฉ์ฆ๋ช… ํš๋“ ๊ฒฝ๋กœ ์ „์ฒด์˜ ๋ฐฐ์„ ์ด ์—ฌ๊ธฐ ๋‹ฌ๋ ธ๋‹ค), PRD Q-02 ํ–‰์—๋Š” ๋ณด๋ฅ˜ ํ‘œ๊ธฐ๊ฐ€ ์—†์–ด ์ถœ์‹œ ํ›„๋กœ ๋ฏธ๋ฃจ๋ ค๋ฉด ๋ณด๋ฅ˜ ์‚ฌ์‹ค ์ž์ฒด๋ฅผ ์ƒˆ๋กœ ๊ธฐ๋กํ•ด์•ผ ํ–ˆ๋‹ค. ์˜ค๋„ˆ๊ฐ€ 2026-09-10 ์— ํ™•์ •ํ•ด ๊ทธ ์„ ํ–‰ ์กฐ๊ฑด์ด ์‚ฌ๋ผ์กŒ๋‹ค โ€” ์ถœ์‹œ ํ›„๋กœ ๋ฏธ๋ฃจ๋Š” ๊ฒฝ๋กœ๋Š” ์„ ํƒ๋˜์ง€ ์•Š์•˜๋‹ค
#46 ์€ ๋ง‰ํžˆ์ง€ ์•Š์•˜๋‹ค ์žฌํ™•์ธ. DD-23 ์ด ํ™•์ •ํ•œ ์ €์žฅ ์œ„์น˜ยท๊ธˆ์ง€ ๊ทœ์น™๋งŒ์œผ๋กœ ์ž๊ฒฉ์ฆ๋ช… ์ €์žฅ์†Œ ๊ตฌํ˜„์ด ์„ฑ๋ฆฝํ•œ๋‹ค โ€” BYOK ๋“  ์ œํ’ˆ ์กฐ๋‹ฌ์ด๋“  ใ€ŒOS ์ž๊ฒฉ์ฆ๋ช… ์ €์žฅ์†Œ์— ๋„ฃ๊ณ  ์›Œํฌ์ŠคํŽ˜์ด์Šคยทํ‰๋ฌธยทํ™˜๊ฒฝ๋ณ€์ˆ˜๋กœ๋Š” ๋‚ด๋ณด๋‚ด์ง€ ์•Š๋Š”๋‹คใ€๋Š” ๊ฐ™๋‹ค
PRD ยง1.6 Q-02 ํ–‰ ํ•ด์†Œ ํ‘œ๊ธฐ + ๊ฒฐ์ • ์ด์Šˆ ๋งํฌ. ยง1.4 ์˜ ใ€Œ๋ชจ๋ธ ๋งˆ์ง„ ์—†์ด ๋„๊ตฌ๊ฐ’๋งŒใ€ ๋…ผ๋ฆฌ๋Š” acp ๊ฒฝ๋กœ์—๋งŒ ์ ์šฉ๋œ๋‹ค๊ณ  ๋ฒ”์œ„๋ฅผ ์ ์—ˆ๋‹ค
๊ฐ€๊ฒฉ๊ฐ’ ์ธ์šฉ ๊ธˆ์ง€ $5~9/์›”ยท$0ยท$20/์›” ์€ ์„ค๊ณ„ ๋…ธํŠธ์˜ ์‹œ์žฅ ๋ถ„์„๊ฐ’์ด๊ณ  ์ด ์ œํ’ˆ์˜ ๊ฐ€๊ฒฉ์ด ์•„๋‹ˆ๋‹ค. Q-02 ๊ฐ€ BYOK ๋กœ ๋‹ซํ˜”๋‹ค๋Š” ์‚ฌ์‹ค์ด ๊ทธ ์ˆ˜์น˜๋ฅผ ๊ฐ€๊ฒฉ์œผ๋กœ ๋งŒ๋“ค์ง€ ์•Š๋Š”๋‹ค โ€” Q-03(๊ฐ€๊ฒฉ๋Œ€) ํ–‰์— ๊ทธ ๋ฌธ์žฅ์„ ๋ช…์‹œ์ ์œผ๋กœ ์ถ”๊ฐ€ํ–ˆ๋‹ค. ์‹ค์ธก: ์ด ์ˆ˜์น˜๋“ค์€ docs/discovery-cocode.md(์› ์ถœ์ฒ˜)์™€ docs/prd-cocode.md(์ธ์šฉ ์ฃผ์˜ ๋ฌธ๋‹จ)์—๋งŒ ์žˆ๊ณ , ๊ฐ€๊ฒฉ์œผ๋กœ ๋‹จ์–ธํ•˜๋Š” ๋ฌธ์žฅ์€ 0๊ฑด์ด๋‹ค

D-035: C-02 ์˜ ๋ฌด์กฐ๊ฑด ๋กค๋ฐฑ ๋ณด์žฅ ๋ฒ”์œ„๋ฅผ ๋ณด์กด ์ •์ฑ… ์œ ์ง€๋ถ„์œผ๋กœ ํ•œ์ • โ€” ๊ฐ’ 3์ข…์€ #29 ์˜ ๋ชซ

  • Date: 2026-09-10
  • Context: ์ด์Šˆ #108. EditSnapshot ๋ณด์กด ์ •์ฑ… ๊ฐ’ 3์ข…(Kยท์ด๋Ÿ‰ ์ƒํ•œยท๋ณด์กด ๊ธฐ๊ฐ„)๊ณผ C-02 ์˜ "์ž„์˜ ๊ฒฝ๊ณ„ ์‹œ์  ๋ฌด์กฐ๊ฑด ๋กค๋ฐฑ" ๋ณด์žฅ์ด ์ถฉ๋Œํ•ด, ๊ฐ’์„ ์ •ํ•˜๋ฉด C-02 ๋ฅผ ๊นจ๊ณ  ์•ˆ ์ •ํ•˜๋ฉด ์‚ญ์ œ ํŠธ๋ฆฌ๊ฑฐ(P7)๊ฐ€ ๋ฐœ๋™ํ•˜์ง€ ์•Š์•„ ๋ณด์กด ์ •์ฑ…์ด ์‚ฌ์‹ค์ƒ ๋น„ํ™œ์„ฑ์œผ๋กœ ์ถœํ•˜๋œ๋‹ค.
  • Options: โ‘ Seed Spec ๊ฐœ์ •์œผ๋กœ C-02 ์— ๋ณด์กด ํ•œ๊ณ„ ๋ช…์‹œ โ‘ก๊ฐ’์„ ์ •ํ•˜์ง€ ์•Š๊ณ  ์šฉ๋Ÿ‰ ์ฆ๊ฐ€ ์œ„ํ—˜ ์ธ์ˆ˜ โ‘ข๊ฐ’๋งŒ ์ •ํ•˜๊ณ  ์ถฉ๋Œ์€ ๊ธฐ๋ก๋งŒ
  • Decision: ์˜ต์…˜ โ‘  โ€” C-02 ๊ฐœ์ •. ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•์ •(2026-09-10).
  • Rationale: โ‘ก๋Š” #29 ์˜ "์ถœํ•˜ ๊ธฐ๋ณธ๊ฐ’" AC ๋ฅผ ์ถฉ์กฑํ•  ์ˆ˜ ์—†๊ณ  ํžˆ์Šคํ† ๋ฆฌ๊ฐ€ ๋ฌดํ•œ ์ฆ๊ฐ€ํ•œ๋‹ค. โ‘ข์€ ๋ถˆ๋ณ€์‹๊ณผ ์„ค๊ณ„๊ฐ€ ์–ด๊ธ‹๋‚œ ์ฑ„ ๋‚จ์•„ ๋กค๋ฐฑ ์‹คํŒจ ๋•Œ๋งˆ๋‹ค ํŒ์ • ๊ทผ๊ฑฐ๊ฐ€ ๊ฐˆ๋ฆฐ๋‹ค. โ‘ ๋งŒ์ด ๋ชจ์ˆœ์„ ์‹ค์ œ๋กœ ์—†์•ค๋‹ค.
  • Impact: seed-spec v3.3.0 โ€” C-02 ์— "๋ณด์žฅ ๋ฒ”์œ„๋Š” ๋ณด์กด ์ •์ฑ…์ด ์œ ์ง€ํ•˜๊ณ  ์žˆ๋Š” EditSnapshot ์— ํ•œํ•œ๋‹ค + ์‚ญ์ œ๋ถ„ ๊ณ ์ง€ ์˜๋ฌด" ์ถ”๊ฐ€. ์ด ๊ฐœ์ •์€ ๊ฐ’์„ ์ •ํ•˜์ง€ ์•Š๋Š”๋‹ค โ€” ๊ฐ’ 3์ข…์€ ๋ชจ์ˆœ์ด ์‚ฌ๋ผ์ง„ ๋’ค #29 ๊ฐ€ ์‹ค์ธก ๊ทผ๊ฑฐ๋กœ ์ •ํ•˜๋Š” ์‚ฐ์ถœ๋ฌผ์ด๋‹ค(๊ทผ๊ฑฐ ์—†๋Š” ์ˆซ์ž๋ฅผ ๋ถˆ๋ณ€ ์ธต์œ„์— ์ž ๊ทธ์ง€ ์•Š๋Š”๋‹ค๋Š” D-020 ์›์น™ ์œ ์ง€). #32(verification_log ์˜ P4 ์‚ญ์ œ ๋Œ€์ƒ ํฌํ•จ ์—ฌ๋ถ€)๊ฐ€ ์ด์ œ ํŒ์ • ๊ฐ€๋Šฅํ•ด์ง„๋‹ค.

D-036: ๋กค๋ฐฑ ์ถฉ๋Œ ํŒ์ •์— ์ž‘์—… ๋ฒ”์œ„ ํ•œ์ •์„ ์ŠคํŽ™ ๋ฌธ๋ฉด์œผ๋กœ ๋ช…์‹œ

  • Date: 2026-09-10
  • Context: ์ด์Šˆ #110. #24 ๋Š” ์ด๋ฏธ "์ „์—ญ ๋งˆ์ง€๋ง‰ EditSnapshot ์ด ๋กค๋ฐฑ ๋Œ€์ƒ ์ž‘์—…์˜ ๊ฒƒ์ธ์ง€๋„ ํ•จ๊ป˜ ๋ณธ๋‹ค"๋ฅผ AC ๋กœ ์ ์–ด ๋‘์—ˆ์œผ๋‚˜(๊ทผ๊ฑฐ: flow-permutation ยง6.1 C-4 / FP-304) Seed Spec ๋ฌธ๋ฉด์—๋Š” ๊ทธ ํ•œ์ •์ด ์—†์—ˆ๋‹ค โ€” ๊ตฌํ˜„์ด ์ŠคํŽ™๋ณด๋‹ค ์•ž์„œ ์žˆ๋Š” ์ƒํƒœ์˜€๋‹ค.
  • Options: โ‘ ๋ฌธ๋ฉด์— "๊ฐ™์€ ์ž‘์—…์—์„œ" ๋ฒ”์œ„ ๋ช…์‹œ โ‘ก๋ฌธ๋ฉด ์œ ์ง€ + #24 ์˜ ์‚ฌ์ „๊ฒ€์‚ฌ ์ œ๊ฑฐ โ‘ข"์ „์—ญ ๋งˆ์ง€๋ง‰์ด ๋Œ€์ƒ ์ž‘์—… ๊ฒƒ์ด ์•„๋‹ˆ๋ฉด ํ•ญ์ƒ ์ถฉ๋Œ" ์„ ์ŠคํŽ™์— ๋ช…์‹œ
  • Decision: ์˜ต์…˜ โ‘  โ€” ๋ฌธ๋ฉด์— ๋ฒ”์œ„ ๋ช…์‹œ(์‹ค์งˆ์ ์œผ๋กœ โ‘ข์˜ ์•ˆ์ „์„ฑ์„ โ‘ ์˜ ํ˜•ํƒœ๋กœ ๋‹ด์•˜๋‹ค). ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•์ •(2026-09-10).
  • Rationale: โ‘ก๋Š” ๋‘ ์ž‘์—…์ด ๊ฐ™์€ ํŒŒ์ผ์„ ์ˆœ์ฐจ ํŽธ์ง‘ํ•œ ๋’ค ์•ž ์ž‘์—…์„ ๋กค๋ฐฑํ•  ๋•Œ ๋’ค ์ž‘์—… ํŽธ์ง‘์ด ์ถฉ๋Œ๋กœ ์žกํžˆ์ง€ ์•Š๊ณ  ์‚ฌ๋ผ์ง€๋Š” ๋™์ž‘์„ ์ธ์ˆ˜ํ•˜๊ฒŒ ๋˜๊ณ , #24 ์˜ AC ํ•œ ์ค„๊ณผ ๊ทธ ํ…Œ์ŠคํŠธ๊ฐ€ ํ†ต์งธ๋กœ ๋ฌดํšจ๊ฐ€ ๋œ๋‹ค. ์ด๋ฏธ ๋‚˜๊ฐ„ ๊ตฌํ˜„๊ณผ ์ŠคํŽ™์„ ์ผ์น˜์‹œํ‚ค๋Š” ๋ฐฉํ–ฅ์ด ์žฌ์ž‘์—…์ด ๊ฐ€์žฅ ์ ๋‹ค.
  • Impact: seed-spec v3.3.0 โ€” EditSnapshot ๋ถˆ๋ณ€์‹๊ณผ AC-02 ๋ฅผ "๋กค๋ฐฑ ๋Œ€์ƒ ์ž‘์—…์ด ๋‚จ๊ธด ๋งˆ์ง€๋ง‰ result_content_hash" ๋กœ ํ•œ์ •ํ•˜๊ณ , "์ „์—ญ ๋งˆ์ง€๋ง‰ ์Šค๋ƒ…์ƒท์ด ๋กค๋ฐฑ ๋Œ€์ƒ ์ž‘์—…์˜ ๊ฒƒ์ด ์•„๋‹ˆ๋ฉด ์ถฉ๋Œ๋กœ ์ œ์‹œ" ๋ฅผ ๊ทœ๋ฒ”์œผ๋กœ ์ถ”๊ฐ€. #24 ์˜ ์‚ฌ์ „๊ฒ€์‚ฌ๊ฐ€ ์ŠคํŽ™ ๊ทผ๊ฑฐ๋ฅผ ์–ป์—ˆ๊ณ  #89(์ตœ๋Œ€ sequence_no ๋กค๋ฐฑ ํ‘œ์‹œ)์˜ ๊ฒฝ๊ณ„ ์ •์˜๊ฐ€ ํŒ์ • ๊ฐ€๋Šฅํ•ด์ง„๋‹ค.

D-037: ๊ธฐ์กด ์›Œํฌ์ŠคํŽ˜์ด์Šค์— co-brick ๋ง๋ถ™์ด๊ธฐ๋Š” MVP ๋ฒ”์œ„ ๋ฐ–

  • Date: 2026-09-10
  • Context: ์ด์Šˆ #113. ยง4 ์ธ์ˆ˜ ๊ฒฝ๊ณ„์— ๋Œ€์‘ AC 0๊ฑด์ธ ์†์„ฑ ์ •์˜("co-brick")๊ฐ€ ๋‚จ์•„ Specification Gate ์žฌํ†ต๊ณผ(ํ˜„์žฌ 0.3125 / ๊ธฐ์ค€ 0.2)์— ๊ณ„์† ๊ฑธ๋ ธ๋‹ค. ์ด ๋‹ต์ด ํ‘ธ๋Š” ๊ฒƒ์€ ์ž๊ธฐ ์ž์‹ (#42, 3pt)๋ฟ์ด๋‹ค.
  • Options: โ‘ MVP ์— ํฌํ•จ โ‘กMVP ๋ฒ”์œ„ ๋ฐ– โ‘ข๊ณ„์† ๋ฏธ๊ฒฐ
  • Decision: ์˜ต์…˜ โ‘ก โ€” MVP ๋ฒ”์œ„ ๋ฐ–. ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•์ •(2026-09-10).
  • Rationale: โ‘ ์€ seed-spec ยง4 AC ์‹ ์„ค โ†’ bdd Feature 7 ์‹œ๋‚˜๋ฆฌ์˜ค + ยง2 ๋Œ€์‘ํ‘œ โ†’ ux-spec ํ™”๋ฉด ์ธ๋ฒคํ† ๋ฆฌ ์‹ ์„ค๋กœ ์—ฐ์‡„ ๊ฐœ์ •์ด ๋ฐœ์ƒํ•˜๊ณ  ๋ชจํ˜ธ์„ฑ ์žฌํ‰๊ฐ€ ํšŒ์ฐจ๊ฐ€ ํ•œ ๋ฒˆ ๋” ๋“ ๋‹ค. ๋‹ค๋ฅธ Story ๊ฐ€ co-brick ์ ์šฉ์„ ์ „์ œํ•˜์ง€ ์•Š์œผ๋ฏ€๋กœ(#40 ์€ ์ตœ์ดˆ ์Šค์บํด๋”ฉ brick ๋งŒ, ux-spec ์ง„์ž…์  ํ™”๋ฉด 0๊ฑด) ์ œ์™ธ์˜ ๋ถ€์ž‘์šฉ์ด ์—†๋‹ค. โ‘ข์€ ๊ฒŒ์ดํŠธ๋ฅผ ๊ณ„์† ๋ง‰๋Š”๋‹ค.
  • Impact: seed-spec v3.3.0 โ€” AC-24(Must-Not) ์‹ ์„ค, ์šฉ์–ดํ‘œ์™€ Workspace.applied_bricks ๋ฅผ "์ตœ์ดˆ ์Šค์บํด๋”ฉ brick" ์˜๋ฏธ๋กœ ์ •์ •(MVP ์—์„œ ์›์†Œ 1๊ฐœ). #42 ๊ฐ€ ๋‹ซํžŒ๋‹ค. ํ›„์†: docs/bdd-cocode.mdยทdocs/ux-spec-cocode.md ์˜ co-brick ๋ฌธ๊ตฌ ์ž”์—ฌ๋ถ„ ์ •์ •.
  • Source: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•๋‹ต โ€” ๊ฒฐ์ • ์ด์Šˆ #113 (2026-09-10)

๐Ÿ“Œ ํŒŒ๊ธ‰ ๋ฐ˜์˜ ์™„๋ฃŒ (#42, 2026-09-12) โ€” D-037 ์ด ๋‚จ๊ธด ใ€Œํ›„์†ใ€์„ ๋‹ซ์•˜๋‹ค.

ํ•ญ๋ชฉ ์ฒ˜๋ถ„
๊ฒฐ์ • ๋ฒˆํ˜ธ ์ด์Šˆ #42 ๋ณธ๋ฌธ์€ D-024 ๋ฅผ ์˜ˆ์•ฝํ–ˆ์œผ๋‚˜ ๊ทธ ๋ฒˆํ˜ธ๋Š” ใ€Œ๋ธŒ๋žœ์น˜ ํ† ํด๋กœ์ง€ใ€๊ฐ€ ์„ ์ ํ–ˆ๋‹ค(์ผ์ง€๊ฐ€ ๊ทธ ์‚ฌ์ด D-044 ๊นŒ์ง€ ์ž๋ž๋‹ค). ์ด ๊ฒฐ์ •์˜ ์ •๋ณธ ๋ฒˆํ˜ธ๋Š” D-037 ์ด๋ฉฐ, #42 ์˜ ์ธ์ˆ˜ ์กฐ๊ฑด์—์„œ D-024 ๋กœ ์ ํžŒ ์ง€์ ์€ ์ „๋ถ€ D-037 ๋กœ ์ฝ๋Š”๋‹ค. ์ƒˆ ํ•ญ๋ชฉ์„ ์ค‘๋ณต ๋ฐœ๊ธ‰ํ•˜์ง€ ์•Š๋Š”๋‹ค โ€” ๊ฐ™์€ ๊ฒฐ์ •์— ๋ฒˆํ˜ธ๊ฐ€ ๋‘˜์ด๋ฉด ์–ด๋А ์ชฝ์ด ์ •๋ณธ์ธ์ง€ ์•Œ ์ˆ˜ ์—†๋‹ค
prd:301 ๋ฒ”์œ„ ๋ฏธํ™•์ • 1 ๊ฒฝ๊ณ  ๋ธ”๋ก ์ œ๊ฑฐ โ†’ ํ™•์ • ์„œ์ˆ 
prd:550 ์†์„ฑํ‘œ ใ€Œ+ ์ดํ›„ ์ ์šฉ๋œ co-brick ๋ชฉ๋กใ€ ์‚ญ์ œ โ†’ ์ตœ์ดˆ ์Šค์บํด๋”ฉ brick ๋งŒ
prd:665 ๋ฏธ๊ฒฐ ํ‘œ ํ–‰ ์ œ๊ฑฐ
architecture:459 ยง4.6 ๋ง๋ฏธ ใ€Œ๋ฏธ๊ฒฐ์ด๋‹คใ€ โ†’ ํ™•์ • ์„œ์ˆ (์›์ž์„ฑ์€ ์ตœ์ดˆ ์Šค์บํด๋”ฉ ํ•œ ๊ฒฝ๋กœ์—๋งŒ ์ ์šฉ)
architecture:633 ยง9 ๋ฏธ๊ฒฐ 12 ํ–‰ ์ œ๊ฑฐ
bdd ยง3 ์ปค๋ฒ„๋ฆฌ์ง€์˜ ํ•œ๊ณ„ ํ•ญ๋ชฉ 8 ์‹ ์„ค โ€” Must-Not ์ด๋ผ ๋ถ€์žฌ ์ž์ฒด๊ฐ€ ์š”๊ฑด์ด๋ฏ€๋กœ ์‹œ๋‚˜๋ฆฌ์˜ค๋ฅผ ์“ฐ์ง€ ์•Š๋Š”๋‹ค(AC-04ยทAC-21 ๊ณผ ๊ฐ™์€ ์ฒ˜๋ถ„)
breakdown 150ยท355ยท392ยท491 ํŒŒ์ƒ ์–ธ๊ธ‰ 4๊ณณ ํ•ด์†Œ ํ‘œ๊ธฐ
ux-spec ํ™”๋ฉด ์ธ๋ฒคํ† ๋ฆฌ ํ•ด๋‹น ์—†์Œ โ€” ์ œ์™ธ ๊ฒฐ์ •์ด๋ฏ€๋กœ co-brick ์ ์šฉ ์ง„์ž…์  ํ™”๋ฉด์„ ์‹ ์„คํ•˜์ง€ ์•Š๋Š”๋‹ค. ยง10 ์€ ์ด ๊ฒฐ์ •์œผ๋กœ ๋ฐ”๋€Œ์ง€ ์•Š๋Š”๋‹ค(#42 ์ธ์ˆ˜ ์กฐ๊ฑด 6์˜ ์ œ์™ธ ๊ฒฝ๋กœ)
๋ชจํ˜ธ์„ฑ ์žฌํ‰๊ฐ€ ์ด Story ๋Š” ยง4 ์— AC ๋ฅผ ์‹ ์„คํ•˜์ง€ ์•Š๋Š”๋‹ค โ€” AC-24 ๋Š” v3.3.0 ์ด ์ด๋ฏธ ์„ธ์› ๊ณ  #42 ๋Š” ํŒŒ์ƒ ๋ฌธ์„œ ์ •ํ•ฉ๋งŒ ๋งž์ถ˜๋‹ค. ๋”ฐ๋ผ์„œ ์žฌํ‰๊ฐ€๋ฅผ ์ด‰๋ฐœํ•  ยง4 ๊ฐœ์ •์ด ์—†์œผ๋ฉฐ, Specification Gate ์žฌ์ธก์ •์€ ๋ณ„๋„ ๊ฒŒ์ดํŠธ ํšŒ์ฐจ์˜ ๋ชซ์ด๋‹ค(#42 ์ธ์ˆ˜ ์กฐ๊ฑด 7์˜ ใ€ŒํŒ์ • ์ฃผ์ฒด๊ฐ€ ๊ทผ๊ฑฐ ๋ฌธ์„œ์— ์ด๋ฆ„์œผ๋กœ ์ง€์ •๋ผ ์žˆ์ง€ ์•Š์Œใ€์€ ๊ทธ๋Œ€๋กœ ๋‚จ๋Š”๋‹ค โ€” ์ด Story ๊ฐ€ ๊ทธ ์ฃผ์ฒด๋ฅผ ์ง€๋ช…ํ•˜์ง€ ์•Š๋Š”๋‹ค)

D-038: EditSnapshot ์˜ ์ƒ์„ฑยท์‚ญ์ œยท์ด๋ฆ„๋ณ€๊ฒฝ ํ‘œํ˜„ โ€” ๋ถ€์žฌ๊ฐ’ + previous_path ์ฑ„ํƒ (Seed Spec v3.4.0)

  • Date: 2026-09-10 (๊ธฐ๋ก๋งŒ โ€” ๊ฒฐ์ • ์•„๋‹˜)
  • Context: ์ด์Šˆ #28 (spike). base_content_hash/result_content_hash ๊ฐ€ "ํ•ด๋‹น ํŒŒ์ผ ๋‚ด์šฉ์˜ ํ•ด์‹œ"๋กœ๋งŒ ์ •์˜๋ผ ์ƒ์„ฑ(base ๋ฏธ์ •์˜)ยท์‚ญ์ œ(result ๋ฏธ์ •์˜)ยท์ด๋ฆ„๋ณ€๊ฒฝ(๊ฒฝ๋กœ 2๊ฐœ)์„ ํ‘œํ˜„ํ•  ์ˆ˜ ์—†์—ˆ๋‹ค(flow-permutation ยง6.2 I-4 / FP-306ยท307). Design ๊ฒฐ์ •์€ docs/architecture-cocode.md ยง4.7 DD-25 ๋กœ ์„ฐ๋‹ค โ€” ๋‘ ํ•ด์‹œ์— ๋ถ€์žฌ๊ฐ’(โˆ…) ๋„์ž…, previous_path ์‹ ์„ค(์ด๋ฆ„๋ณ€๊ฒฝ = ์Šค๋ƒ…์ƒท 1๊ฑด ยท ๊ฒฝ๋กœ 2๊ฐœ ํˆฌ์˜), ๋ถˆ๋ณ€์‹ 2ยท4 ๋ฅผ ๊ฒฝ๋กœ๋ณ„ ํˆฌ์˜ ์ „์ด์— ์ ์šฉ, ๊ฒŒ์ดํŠธ ๊ฑฐ๋ถ€ ๊ทœ์น™, C-05 ๋ฅผ ํˆฌ์˜ ์ „์ด ๋‹จ์œ„๋กœ ํŒ์ •. Seed Spec ยง3 ๋ฌธ๋ฉด ๋ฐ˜์˜์€ ์˜ค๋„ˆ ํŒ์ • ์‚ฌํ•ญ์ด๋ผ ๊ฐœ์ • ์š”์ฒญ์œผ๋กœ ์˜ฌ๋ฆฐ๋‹ค(ยง4.7 ยซ๊ฐœ์ • ์š”์ฒญยป โ‘ ~โ‘ฃ).
  • Options:
    1. ๊ฐœ์ • ์š”์ฒญ๋Œ€๋กœ ยง3 ์— ๋ถ€์žฌ๊ฐ’ยทprevious_pathยท๋ถˆ๋ณ€์‹ 6ยท7 ์„ ์‹ ์„คํ•˜๊ณ  AC-11 ๋ฌธ๋ฉด์„ ๋ช…ํ™•ํ™” (v3.4.0)
    2. ๋‘ ํ•ด์‹œ์˜ ๊ฐ’ ์ง‘ํ•ฉ์„ ๋ฐ”๊พธ์ง€ ์•Š๊ณ  ์ด๋ฆ„๋ณ€๊ฒฝ์„ ์‚ญ์ œ+์ƒ์„ฑ 2๊ฑด์œผ๋กœ ํ‘œํ˜„ํ•˜๋˜ ๋‘˜์„ ๋–ผ์–ด๋‚ผ ์ˆ˜ ์—†๊ฒŒ ๋ฌถ๋Š” ์†์„ฑ์„ ์‹ ์„ค โ€” ๊ทธ ์‚ฌ์ด ๊ฒฝ๊ณ„๋กœ ๋กค๋ฐฑํ•˜๋ฉด ํŒŒ์ผ์ด ๋‘ ๊ฒฝ๋กœ ๋ชจ๋‘์— ์—†๋Š” ์ƒํƒœ๊ฐ€ ์ƒ๊ธฐ๋ฏ€๋กœ ๋ฌถ์Œ ๊ทœ์น™์ด ์ถ”๊ฐ€๋กœ ํ•„์š”ํ•˜๋‹ค
    3. ์ƒ์„ฑยท์‚ญ์ œยท์ด๋ฆ„๋ณ€๊ฒฝ์„ EditSnapshot ๋Œ€์ƒ์—์„œ ์ œ์™ธ โ€” AC-11 ์ด ์ƒ์„ฑ์„ ์ธ์ •ํ•˜๊ณ  C-02 ๊ฐ€ "EditSnapshot ์—†๋Š” ํŽธ์ง‘ ๊ฒฝ๋กœ๋Š” ์—†๋‹ค"๋ผ ๋ถˆ๊ฐ€
  • Decision: ์˜ต์…˜ 1 ์ฑ„ํƒ โ€” ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ํ™•์ •(2026-09-10). ๊ฐœ์ • ์š”์ฒญ โ‘ ~โ‘ฃ ๋ฅผ ๊ทธ๋Œ€๋กœ docs/seed-spec-cocode.md v3.4.0 ์— ๋ฐ˜์˜ํ–ˆ๋‹ค(ยง3 ๋ถ€์žฌ๊ฐ’ยทprevious_pathยท๋ถˆ๋ณ€์‹ 6ยท7 ยท ยง4 AC-11 ๋ฌธ๋ฉด ยท ยง2 C-05 Rationale ยท ยง6 Evolution Log).
  • Rationale: DD-25 ๊ฐ€ ์ด๋ฏธ ์˜ต์…˜ 1 ์„ ์ „์ œ๋กœ ์„œ ์žˆ์–ด ์žฌ์ž‘์—…์ด ์—†๊ณ , ์ด๋ฆ„๋ณ€๊ฒฝ์ด ์Šค๋ƒ…์ƒท 1๊ฑด์ด๋ผ ์ค‘๊ฐ„ ๊ฒฝ๊ณ„ ๋กค๋ฐฑ์—์„œ ํŒŒ์ผ์ด ๋‘ ๊ฒฝ๋กœ ๋ชจ๋‘์— ์—†๋Š” ์ƒํƒœ๊ฐ€ ์ƒ๊ธฐ์ง€ ์•Š๋Š”๋‹ค. ์˜ต์…˜ 2 ๋Š” ๊ทธ ์œ„ํ—˜์„ ๋ง‰๊ธฐ ์œ„ํ•ด ๋ฌถ์Œ ๊ทœ์น™์„ ์ƒˆ๋กœ ์„ค๊ณ„ํ•ด์•ผ ํ•˜๊ณ  DD-25 ์˜ R3ยทR4ยทR6ยทR7 ์ด ์ „์ œ๋ฅผ ์žƒ๋Š”๋‹ค. ์˜ต์…˜ 3 ์€ AC-11(์ƒ์„ฑ ์ธ์ •)ยทC-02(EditSnapshot ์—†๋Š” ํŽธ์ง‘ ๊ฒฝ๋กœ ์—†์Œ)์™€ ๋ชจ์ˆœ์ด๋ผ ์• ์ดˆ์— ๋ถˆ๊ฐ€๋‹ค.
  • Impact: โœ… ํŒ์ • ์™„๋ฃŒ โ€” ์—”ํ‹ฐํ‹ฐ ๊ฐœ์ •์ด ํ•ด์ œ๋๋‹ค. core ์˜ EditSnapshot ์ด ๋ถ€์žฌ๊ฐ’ยทprevious_pathยทํˆฌ์˜ ์ „์ด๋ฅผ ํ‘œํ˜„ํ•˜๋„๋ก ๊ฐœ์ •ํ•˜๋Š” ๊ฒƒ์ด #23 ์ฐฉ์ˆ˜์˜ ์„ ํ–‰์ด๋ฉฐ ์ด PR ์ด ํ•จ๊ป˜ ์ˆ˜ํ–‰ํ•œ๋‹ค. (ํŒ์ • ์ „ ๊ธฐ๋ก) ํŒ์ • ์ „๊นŒ์ง€ core ์˜ EditSnapshot ์—”ํ‹ฐํ‹ฐ(๋‘ ํ•ด์‹œ์˜ ๋น„์–ด์žˆ์Œ ๊ธˆ์ง€ ๊ฒ€์‚ฌ)๋Š” ๋ฐ”๊พธ์ง€ ์•Š๋Š”๋‹ค. #22(๊ฒŒ์ดํŠธ ์—ฐ์‚ฐ ์–ดํœ˜)ยท#23(๋ ˆ์ฝ”๋“œ prev ํ•„๋“œยทโˆ… ์ธ์ฝ”๋”ฉ)ยท#24(ํˆฌ์˜ ์ „์ด ํ•จ์ˆ˜)ยท#25(โˆ… ๋ชฉํ‘œ = unlink)๋Š” DD-25 ์œ„์— ๊ตฌํ˜„ํ•˜๋˜, ํŒ์ • ์—†์ด #23 ์ด ์ฐฉ์ˆ˜ํ•˜๋ฉด D-036 ์ด์ „์˜ #24 ์™€ ๊ฐ™์€ "๊ตฌํ˜„์ด ์ŠคํŽ™๋ณด๋‹ค ์•ž์„ " ์ƒํƒœ๊ฐ€ ๋‹ค์‹œ ์ƒ๊ธด๋‹ค โ€” #23 ์ฐฉ์ˆ˜ ์ „ ํŒ์ • ํ•„์š”. AC-11 ๋ฌธ๋ฉด ๋ช…ํ™•ํ™”(๊ฐœ์ • ์š”์ฒญ โ‘ข)๊ฐ€ ๊ธฐ๊ฐ๋˜๋ฉด R6(ํ…Œ์ŠคํŠธ ํŒŒ์ผ ์‚ญ์ œยท์ด๋ฆ„๋ณ€๊ฒฝ์˜ ์Šน์ธ ๋Œ€์ƒ ์—ฌ๋ถ€)์ด ๊ทผ๊ฑฐ๋ฅผ ์žƒ๋Š”๋‹ค.
  • Source: #28 (architecture ยง4.7 DD-25 ยซ๊ฐœ์ • ์š”์ฒญยป)

D-039: ๋ณด์กด ์ •์ฑ… ๊ฐ’์˜ ์‚ฐ์ • ๊ทœ์น™ยท์ธก์ • ๊ทœ์•ฝ์„ ํ™•์ • โ€” ๊ฐ’์€ ๊ทœ์น™ยทํ‘œ๋ณธยท์žฌ์‚ฐ์ • ์กฐ๊ฑด 3์š”์†Œ๋กœ๋งŒ ์ •ํ•˜๊ณ (#29 ์˜ ๋ชซ), ๋ณด์กด ๊ธฐ๊ฐ„์€ MVP ๊ฐ’ ์ง‘ํ•ฉ์—์„œ ์ œ์™ธ

  • Date: 2026-09-10
  • Context: ์ด์Šˆ #30(spike). D-035 ๊ฐ€ C-02 ๋ฅผ ๊ฐœ์ •ํ•ด ๋ชจ์ˆœ ์ž์ฒด๋Š” ์‚ฌ๋ผ์กŒ์œผ๋‚˜, ๊ฐ’ 3์ข…(Kยท์ด๋Ÿ‰ ์ƒํ•œยท๋ณด์กด ๊ธฐ๊ฐ„)์„ "๋ฌด์—‡์„ ์žฌ์„œ ์–ด๋–ค ๊ทœ์น™์œผ๋กœ ๋„์ถœํ•˜๋Š”๊ฐ€"๊ฐ€ ์–ด๋””์—๋„ ์—†์—ˆ๋‹ค โ€” docs/architecture-cocode.md ยง4.4 ๋Š” ์ธก์ • ํ•ญ๋ชฉ 4์ข…๋งŒ ์—ด๊ฑฐํ•˜๊ณ  ยง9 ๋ฏธ๊ฒฐ 1 ์€ "Planning, A-06 ๊ณผ ๊ฐ™์€ ํšŒ์ฐจ"๋กœ ์‹œ์ ๋งŒ ์ ์—ˆ๋‹ค. ์‹ค๋ฌผ ํ‘œ๋ณธ(cocode ADE SnapshotStore ๊ฐ€ ๋‚จ๊ธด ์Šค๋ƒ…์ƒท)์€ #22ยท#23 ์ด ๋ฏธ์ฐฉ์ˆ˜๋ผ ์กด์žฌํ•˜์ง€ ์•Š๋Š”๋‹ค. ๋˜ํ•œ ยง4.4 P1~P7 ์–ด๋””์—๋„ ๋ณด์กด ๊ธฐ๊ฐ„์„ ์†Œ๋น„ํ•˜๋Š” ๊ทœ์น™์ด ์—†๋‹ค(grep -n "๊ธฐ๊ฐ„" docs/architecture-cocode.md ํžˆํŠธ 2๊ฑด ์ „๋ถ€ "๊ฐ’ 3๊ฐœ" ๋ฌธ์žฅ๋ฟ โ€” P3 ์€ K, P4ยทP4โ€ฒ๋Š” ์ด๋Ÿ‰ ์ƒํ•œ๋งŒ ์ฝ๋Š”๋‹ค). ๊ฐ’์ด ์žˆ์–ด๋„ ์•„๋ฌด ๊ทœ์น™๋„ ์ฝ์ง€ ์•Š๋Š” ๊ฐ’์€ ๊ฐ’์ด ์•„๋‹ˆ๋‹ค.
  • Options:
    1. ์‚ฐ์ • ๊ทœ์น™(V-1~V-4)๊ณผ ์ธก์ • ๊ทœ์•ฝ์„ ํ™•์ •ํ•˜๊ณ , ์ฐธ์กฐ ์›Œํฌ์ŠคํŽ˜์ด์Šค git ์ด๋ ฅ์„ ํ”„๋ก์‹œ ํ‘œ๋ณธ(R-1 ํ•„๋“œ ๋™๋ฐ˜)์œผ๋กœ ์‚ผ์•„ ๊ทœ์น™์„ ์ ์šฉํ•œ ํ›„๋ณด๊นŒ์ง€๋งŒ ๋‚ด๋˜ ๊ฐ’ ํ™•์ •์€ #29 ์— ๋‚จ๊ธด๋‹ค
    2. ํ”„๋ก์‹œ ์—†์ด ์‹ค๋ฌผ ํ‘œ๋ณธ์ด ์ƒ๊ธธ ๋•Œ๊นŒ์ง€ ๊ฐ’ ์นธ์„ ๋น„์›Œ ๋‘”๋‹ค
    3. ์ง€๊ธˆ ๊ฐ’์„ ํ™•์ •ํ•œ๋‹ค
  • Decision: ์˜ต์…˜ 1 โ€” ๊ทœ์น™ยท๊ทœ์•ฝยทํ›„๋ณด๊นŒ์ง€. ๊ฐ’์€ ์—ฌ๊ธฐ์„œ ํ™•์ •ํ•˜์ง€ ์•Š๋Š”๋‹ค. ๋ณด์กด ๊ธฐ๊ฐ„์€ ์†Œ๋น„ ๊ทœ์น™์ด ์—†์œผ๋ฏ€๋กœ MVP ๊ฐ’ ์ง‘ํ•ฉ์—์„œ ์ œ์™ธ(๊ถŒ๊ณ ์•ˆ A). ๋ฒˆ๋ณต ์กฐ๊ฑด: ์˜ค๋„ˆ ๋˜๋Š” Design ์ด ์‹œ๊ฐ„ ๊ธฐ๋ฐ˜ ์ •๋ฆฌ ์š”๊ตฌ(๋น„๊ณต๊ฐœ ์ฝ”๋“œยท๊ฐœ์ธ์ •๋ณด์˜ ์žฅ๊ธฐ ์ž”์กด ๋“ฑ)๋ฅผ ์„ธ์šฐ๋ฉด ๊ทœ์น™ P8 ์‹ ์„ค์ด ๊ฐ’์— ์„ ํ–‰ํ•˜๋ฉฐ, ๊ทธ๋•Œ ์“ธ ๊ทœ์น™ ๋ฌธ์•ˆ๊ณผ ์ธก์ • ๊ณ„ํš์€ docs/retention-values-cocode.md ยง3 V-3 ์— ๋ฏธ๋ฆฌ ์ ์–ด ๋‘์—ˆ๋‹ค.
  • Rationale: โ‘ข์€ D-013ยทD-015ยทD-020 ์ด ์„ธ ๋ฒˆ ๋ฐ˜๋ณต์„ ๊ฒฝ๊ณ„ํ•œ ํŒจํ„ด ๊ทธ๋Œ€๋กœ๋‹ค(๊ทผ๊ฑฐ ์—†๋Š” ๊ฐ’์„ ์ž ๊ทธ๊ธฐ). โ‘ก๋Š” #29 ์˜ "์„ค์น˜ ์งํ›„ ์–‘์˜ ์œ ํ•œํ•œ ์ถœํ•˜ ๊ธฐ๋ณธ๊ฐ’" AC ๊ฐ€ ์‹ค๋ฌผ ํ‘œ๋ณธ ์ „์—๋Š” ์˜์›ํžˆ ์—ด๋ฆฌ์ง€ ์•Š๋Š”๋‹ค โ€” D-033 ์ด ์‹œ๊ฐ„ ์ƒํ•œ์— ๋Œ€ํ•ด ๊ฐ™์€ ์ด์œ ๋กœ ์ž ์ •๊ฐ’์„ ํƒํ–ˆ๋‹ค. โ‘ ์€ D-033 ์„ ๋ก€๋ฅผ ๊ทธ๋Œ€๋กœ ๋”ฐ๋ฅธ๋‹ค: โ“ ์ถœ์ฒ˜ ์žˆ๋Š” ํ‘œ๋ณธ์—์„œ ๊ทœ์น™(job-timeout-budget B-1ยทB-3 ์ค€์šฉ)์œผ๋กœ ๋„์ถœํ•˜๊ณ  โ“‘ ๊ฐ’์ด ์‚ฌ๋Š” ์ž๋ฆฌ๋Š” ๋ถˆ๋ณ€ ์ธต์œ„(ยง2ยทยง4)๊ฐ€ ์•„๋‹ˆ๋ผ ์กฐ์ • ๊ฐ€๋Šฅํ•œ Planning ์ธต์œ„(planning-inputs ยง7)์ด๋ฉฐ โ“’ ์‹ค๋ฌผ ํ‘œ๋ณธ์ด ์ƒ๊ธฐ๋ฉด ๊ฐ™์€ ๊ทœ์น™์œผ๋กœ ์žฌ์‚ฐ์ •ํ•œ๋‹ค. ํ”„๋ก์‹œ(์ฐธ์กฐ ์›Œํฌ์ŠคํŽ˜์ด์Šค coco-de/unibook @ 9db9015, first-parent ์ปค๋ฐ‹ = 1 ์ž‘์—…)๋Š” ์šฐ๋ฆฌ ์ €์žฅ ์„ค๊ณ„(content-addressed gzip blob + dedup, DD-10)์™€ ๊ตฌ์กฐ๊ฐ€ ๊ฐ™์•„ ๋ฐ”์ดํŠธ ๋‹จ์œ„๊ฐ€ ๋งž๊ณ , ๊ทธ ์ปค๋ฐ‹์˜ ๋‹ค์ˆ˜๊ฐ€ ์‹ค์ œ๋กœ ์—์ด์ „ํŠธ(cc-dev)๊ฐ€ ๋งŒ๋“  PR ์ด๋ผ ์„ฑ๊ฒฉ๋„ ๊ฐ€๊น๋‹ค. ๋‹ค๋งŒ ์ปค๋ฐ‹์€ ๊ฐ™์€ ํŒŒ์ผ์˜ ์ค‘๊ฐ„ ์“ฐ๊ธฐ๋ฅผ ์ ‘๊ณ  ์žฌ์‹œ๋„ ๋ˆ„์ (D-030)์„ ๋‹ด์ง€ ์•Š์œผ๋ฏ€๋กœ ํ•˜ํ•œ์ด๋ฉฐ, ๊ทธ๋ž˜์„œ ํ›„๋ณด์—๋Š” B-1 ์˜ ร—2 ๋ฅผ ๊ทธ๋Œ€๋กœ ๊ฑด๋‹ค. ๋ณด์กด ๊ธฐ๊ฐ„์„ ๋นผ๋Š” ์ด์œ : ์ด๋Ÿ‰ ์ƒํ•œ์ด ๋ณผ๋ฅจ์„ ์ด๋ฏธ ์œ ๊ณ„๋กœ ๋งŒ๋“ค๊ณ , ์‹œ๊ฐ„๋งŒ์œผ๋กœ ์ง€์šฐ๋Š” ๊ทœ์น™์€ ๋””์Šคํฌ ์ด๋“ ์—†์ด ๋กค๋ฐฑ ์ง€์ ๋งŒ ์ค„์ด๋ฏ€๋กœ C-02 ์ชฝ์—์„œ ์•ˆ์ „์ธก์ด ์•„๋‹ˆ๋‹ค(B-3 โ€” ๋ณด์กด์€ ๊ณผ๋Œ€ ์ชฝ์ด ์•ˆ์ „์ธก). "์‚ฌ์šฉ์ž๊ฐ€ ์–ผ๋งˆ๋‚˜ ์˜ค๋ž˜๋œ ์ž‘์—…์„ ๋˜๋Œ๋ฆฌ๋Š”๊ฐ€"์˜ ํ‘œ๋ณธ์€ ์‹ค๋ฌผ ์‚ฌ์šฉ ์™ธ์—๋Š” ์—†๊ณ , git ์ด๋ ฅ์˜ revert ๋Š” ์„ฑ๊ฒฉ์ด ๋‹ฌ๋ผ ๋Œ€์ฒด๊ฐ€ ์•ˆ ๋œ๋‹ค(๊ฐ™์€ ๋ฌธ์„œ ยง5.8 โ€” ํ‘œ๋ณธ 5๊ฑด, ํŒ์ • ๋ถˆ๊ฐ€๋กœ ๊ธฐ๋ก).
  • Impact: docs/retention-values-cocode.md ์‹ ์„ค(๊ทœ์น™ V-1~V-4 ยท ์ธก์ • ๊ทœ์•ฝ M-1~M-6 ยท R-1 ํ”„๋ก์‹œ ์‹ค์ธก ยท ํ›„๋ณด ยท #29 ์ธ๊ณ„). docs/planning-inputs-cocode.md ยง6 ํ–‰ ๊ฐฑ์‹ (๊ฐ’์€ #29 ๊ฐ€ ยง7.2 ๋กœ ์˜ฎ๊ฒจ ์ ์„ ๋•Œ ํ™•์ •). docs/architecture-cocode.md ยง4.4 ํฌ์ธํ„ฐยทยง9 ๋ฏธ๊ฒฐ 1 ๊ฐฑ์‹ . #29 ์ฐฉ์ˆ˜ ์กฐ๊ฑด โ“ ์ถฉ์กฑ(#30 ์€ "๊ฐ’์„ ์ •ํ•˜๋Š” ๋ถ„๊ธฐ"๋ฅผ ํƒํ–ˆ๋‹ค โ€” ์ •ํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ํ™•์ •ํ–ˆ๊ณ  ๊ฐ’์˜ ๊ธฐ๋ก์€ #29). #29 ์˜ "๊ฐ’ 3์ข…" AC ๋Š” "๊ทœ์น™์ด ์†Œ๋น„ํ•˜๋Š” ๊ฐ’ ์ „๋ถ€(Kยท์ด๋Ÿ‰ ์ƒํ•œ) + ์˜ˆ์•ฝ ํ‚ค" ๋กœ ์ฝ๋Š”๋‹ค. #32(P4 ์‚ญ์ œ ๋Œ€์ƒ ํŒ์ •)์™€๋Š” ๋…๋ฆฝ. ๊ณ„์ˆ˜ ๊ทœ์น™(๋ฌด์—‡์„ ์„ธ๋Š”๊ฐ€ โ€” flow-permutation ยง8 R-3 ์˜ ์š”๊ตฌ)์€ history/objects/** ์••์ถ• ๋ฐ”์ดํŠธ ํ•ฉ์œผ๋กœ ์ œ์•ˆํ•˜๊ณ  ์ฑ„ํƒ์€ #29(Design).
  • Source: #30 spike ์„ธ์…˜ ยท ์ฐธ์กฐ ์›Œํฌ์ŠคํŽ˜์ด์Šค ์‹ค์ธก(scripts/spike/measure_retention_proxy.py, R-1 ํ•„๋“œ ๋™๋ฐ˜) ยท D-033 ์„ ๋ก€ ยท job-timeout-budget B-1~B-4

D-040: Windows ๋กค๋ฐฑ ์น˜ํ™˜์€ Dart File.rename ๊ทธ๋Œ€๋กœ โ€” FFI ๋ฏธ์ฑ„ํƒ, ReplaceFileW ์ฑ„ํƒ ๋ถˆ๊ฐ€

  • Date: 2026-09-10
  • Context: ์ด์Šˆ #27(spike, Epic #21). architecture ยง4.3 5๋‹จ๊ณ„๊ฐ€ Windows ์น˜ํ™˜ API ๋ฅผ "ReplaceFileW/MoveFileExW ๊ณ„์—ด์„ ์“ฐ๋˜ Dart File.rename ์ด ๊ทธ ์˜๋ฏธ๋ฅผ ๋ณด์žฅํ•˜๋Š”์ง€ยทํ•ธ๋“ค ์ ์œ  ์‹œ ๋™์ž‘์€ ํ™•์ธ ํ•„์š”"(ยง9 ๋ฏธ๊ฒฐ 3)๋กœ ๋‚จ๊ฒจ ๋‘์–ด, #25(์ €๋„ 2๋‹จ๊ณ„ ์ปค๋ฐ‹)๊ฐ€ ์น˜ํ™˜ ์›์‹œ ์—ฐ์‚ฐ์„ ์ •ํ•  ์ˆ˜ ์—†์—ˆ๋‹ค. ๊ฐœ๋ฐœ ๋จธ์‹ ์ด ์ „๋ถ€ macOS ๋ผ ๋กœ์ปฌ ์‹ค์ธก์ด ๋ถˆ๊ฐ€๋Šฅํ–ˆ๋‹ค.
  • Options: โ‘ Dart File.rename ๊ทธ๋Œ€๋กœ โ‘กMoveFileExW ๋ฅผ FFI ๋กœ ์ง์ ‘ ํ˜ธ์ถœ โ‘ขReplaceFileW FFI โ‘ฃSetFileInformationByHandle(FileRenameInfoEx, REPLACE_IF_EXISTS|POSIX_SEMANTICS) FFI
  • Decision: ์˜ต์…˜ โ‘  โ€” File.rename ๊ทธ๋Œ€๋กœ, โ‘ฃ๋Š” ์กฐ๊ฑด๋ถ€ ์˜ต์…˜์œผ๋กœ๋งŒ ๊ธฐ๋ก(docs/windows-atomic-replace-cocode.md W-6), โ‘กโ‘ข์€ ๋ถˆ์ฑ„ํƒ.
  • Rationale: ์ถ”์ธก์ด ์•„๋‹ˆ๋ผ windows-2022 ๋Ÿฌ๋„ˆ ์‹ค์ธก 2ํšŒ(run 34460374634 ยท 34461196523, Windows Server 2022 build 20348 ยท NTFS ยท Dart 3.13.0)๋‹ค. โ“ SDK ์†Œ์Šค(3.13.0 runtime/bin/file_win.cc 799ยท813ํ–‰)๊ฐ€ File.rename = MoveFileExW(REPLACE_EXISTING|WRITE_THROUGH) ์ž„์„ ๋ณด์ด๊ณ , ์‹ค์ธก 76์…€์—์„œ FFI MoveFileExW ์™€ ๊ฒฐ๊ณผยท์ฝ”๋“œ๊ฐ€ ์ „๋ถ€ ๊ฐ™์•˜๋‹ค โ†’ โ‘ก๋Š” ์ด๋“ 0. โ“‘ rename ๊ณ„์—ด์€ ๋‘ ์‹คํ–‰ 13,056ํšŒ ๋™์‹œ ์ฝ๊ธฐ์—์„œ ๋นˆ/๋ถ€๋ถ„/ํ˜ผํ•ฉ ๋‚ด์šฉ 0๊ฑด(์ด๋ฆ„ ๊ณต๊ฐ„ ์›์ž์„ฑ), ReplaceFileW ๋Š” 13,952ํšŒ ์ค‘ 1,328ํšŒ(9.5%) ๋Œ€์ƒ ์ด๋ฆ„์ด ์—†๋Š” ์ฐฝ์„ ๋…ธ์ถœํ•˜๊ณ  ์ง€์—ฐ์ด 4~5๋ฐฐ์ด๋ฉฐ ๋Œ€์ƒ ๋ถ€์žฌ ์‹œ ์‹คํŒจ โ†’ โ‘ข์€ AC-02 ์˜ "์›์ž์ "์„ ๊นจ๋œจ๋ฆฐ๋‹ค. โ“’ โ‘ฃ๊ฐ€ File.rename ์„ ์ด๊ธฐ๋Š” ์…€์€ ํ™€๋”๊ฐ€ FILE_SHARE_DELETE ๋ฅผ ์ค€ ๊ฒฝ์šฐ๋ฟ์ด๊ณ , Dart ์ž์‹ ์˜ File.open ํ•ธ๋“คยทCRT _wopen ๊ณ„์—ดยทPowerShell ๊ธฐ๋ณธ FileShare.Read ์•ž์—์„œ๋Š” ๋˜‘๊ฐ™์ด ์‹คํŒจํ•˜๋ฉฐ OS ํ•˜ํ•œ(Windows 10 1607 / Server 2016)์ด ์ถ”๊ฐ€๋œ๋‹ค โ†’ ์ด๋“์ด ์šฐ๋ฆฌ ์ฝ”๋“œ๊ฐ€ ์•„๋‹ˆ๋ผ ํ™€๋”์˜ ๊ณต์œ  ๋ชจ๋“œ์— ๋‹ฌ๋ ค ์žˆ์œผ๋ฏ€๋กœ MVP ์— ๋„ฃ์ง€ ์•Š๋Š”๋‹ค. D-013ยทD-015ยทD-020 ์ด ๊ฒฝ๊ณ„ํ•œ ํŒจํ„ด๊ณผ ๊ตฌ๋ถ„๋˜๋Š” ์ง€์ : ๊ฐ’(์žฌ์‹œ๋„ ํšŸ์ˆ˜ยท๊ฐ„๊ฒฉ)์€ ์ •ํ•˜์ง€ ์•Š์•˜๊ณ  ์‹ค์ธก ๊ทผ๊ฑฐ๊ฐ€ ์ƒ๊ธธ ์ž๋ฆฌ(#25 ํŒŒ๋ผ๋ฏธํ„ฐ + ํ…”๋ ˆ๋ฉ”ํŠธ๋ฆฌ)๋งŒ ์ง€์ •ํ–ˆ๋‹ค.
  • Impact: architecture ยง4.3 5๋‹จ๊ณ„ ๋ฌธ๊ตฌ ๊ต์ฒด + ยง9 ๋ฏธ๊ฒฐ 3 ํ•ด์†Œ. #25 ๋Š” ๊ณ„์•ฝ W-1~W-7(๊ฐ™์€ ๋ณผ๋ฅจ ์ž„์‹œ ํŒŒ์ผ ยท ์น˜ํ™˜ ์ง์ „ ์ž๊ธฐ Dart ํ•ธ๋“ค 0๊ฐœ ยท 5/32 ๋Š” ์ผ์‹œ ์ ์œ ๋กœ ์žฌ์‹œ๋„ ํ›„ ์ถฉ๋Œ ์ œ์‹œ, ๋‹จ 5 ๋Š” ์ฝ๊ธฐ ์ „์šฉยท๋””๋ ‰ํ„ฐ๋ฆฌ๋ฅผ ๋จผ์ € ๊ฑธ๋Ÿฌ๋‚ธ๋‹ค ยท ์ฝ๊ธฐ ๊ฒฝ๋กœ 32 ์žฌ์‹œ๋„ ยท ReplaceFileW ๊ธˆ์ง€ ยท ์ถ”๊ฐ€ fsync ์—†์Œ)์„ ๊ตฌํ˜„ํ•œ๋‹ค. ์‹ค์ธก ํ•˜๋„ค์Šค(.github/workflows/probe.windows-atomic-replace.yaml)๋Š” ์žฌํ˜„์šฉ์œผ๋กœ ๋‚จ๊ธด๋‹ค. ๋ฏธํ™•์ • ํ•ญ๋ชฉ 10๊ฑด์€ ๊ทธ ๋ฌธ์„œ ยง5.

D-041: ๊ฒ€์ฆ ์›๋ฌธ ๋น„์˜์†(DD-23b)์˜ ๋ณด์•ˆ ํŒ๋‹จ์„ ์œ ์ง€ยท๋ฒˆ๋ณตํ•  ํŒ์ • ์ฃผ์ฒด โ€” ๊ฒฐ์ • ๋Œ€๊ธฐ (ํŒ์ • ์ฃผ์ฒด์˜ ํ™•์ •์€ ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ)

  • Date: 2026-09-10 (๊ธฐ๋ก๋งŒ โ€” ๊ฒฐ์ • ์•„๋‹˜)
  • Context: ์ด์Šˆ #32 (spike). DD-23b(architecture ยง7.1)๋Š” verification_log ์— ์›๋ฌธ์„ ๋‹ด์ง€ ์•Š๊ณ  ์‚ฌ๋žŒ์ด ๋ณผ ์›๋ฌธ์€ "UI ์„ธ์…˜ ๋ฒ„ํผ"์—๋งŒ ๋‘”๋‹ค๊ณ  ์ •ํ–ˆ์œผ๋‚˜, ๊ทธ ๋ฒ„ํผ์˜ ์ •์˜์™€ ์ข…๊ฒฐ๋œ ์ž‘์—…์˜ ์›๋ฌธ ์‚ฌํ›„ ์กฐํšŒ ๊ฐ€๋Šฅ ์—ฌ๋ถ€๊ฐ€ ๋น„์–ด ์žˆ์—ˆ๋‹ค. Design ๊ฒฐ์ •์€ architecture ยง7.1 DD-23c ๋กœ ์„ฐ๋‹ค โ€” โ‘  ์„ธ์…˜ ๋ฒ„ํผ = toolchain ํ”„๋กœ์„ธ์Šค ๋ฉ”๋ชจ๋ฆฌ(์›Œํฌ์ŠคํŽ˜์ด์Šค ๋‹จ์œ„, ๋‹ซํž˜ยทํ”„๋กœ์„ธ์Šค ์ข…๋ฃŒ์—์„œ๋งŒ ์†Œ๋ฉธ, ์ƒํ•œ ์ดˆ๊ณผ ์‹œ "์ข…๊ฒฐ ์ž‘์—… โ†’ ์˜ค๋ž˜๋œ ํšŒ์ฐจ โ†’ ์ŠคํŠธ๋ฆผ ์•ž๋ถ€๋ถ„" ์ˆœ ์ •๋ฆฌ) โ‘ก ์ข…๊ฒฐ ์ž‘์—…์˜ ์›๋ฌธ ์‚ฌํ›„ ์กฐํšŒ ๋ถˆ๊ฐ€ ํ™•์ •(์˜์† ๊ฒฝ๋กœ ์‹ ์„ค ์—†์Œ โ€” DD-23b ์œ ์ถœ ํ‘œ๋ฉด ๋…ผ๊ฑฐ + ux-spec P1 ์€ ์žฌํ˜„์œผ๋กœ ์ถฉ์กฑ) โ‘ข verification_log ํšŒ์ฐจ๋ณ„ ๋ˆ„์ (attempt_no, DD-21a ๋Š” ํ˜„์žฌ ํšŒ์ฐจ๋งŒ ๋ณธ๋‹ค) โ‘ฃ P4 ์‚ญ์ œ ๋‹จ์œ„์— ์ž‘์—… ๋ ˆ์ฝ”๋“œยทverification_log ๋ถˆํฌํ•จ. ๊ทธ๋Ÿฐ๋ฐ โ‘ก ๊ฐ€ ๊ธฐ๋Œ€๋Š” "์›๋ฌธ์„ ์–ด๋–ค ํ˜•ํƒœ๋กœ๋„ ์˜์†ํ•˜์ง€ ์•Š๋Š”๋‹ค"๋Š” ๋ณด์•ˆ ํŒ๋‹จ์„ Design ๋‹จ๋…์œผ๋กœ ์œ ์ง€ยท๋ฒˆ๋ณตํ•  ์ˆ˜ ์žˆ๋Š”์ง€, ์˜ค๋„ˆ ํ™•๋‹ต ์‚ฌํ•ญ์ธ์ง€๊ฐ€ ์–ด๋””์—๋„ ์ •ํ•ด์ ธ ์žˆ์ง€ ์•Š๋‹ค(#32 AC 8). ๊ถŒํ•œ ๋ฐฐ๋ถ„ ์ž์ฒด๋Š” ์˜ค๋„ˆ๋งŒ ํ•  ์ˆ˜ ์žˆ์œผ๋ฏ€๋กœ ์ด ํ•ญ๋ชฉ์„ ์˜ค๋„ˆ์—๊ฒŒ ์˜ฌ๋ฆฐ๋‹ค.
  • Options:
    1. Design ๋‹จ๋… ๊ถŒํ•œ โ€” DD-23bยท23c ๋ฅผ Design ๊ฒฐ์ •์œผ๋กœ ํ™•์ •ํ•˜๊ณ , ๋ฒˆ๋ณต๋„ Design ์ด architecture ๊ฐœ์ •์œผ๋กœ ํ•œ๋‹ค
    2. ์˜ค๋„ˆ ํ™•๋‹ต ์‚ฌํ•ญ โ€” ์›๋ฌธ ์˜์† ์—ฌ๋ถ€๋Š” ๋ณด์•ˆ ์ •์ฑ…์ด๋ฏ€๋กœ ์˜ค๋„ˆ๊ฐ€ ์ผ์ง€ ํ•ญ๋ชฉ์œผ๋กœ ํ™•์ •ํ•˜๊ณ , Design ์€ ๊ทธ ์•ˆ์—์„œ ํ‘œํ˜„๋งŒ ์ •ํ•œ๋‹ค
    3. ํŒ์ • ์ฃผ์ฒด๋ฅผ ์ •ํ•˜์ง€ ์•Š๊ณ  ๋‘”๋‹ค โ€” DD-23c โ‘ก ๊ฐ€ "๋ฏธ์ • ์‹œ ๋™์ž‘"์œผ๋กœ ๊ณ„์† ์ ์šฉ๋œ๋‹ค
  • Decision: ๋ฏธ์ • โ€” ๊ฒฐ์ • ํ•„์š”(ํŒ์ • ์ฃผ์ฒด: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ โ€” "๋ˆ„๊ฐ€ ์ •ํ•˜๋Š”๊ฐ€"๋ฅผ ์ •ํ•˜๋Š” ๊ฒƒ์€ ์˜ค๋„ˆ์˜ ๋ชซ์ด๋‹ค). ํŒ์ • ์ „๊นŒ์ง€ DD-23bยทDD-23c โ‘ก ๊ฐ€ ๊ทธ๋Œ€๋กœ ์ ์šฉ๋œ๋‹ค(์ฐจ๋‹จ ๋ฐฉํ–ฅ โ€” ์˜์†ํ•˜์ง€ ์•Š๋Š” ์ชฝ์ด ์œ ์ถœ ํ‘œ๋ฉด์ด ์ž‘๋‹ค).
  • Impact: ํŒ์ • ์ „ #63(์Šคํ‚ค๋งˆยท์‹คํ–‰๊ธฐ)ยท#86(ํŒจ๋„)์€ DD-23c ์œ„์— ๊ตฌํ˜„ํ•œ๋‹ค โ€” ์›๋ฌธ ๋น„์˜์†์€ ๊ตฌํ˜„ ๋ถ€๋‹ด์ด ์•„๋‹ˆ๋ผ ๋ถ€๋‹ด์˜ ๋ถ€์žฌ์ด๋ฏ€๋กœ ํŒ์ •์ด ๋Šฆ์–ด๋„ ์žฌ์ž‘์—…์ด ์ƒ๊ธฐ์ง€ ์•Š๋Š”๋‹ค. ์˜ต์…˜ 2 ๋กœ ๊ฐ€์„œ ์˜ค๋„ˆ๊ฐ€ "์˜์†"์„ ํƒํ•˜๋ฉด DD-23c โ‘กยทโ‘ฃ ์™€ ux-spec ยง3.4ยทยง4.4ยทยง5.2 ๊ณ ์ง€ ๋ฌธ๊ตฌ, bdd Feature 4 ์˜ ๋น„์˜์† ์‹œ๋‚˜๋ฆฌ์˜ค๊ฐ€ ์žฌ๊ฒ€ํ†  ๋Œ€์ƒ์ด๊ณ  โ‘ ยทโ‘ข ์€ ์˜ํ–ฅ๋ฐ›์ง€ ์•Š๋Š”๋‹ค. ์„ธ์…˜ ๋ฒ„ํผ ์ด๋Ÿ‰ ์ƒํ•œ์˜ ๊ฐ’์€ ๋ณ„๊ฑด(architecture ยง9 ๋ฏธ๊ฒฐ 20 โ€” Design, ์‹ค์ธก).
  • Source: #32 spike ์„ธ์…˜ ยท architecture ยง7.1 DD-23c ยท ยง9 ๋ฏธ๊ฒฐ 20ยท21 ยท ยง10-18ยท19
  • โš ๏ธ ๋ฒˆํ˜ธ: ๊ฐ™์€ ๋‚  epic/21 ์— #30(D-039)ยท#27(D-040)์ด ๋ณ‘๋ ฌ๋กœ ์ฐฉ์ง€ํ•ด, ์ด ํ•ญ๋ชฉ์€ ๊ทธ ๋‘˜์„ ํ™•์ธํ•œ ๋’ค D-041 ๋กœ ์ ์—ˆ๋‹ค(architecture ยง10-11 โ€” "์ผ์ง€์˜ ๋งˆ์ง€๋ง‰ ๋ฒˆํ˜ธ๋ฅผ ๋งค๋ฒˆ ์žฌํ™•์ธ"์˜ ์‹ค์‚ฌ๋ก€ โ€” #30 ์˜ PR ์€ ์ฒ˜์Œ D-038 ๋กœ ์˜ฌ๋ผ์™€ ๋จธ์ง€ ์‹œ ์žฌ๋ฒˆํ˜ธ๋๋‹ค).

D-042: ํŠน์ • ์Šค๋ƒ…์ƒท ๋กค๋ฐฑ์—์„œ ์„ ํƒํ•œ ์Šค๋ƒ…์ƒท ์ž์‹ ์˜ ํฌํ•จ ์—ฌ๋ถ€ โ€” ๊ฒฐ์ • ๋Œ€๊ธฐ (ํŒ์ • ์ฃผ์ฒด: ๋ฏธ์ • ยท owner #89)

  • Date: 2026-09-10 (๊ธฐ๋ก๋งŒ โ€” ๊ฒฐ์ • ์•„๋‹˜)
  • Context: ์ด์Šˆ #24(๋กค๋ฐฑ ๋Œ€์ƒ ์‚ฐ์ถœ ์ˆœ์ˆ˜ ํ•จ์ˆ˜) ๊ตฌํ˜„ ์ค‘ ๋ฐœ๊ฒฌ. ใ€ŒํŠน์ • ์Šค๋ƒ…์ƒท์œผ๋กœ ๋กค๋ฐฑใ€์˜ ๋Œ€์ƒ ์ง‘ํ•ฉ์— ์„ ํƒํ•œ ์Šค๋ƒ…์ƒท ์ž์‹ ์ด ๋“ค์–ด๊ฐ€๋Š”์ง€๋ฅผ ๋‘๊ณ  ๋ฌธ์„œ๊ฐ€ ์ •๋ฉด์œผ๋กœ ๊ฐˆ๋ฆฐ๋‹ค:
    • ์ œ์™ธ โ€” docs/seed-spec-cocode.md ๋ถˆ๋ณ€์‹ 3 ใ€Œ๊ทธ ์ดํ›„ ์ƒ์„ฑ๋œใ€ ยท docs/bdd-cocode.md:151(seq 1 ์„ ํƒ โ†’ 2ยท3 ๋˜๋Œ๋ฆผ)
    • ํฌํ•จ โ€” docs/flow-permutation-cocode.md:129 ยท docs/ux-spec-cocode.md ยง4.2 ์™€์ด์–ดํ”„๋ ˆ์ž„(seq 1 ์„ ํƒ โ†’ 4๊ฑด)
  • Options:
    1. seed-spec ๋ฌธ๋ฉด๋Œ€๋กœ ์ œ์™ธ โ€” bdd ์™€ ์ผ์น˜. flow-permutationยทux-spec ์™€์ด์–ดํ”„๋ ˆ์ž„์„ ์ •์ •ํ•ด์•ผ ํ•œ๋‹ค
    2. ํฌํ•จ โ€” ์™€์ด์–ดํ”„๋ ˆ์ž„๊ณผ ์ผ์น˜ํ•˜๊ณ  ์‚ฌ์šฉ์ž๊ฐ€ ใ€Œ์ด ์Šค๋ƒ…์ƒท์œผ๋กœ ๋˜๋Œ๋ฆฐ๋‹คใ€๋ฅผ ์ง๊ด€์ ์œผ๋กœ ์ฝ๋Š” ๋ฐฉ์‹์ผ ์ˆ˜ ์žˆ๋‹ค. seed-spec ๋ถˆ๋ณ€์‹ 3 ๋ฌธ๋ฉด ๊ฐœ์ •์ด ๋”ฐ๋ฅธ๋‹ค
    3. ์งˆ์˜๋ฅผ ๋‘˜๋กœ ๋‚˜๋ˆˆ๋‹ค(ใ€Œ์ด ์Šค๋ƒ…์ƒท ์ดํ›„ใ€/ใ€Œ์ด ์Šค๋ƒ…์ƒท ํฌํ•จใ€) โ€” ํ‘œํ˜„๋ ฅ์€ ๋Š˜์ง€๋งŒ UI ์„ ํƒ์ง€๊ฐ€ ํ•˜๋‚˜ ๋” ์ƒ๊ธด๋‹ค
  • Decision: ๋ฏธ์ • โ€” ๊ฒฐ์ • ํ•„์š”. #24 ์˜ ๊ตฌํ˜„์€ seed-spec ๋ฌธ๋ฉด์„ ๋ฌธ์ž ๊ทธ๋Œ€๋กœ ์ฝ์–ด sequenceNo ๊ฐ€ ์„ ํƒํ•œ ๊ฒƒ๋ณด๋‹ค ํฐ ์Šค๋ƒ…์ƒท๋งŒ ๋Œ€์ƒ์œผ๋กœ ์‚ผ๋Š”๋‹ค(์˜ต์…˜ 1 ์ž ์ •).
  • Impact: ๋‘ ํ•ด์„์ด ใ€Œ์ž๊ธฐ ํ•˜๋‚˜ vs ์•„๋ฌด๊ฒƒ๋„ ์•„๋‹˜ใ€์œผ๋กœ ์ •๋ฉด ์ถฉ๋Œํ•˜๋Š” ์œ ์ผํ•œ ์ง€์ ์€ ์ตœ๋Œ€ sequenceNo ์งˆ์˜๋‹ค โ€” ๊ฑฐ๊ธฐ์„œ๋Š” ์˜ต์…˜ 1 ์ด๋ฉด ๋Œ€์ƒ 0๊ฑด, ์˜ต์…˜ 2 ๋ฉด 1๊ฑด์ด๋ผ ยซ๋˜๋Œ๋ฆด ๊ฒŒ ์—†๋‹คยป์™€ ยซํ•˜๋‚˜ ๋˜๋Œ๋ฆฐ๋‹คยป๊ฐ€ ๊ฐˆ๋ฆฐ๋‹ค. ๊ทธ๋ž˜์„œ #24 ๋Š” ๊ทธ ์งˆ์˜๋ฅผ ๊ฑฐ๋ถ€ํ•œ๋‹ค(RollbackRejected, owner: '#89'). ๋‚˜๋จธ์ง€ ์งˆ์˜๋Š” ๋‘ ํ•ด์„์˜ ์ฐจ์ด๊ฐ€ ยซ์ž๊ธฐ ํฌํ•จ ์—ฌ๋ถ€ยป ํ•œ ๊ฑด๋ฟ์ด๋ผ ๊ตฌํ˜„์ด ์–‘์ชฝ ๋ชจ๋‘์—์„œ ๋™์ž‘ํ•œ๋‹ค. ํ™•์ •๋˜๋ฉด RollbackTargets ์˜ ๋น„๊ต ํ•œ ๊ณณ๊ณผ ๊ทธ ๊ฑฐ๋ถ€ ๋ถ„๊ธฐ๋งŒ ๋ฐ”๋€๋‹ค. โš ๏ธ #89(๊ฒฝ๊ณ„ ์ž…๋ ฅยท๋นˆ ์ƒํƒœ ๋™์ž‘ ์ •์˜)๊ฐ€ ใ€ŒํŠน์ • ์Šค๋ƒ…์ƒท์œผ๋กœ ๋กค๋ฐฑ์ด ์„ ํƒํ•œ ์Šค๋ƒ…์ƒท ์ž์‹ ์„ ๋˜๋Œ๋ฆฌ๋Š”์ง€ใ€๋ฅผ ๊ฐ™์€ ๊ณ„์—ด์˜ ๋ฏธ์ •์œผ๋กœ ์ด๋ฏธ ๋‹ฌ๊ณ  ์žˆ๊ณ  ใ€Œseed-spec:104 ๋ฌธ๋ฉด ๊ฐœ์ •์ด ํ•„์š”ํ•˜๋ฉด ์˜ค๋„ˆ ํŒ๋‹จ์ด ๊ฑธ๋ฆฐ๋‹คใ€๊ณ  ์ ๋Š”๋‹ค โ€” ๊ทธ๋ž˜์„œ owner ๋ฅผ #89 ๋กœ ์ ์—ˆ๋‹ค.
  • Source: #24 (package/core/lib/src/domain/rollback_targets.dart โ€” SnapshotRollback ๋ฌธ์„œ ์ฃผ์„)

D-043: ์“ฐ๊ธฐ ์ปค๋ฐ‹ ํ”„๋กœํ† ์ฝœ์˜ ํฌ๋ž˜์‹œ ์ฐฝ ์ˆ˜๋ ด ๋ฐฉํ–ฅ โ€” ์ €๋„๋กœ ํ™•์ •(โ“‘), ๋˜๋Œ๋ฆผ(โ“) ์—†์Œ ยท ๋ฏธํ•ด๊ฒฐ์€ ๋ณด๊ณ  โ€” ์˜ค๋„ˆ ํ™•์ธ ๋Œ€๊ธฐ (#31)

  • Date: 2026-09-11
  • Context: #31 AC 7 ์€ ใ€ŒํŒŒ์ผ์€ ๋ฐ”๋€Œ์—ˆ๊ณ  ๋ ˆ์ฝ”๋“œ๋Š” ์—†๋Š” ์ƒํƒœ๋กœ ๋ณต๊ตฌ๊ฐ€ ์ง„์ž…ํ–ˆ์„ ๋•Œ โ“ ํŒŒ์ผ์„ base ๋กœ ๋˜๋Œ๋ฆฐ๋‹ค / โ“‘ ํ˜„์žฌ ๋‚ด์šฉ์œผ๋กœ ์‚ฌํ›„ EditSnapshot ์„ ํ•ฉ์„ฑํ•œ๋‹คใ€๋ฅผ ๋ฏธ์ • โ€” ๊ฒฐ์ • ํ•„์š”(ํŒ์ • ์ฃผ์ฒด Design)๋กœ ๋‚จ๊ฒผ๋‹ค. C-02ยท๋ถˆ๋ณ€์‹ 1 ์€ ๊ฒฐ๊ณผ ์ƒํƒœ๋งŒ ์š”๊ตฌํ•˜๊ณ  ์ˆ˜๋ ด ๋ฐฉํ–ฅ์„ ๊ทœ์ •ํ•˜์ง€ ์•Š๋Š”๋‹ค.
  • Options: โ“ base ๋กœ ๋˜๋Œ๋ฆผ (์—์ด์ „ํŠธ ํŽธ์ง‘ ์œ ์‹ค, ๋ ˆ์ฝ”๋“œ ์—†์Œ) ยท โ“‘ ์‚ฌํ›„ ์Šค๋ƒ…์ƒท ํ•ฉ์„ฑ (๋‚ด์šฉ์ด ์—์ด์ „ํŠธ ๊ฒƒ์ธ์ง€ ๋ถˆํ™•์‹ค) ยท โ“’ ์ปค๋ฐ‹ ์˜๋„ ์ €๋„๋กœ ํ™•์ • โ€” ์ €๋„์ด ํŒŒ์ผ ์กฐ์ž‘์— ์„ ํ–‰ํ•˜๋ฏ€๋กœ ใ€ŒํŒŒ์ผ์ด result ์ƒํƒœใ€๋Š” ๊ณง ๊ฒŒ์ดํŠธ์˜ ํŽธ์ง‘์ด ์ฐฉ์ง€ํ•œ ๊ฒƒ์ด๊ณ , ๋ ˆ์ฝ”๋“œ๋Š” ์ €๋„์— ์ด๋ฏธ ํ™•์ •๋ผ ์žˆ๋‹ค(ํ•ฉ์„ฑ์ด ์•„๋‹ˆ๋‹ค)
  • Decision: โ“’. ํŒŒ์ผ์ด result ๋ฉด ์ €๋„์˜ ๋ ˆ์ฝ”๋“œ๋ฅผ ๋น ์ง„ ์ธ๋ฑ์Šค์— append(ํ™•์ •), base ๋ฉด ํ๊ธฐ, ๋‘˜ ๋‹ค ์•„๋‹ˆ๋ฉด(์‚ฌ๋žŒ์ด ๊ทธ ์‚ฌ์ด ๊ณ ์นจ) ์ž๋™ ์ˆ˜๋ ด ์—†์ด ๋ฏธํ•ด๊ฒฐ ๋ณด๊ณ  + ์ €๋„ ์œ ์ง€. ํŒ์ • ์ฃผ์ฒด๋Š” Design(architecture ยง4.3a DD-26)์ด๋ฉฐ ์˜ค๋„ˆ ํ™•์ธ์„ ๊ธฐ๋‹ค๋ฆฐ๋‹ค โ€” ํ™•์ธ ์ „๊นŒ์ง€๋„ ์žฌ์ž‘์—…์ด ์—†๋Š” ์ชฝ์ด๋‹ค(์–ด๋А ์ชฝ์œผ๋กœ๋„ ํŒŒ์ผ์„ ๊ฑด๋“œ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค).
  • Rationale: โ“ ๋Š” ์‹ค์ œ๋กœ ์ฐฉ์ง€ํ•œ ์—์ด์ „ํŠธ ํŽธ์ง‘์„ ์กฐ์šฉํžˆ ์ง€์šด๋‹ค(AC-19 ์˜ ใ€Œ์กฐ์šฉํžˆ ํ๊ธฐ๋˜์ง€ ์•Š๋Š”๋‹คใ€์™€ ์–ด๊ธ‹๋‚œ๋‹ค). โ“‘ ์˜ ใ€Œํ•ฉ์„ฑใ€์ด ์œ„ํ—˜ํ•œ ์ด์œ ๋Š” ๋‚ด์šฉ์˜ ์ถœ์ฒ˜๊ฐ€ ๋ถˆํ™•์‹คํ•ด์„œ์ธ๋ฐ, ์ €๋„์ด ์„ ํ–‰ํ•˜๋ฉด ๊ทธ ๋ถˆํ™•์‹ค์„ฑ์ด ์—†๋‹ค. ๋‚จ๋Š” ์œ ์ผํ•œ ๋ถˆํ™•์‹ค์€ ใ€Œbase ๋„ result ๋„ ์•„๋‹˜ใ€์ด๊ณ  ๊ทธ๊ฒƒ์€ ํŒ์ • ๋ถˆ๊ฐ€์ด๋ฏ€๋กœ ๋ณด๊ณ ํ•œ๋‹ค.
  • Impact: architecture ยง4.3a(DD-26) ยท workspace WriteJournalRecoveryยทWorkspaceRecovery(์‹œ์ž‘ ํ›… ์ˆœ์„œ: ์“ฐ๊ธฐ ์ €๋„ โ†’ ๋กค๋ฐฑ ์ €๋„ โ†’ edit_locks) ยท ๊ฒŒ์ดํŠธ์˜ recoveryPending ์ถฉ๋Œ(๋ฏธํ•ด๊ฒฐ ๊ฒฝ๋กœ ๋ด‰์‡„)ยทabandonWriteJournal ยท ํฌ๋ž˜์‹œ ์ฃผ์ž… ํ…Œ์ŠคํŠธ(AC 1)๊ฐ€ ์ „ ๊ฒฝ๊ณ„์—์„œ โ“/โ“‘ ๋งŒ ๊ด€์ธกํ•จ์„ ๊ณ ์ •

D-044: ๋ณด์กด ์ •์ฑ… ๊ฐ’ ํ™•์ • โ€” K = 14 ยท ์ด๋Ÿ‰ ์ƒํ•œ 80 MiB(ํ”„๋ก์‹œ ํŒŒ์ƒ ์ž ์ •๊ฐ’) ยท ๋ณด์กด ๊ธฐ๊ฐ„ ์—†์Œ ยท GC ๋Š” ๊ฒŒ์ดํŠธ ์ง๋ ฌ ๊ตฌ๊ฐ„์—์„œ (#29)

  • Date: 2026-09-12
  • Context: #30(D-039)์ด ์‚ฐ์ • ๊ทœ์น™(V-1~V-4)ยท์ธก์ • ๊ทœ์•ฝ(R-1)ยทํ›„๋ณด ์„ธํŠธ(H=7์ผ: K=14 ยท 80 MiB text)๊นŒ์ง€ ํ™•์ •ํ•˜๊ณ  ใ€Œ๊ฐ’์˜ ๊ธฐ๋ก์€ #29 ๊ฐ€ planning-inputs ยง7 ๋กœ ์˜ฎ๊ฒจ ์ ๋Š” ์ˆœ๊ฐ„ใ€์œผ๋กœ ๋‚จ๊ฒผ๋‹ค. architecture ยง4.4 ๋Š” ์„ค์น˜ ์งํ›„์—๋„ ์–‘์˜ ์œ ํ•œํ•œ ๊ธฐ๋ณธ๊ฐ’์„ ์š”๊ตฌํ•œ๋‹ค.
  • Options: โ‘  ๊ธฐ๋ณธ ์„ธํŠธ(H=7์ผ, K=14 ยท 80 MiB) โ‘ก ๋ณด์ˆ˜ ์„ธํŠธ(H=30์ผ, K=โ€ฆ ยท 300 MiB) โ‘ข ๋ฐ”์ด๋„ˆ๋ฆฌ ํฌํ•จ(all, 400 MiB) โ€” ๊ฐ™์€ ๋ฌธ์„œ ยง6.3 ํ‘œ
  • Decision: โ‘ . planning-inputs ยง7.2 ์— ๊ทœ์น™ยทํ‘œ๋ณธยท์žฌ์‚ฐ์ • ์กฐ๊ฑด 3์š”์†Œ์™€ ํ•จ๊ป˜ ๊ธฐ๋กํ–ˆ๊ณ , workspace RetentionSettings.shipped ๊ฐ€ ๊ทธ ๊ฐ’์„ ๋“ ๋‹ค(์ฝ”๋“œ์— ์ƒ์ˆ˜๋กœ ํฉ์–ด์ง€์ง€ ์•Š๋Š”๋‹ค โ€” ํ•œ ๊ณณ). ์„ค์ • ํ‚ค๋Š” history.retention.pinned_tasks_per_path ยท history.retention.max_bytes. ๋ณด์กด ๊ธฐ๊ฐ„์€ MVP ๊ฐ’ ์ง‘ํ•ฉ์—์„œ ์ œ์™ธ(D-039 V-3 ๊ทธ๋Œ€๋กœ).
  • Rationale: โ‘ ์€ ยง10-โ‘ฃ ๊ฐ€ ๋ฏธ์ •์ธ ๋™์•ˆ์˜ ๊ธฐ๋ณธ ์ „์ œ(ํ…์ŠคํŠธ๋งŒ ์Šค๋ƒ…์ƒท)์™€ ๋งž๊ณ  C-1(๋‹จ์ผ ์ž‘์—… ์ตœ๋Œ€ ร— 2 โ‰ค ์ƒํ•œ)์„ ๋งŒ์กฑํ•œ๋‹ค. โ‘กโ‘ข์€ ์ „์ œ๊ฐ€ ๋ฐ”๋€” ๋•Œ ๊ฐˆ์•„ ๋ผ์šฐ๋Š” ๊ฐ’์ด์ง€ ์ง€๊ธˆ ๊ทผ๊ฑฐ๊ฐ€ ์žˆ๋Š” ๊ฐ’์ด ์•„๋‹ˆ๋‹ค.
  • Impact: RetentionGc(P1~P7 + P4โ€ฒ ยท E-1 ๋ฐ”๋‹ฅ ๊ทœ์น™ ยท E-2 ์ดˆ๊ณผ ์ƒํƒœ ๋ณด๊ณ ) โ€” GC ๋Š” ๊ฒŒ์ดํŠธ์˜ ์ง๋ ฌ ๊ตฌ๊ฐ„์—์„œ ๋Œ๊ณ , ๋‚จ์€ ์“ฐ๊ธฐยท๋กค๋ฐฑ ์ €๋„์ด ์ฐธ์กฐํ•˜๋Š” blob ์€ P5 ์˜ ํšŒ์ˆ˜ ๋Œ€์ƒ์—์„œ ์ œ์™ธํ•œ๋‹ค(๊ทธ blob ์€ ์žฌ๊ธฐ๋™ ๋ณต๊ตฌยท์žฌ์ˆ˜ํ–‰์ด ์ฝ๋Š”๋‹ค). ์ •๋ฆฌ ๋งˆ์ปค tasks/<task_id>/retention.json ์ด P6 ์˜ ํ‘œ์‹œ ๊ทผ๊ฑฐ(UX-D-12 R3 โ€” [๋กค๋ฐฑ] ๋น„ํ™œ์„ฑ + ์‚ฌ์œ ). ์‹ค๋ฌผ ํ‘œ๋ณธ์ด ์ƒ๊ธฐ๋ฉด ๊ฐ™์€ ๊ทœ์น™์œผ๋กœ ์žฌ์‚ฐ์ •(ยง7.2 ์žฌ์‚ฐ์ • ์กฐ๊ฑด).

D-045: ํŽธ์ง‘ ๋ฆฌ์Šค์˜ ํš๋“ยทํ•ด์ œ ์‹œ์  โ€” ํš๋“ = ํŽธ์ง‘ ์‹œ๋„ ์‹œ์  ยท ํ•ด์ œ = ๊ฒŒ์ดํŠธ ์—ฐ์‚ฐ์˜ ๋ฐ˜ํ™˜(D-14 ํ›„๋ณด โ‘ข) (#76)

  • Date: 2026-09-12
  • Context: prd ยง4 D-14 ๊ฐ€ ใ€ŒํŒŒ์ผ์˜ ํŽธ์ง‘์„ ๋งˆ์น˜๋Š” ์‹œ์ ใ€ ํŒ์ • ๊ธฐ์ค€์„ ๋ฏธ๊ทœ์ •์œผ๋กœ ๋‚จ๊ธฐ๊ณ  ํ›„๋ณด ์…‹(์—์ด์ „ํŠธ ์ž๊ธฐ ์„ ์–ธ / ๋งˆ์ง€๋ง‰ ์“ฐ๊ธฐ ์™„๋ฃŒ / ๋„๊ตฌ ํ˜ธ์ถœ ๋ฐ˜ํ™˜)๋งŒ ์—ด๊ฑฐํ–ˆ๊ณ , architecture ยง9 ๋ฏธ๊ฒฐ 14 ๊ฐ€ ๊ทธ๊ฒƒ์„ ๊ทธ๋Œ€๋กœ ์˜ฎ๊ธฐ๋ฉฐ ์ž„์‹œ ๊ทœ์น™(ใ€Œ๋ฏธ์ • ๋™์•ˆ ์„ธ์…˜ ์ข…๋ฃŒยท์ž‘์—… ์ข…๊ฒฐ ํŠธ๋ฆฌ๊ฑฐ๋กœ๋งŒ ํ•ด์ œใ€)์„ ๋‹ฌ์•˜๋‹ค. ํš๋“ ์‹œ์ (ํŽธ์ง‘ ์‹œ๋„ ์‹œ์  vs ์ž‘์—… ์‹œ์ž‘ ์‹œ ์ผ๊ด„ ์˜ˆ์•ฝ)๋„ ๊ฐ™์€ ๊ณต๋ฐฑ์ด๋‹ค(prd ยง2 ํ๋ฆ„ 2 3๋‹จ๊ณ„). ๊ธฐ์ค€์ด ์—†์œผ๋ฉด AC-12 ๋ฅผ ๊ธฐ๊ณ„์ ์œผ๋กœ ํŒ์ •ํ•  ์ˆ˜ ์—†๋‹ค.
  • Options: โ‘  ์—์ด์ „ํŠธ์˜ ์ž๊ธฐ ์„ ์–ธ ยท โ‘ก ๋งˆ์ง€๋ง‰ ์“ฐ๊ธฐ ์™„๋ฃŒ ยท โ‘ข ๋„๊ตฌ ํ˜ธ์ถœ ๋ฐ˜ํ™˜ / ํš๋“์€ โ“ ํŽธ์ง‘ ์‹œ๋„ ์‹œ์  ยท โ“‘ ์ž‘์—… ์‹œ์ž‘ ์‹œ ์ผ๊ด„ ์˜ˆ์•ฝ
  • Decision: โ‘ข + โ“. ๋ฆฌ์Šค ๊ตฌ๊ฐ„ = [๊ฒŒ์ดํŠธ ์—ฐ์‚ฐ ํ˜ธ์ถœ ์ง์ „, ๊ทธ ์—ฐ์‚ฐ์˜ ๋ฐ˜ํ™˜ ์งํ›„]. ํ›„๋ณด โ‘ข ์˜ ใ€Œ๋ฐ˜ํ™˜ใ€์˜ ์ขŒํ‘œ๋ฅผ WorkspaceFileGate ์—ฐ์‚ฐ์˜ ๋ฐ˜ํ™˜์œผ๋กœ ๊ณ ์ •ํ•œ๋‹ค(์š”์ฒญ ์ข…๊ฒฐ์ด ์•„๋‹ˆ๋‹ค). ์‹คํŒจยท๊ฑฐ๋ถ€ ๊ฒฝ๋กœ๋„ ๊ฐ™์€ ๊ฒฝ๊ณ„์—์„œ ํ•ด์ œํ•œ๋‹ค.
  • Rationale: โ‘ ์€ ๊ทธ๋Ÿฐ ์‚ฌ๊ฑด์ด ํ”„๋กœํ† ์ฝœ์— ์—†๋‹ค โ€” AgentEvent ํ์‡„ ์ง‘ํ•ฉ๊ณผ ACP v1 ํด๋ผ์ด์–ธํŠธ ๋Šฅ๋ ฅ ์–ด๋””์—๋„ ใ€Œ์ด ํŒŒ์ผ ๋‹ค ์ผ๋‹คใ€๊ฐ€ ์—†์–ด acp ์—์„œ ๊ตฌํ˜„ ๋ถˆ๊ฐ€๋‹ค(AC-18 ์ดˆํŒ์ด rev.2 ์—์„œ ์ •์ •๋‹นํ•œ ๊ฒƒ๊ณผ ๊ฐ™์€ ๊ฒฐํ•จ ์œ ํ˜• โ€” ํ•œ ๋ฐฑ์—”๋“œ์—์„œ๋งŒ ์„ฑ๋ฆฝํ•˜๋Š” ํŒ์ •). โ‘ก๋Š” ใ€Œ๋งˆ์ง€๋ง‰ใ€์„ ๊ทธ ์‹œ์ ์— ํŒ์ •ํ•  ์ˆ˜ ์—†๊ณ (๋ฏธ๋ž˜๋ฅผ ์•Œ์•„์•ผ ํ•œ๋‹ค), ํŒ์ • ๊ฐ€๋Šฅํ•ด์ง€๋Š” ์‹œ์ ์œผ๋กœ ๋Šฆ์ถ”๋ฉด ํŠธ๋ฆฌ๊ฑฐ 2์™€ ๊ฐ™์€ ์‚ฌ๊ฑด์ด ๋˜๊ฑฐ๋‚˜ ์‚ฌ๋žŒ์Šน์ธ๋Œ€๊ธฐ(์™„๋ฃŒ์Šน์ธ) ๊ฒฝ๊ณ„์—์„œ ๋ณ„๋„ ํ•ด์ œ ๊ทœ์น™์ด ๋˜ ํ•„์š”ํ•ด์ ธ ๋ถˆ๋ณ€์‹ 2 ํ›„๋ฐ˜๋ถ€์™€ ์ถฉ๋Œํ•œ๋‹ค. โ‘ข์€ ํŒ์ •์ด ์—†๊ณ (์‚ฌ๊ฑด ๋ฐœ์ƒ ์—ฌ๋ถ€), ๋‘ ๋ฐฑ์—”๋“œ์—์„œ ๊ฐ™์€ ์ขŒํ‘œ๋ฅผ ๊ฐ€์ง€๋ฉฐ(architecture:278), ๋‹จ์ผ ์“ฐ๊ธฐ ์ง€์ (C-02/DD-15) ์œ„์— ์žˆ์–ด ์—์ด์ „ํŠธ ํŽธ์ง‘์˜ ๊ฒฝ๊ณ„์™€ ์ผ์น˜ํ•œ๋‹ค. โ“‘ ๋Š” ์ž…๋ ฅ์ด ์—†๋‹ค โ€” ์ž‘์—… ์‹œ์ž‘ ์‹œ์ ์— ํŽธ์ง‘ํ•  ํŒŒ์ผ ์ง‘ํ•ฉ์˜ ์ถœ์ฒ˜๊ฐ€ ์–ด๋А ๋ฌธ์„œ์—๋„ ์—†๊ณ (DelegatedTask ์†์„ฑ 10์ข…์— ์—†๋‹ค), ํƒํ•˜๋ฉด FR-205 ๊ฐ€ ํŠธ๋ฆฌ๊ฑฐ 2์˜ ์ค‘๋ณต ์„œ์ˆ ์ด ๋˜์–ด ๋ณ„๋„ ๊ทœ์น™์œผ๋กœ ์กด์žฌํ•  ์ด์œ ๋ฅผ ์žƒ๋Š”๋‹ค.
  • Impact: architecture ยง4.5(ํ™•์ • ๋ฌธ์žฅ์œผ๋กœ ๊ต์ฒด) ยท ยง9 ๋ฏธ๊ฒฐ 14(ํ•ด์†Œ) ยท prd FR-205ยทยง2 ํ๋ฆ„ 2 3ยท5๋‹จ๊ณ„ยทยง4 D-14(ํ•ด์†Œ) ยท #75 EditLockRegistry ํ‘œ๋ฉด(ํš๋“ยทํ•ด์ œ๊ฐ€ ์ง์ง€์–ด์ง„ ๊ตฌ๊ฐ„ API ์—ฌ์•ผ ํ•œ๋‹ค โ€” ์ž์œ  put/remove ๋Š” ํ•ด์ œ๋ฅผ ๋น ๋œจ๋ฆฐ ํ˜ธ์ถœ์ž๋ฅผ ๋งŒ๋“ ๋‹ค) ยท ์Šน์ธ ํŒ์ •์€ ๋ฆฌ์Šค ๊ตฌ๊ฐ„ ๋ฐ–์— ๋‘”๋‹ค(๋ถˆ๋ณ€์‹ 2 ํ›„๋ฐ˜๋ถ€๊ฐ€ ๋Ÿฐํƒ€์ž„ ๊ฒ€์‚ฌ ์—†์ด ์„ฑ๋ฆฝ) ยท ํŠธ๋ฆฌ๊ฑฐ 3์ข…์€ ์ถ•์†Œ๋˜์ง€ ์•Š๋Š”๋‹ค(๋ฆฌ์Šค ๊ตฌ๊ฐ„ ์•ˆ์˜ ์‚ฌ๋ง์€ ์ •์ƒ ๊ฒฝ๋กœ๊ฐ€ ๋ฎ์ง€ ๋ชปํ•œ๋‹ค) ยท #77 ๋กœ ์ธ๊ณ„: ๋‹ค์ค‘ ๊ฒฝ๋กœ ์—ฐ์‚ฐ(rename ์€ fromยทto ๋‘˜)์˜ ํš๋“ ์ˆœ์„œ๊ฐ€ ๊ต์ฐฉ์˜ ์‹ค์งˆ ํ‘œ๋ฉด์ด๊ณ , ๋Œ€๊ธฐ ์ค‘ ์ž‘์—…์˜ status ๋Š” ์‹คํ–‰์ค‘(์ „์ด๊ฐ€ ์•„๋‹ˆ๋ผ ๊ฒŒ์ดํŠธ ์—ฐ์‚ฐ ์•ˆ์˜ ๋Œ€๊ธฐ)์ด๋ผ state-machine-cocode.md ยง4 ์˜ ์ „์ด ํ•จ์˜ ๋ฌธ์žฅ(โ“‘ ์ „์ œ)๊ณผ ์–ด๊ธ‹๋‚œ๋‹ค โ€” #16 ์˜ ๊ฒฐ์ •(์ƒˆ status ๊ฐ’ ์—†์Œ)์€ ๊ทธ๋Œ€๋กœ ์œ ํšจ
  • Source: #76 (docs/edit-lock-lifecycle-cocode.md)

D-046: ์ž ๊ธˆ ๋Œ€๊ธฐ์—ด ๊ทœ์น™ โ€” ๊ฒฝ๋กœ๋ณ„ FIFO ยท ์ •๋ ฌ ํš๋“์œผ๋กœ ๊ต์ฐฉ ์˜ˆ๋ฐฉ ยท ๋Œ€๊ธฐ ์ƒํ•œ ์—†์Œ (#77)

  • Date: 2026-09-12
  • Context: flow ยง3 FP-405(๊ต์ฐฉ)ยทFP-406(๋Œ€๊ธฐ์ž ๋ณต์ˆ˜ ์‹œ ์„ ํƒ ๊ทœ์น™ โ†’ ๊ธฐ์•„)ยทยง6.2 I-1ยทยง6.3 N-5(๋Œ€๊ธฐ์—ด ์ˆœ์„œยท์˜ˆ์ƒ ๋Œ€๊ธฐ ํ‘œ์‹œ)ยทยง6.1 C-5(์ž ๊ธˆ ๋Œ€๊ธฐ์— ์ƒํ•œ ์—†์Œ)ยทยง5 B-08 ์ด ์ „๋ถ€ ๋ฏธ๊ทœ์ •์œผ๋กœ ์—ด๋ ค ์žˆ์—ˆ๋‹ค. D-045(#76)๊ฐ€ ํš๋“ยทํ•ด์ œ ์‹œ์ ์„ ๋‹ซ์œผ๋ฉด์„œ ใ€Œํš๋“์ด ์ฆ‰์‹œ ์„ฑ๊ณตํ•˜์ง€ ์•Š์„ ๋•Œ ๋ฌด์—‡์ด ์ผ์–ด๋‚˜๋Š”๊ฐ€ใ€๊ฐ€ ๋‚จ์•˜๋‹ค.
  • Options: ์ˆœ์„œ โ€” FIFO / ์šฐ์„ ์ˆœ์œ„ / ๋ฏธ๊ทœ์ •(์ž„์˜) ยท ๊ต์ฐฉ โ€” ๊ฒ€์ถœ๊ธฐ+ํฌ์ƒ์ž ์„ ํƒ / ์ •๋ ฌ ํš๋“ ์˜ˆ๋ฐฉ / ํƒ€์ž„์•„์›ƒ ยท ์ƒํ•œ โ€” ๊ฐ’์„ ์ •ํ•œ๋‹ค / ๋‘์ง€ ์•Š๋Š”๋‹ค
  • Decision: โ‘  ๊ฒฝ๋กœ๋ณ„ FIFO ํ(์ „์—ญ ํ๊ฐ€ ์•„๋‹ˆ๋‹ค โ€” AC-12 ๋Š” ๊ฒฝ๋กœ ๋‹จ์œ„ ๋ฐฐํƒ€๋งŒ ์š”๊ตฌํ•œ๋‹ค) ยท โ‘ก ํ•œ ์—ฐ์‚ฐ์ด ์š”๊ตฌํ•˜๋Š” ๊ฒฝ๋กœ๋ฅผ ์ „๋ถ€-์•„๋‹ˆ๋ฉด-์ „๋ฌด๋กœ ํš๋“(๊ต์ฐฉ ๊ฒ€์ถœ๊ธฐ๋Š” ๋‘์ง€ ์•Š๋Š”๋‹ค) ยท โ‘ข ์ž ๊ธˆ ๋Œ€๊ธฐ์— ์‹œ๊ฐ„ ์ƒํ•œ์„ ๋‘์ง€ ์•Š๋Š”๋‹ค ยท โ‘ฃ ํ๋Š” ์˜์†ํ•˜์ง€ ์•Š๋Š”๋‹ค ยท โ‘ค ํ™”๋ฉด: S-01b ๋Š” ๊ทธ๋Œ€๋กœ(๋Œ€๊ธฐ ์นธ ์‹ ์„ค ์—†์Œ), S-06 ์‹คํ–‰์ค‘ ํ–‰์˜ ์ž ๊ธˆ ์นธ์„ 3๊ฐ’(์ž ๊ธˆ Nยท์ž ๊ธˆ ๋Œ€๊ธฐยท๋นˆ์นธ)์œผ๋กœ. ์˜ˆ์ƒ ๋Œ€๊ธฐยท์ˆœ๋ฒˆ์€ ๊ทธ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค.
  • Rationale: โ‘  ์šฐ์„ ์ˆœ์œ„๋Š” DelegatedTask ์†์„ฑ 10์ข…์— ๊ทผ๊ฑฐ๊ฐ€ ์—†์–ด ๊ธฐ๊ฐ(D-045 ๊ฐ€ โ“‘ ๋ฅผ ๊ธฐ๊ฐํ•œ ๊ฒƒ๊ณผ ๊ฐ™์€ ํ˜•ํƒœ โ€” ์—†๋Š” ์ž…๋ ฅ์„ ์š”๊ตฌํ•˜๋Š” ๊ทœ์น™์€ ๊ทœ์น™์ด ์•„๋‹ˆ๋‹ค). FIFO ๋Š” ์•ž ์ˆœ๋ฒˆ์ด ๋‹จ์กฐ ๊ฐ์†Œํ•˜๊ณ  ๋ฆฌ์Šค ๊ตฌ๊ฐ„์ด ์œ ํ•œํ•˜๋ฏ€๋กœ(๊ฒŒ์ดํŠธ ์—ฐ์‚ฐ 1ํšŒ) ๊ธฐ์•„๊ฐ€ ์ •์ฑ…์ด ์•„๋‹ˆ๋ผ ์ž๋ฃŒ๊ตฌ์กฐ๋กœ ๋‹ซํžŒ๋‹ค. โ‘ก ์ž ๊ทธ๋Š” ๋‹จ์œ„๋Š” FileEditOperation.touchedPaths ์ด๊ณ  ๋ฆฌ์Šค๋ฅผ ๋‘˜ ๋“œ๋Š” ์—ฐ์‚ฐ์€ rename ๋ฟ์ด๋‹ค. โš ๏ธ ์ดˆํŒ์€ ใ€Œ์ •๋ ฌํ•ด ํ•˜๋‚˜์”ฉ ํš๋“ใ€์ด๋ผ๊ณ  ์ ์—ˆ๊ณ  ๊ทธ๊ฒƒ์€ ํ‹€๋ ธ๋‹ค โ€” #75 ๊ตฌํ˜„ ๋ฆฌ๋ทฐ๊ฐ€ ๊ต์ฐฉ 3์ข…์„ ์žฌํ˜„ํ–ˆ๋‹ค(๋Œ€๊ธฐ์ž ๊ฐ„์„ ์ด ํ‚ค ์ˆœ์„œ๋ฅผ ๋”ฐ๋ฅด์ง€ ์•Š๋Š” A ยท ์ •๋ ฌ ์ˆœ์„œ์™€ ํฌํ•จ ๊ด€๊ณ„๊ฐ€ ์–ด๊ธ‹๋‚˜๋Š” E1 ยท ํ•œ ์—ฐ์‚ฐ์˜ ๋‘ ๊ฒฝ๋กœ๊ฐ€ ์ค‘์ฒฉ๋˜๋Š” ์ž๊ธฐ๊ต์ฐฉ C). ์ถ”์›” ์˜ˆ์™ธ๋กœ A ๋ฅผ ๋ง‰์œผ๋ฉด ์ด๋ฒˆ์—๋Š” ๊ธฐ์•„๊ฐ€ ์žฌํ˜„๋ผ ๊ต์ฐฉ๊ณผ ๊ธฐ์•„๊ฐ€ ๋งž๊ตํ™˜์ด ๋๋‹ค. ๋ฟŒ๋ฆฌ๋Š” ใ€Œ๋ฆฌ์Šค๋ฅผ ๋“  ์ฑ„ ๊ธฐ๋‹ค๋ฆฌ๋Š” ์ƒํƒœใ€ ํ•˜๋‚˜์ด๋ฉฐ, ์ „๋ถ€-์•„๋‹ˆ๋ฉด-์ „๋ฌด๊ฐ€ ๊ทธ๊ฒƒ์„ ์—†์•ค๋‹ค: ๋‚˜๊ฐ€๋Š” ๊ฐ„์„ ์„ ๊ฐ€์ง„ ๋…ธ๋“œ๋Š” ๋ณด์œ ๊ฐ€ 0 ์ด๋ผ ์ˆœํ™˜ ๋Œ€๊ธฐ๊ฐ€ ์„ฑ๋ฆฝํ•  ์ˆ˜ ์—†๊ณ , ์ถ”์›” ์˜ˆ์™ธ๊ฐ€ ์—†์–ด ์—„๊ฒฉ FIFO ๊ฐ€ ์œ ์ง€๋œ๋‹ค. ์ •๋ ฌ์€ ๋‚จ๋˜ ์—ญํ• ์ด ๋ฐ”๋€๋‹ค(์ค‘์ฒฉ ํ‚ค ์ œ๊ฑฐ + ๊ฒฐ์ •์„ฑ) โ€” ๊ฒ€์ถœ์ด ์•„๋‹ˆ๋ผ ์˜ˆ๋ฐฉ์ด๊ณ  ํŒ์ •์ด ์•„๋‹ˆ๋ผ ๊ณ„์‚ฐ์ด๋‹ค. ๊ฒ€์ถœ๊ธฐ๋Š” ํฌ์ƒ์ž ์„ ํƒ ๊ทœ์น™์˜ ๊ทผ๊ฑฐ๊ฐ€ ์—†๊ณ (ํฌ์ƒ๋œ ์ž‘์—…์˜ status ๋„ #71 ์†Œ์œ ์˜ ๋ฏธ์ • ๊ณ„์—ด) ์˜ˆ๋ฐฉ์ด ์„ฑ๋ฆฝํ•˜๋ฉด ๋„๋‹ฌ ๋ถˆ๊ฐ€ ์ฝ”๋“œ๊ฐ€ ๋œ๋‹ค. ์ „์ œ(ํ•œ ์ž‘์—…์ด ๋™์‹œ์— ๋‘ ๊ฒŒ์ดํŠธ ์—ฐ์‚ฐ์„ ์ง„ํ–‰ํ•˜์ง€ ์•Š๋Š”๋‹ค)๋Š” ๊ฒŒ์ดํŠธ runSerially ์˜ ์„ฑ์งˆ์ด๋ฉฐ #75 ์˜ ํ…Œ์ŠคํŠธ๊ฐ€ ๋‹จ์–ธํ•œ๋‹ค. โ‘ข ๊ฐ’์˜ ์ถœ์ฒ˜๊ฐ€ ์—†๋‹ค โ€” AC-08 ์˜ ์ƒํ•œ์€ Given ์ด ใ€Œ์ž๊ฐ€ ๊ฒ€์ฆ ์‹œ๋„๊ฐ€ ์ง„ํ–‰ ์ค‘์ผ ๋•Œใ€๋กœ ํ•œ์ •๋ผ ์ž ๊ธˆ ๋Œ€๊ธฐ๋ฅผ ๋ฎ์ง€ ๋ชปํ•œ๋‹ค(flow FP-405 ์™€ ux-spec UX-D-06 ํ๊ธฐ ์ฃผ์„์ด ๊ฐ™์€ ๋ง๋กœ ์ ์–ด ๋‘” ์‚ฌ์‹ค). ๊ทธ๋ฆฌ๊ณ  ํ•„์š”ํ•˜์ง€ ์•Š๋‹ค: ๊ต์ฐฉยท๊ธฐ์•„๋Š” โ‘ โ‘ก๋กœ ์„ฑ๋ฆฝ ๋ถˆ๊ฐ€, ์Šน์ธ ๋Œ€๊ธฐ๋Š” ๋ฆฌ์Šค ๊ตฌ๊ฐ„ ๋ฐ–์ด๋ผ ๋Œ€๊ธฐ์—ด์„ ์žก์ง€ ์•Š์œผ๋ฉฐ(D-045 ยง2.1), ๋ณด์œ ์ž ์‚ฌ๋ง์€ DD-13 ํŠธ๋ฆฌ๊ฑฐ 3์ข…์ด ๋ฎ๋Š”๋‹ค. ์ฆ‰ ใ€Œ์ƒํ•œ ์—†์Œใ€์˜ ๊ทผ๊ฑฐ๊ฐ€ ๋ฌด๋ฐฉ๋น„๊ฐ€ ์•„๋‹ˆ๋ผ ๊ตฌ์กฐ์  ์œ ํ•œ์„ฑ์ด๋‹ค. โ‘ฃ ํŠธ๋ฆฌ๊ฑฐ 3์ด ์žฌ๊ธฐ๋™ ์‹œ ๋ฆฌ์Šค๋ฅผ ์ „๋ถ€ ๋ฌดํšจํ™”ํ•˜๋ฏ€๋กœ ์žฌ๊ธฐ๋™ ํ›„ ๋Œ€๊ธฐ์—ด์€ ์ •์˜์ƒ ๋นˆ ์ง‘ํ•ฉ์ด๋‹ค โ€” ์˜์†ํ•˜๋ฉด ๊ทธ ๋ชจ์ˆœ์„ ์ง€์šฐ๋Š” ์ฝ”๋“œ๋ฅผ ๋”ฐ๋กœ ์จ์•ผ ํ•œ๋‹ค. โ‘ค S-01b ๋Œ€๊ธฐ ์นธ์€ ยง2.4 ํ‘œ์— ๋Œ€์‘ ์ถœ์ฒ˜ ์†์„ฑ์ด ์—†๊ณ  ์‚ฌ๋žŒ์ด ์ฝ๊ธฐ ์ „์— ์‚ฌ๋ผ์ง„๋‹ค. ์˜ˆ์ƒ ๋Œ€๊ธฐ๋Š” ๊ณ„์‚ฐํ•  ์ž…๋ ฅ์ด ์—†๊ณ (UX-D-07 ๊ณผ ๊ฐ™์€ ๋ฟŒ๋ฆฌ), ์ˆœ๋ฒˆ์€ ๊ณ„์‚ฐ ๊ฐ€๋Šฅํ•˜๋‚˜ ํ–‰๋™์„ ๋ฐ”๊พธ์ง€ ์•Š๋Š”๋‹ค.
  • Impact: flow FP-401ยท402ยท403ยท405ยท406 ํ•ด์†Œ ยท I-1 ํ•ด์†Œ ยท N-5 ํ•ด์†Œ ยท B-08 ํ•ด์†Œ ยท C-5 ๋Š” ์ž ๊ธˆ ์ถ•๋งŒ ํ•ด์†Œ(ํŽธ์ง‘ ๋‹จ๊ณ„ FP-105ยท์ž‘์—… ์ด๋Ÿ‰ FP-106ยท์‘๋‹ต ๋ถˆ๊ฐ€ FP-107 ์€ #71) ยท ux-spec ยง3.2 ์‹คํ–‰์ค‘ ํ–‰ 3๊ฐ’ + UX-D-23 ์‹ ์„ค ยท ยง10 S-01bยทS-06 ยท ยง12 UX-D-20 ์˜ ๋ณด๋ฅ˜ ์‚ฌ์œ  ์†Œ๋ฉธ ๊ธฐ๋ก(DD-13 ์˜ EditLease.ownerTaskId ๊ฐ€ ๊ท€์† ์†์„ฑ์ด๋‹ค โ€” ๋‚จ์€ ๊ฒƒ์€ UX ํŒ์ • ํ•˜๋‚˜) ยท #75 ๊ตฌํ˜„ ๋Œ€์ƒ: ๊ฒฝ๋กœ๋ณ„ FIFO ํ(๋น„์˜์†) ยท ์ „๋ถ€-์•„๋‹ˆ๋ฉด-์ „๋ฌด ํš๋“(์ •๋ ฌ์€ ์ค‘์ฒฉ ํ‚ค ์ œ๊ฑฐ์šฉ) ยท ๊ฒฝ๋กœ ํฌํ•จ ๊ด€๊ณ„ ์ถฉ๋Œ ํŒ์ •(๊ตฌํ˜„์ด ๋“œ๋Ÿฌ๋‚ธ ๋ณด๊ฐ• โ€” ๋””๋ ‰ํ„ฐ๋ฆฌ ์—ฐ์‚ฐ์€ ๋ฆฌ์Šค 1๊ฐœ๋ฅผ ๋“ค๋ฉด์„œ ํ•˜์œ„ ํŒŒ์ผ N๊ฐœ๋ฅผ ํ•œ ์ปค๋ฐ‹์— ๋‹ด์œผ๋ฏ€๋กœ ์ •ํ™• ์ผ์น˜๋งŒ ๋ณด๋ฉด ๋™์‹œ ํŽธ์ง‘์ด ํ†ต๊ณผํ•œ๋‹ค, edit-lock-queue-cocode.md ยง3.1) ยท ๊ฒŒ์ดํŠธ ์ง๋ ฌ์„ฑ ์ „์ œ์˜ ํ…Œ์ŠคํŠธ ๋‹จ์–ธ ยท ๋Œ€๊ธฐ/๋ณด์œ  ์กฐํšŒ seam ยท #78 ์€ ใ€Œ์žฌ๊ธฐ๋™ ํ›„ ๋Œ€๊ธฐ์—ด = ๋นˆ ์ง‘ํ•ฉใ€์„ ๊ฒ€์ฆ ๋Œ€์ƒ์œผ๋กœ ๋ฐ›๋Š”๋‹ค
  • ๋ฏธ์ •์œผ๋กœ ๋‚จ๊ธด ๊ฒƒ: ์ž ๊ธˆ ๋Œ€๊ธฐ ์ƒํ•œ์˜ ๊ฐ’(๋‘์ง€ ์•Š๊ธฐ๋กœ ํ–ˆ์œผ๋ฏ€๋กœ ๋ถˆํ•„์š”ํ•˜๋‚˜, ๋ฆฌ์Šค ๊ตฌ๊ฐ„์ด ๋„“์–ด์ง€๋ฉด ์žฌ๊ฒ€ํ†  โ€” D-045 ยง6) ยท ๊ฒŒ์ดํŠธ ์—ฐ์‚ฐ ์ž์ฒด์˜ ์‹œ๊ฐ„ ์ƒํ•œ(์ž ๊ธˆ ์ถ•์ด ์•„๋‹ˆ๋ผ ํŒŒ์ผ IO ์ถ•์ด๋‹ค. ์ž ๊ธˆ์œผ๋กœ ๋Œ์–ด์˜ค๋ฉด ๊ทผ๊ฑฐ ์—†๋Š” ๊ฐ’์„ ใ€Œ์ž ๊ธˆ ๋Œ€๊ธฐ ์ƒํ•œใ€์ด๋ผ๋Š” ์ด๋ฆ„์œผ๋กœ ์ •ํ•˜๊ฒŒ ๋œ๋‹ค) ยท U-11 ์˜ status ๊ฐ’ ์žฌํ™•์ •(#16 ๋‹จ๋… ์†Œ์œ  โ€” D-045 ๋กœ ์ „์ œ๊ฐ€ ๋ฐ”๋€Œ์–ด state-machine-cocode.md ยง4 ์˜ ์ „์ด ํ•จ์˜ ๋ฌธ์žฅ์ด ๊ฐฑ์‹  ๋Œ€์ƒ์ด๋‹ค)
  • Source: #77 (docs/edit-lock-queue-cocode.md)

D-047: edit_locks ๋ฅผ ใ€Œ๊ฒฝ๋กœ ์ง‘ํ•ฉใ€์—์„œ ใ€Œ๊ฒฝ๋กœ โ†’ ๋ฆฌ์Šคใ€๋กœ โ€” Seed Spec ยง3 ๊ฐœ์ • ์š”์ฒญ (์˜ค๋„ˆ ํŒ์ • ๋Œ€๊ธฐ) (#75)

  • Date: 2026-09-12 (๊ธฐ๋ก๋งŒ โ€” ๊ฒฐ์ • ์•„๋‹˜)
  • Context: seed-spec:70(ยง3 Workspace Attributes)์ด edit_locks ๋ฅผ ใ€Œ์—์ด์ „ํŠธ๊ฐ€ ํ˜„์žฌ ํŽธ์ง‘ ์ค‘์ธ ํŒŒ์ผ ๊ฒฝ๋กœ ์ง‘ํ•ฉใ€์œผ๋กœ ์ •์˜ํ•œ๋‹ค. architecture ยง4.5 DD-13 ์ด ์ด๋ฅผ ๊ฒฝ๋กœ โ†’ ๋ฆฌ์Šค(์†Œ์œ  task_id ยท ์†Œ์œ  ์„ธ์…˜ ์‹๋ณ„์ž ยท ๊ฐฑ์‹  ์‹œ๊ฐ)๋กœ ๋Œ€์ฒดํ–ˆ๊ณ , #15 ๊ฐ€ Workspace.editLocks ๋ฅผ Map<String, EditLease> ๋กœ ์ด๋ฏธ ์„ธ์› ์œผ๋ฉฐ #75 ๊ฐ€ ๊ทธ ์œ„์— ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ์™€ ํ•ด์ œ ํŠธ๋ฆฌ๊ฑฐ 3์ข…์„ ๊ตฌํ˜„ํ–ˆ๋‹ค. ยง3 ๋จธ๋ฆฌ๋ง์ด ใ€Œ์ž ๊ธˆ ํ›„ ๊ธฐ์กด ์—”ํ‹ฐํ‹ฐ ์ˆ˜์ • ๋ถˆ๊ฐ€, ์ถ”๊ฐ€๋งŒ ํ—ˆ์šฉใ€์ด๋ฏ€๋กœ ์†์„ฑ ์ •์˜์˜ ๋ณ€๊ฒฝ์€ ๊ตฌํ˜„ ์žฌ๋Ÿ‰์ด ์•„๋‹ˆ๋ผ ๋ฌธ์„œ ๊ฒฐ์ •์ด๋‹ค โ€” #75 ์ธ์ˆ˜์กฐ๊ฑด 5 ๊ฐ€ ใ€ŒSeed Spec ยง3 ๊ฐœ์ • ๋˜๋Š” ๋ช…์‹œ์  ์–ด๊ธ‹๋‚จ ๊ธฐ๋ก์ด ์„ ํ–‰๋œ๋‹คใ€๊ณ  ์š”๊ตฌํ•œ ์ž๋ฆฌ์ด๋ฉฐ, ์ด ํ•ญ๋ชฉ๊ณผ architecture ยง10-20 ์ด ๊ทธ ๊ธฐ๋ก์ด๋‹ค.
  • Options:
    1. ยง3 ์˜ edit_locks ์ •์˜๋ฅผ ๊ฒฝ๋กœ โ†’ ๋ฆฌ์Šค ์‚ฌ์ƒ์œผ๋กœ ๊ฐœ์ • (DD-25 โ†’ D-038 ๊ณผ ๊ฐ™์€ ๊ฒฝ๋กœ)
    2. ใ€Œ๊ฒฝ๋กœ ์ง‘ํ•ฉใ€ ๋ฌธ๋ฉด์„ ์œ ์ง€ํ•˜๊ณ  ๋ฆฌ์Šค๋ฅผ ๋ณ„๋„ ์†์„ฑ์œผ๋กœ ์ถ”๊ฐ€ โ€” ยง3 ๋จธ๋ฆฌ๋ง์˜ ใ€Œ์ถ”๊ฐ€๋งŒ ํ—ˆ์šฉใ€์— ํ˜•์‹์ƒ ๋งž์ง€๋งŒ, ์ง‘ํ•ฉ๊ณผ ์‚ฌ์ƒ์ด ๊ฐ™์€ ์‚ฌ์‹ค์˜ ๋‘ ํ‘œํ˜„์ด๋ผ ๋‘˜์ด ์–ด๊ธ‹๋‚  ๋•Œ ์–ด๋А ์ชฝ์ด ์ •๋ณธ์ธ์ง€๊ฐ€ ๊ทœ์ •๋˜์ง€ ์•Š๋Š”๋‹ค
    3. ์ง‘ํ•ฉ ์œ ์ง€ + ์†Œ์œ ์ž ์ถ”์  ํฌ๊ธฐ โ€” ๋ถˆ๊ฐ€. ํ•ด์ œ ํŠธ๋ฆฌ๊ฑฐ 1(์„ธ์…˜ ์ข…๋ฃŒ)๊ณผ 2(์ž‘์—… ์ข…๊ฒฐ)๋Š” ใ€Œ๊ทธ ์„ธ์…˜/๊ทธ task_id ๊ฐ€ ์†Œ์œ ํ•œ ๋ฆฌ์Šคใ€๋ฅผ ์ฐพ์•„์•ผ ํ•˜๋Š”๋ฐ ์ง‘ํ•ฉ์—๋Š” ์†Œ์œ ์ž๊ฐ€ ์—†๋‹ค. AC-18 ์ด ์„ฑ๋ฆฝํ•˜์ง€ ์•Š๋Š”๋‹ค
  • Decision: ๋ฏธ์ • โ€” ์˜ค๋„ˆ ํŒ์ • ๋Œ€๊ธฐ. ์„ค๊ณ„ยท๊ตฌํ˜„์€ ์˜ต์…˜ 1 ์„ ์ „์ œ๋กœ ์„œ ์žˆ๋‹ค(DD-13 ยท #15 ยท #75).
  • Rationale: ์˜ต์…˜ 3 ์€ AC-18 ๊ณผ ๋ชจ์ˆœ์ด๋ผ ์• ์ดˆ์— ๋ถˆ๊ฐ€ํ•˜๊ณ , ์˜ต์…˜ 2 ๋Š” ์ •๋ณธ ๊ทœ์ •์ด ์—†๋Š” ์ด์ค‘ ํ‘œํ˜„์„ ๋งŒ๋“ ๋‹ค. ์˜ต์…˜ 1 ์ด ์ด๋ฏธ architecture ยง4.5 ์™€ ์ฝ”๋“œ์— ์„œ ์žˆ์œผ๋ฏ€๋กœ ์žฌ์ž‘์—…์ด ์—†๋‹ค.
  • Impact: โš ๏ธ ํŒ์ • ์ „๊นŒ์ง€ ใ€Œ์ŠคํŽ™๋ณด๋‹ค ์•ž์„ ใ€ ์ƒํƒœ๋‹ค(ยง10-20). ๋‹ค๋งŒ ๋ง‰ํžˆ๋Š” ํ›„์† ์ž‘์—…์€ ์—†๋‹ค โ€” D-038 ํŒ์ • ์ „์˜ DD-25 ๋Š” ์—”ํ‹ฐํ‹ฐ ๊ฐœ์ •์ด ์„ ํ–‰ํ•ด์•ผ #23 ์ด ์ฐฉ์ˆ˜ํ•  ์ˆ˜ ์žˆ์—ˆ์ง€๋งŒ, ์—ฌ๊ธฐ์„œ๋Š” Workspace.editLocks ๊ฐ€ ์ด๋ฏธ ์‚ฌ์ƒ์œผ๋กœ ์„œ ์žˆ๊ณ  ๊ทธ ์œ„์—์„œ AC-12ยทAC-18 ์ด ์„ฑ๋ฆฝํ•œ๋‹ค. ํŒ์ •์ด ใ€Œ์ง‘ํ•ฉ ์œ ์ง€ใ€๋กœ ๋’ค์ง‘ํžˆ๋ฉด ํ•ด์ œ ํŠธ๋ฆฌ๊ฑฐ 1ยท2 ์˜ ์žฌ์„ค๊ณ„๊ฐ€ ํ•„์š”ํ•˜๋‹ค(๊ทธ ๊ฒฝ์šฐ AC-18 ์ด ์„ฑ๋ฆฝํ•  ๋‹ค๋ฅธ ์ˆ˜๋‹จ์„ ๋จผ์ € ์ฐพ์•„์•ผ ํ•œ๋‹ค). ๊ฐœ์ •์ด ํ™•์ •๋˜๋ฉด ux-spec ยง12 ์˜ UX-D-20 ๋ฏธ๊ฒฐ(ใ€Œ์ž‘์—…โ†”์ž ๊ธˆ ๊ท€์† ์†์„ฑใ€)๋„ ํ•จ๊ป˜ ๋‹ซํžŒ๋‹ค โ€” EditLease.ownerTaskId ๊ฐ€ ๊ทธ ๊ท€์†์ด๋ฉฐ D-046 ์ด ๊ทธ ์‚ฌ์‹ค์„ ๊ธฐ๋กํ–ˆ๋‹ค.
  • Source: #75 (architecture ยง4.5 ยซ๊ฐœ์ • ์š”์ฒญยป ยท ยง10-20)

D-048: ํŠธ๋ฆฌ๊ฑฐ 3 ์Šค์œ•๊ณผ S-01b ์ฒซ ๋ Œ๋”์˜ ์ˆœ์„œ โ€” ์Šค์œ•์ด ์„ ํ–‰ํ•˜๊ณ , ๊ทธ ์ „์—๋Š” ์ž ๊ธˆ ์นธ์„ ๋ Œ๋”ํ•˜์ง€ ์•Š๋Š”๋‹ค (#78)

  • Date: 2026-09-12
  • Context: #78 ์ธ์ˆ˜์กฐ๊ฑด 1 ์ด ์ธก์ • ์‹œ์ ์„ ใ€Œํ•ด์ œ ํŠธ๋ฆฌ๊ฑฐ 3(์•ฑ ์žฌ๊ธฐ๋™) ์Šค์œ• ์™„๋ฃŒ ์ดํ›„ ์ฒซ ํ”„๋ ˆ์ž„ใ€์œผ๋กœ ๊ณ ์ •ํ•˜๋ ค ํ–ˆ์œผ๋‚˜, ๋‘ ์‚ฌ๊ฑด์˜ ์ˆœ์„œ๋ฅผ ๊ทœ์ •ํ•œ ๋ฌธ์„œ๊ฐ€ ์—†๋‹ค โ€” ux-spec ยง2.4(198~205ํ–‰) ์ƒํƒœ๋ฐ” ํ‘œ๋Š” ์ž ๊ธˆ ์นธ์˜ ๊ฐ’ ์ถœ์ฒ˜๋งŒ ์ ๊ณ  ๊ฐฑ์‹  ์‹œ์ ์„ ๊ทœ์ •ํ•˜์ง€ ์•Š๋Š”๋‹ค. ์ˆœ์„œ๊ฐ€ ์—†์œผ๋ฉด โ“(ํ‘œ์‹œ ์ˆ˜ = ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ ์‹ค์ œ ํฌ๊ธฐ)ยทโ“‘(์Šค์œ• ์ „ ๋ฏธ๋ Œ๋”)๋ฅผ ๊ธฐ๊ณ„์ ์œผ๋กœ ํŒ์ •ํ•  ์ˆ˜ ์—†๋‹ค.
  • Options:
    1. ์Šค์œ• โ†’ ์ฒซ ๋ Œ๋”. ์Šค์œ• ์™„๋ฃŒ ์ „์—๋Š” ์ž ๊ธˆ ์นธ์„ ๋ Œ๋”ํ•˜์ง€ ์•Š๋Š”๋‹ค
    2. ์Šค์œ• โ†’ ์ฒซ ๋ Œ๋”์ด๋˜, ์Šค์œ• ์ „์—๋Š” 0 ์„ ๊ทธ๋ฆฐ๋‹ค
    3. ์ฒซ ๋ Œ๋” โ†’ ์Šค์œ•. ์Šค์œ•์ด ๋๋‚˜๋ฉด ๊ฐ’์„ ๊ฐฑ์‹ ํ•œ๋‹ค
  • Decision: ์˜ต์…˜ 1. ํŒ์ • ์ˆ ์–ด๋Š” EditLockRegistry.startupSweepCompleted ์ด๋ฉฐ, false ์ธ ๋™์•ˆ S-01b ๋Š” ์ž ๊ธˆ ์นธ์„ ๊ทธ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค.
  • Rationale: ์˜ต์…˜ 3 ์€ ์œ ๋ น ์ž ๊ธˆ์„ ํ™”๋ฉด์— ๋„์šด๋‹ค โ€” ๋””์Šคํฌ์— ๋‚จ์€ ๋ฆฌ์Šค๊ฐ€ ๊ทธ๋Œ€๋กœ ใ€Œ์ž ๊ธด ํŒŒ์ผ N๊ฐœใ€๋กœ ํ‘œ์‹œ๋˜๊ณ , ๊ทธ๊ฒƒ์€ AC-18 ์ด ์—†์• ๋ ค๋Š” ์ƒํƒœ๊ฐ€ ์‚ฌ์šฉ์ž์—๊ฒŒ ๋„๋‹ฌํ•œ ๊ฒƒ์ด๋‹ค. ์ด ํ•œ ๊ฐ€์ง€๋กœ ํƒˆ๋ฝํ•œ๋‹ค. ์˜ต์…˜ 2 ๋„ ๋‹ต์ด ์•„๋‹ˆ๋‹ค โ€” 0 ์€ ใ€Œ์ž ๊ธด ํŒŒ์ผ์ด ์—†๋‹คใ€๋Š” ์‚ฌ์‹ค ์ฃผ์žฅ์ธ๋ฐ ์Šค์œ• ์ „์—๋Š” ๊ทธ ๊ฐ’์ด ํ™•์ •๋˜์ง€ ์•Š์•˜๋‹ค. ux-spec ยง3.2 ๊ฐ€ ์‹คํŒจ ์‚ฌ์œ ์— ๋Œ€ํ•ด ์„ธ์šด ๊ทœ์น™(ใ€Œ๋ฌธ์žฅ์„ ์ง€์–ด๋‚ด์ง€ ์•Š๋Š”๋‹ค โ€” ๋ชจ๋ฅด๋ฉด ์ž๋ฆฌํ‘œ์‹œ์žใ€)๊ณผ ๊ฐ™์€ ๋…ผ๋ฆฌ์ด๋ฉฐ, ์—ฌ๊ธฐ์„œ ์ž๋ฆฌํ‘œ์‹œ์ž์— ํ•ด๋‹นํ•˜๋Š” ๊ฒƒ์ด ์นธ์˜ ๋ถ€์žฌ๋‹ค. ์˜ต์…˜ 1 ์€ ๊ตฌํ˜„ ๋น„์šฉ๋„ ์—†๋‹ค: ์Šค์œ•์€ ์ด๋ฏธ ์‹œ์ž‘ ํ›…(WorkspaceRecovery.runOnStartup) 3๋‹จ๊ณ„์ด๊ณ , ์…ธ์— ํ•„์š”ํ•œ ๊ฒƒ์€ ํŒ์ • ์ˆ ์–ด ํ•˜๋‚˜๋ฟ์ด๋‹ค.
  • Impact: core EditLockRegistry.startupSweepCompleted ์‹ ์„ค ยท workspace FileEditLockRegistry ๊ฐ€ discardPersistedLeases ์™„๋ฃŒ ์‹œ ๊ทธ ๊ฐ’์„ ์„ธ์šด๋‹ค(๋˜๋Œ์•„๊ฐ€์ง€ ์•Š๋Š”๋‹ค) ยท ux-spec ยง2.4 ์ž ๊ธˆ ์นธ ํ–‰๊ณผ ยง10 S-01b ์— ๋ Œ๋” ์กฐ๊ฑด ๋ช…์‹œ ยท flow FP-408ยทI-7 ํ•ด์†Œ.
  • โš ๏ธ ์ด ๊ฒฐ์ •์ด ๋‹ซ์ง€ ์•Š๋Š” ๊ฒƒ: ใ€Œ์ฒซ ํ”„๋ ˆ์ž„ใ€์€ ๋ Œ๋” ๊ณ„์ธต์˜ ์‚ฌ๊ฑด์ด๊ณ  ์ด ๋ฆฌํฌ์—๋Š” ์•„์ง ์…ธ์ด ์—†๋‹ค(coreยทworkspace ๋‘˜๋ฟ, CocodeStatusBar grep 0๊ฑด). ๊ทธ๋ž˜์„œ #78 ์ด ๋‹จ์–ธํ•˜๋Š” ๊ฒƒ์€ ๋ฐ์ดํ„ฐ ๊ณ„์•ฝ์ด๋‹ค โ€” ์ˆ ์–ด๊ฐ€ true ์ธ ๋’ค leases.length ๊ฐ€ ์‹ค์ œ ํฌ๊ธฐ์™€ ๊ฐ™๊ณ , false ์ธ ๋™์•ˆ ๊ทธ๋ฆด ๊ฐ’์ด ์—†๋‹ค๋Š” ๊ฒƒ. ๋ Œ๋” ์ˆœ์„œ ์ž์ฒด์˜ ์‹ค๊ธฐ๊ธฐ ๊ฒ€์ฆ์€ ์…ธ Epic ์†Œ๊ด€์ด๋ฉฐ, ์…ธ์€ ์ด ์ˆ ์–ด๋ฅผ ์ง€ํ‚ค๊ธฐ๋งŒ ํ•˜๋ฉด ๋œ๋‹ค.
  • ํ•จ๊ป˜ ๋‚จ๊ธด ๋ฏธ๊ฒฐ: ใ€Œ์žฌ๊ธฐ๋™ ํ›„ ๊ธฐ์กด DelegatedTask ๊ฐ€ ์ด์–ด์„œ ์‹คํ–‰๋˜๋Š”์ง€ใ€๋Š” ์–ด๋А ๋ฌธ์„œ๋„ ๊ทœ์ •ํ•˜์ง€ ์•Š๋Š”๋‹ค(#78 ์ธ์ˆ˜์กฐ๊ฑด 2 ๊ฐ€ ํ™•์ธํ•œ grep ๊ฒฐ๊ณผ ๊ทธ๋Œ€๋กœ โ€” ์žฌ์‹œ์ž‘|์žฌ๊ธฐ๋™ ํžˆํŠธ๋Š” arch:349ยท:394, flow:205ยท:277 ๋ฟ). #78 ์€ ๊ทธ ์ „์ œ๋ฅผ ์“ฐ์ง€ ์•Š๊ณ  ใ€Œ์ƒˆ๋กœ ์‹œ์ž‘๋œ ๋‘ ์ž‘์—…ใ€์œผ๋กœ๋งŒ ๋ฐฐํƒ€๋ฅผ ํŒ์ •ํ–ˆ๋‹ค. ์ž‘์—… ์žฌ๊ฐœ ์—ฌ๋ถ€๋Š” ๋ฏธ์ • โ€” ๊ฒฐ์ • ํ•„์š”(ํŒ์ • ์ฃผ์ฒด: Design)๋กœ ๋‚จ๋Š”๋‹ค.
  • Source: #78

D-049: ์Šค์บํด๋”ฉ "์ง„ํ–‰ ์ค‘ ์‹คํŒจ" = ์ฒซ ์Šคํ…Œ์ด์ง• ์“ฐ๊ธฐ ~ ์ปค๋ฐ‹ ์™„๋ฃŒ ์ง์ „์˜ ๋ชจ๋“  ๋น„์ •์ƒ ์ข…๋ฃŒ โ€” ์›์ธ์ด ์•„๋‹ˆ๋ผ ์œ„์น˜๋กœ ๊ฐ€๋ฅธ๋‹ค (#41)

๐Ÿ”ข ๋ฒˆํ˜ธ ์žฌ๋ฐฐ์ •(2026-09-13) โ€” ์ด ํ•ญ๋ชฉ์€ epic/33 ์—์„œ D-045 ๋กœ ๋ฐœ๊ธ‰๋์œผ๋‚˜, ๊ฐ™์€ ๋ฒˆํ˜ธ๋ฅผ project/2 ์˜ Epic #74(edit_locks)๊ฐ€ ๋จผ์ € ๊ฐ€์ ธ๊ฐ”๋‹ค(PR #206). Epic #33 ์„ project/2 ์— ํ•ฉ์น  ๋•Œ D-049 ๋กœ ์žฌ๋ฐฐ์ •ํ–ˆ๋‹ค โ€” #41 ์˜ PRยท์ฝ”๋ฉ˜ํŠธ์™€ ์ปค๋ฐ‹ ๋ฉ”์‹œ์ง€์— ๋‚จ์€ ์˜› ๋ฒˆํ˜ธ D-045 ๋Š” ์ด ํ•ญ๋ชฉ์„ ๊ฐ€๋ฆฌํ‚จ๋‹ค.

  • Date: 2026-09-12

  • Context: ์ด์Šˆ #41(spike). FR-102/AC-13/๋ถˆ๋ณ€์‹ 3 ์€ "์ง„ํ–‰ ์ค‘ ์‹คํŒจํ•˜๋ฉด ๋ถ€๋ถ„ ์ƒ์„ฑ๋œ ํŒŒ์ผ์ด ์ „๋Ÿ‰ ์ œ๊ฑฐ๋œ๋‹ค"๋Š” ๊ฒฐ๊ณผ๋งŒ ๊ทœ์ •ํ•˜๊ณ  ๋ฌด์—‡์ด "์ง„ํ–‰ ์ค‘ ์‹คํŒจ"์ธ์ง€๋Š” ๊ทœ์ •ํ•˜์ง€ ์•Š๋Š”๋‹ค(PRD 303ํ–‰ ใ€ŒํŒ์ • ๋ฏธํ™•์ • 2ใ€ ยท 449ํ–‰ ํ๋ฆ„ 1 ๋ฏธ๊ฒฐ B ยท 643ํ–‰ D-16 ยท architecture ยง9 ๋ฏธ๊ฒฐ 15). PRD ๋Š” ํ›„๋ณด 4์ข…(brick ํ›… ๋น„์ •์ƒ ์ข…๋ฃŒ / ํŒŒ์ผ ์“ฐ๊ธฐ ์˜ค๋ฅ˜ / ๋ณ€์ˆ˜ ๊ฒ€์ฆ ์‹คํŒจ / ์‚ฌ์šฉ์ž ์ทจ์†Œ)๋งŒ ์—ด๊ฑฐํ–ˆ๋‹ค. ํŠธ๋ฆฌ๊ฑฐ๊ฐ€ ์—†์œผ๋ฉด DD-13a 3๋ฒˆ์˜ "์‹คํŒจ ์‹œ ์Šคํ…Œ์ด์ง• ์ „์ฒด ์‚ญ์ œ"๋ฅผ ๊ตฌํ˜„ํ•  ์ˆ˜ ์—†๋‹ค.

  • Options:

    1. ์›์ธ ์—ด๊ฑฐ๋กœ ์ •์˜ โ€” ํ›„๋ณด 4์ข… ์ค‘ ์–ด๋””๊นŒ์ง€๊ฐ€ ์‹คํŒจ์ธ์ง€ ํƒ์ผํ•œ๋‹ค. ๋ฌธ์ œ: ๊ฐ™์€ ์›์ธ์ด ์‹œ์ ์— ๋”ฐ๋ผ ๋‹ค๋ฅธ ๊ฒฐ๊ณผ๋ฅผ ๋‚ณ๋Š”๋‹ค(๋ณ€์ˆ˜ ๊ฒ€์ฆ ์‹คํŒจ๋Š” ์ƒ์„ฑ๊ธฐ ๊ธฐ๋™ ์ „์ด๋ฉด ์ง€์šธ ๊ฒƒ์ด ์—†๊ณ , ํ›…์ด ์‹คํ–‰ ์ค‘ ๊ฒ€์ฆ์— ์‹คํŒจํ•˜๋ฉด ์Šคํ…Œ์ด์ง•์ด ์ด๋ฏธ ์žˆ๋‹ค). ์—ด๊ฑฐ๋Š” ๊ทธ ์ฐจ์ด๋ฅผ ํ‘œํ˜„ํ•˜์ง€ ๋ชปํ•˜๊ณ , ์ƒˆ ์›์ธ์ด ์ƒ๊ธธ ๋•Œ๋งˆ๋‹ค ์ •์˜๋ฅผ ๊ณ ์ณ์•ผ ํ•œ๋‹ค.
    2. ์œ„์น˜(๊ตฌ๊ฐ„)๋กœ ์ •์˜ โ€” DD-13a ๊ฐ€ ์ด๋ฏธ ์Šคํ…Œ์ด์ง• โ†’ ํ›… โ†’ ์ปค๋ฐ‹์˜ 3๊ตฌ๊ฐ„์„ ์„ธ์› ์œผ๋ฏ€๋กœ, ๊ทธ ๊ตฌ๊ฐ„ ๊ฒฝ๊ณ„๋กœ ๊ฐ€๋ฅธ๋‹ค. ํ›„๋ณด 4์ข…์€ ์—ด๊ฑฐ๊ฐ€ ์•„๋‹ˆ๋ผ ๊ตฌ๊ฐ„์— ๋งคํ•‘๋œ๋‹ค.
    3. ๊ณ„์† ๋ฏธ๊ฒฐ โ€” architecture ยง4.6 ํ•ญ๋ชฉ 4 ์˜ ์ž„์‹œ ๊ทœ์น™("์ปค๋ฐ‹ ๋‹จ๊ณ„ ์ด์ „์˜ ๋ชจ๋“  ๋น„์ •์ƒ ์ข…๋ฃŒ")์„ ๊ทธ๋Œ€๋กœ ๋‘”๋‹ค. ํ•˜ํ•œ์ด ์—†์–ด "์ง€์šธ ์Šคํ…Œ์ด์ง•์ด ์—†๋Š”๋ฐ ์‹คํŒจ๋กœ ํ‘œ์‹œ"ํ•˜๋Š” ๊ฒฝ๋กœ๊ฐ€ ๋‚จ๋Š”๋‹ค.
  • Decision: ์˜ต์…˜ 2 โ€” ์œ„์น˜๋กœ ๊ฐ€๋ฅธ๋‹ค. "์ง„ํ–‰ ์ค‘ ์‹คํŒจ"๋Š” ๋ฐ˜์—ด๋ฆฐ ๊ตฌ๊ฐ„ [์ฒซ ์Šคํ…Œ์ด์ง• ์“ฐ๊ธฐ, ์ปค๋ฐ‹ ์™„๋ฃŒ) ์•ˆ์—์„œ ์ผ์–ด๋‚œ ๋ชจ๋“  ๋น„์ •์ƒ ์ข…๋ฃŒ์ด๋ฉฐ, ์›์ธ์„ ๋ฌป์ง€ ์•Š๋Š”๋‹ค. ๊ตฌ๊ฐ„ ๋ฐ–์˜ ๋‘ ๊ฒฝ์šฐ๋Š” ์‹คํŒจ๊ฐ€ ์•„๋‹ˆ๋ผ ๊ฐ๊ฐ ๋‹ค๋ฅธ ํŒ์ •์ด๋‹ค:

    ๊ตฌ๊ฐ„ ํŒ์ • ๊ด€์ธก ๊ฐ€๋Šฅํ•œ ๊ฒฐ๊ณผ
    ์ฒซ ์Šคํ…Œ์ด์ง• ์“ฐ๊ธฐ ์ด์ „ ์ฐฉ์ˆ˜ ์ „ ๊ฑฐ๋ถ€ ์Šคํ…Œ์ด์ง•์ด ์—†๋‹ค. ์ง€์šธ ๊ฒƒ๋„ ์—†๊ณ  ์›Œํฌ์ŠคํŽ˜์ด์Šค๋„ ์—†๋‹ค โ€” AC-13 ๋ถˆ๋ณ€์‹์ด ์ž๋ช…ํ•˜๊ฒŒ ์„ฑ๋ฆฝ
    [์ฒซ ์“ฐ๊ธฐ, ์ปค๋ฐ‹ ์™„๋ฃŒ) ์ง„ํ–‰ ์ค‘ ์‹คํŒจ ์Šคํ…Œ์ด์ง• ๋””๋ ‰ํ„ฐ๋ฆฌ ์ „์ฒด ์‚ญ์ œ โ†’ ์ตœ์ข… ์œ„์น˜์— ์•„๋ฌด๊ฒƒ๋„ ์—†์Œ(DD-13a 3)
    ์ปค๋ฐ‹ ์™„๋ฃŒ ์ดํ›„ ์Šค์บํด๋”ฉ ์„ฑ๊ณต ์ดํ›„์˜ ์‹คํŒจ๋Š” ์Šค์บํด๋”ฉ์ด ์•„๋‹ˆ๋ผ ์›Œํฌ์ŠคํŽ˜์ด์Šค ์—ฐ์‚ฐ์ด๋ฉฐ ๊ฒŒ์ดํŠธ๋ฅผ ๊ฒฝ์œ ํ•œ๋‹ค

    PRD ํ›„๋ณด 4์ข…์€ ์ด ๊ตฌ๊ฐ„์— ๋‹ค์Œ๊ณผ ๊ฐ™์ด ๋งคํ•‘๋œ๋‹ค โ€” ์…‹์€ ์œ„์น˜๊ฐ€ ๊ณ ์ •์ด๊ณ  ๋‘˜์€ ์œ„์น˜์— ๋”ฐ๋ผ ๊ฐˆ๋ฆฐ๋‹ค:

    ํ›„๋ณด ์œ„์น˜ ํŒ์ •
    brick ํ›… ๋น„์ •์ƒ ์ข…๋ฃŒ ํ›… ๊ตฌ๊ฐ„(์ฒซ ์“ฐ๊ธฐ ์ดํ›„) ์ง„ํ–‰ ์ค‘ ์‹คํŒจ
    ํŒŒ์ผ ์“ฐ๊ธฐ ์˜ค๋ฅ˜ ์Šคํ…Œ์ด์ง• ์“ฐ๊ธฐ ๊ตฌ๊ฐ„ ์ง„ํ–‰ ์ค‘ ์‹คํŒจ
    ํ›…์ด ์Šคํ…Œ์ด์ง• ๋ฐ–์„ ์“ฐ๋ ค๋‹ค ๋Ÿฐ์ฒ˜์— ์ฐจ๋‹จ๋จ(ยง4.6-2) ํ›… ๊ตฌ๊ฐ„ ์ง„ํ–‰ ์ค‘ ์‹คํŒจ
    ๋ณ€์ˆ˜ ๊ฒ€์ฆ ์‹คํŒจ ์ƒ์„ฑ๊ธฐ ๊ธฐ๋™ ์ „์ด๋ฉด ์ฒซ ์“ฐ๊ธฐ ์ด์ „ ยท ํ›…์˜ ์‹คํ–‰ ์ค‘ ๊ฒ€์ฆ์ด๋ฉด ์ดํ›„ ๊ฐˆ๋ฆฐ๋‹ค โ€” ์œ„์น˜๊ฐ€ ์ •ํ•œ๋‹ค
    ์‚ฌ์šฉ์ž ์ทจ์†Œ ์ทจ์†Œ๋ฅผ ๋ˆ„๋ฅธ ์‹œ์  ๊ฐˆ๋ฆฐ๋‹ค โ€” ์ฒซ ์“ฐ๊ธฐ ์ดํ›„๋ฉด ์ง„ํ–‰ ์ค‘ ์‹คํŒจ

    ์ปค๋ฐ‹(๋‹จ์ผ ๋””๋ ‰ํ„ฐ๋ฆฌ ์ด๋™) ์ž์ฒด์˜ ์‹คํŒจ๋Š” ๊ตฌ๊ฐ„ ์•ˆ์ด๋‹ค โ€” ์ด๋™์ด ์›์ž์ ์ด๋ฏ€๋กœ ์ตœ์ข… ์œ„์น˜์—๋Š” ์•„๋ฌด๊ฒƒ๋„ ์—†๊ณ , ์Šคํ…Œ์ด์ง•์„ ์‚ญ์ œํ•œ๋‹ค.

  • Rationale: ์›์ธ ์—ด๊ฑฐ(โ‘ )๋Š” "๊ฐ™์€ ์›์ธยท๋‹ค๋ฅธ ์‹œ์ "์„ ํ‘œํ˜„ํ•˜์ง€ ๋ชปํ•˜๊ณ  ํ™•์žฅํ•  ๋•Œ๋งˆ๋‹ค ์ •์˜๋ฅผ ๊ณ ์ณ์•ผ ํ•˜๋Š” ๋ฐ˜๋ฉด, ์œ„์น˜ ํŒ์ •์€ ๊ตฌํ˜„์ด ์ด๋ฏธ ์•„๋Š” ์‚ฌ์‹ค๋งŒ ์“ด๋‹ค โ€” ์—”์ง„์€ ์ž๊ธฐ๊ฐ€ ์ฒซ ์“ฐ๊ธฐ๋ฅผ ํ–ˆ๋Š”์ง€์™€ ์ปค๋ฐ‹์„ ๋งˆ์ณค๋Š”์ง€๋ฅผ ํŒ์ • ์—†์ด ์•ˆ๋‹ค(P2: ํŒ์ •ํ•˜์ง€ ์•Š๋Š”๋‹ค). โ‘ข์˜ ์ž„์‹œ ๊ทœ์น™์€ ์ƒํ•œ("์ปค๋ฐ‹ ์ด์ „")๋งŒ ์žˆ๊ณ  ํ•˜ํ•œ์ด ์—†์–ด, ๋ณ€์ˆ˜ ๊ฒ€์ฆ์ด ์ƒ์„ฑ๊ธฐ ๊ธฐ๋™ ์ „์— ์‹คํŒจํ•ด๋„ "์‹คํŒจ"๋กœ ํ‘œ์‹œํ•˜๊ฒŒ ๋œ๋‹ค โ€” ์‚ฌ์šฉ์ž๊ฐ€ ํ•  ์ผ์€ "์žฌ์‹œ๋„"๊ฐ€ ์•„๋‹ˆ๋ผ "๋ณ€์ˆ˜ ๋‹ค์‹œ ์ž…๋ ฅ"์ธ๋ฐ ๊ฐ™์€ ํ™”๋ฉด์„ ๋ณด๊ฒŒ ๋œ๋‹ค. ์ด ๊ฒฐ์ •์€ ๊ทธ ์ž„์‹œ ๊ทœ์น™์„ ๋’ค์ง‘์ง€ ์•Š๊ณ  ํ•˜ํ•œ์„ ๋ถ™์—ฌ ํ™•์ •ํ•œ ๊ฒƒ์ด๋‹ค.

  • Impact:

    • docs/architecture-cocode.md ยง4.6 ํ•ญ๋ชฉ 4 ์˜ ์ž„์‹œ ๊ทœ์น™์ด ์ด ๊ฒฐ์ •์œผ๋กœ ๋Œ€์ฒด๋˜๊ณ  ยง9 ๋ฏธ๊ฒฐ 15 ํ–‰์ด ์ œ๊ฑฐ๋œ๋‹ค.
    • docs/prd-cocode.md ใ€ŒํŒ์ • ๋ฏธํ™•์ • 2 โ€” ์‹คํŒจ์˜ ์ •์˜ใ€ ๊ฒฝ๊ณ  ๋ธ”๋ก๊ณผ ํ๋ฆ„ 1 ๋ฏธ๊ฒฐ B ๊ฐ€ ํ•ด์†Œ๋˜๊ณ  ยง4 D-16 ํ–‰์ด ์ด ๊ฒฐ์ • ์ฐธ์กฐ๋กœ ๋ฐ”๋€๋‹ค.
    • docs/ux-spec-cocode.md UX-D-23 ์ด ์ œ์‹œ ํ˜•ํƒœ๋ฅผ ์ •ํ•˜๊ณ  ยง11 ๋ฏธ๊ฒฐ ํ‘œ์˜ ใ€Œ์Šค์บํด๋”ฉ ์‹คํŒจ ์‚ฌ์œ  ์ œ์‹œ ํ˜•ํƒœ(S-14)ใ€ ํ–‰์ด ์ œ๊ฑฐ๋œ๋‹ค(PRD ํ๋ฆ„ 1 ๋ฏธ๊ฒฐ A ๋„ ํ•จ๊ป˜ ๋‹ซํžŒ๋‹ค).
    • #40(brick ์Šค์บํด๋”ฉ ์›์ž์„ฑ)์˜ ๋กค๋ฐฑ ํŠธ๋ฆฌ๊ฑฐ๊ฐ€ ์ด ๊ตฌ๊ฐ„ ํŒ์ •์„ ๊ทธ๋Œ€๋กœ ๊ตฌํ˜„ํ•œ๋‹ค โ€” BrickEngine ์€ ์ฒซ ์Šคํ…Œ์ด์ง• ์“ฐ๊ธฐ ์—ฌ๋ถ€๋ฅผ ์ƒํƒœ๋กœ ๋“ค๊ณ  ์žˆ์–ด์•ผ ํ•œ๋‹ค.
  • Source: #41 (ํŒ์ • ์ฃผ์ฒด Design โ€” PRD ยง4 D-16 ํ–‰ ยท architecture ยง9 ๋ฏธ๊ฒฐ 15 '๋ˆ„๊ฐ€' ์—ด)


D-050: ์ƒŒ๋“œ๋ฐ•์Šค ์ •์ฑ… ๋ฏธ๊ฒฐ โ€” ์˜์กด์„ฑ ํ˜ธ์ŠคํŠธ ์ถ”์ถœยท์žฌ์ง€์ • ์—†๋Š” ๊ฒฝ๋กœ 2์ข… ํ™•์ •, ํ—ˆ์šฉ ํ˜ธ์ŠคํŠธ ๊ฐœ์ˆ˜๋Š” ์ •๋ณธํ™”ํ•˜์ง€ ์•Š๋Š”๋‹ค (#39)

๐Ÿ”ข ๋ฒˆํ˜ธ ์žฌ๋ฐฐ์ •(2026-09-13) โ€” ์ด ํ•ญ๋ชฉ์€ epic/33 ์—์„œ D-046 ๋กœ ๋ฐœ๊ธ‰๋์œผ๋‚˜, ๊ฐ™์€ ๋ฒˆํ˜ธ๋ฅผ project/2 ์˜ Epic #74(edit_locks)๊ฐ€ ๋จผ์ € ๊ฐ€์ ธ๊ฐ”๋‹ค(PR #206). Epic #33 ์„ project/2 ์— ํ•ฉ์น  ๋•Œ D-050 ๋กœ ์žฌ๋ฐฐ์ •ํ–ˆ๋‹ค โ€” #39 ์˜ PRยท์ฝ”๋ฉ˜ํŠธ์™€ ์ปค๋ฐ‹ ๋ฉ”์‹œ์ง€์— ๋‚จ์€ ์˜› ๋ฒˆํ˜ธ D-046 ๋Š” ์ด ํ•ญ๋ชฉ์„ ๊ฐ€๋ฆฌํ‚จ๋‹ค.

  • Date: 2026-09-12
  • Context: ์ด์Šˆ #39(spike). architecture ยง9 ๋ฏธ๊ฒฐ 10(์˜์กด์„ฑ ํ˜ธ์ŠคํŠธ ์ถ”์ถœ ์•Œ๊ณ ๋ฆฌ์ฆ˜) ยท 11(ํ—ˆ์šฉ ํ˜ธ์ŠคํŠธ ๊ฐœ์ˆ˜ ์ •๋ณธ) ยท 16(ํƒ€๊ฒŸ ํ”Œ๋žซํผ ํŒ์ • ์ž…๋ ฅ)๊ณผ PRD D-20(์žฌ์ง€์ • ๋ณ€์ˆ˜ ์—†๋Š” ๊ฒฝ๋กœ 2์ข…)์ด ๋ฏธ๊ฒฐ์ด๋ผ ๋‘ ๊ตฌํ˜„์ด ์„œ๋กœ ๋‹ค๋ฅธ ํ—ˆ์šฉ ์ง‘ํ•ฉ์„ ๋งŒ๋“ค ์ˆ˜ ์žˆ์—ˆ๋‹ค. ์ด ๊ฒฐ์ •์€ ๊ทธ์ค‘ ๊ธฐ๊ณ„์ ์œผ๋กœ ํŒ์ • ๊ฐ€๋Šฅํ•œ ๊ฒƒ์„ ๋‹ซ๊ณ , ์˜ค๋„ˆ ํŒ๋‹จ์ด ํ•„์š”ํ•œ ๊ฒƒ์„ ๊ทธ๋Œ€๋กœ ๋‚จ๊ธด๋‹ค.
  • Options: ํ•ญ๋ชฉ๋งˆ๋‹ค ๋‹ค๋ฅด๋‹ค โ€” ์•„๋ž˜ ๊ฐ ์ ˆ์— ์ ๋Š”๋‹ค.

โ‘  ์˜์กด์„ฑ ํ˜ธ์ŠคํŠธ ์ถ”์ถœ ์•Œ๊ณ ๋ฆฌ์ฆ˜ (ยง9 ๋ฏธ๊ฒฐ 10 ยท PRD D-6) โ€” ํ™•์ •

  • ํŒ์ • ์ฃผ์ฒด: Planning (ยง9 '๋ˆ„๊ฐ€' ์—ด ๊ทธ๋Œ€๋กœ)
  • Decision: ์„ธ ์ถ•์„ ์ด๋ ‡๊ฒŒ ์ •ํ•œ๋‹ค.
    • ๋งค๋‹ˆํŽ˜์ŠคํŠธ ๋ฒ”์œ„ = lock ์šฐ์„ . pubspec.lockยทPodfile.lock ์ด ์žˆ์œผ๋ฉด ๊ทธ๊ฒƒ์„ ์ฝ๊ณ , ์—†์œผ๋ฉด pubspec.yaml + dependency_overrides ์™€ Podfile ์„ ์ฝ๋Š”๋‹ค. lock ์€ ์‹ค์ œ๋กœ ํ•ด์„๋œ ๊ฒฐ๊ณผ๋ฅผ ๋‹ด์œผ๋ฏ€๋กœ override ์™€ ์ „์ด ์˜์กด์„ฑ์ด ์ด๋ฏธ ๋ฐ˜์˜๋ผ ์žˆ๋‹ค โ€” ๋งค๋‹ˆํŽ˜์ŠคํŠธ๋งŒ ๋ณด๋ฉด ๊ทธ ๋‘˜์„ ๋†“์น˜๊ณ , ๋†“์นœ ํ˜ธ์ŠคํŠธ๋Š” fail-closed ๋กœ ๋นŒ๋“œ๋ฅผ ๋ฉˆ์ถ˜๋‹ค(PRD NFR-C).
    • ์ „์ด ์˜์กด์„ฑ = ํฌํ•จํ•œ๋‹ค. ยง2.5 ๊ฐ€ ใ€Œ๋‹ซํžŒ ์ง‘ํ•ฉ์œผ๋กœ ์„ ์–ธํ•  ์ˆ˜ ์—†๋Š” ๋ถ€๋ถ„ใ€์œผ๋กœ ์ง€๋ชฉํ•œ ๊ฒƒ์ด ์ •ํ™•ํžˆ ์ „์ด git: ์˜์กด์„ฑ(gitlabยทbitbucketยท์‚ฌ๋‚ด ํ˜ธ์ŠคํŠธ)์ด๋‹ค. ์ œ์™ธํ•˜๋ฉด ๊ทธ ํ˜ธ์ŠคํŠธ๊ฐ€ ๋ชฉ๋ก์— ์˜์˜ ๋“ค์–ด์˜ค์ง€ ์•Š๋Š”๋‹ค.
    • ์žฌ๊ณ„์‚ฐ ์‹œ์  = ์›Œํฌ์ŠคํŽ˜์ด์Šค ์—ด๊ธฐ ์‹œ + ๋งค๋‹ˆํŽ˜์ŠคํŠธยทlock ํŒŒ์ผ์ด ๊ฒŒ์ดํŠธ๋ฅผ ์ง€๋‚˜ ๋ฐ”๋€ ์งํ›„. ๋งค ๊ธฐ๋™๋งˆ๋‹ค ๋‹ค์‹œ ๊ณ„์‚ฐํ•˜์ง€ ์•Š๊ณ (๋น„์šฉ), ์˜์›ํžˆ ๊ณ ์ •ํ•˜์ง€๋„ ์•Š๋Š”๋‹ค(๋‚ก์Œ). ๊ฒŒ์ดํŠธ๊ฐ€ ์œ ์ผํ•œ ์“ฐ๊ธฐ ์ง€์ ์ด๋ฏ€๋กœ(C-02) ๊ทธ ํŒŒ์ผ๋“ค์˜ ๋ณ€๊ฒฝ ์‹œ์ ์„ ์•„๋Š” ๊ณณ์ด ์ด๋ฏธ ์žˆ๋‹ค โ€” ๋ณ„๋„ ๊ฐ์‹œ์ž๊ฐ€ ํ•„์š” ์—†๋‹ค.
    • ๊ณ„์‚ฐ๋œ ์ง‘ํ•ฉ์€ DD-19 ์˜ ๊ฒฝ๋กœ ํ•ด์„๊ณผ ๊ฐ™์ด ์„ธ์…˜ ๊ฐ’์œผ๋กœ ๊ณ ์ •ํ•œ๋‹ค.
  • Rationale: ์„ธ ์ถ• ๋ชจ๋‘ ใ€Œ๋” ๋„“๊ฒŒ ์žก์•„ fail-open ๋˜๋Š” ์ชฝใ€๊ณผ ใ€Œ์ข๊ฒŒ ์žก์•„ ๋นŒ๋“œ๋ฅผ ๋ฉˆ์ถ”๋Š” ์ชฝใ€์˜ ์„ ํƒ์ธ๋ฐ, NFR-C ๊ฐ€ fail-closed ๋ฅผ ์š”๊ตฌํ•˜๋ฏ€๋กœ ๋†“์น˜์ง€ ์•Š๋Š” ์ชฝ(lock ยท ์ „์ด ํฌํ•จ)์„ ํƒํ•˜๋˜ ์žฌ๊ณ„์‚ฐ ์‹œ์ ์„ ๊ฒŒ์ดํŠธ์— ๋ถ™์—ฌ ๋‚ก์Œ์„ ๋ง‰๋Š”๋‹ค.

โ‘ก ์žฌ์ง€์ • ๋ณ€์ˆ˜๊ฐ€ ์—†๋Š” ๊ฒฝ๋กœ 2์ข… (PRD D-20) โ€” ํ™•์ •: DD-19 ์ œ์•ˆ ์ฑ„ํƒ

  • ํŒ์ • ์ฃผ์ฒด: Design โ€” ยง9 ๋ฏธ๊ฒฐ ํ‘œ์— ๋Œ€์‘ ํ–‰์ด ์—†์–ด ์Šน๊ณ„ํ•  '๋ˆ„๊ฐ€' ๊ฐ’์ด ์—†์—ˆ๋‹ค(์ด์Šˆ #39 ์˜ ์‹ค์ธก ๊ทธ๋Œ€๋กœ). ์ด ํ•ญ๋ชฉ์€ architecture ยง5.4 DD-19 ๊ฐ€ ๊ทœ์น™์„ ์ œ์•ˆํ•œ ์ž๋ฆฌ์ด๋ฏ€๋กœ ๊ทธ ๋ฌธ์„œ์˜ ํŒ์ • ์ฃผ์ฒด(Design)๋ฅผ ๋”ฐ๋ฅธ๋‹ค. ์ด ๊ฒฐ์ •์œผ๋กœ ยง9 ์— ์ƒˆ ํ–‰์„ ๋งŒ๋“ค์ง€ ์•Š๋Š”๋‹ค โ€” ๋‹ซํžŒ ํ•ญ๋ชฉ์— ๋ฏธ๊ฒฐ ํ–‰์„ ์ถ”๊ฐ€ํ•˜๋Š” ๊ฒƒ์ด๊ธฐ ๋•Œ๋ฌธ์ด๋‹ค.
  • Decision: DD-19 ์˜ ์ œ์•ˆ์„ ๊ทธ๋Œ€๋กœ ์ฑ„ํƒํ•œ๋‹ค โ€” $FLUTTER_ROOT/bin/cache ์™€ Xcode DerivedData ๋Š” ์‹คํ–‰ ์‹œ์ ์— ํ•ด์„ํ•ด ์„ธ์…˜ ๊ฐ’์œผ๋กœ ๊ณ ์ •ํ•˜๊ณ , ํ•ด์„์— ์‹คํŒจํ•˜๋ฉด ๊ทธ ๊ฒฝ๋กœ๋ฅผ ์˜ˆ์™ธ๋กœ ์ถ”๊ฐ€ํ•˜์ง€ ์•Š๋Š”๋‹ค(์ฐจ๋‹จ ๋ฐฉํ–ฅ).
  • Rationale: ์ด๋ฏธ #36 ์ด ๊ทธ ํ˜•ํƒœ๋กœ ๊ตฌํ˜„ํ–ˆ๊ณ (WriteExceptionResolver โ€” WritePathUnresolved ๋Š” ๋ชฉ๋ก์—์„œ ๋น ์ง„๋‹ค) ํ…Œ์ŠคํŠธ๊ฐ€ ๊ณ ์ •ํ•œ๋‹ค. ๋„“์€ ๊ธฐ๋ณธ๊ฐ’์œผ๋กœ ๋Œ€์‹  ์ฑ„์šฐ๋ฉด ์˜ˆ์™ธ๊ฐ€ ์˜๋„๋ณด๋‹ค ๋„“์–ด์ ธ AC-14 โ“ ๊ฐ€ ๋А์Šจํ•ด์ง„๋‹ค.

โ‘ข ๋ฏธ์ง€ ๋ฆฌ๋‹ค์ด๋ ‰ํŠธ ๋Œ€์ƒ (PRD D-22) โ€” ์žฌ๊ฒฐ์ •ํ•˜์ง€ ์•Š์Œ

  • ํŒ์ • ์ฃผ์ฒด: ํ•ด๋‹น ์—†์Œ
  • Decision: DD-17a ๊ฐ€ ์ด๋ฏธ ํ™•์ •ํ–ˆ๋‹ค(์ฐจ๋‹จ + fail-closed + ์‚ฌํ›„ ์‚ฌ์šฉ์ž ์ถ”๊ฐ€). DD-17 ์˜ ใ€Œ์ฒด์ธ์˜ ๋ชจ๋“  ํ˜ธ์ŠคํŠธ๋ฅผ ๊ฐ™์€ ๊ทœ์น™์œผ๋กœ ํŒ์ •ํ•˜๊ณ  '์ค‘๊ฐ„์ด๋ผ์„œ' ์˜ˆ์™ธ๋ฅผ ์ฃผ์ง€ ์•Š๋Š”๋‹คใ€๋„ ๊ทธ๋Œ€๋กœ ์Šน๊ณ„ํ•œ๋‹ค. '์ฒด์ธ์˜ ๋ชจ๋“  ํ˜ธ์ŠคํŠธ๋ฅผ ํ—ˆ์šฉ'์€ ํ—ˆ์šฉ ๋ชฉ๋ก์„ ๋ฌด๋ ฅํ™”ํ•˜๋ฏ€๋กœ ์ฑ„ํƒํ•˜์ง€ ์•Š๋Š”๋‹ค.
  • ํ™•์ธ: #35 ๊ฐ€ ๊ทธ ๊ทœ์น™์„ ๊ตฌํ˜„์œผ๋กœ ํ™•์ธํ–ˆ๋‹ค โ€” ํ”„๋ก์‹œ๊ฐ€ ๋ฆฌ๋‹ค์ด๋ ‰ํŠธ๋ฅผ ๋”ฐ๋ผ๊ฐ€์ง€ ์•Š์•„ ์ฒด์ธ์˜ ๊ฐ ํ™‰์ด ์ƒˆ ์—ฐ๊ฒฐ๋กœ ์˜ค๊ณ , ๊ทธ๋ž˜์„œ ๊ฐ๊ฐ ํŒ์ •๋œ๋‹ค(docs/architecture-cocode.md ยง5.3 ๊ตฌํ˜„ ์ฃผ์„ ยท ๋ฆฌ๋‹ค์ด๋ ‰ํŠธ ์ฒด์ธ ํ…Œ์ŠคํŠธ 2๊ฑด).

โ‘ฃ ํ—ˆ์šฉ ํ˜ธ์ŠคํŠธ ๊ฐœ์ˆ˜ ์ •๋ณธ (ยง9 ๋ฏธ๊ฒฐ 11) ยท ํƒ€๊ฒŸ ํ”Œ๋žซํผ ํŒ์ • ์ž…๋ ฅ (ยง9 ๋ฏธ๊ฒฐ 16) โ€” ์ •๋ณธํ™”ํ•˜์ง€ ์•Š๋Š”๋‹ค / ์˜ค๋„ˆ ๋ฏธ๊ฒฐ ์œ ์ง€

  • ํŒ์ • ์ฃผ์ฒด: ๊ฐœ์ˆ˜ = Planning ยท ํƒ€๊ฒŸ ํ”Œ๋žซํผ = Design (ยง9 '๋ˆ„๊ฐ€' ์—ด). ๋‘ ํ•ญ๋ชฉ ๋ชจ๋‘ ์˜ค๋„ˆ ๊ฒฐ์ • ์ด์Šˆ #109 ๊ฐ€ ์—ด๋ ค ์žˆ๋‹ค.

  • Decision (๊ฐœ์ˆ˜): ๊ฐœ์ˆ˜๋ฅผ ์ •๋ณธํ™”ํ•˜์ง€ ์•Š๋Š”๋‹ค. ๋ชฉ๋ก ์ž์ฒด๊ฐ€ SSOT ๋‹ค. ๊ทผ๊ฑฐ๋Š” ์„ ํ˜ธ๊ฐ€ ์•„๋‹ˆ๋ผ ์‹ค์ธก์ด๋‹ค โ€” #38 ์˜ 3-OS ํ”„๋กœ๋ธŒ๊ฐ€ planning-inputs ยง2.1 ํ‘œ(12ํ–‰)์— ์—†๋Š” ํ˜ธ์ŠคํŠธ api.github.com ์„ CocoaPods ๊ฒฝ๋กœ์—์„œ ์‹ค์ œ๋กœ ๊ด€์ธกํ–ˆ๋‹ค(docs/sandbox-limits-cocode.md ยง3). ์ฆ‰ 11 ๋„ 12 ๋„ ์ธก์ •๊ณผ ์–ด๊ธ‹๋‚œ๋‹ค; ๋‘ ์„ ํƒ์ง€๋Š” ์„ ํ˜ธ๋กœ ๊ณ ๋ฅด๋Š” ๊ฒƒ์ด ์•„๋‹ˆ๋ผ ์ฆ๊ฑฐ๋กœ ํƒˆ๋ฝํ–ˆ๋‹ค. ๋‚จ๋Š” ๊ฒƒ์€ #109 ์˜ ์„ธ ๋ฒˆ์งธ ์„ ํƒ์ง€ ํ•˜๋‚˜๋‹ค. ๋”ฐ๋ผ์„œ ์ธ์ˆ˜ ํŒ์ •์€ ใ€Œ๋น„์–ด ์žˆ์ง€ ์•Š๋‹คใ€ + ๋Œ€์กฐ ๊ฒ€์‚ฌ๋กœ๋งŒ ํ•˜๊ณ (์ด๋ฏธ #36 ์ด ๊ทธ๋ ‡๊ฒŒ ๊ตฌํ˜„ํ–ˆ๋‹ค), ์ฝ”๋“œยทํ…Œ์ŠคํŠธยท๋ฌธ์„œ ์–ด๋””์—๋„ ๊ฐœ์ˆ˜๋ฅผ ์“ฐ์ง€ ์•Š๋Š”๋‹ค.

  • Decision (ํƒ€๊ฒŸ ํ”Œ๋žซํผ ํŒ์ • ์ž…๋ ฅ): ์ด ๊ฒฐ์ •์ด ์ •ํ•˜์ง€ ์•Š๋Š”๋‹ค โ€” #109 ์œ ์ง€. SandboxDefaults.hostsFor(targets) ๋Š” ํƒ€๊ฒŸ ์ง‘ํ•ฉ์„ ์ธ์ž๋กœ ๋ฐ›์•„ ๊ทธ ํŒ์ •์„ ํ˜ธ์ถœ๋ถ€๋กœ ๋ฐ€์–ด๋ƒˆ๋‹ค(#36). ํŒ์ • ์ž…๋ ฅ(ํ”Œ๋žซํผ ๋””๋ ‰ํ„ฐ๋ฆฌ ์กด์žฌ / ๋นŒ๋“œ ๋ช…๋ น ์ธ์ž / ์‚ฌ์šฉ์ž ์„ค์ • / ์„ ์–ธ)์„ ๊ณ ๋ฅด๋Š” ๊ฒƒ์€ ์ œํ’ˆ ๋™์ž‘์„ ์ •ํ•˜๋Š” ์ผ์ด๋ผ ์˜ค๋„ˆ ๊ฒฐ์ •์ด ์„œ์•ผ ํ•œ๋‹ค. ๋ฏธํŒ์ • ์‹œ ๊ธฐ๋ณธ๊ฐ’์ธ ์ „ ํ”Œ๋žซํผ ํ•ฉ์ง‘ํ•ฉ์ด AC-14 ๋ฅผ ๋А์Šจํ•˜๊ฒŒ ํ•œ๋‹ค๋Š” ยง9 ๋ฏธ๊ฒฐ 16 ์˜ ๊ฒฝ๊ณ ๋Š” ๊ทธ๋Œ€๋กœ ์œ ํšจํ•˜๋‹ค.

  • โš ๏ธ ์˜ค๋„ˆ ํ™•์ธ ๋Œ€๊ธฐ: ์œ„ ๋‘ ํ•ญ๋ชฉ์€ #109 ๊ฐ€ ์ •๋ณธ์ด๋‹ค. ์ด ์ผ์ง€๋Š” โ“ ์ธก์ •์ด ์„ ํƒ์ง€ ๋‘˜์„ ํƒˆ๋ฝ์‹œ์ผฐ๋‹ค๋Š” ์‚ฌ์‹ค๊ณผ โ“‘ ๊ทธ๋™์•ˆ์˜ ์ง‘ํ–‰ ๊ทœ์น™์„ ์ ๋Š” ๊ฒƒ์ด๋ฉฐ, #109 ๋ฅผ ๋Œ€์‹  ๋‹ซ์ง€ ์•Š๋Š”๋‹ค. D-029ยทD-041ยทD-042ยทD-043 ๊ณผ ๊ฐ™์€ ใ€Œ๊ฒฐ์ • ๋Œ€๊ธฐใ€ ํ˜•์‹์ด๋‹ค.

    • ์ •์ •(2026-09-13): ๋Œ€๊ธฐ๊ฐ€ ๋๋‚ฌ๋‹ค. ์˜ค๋„ˆ๊ฐ€ #109 ์—์„œ ๋‘˜ ๋‹ค ํŒ์ •ํ–ˆ๋‹ค โ€” ๊ฐœ์ˆ˜๋Š” D-051(์ •๋ณธํ™”ํ•˜์ง€ ์•Š๋Š”๋‹ค, ๋ชฉ๋ก์ด SSOT โ€” ์ด โ‘ฃ ์˜ ์ œ์•ˆ ๊ทธ๋Œ€๋กœ ํ™•์ •), ํƒ€๊ฒŸ ํ”Œ๋žซํผ ํŒ์ • ์ž…๋ ฅ์€ D-052(์›Œํฌ์ŠคํŽ˜์ด์Šค์˜ ํ”Œ๋žซํผ ๋””๋ ‰ํ„ฐ๋ฆฌ ์กด์žฌ โ€” ์ด โ‘ฃ ๊ฐ€ ์ •ํ•˜์ง€ ์•Š๊ณ  ๋‚จ๊ธด ์ž๋ฆฌ). ์ด ํ•ญ๋ชฉ์˜ ใ€Œ๋ฏธ๊ฒฐ ์œ ์ง€ใ€๋Š” ๊ทธ ๋‘ ๋ฒˆํ˜ธ๋กœ ๋Œ€์ฒด๋๊ณ , โ‘ฃ ๊ฐ€ ์ ์€ ์ง‘ํ–‰ ๊ทœ์น™(๊ฐœ์ˆ˜๋ฅผ ์“ฐ์ง€ ์•Š๋Š”๋‹ค)์€ D-051 ์ด ์˜๊ตฌ ๊ทœ์น™์œผ๋กœ ์Šน๊ฒฉํ–ˆ๋‹ค.
  • Impact:

    • docs/architecture-cocode.md ยง9 ๋ฏธ๊ฒฐ 10 ํ–‰ ์ œ๊ฑฐ(โ‘ ๋กœ ํ™•์ •). 11ยท16 ํ–‰์€ ๋‚จ๋Š”๋‹ค โ€” #109 ์ฐธ์กฐ๋ฅผ ๋‹ฌ์•„ ๊ทธ ์ด์Šˆ๊ฐ€ ์ •๋ณธ์ž„์„ ๋ช…์‹œํ•œ๋‹ค.
    • docs/prd-cocode.md ยง4 D-6(์ถ”์ถœ ์•Œ๊ณ ๋ฆฌ์ฆ˜) ํ•ด์†Œ ยท D-20(๊ฒฝ๋กœ 2์ข…) ํ•ด์†Œ ยท D-22 ๋Š” ์žฌ๊ฒฐ์ •ํ•˜์ง€ ์•Š์Œ ํ™•์ธ.
    • docs/planning-inputs-cocode.md ยง2.5 ใ€ŒPlanning ์ด ํ™•์ •ํ•  ๊ฒƒใ€์ด โ‘ ๋กœ ์ฑ„์›Œ์ง„๋‹ค.
    • #36 ์ด ์ด๋ฏธ โ‘กโ‘ฃ์˜ ๊ตฌํ˜„ ํ˜•ํƒœ๋‹ค โ€” ์ด ๊ฒฐ์ •์ด ๊ทธ ๊ตฌํ˜„์„ ์ •๋‹นํ™”ํ•˜๋ฉฐ, ๋ฐ˜๋Œ€๋กœ ๊ตฌํ˜„์„ ๋ฐ”๊พธ์ง€ ์•Š๋Š”๋‹ค.
  • Source: #39 (ํŒ์ • ์ฃผ์ฒด๋Š” architecture ยง9 '๋ˆ„๊ฐ€' ์—ด ยท โ‘ฃ๋Š” ์˜ค๋„ˆ #109 ๋Œ€๊ธฐ)


D-051: ํ—ˆ์šฉ ํ˜ธ์ŠคํŠธ ๊ฐœ์ˆ˜๋ฅผ ์ •๋ณธํ™”ํ•˜์ง€ ์•Š๋Š”๋‹ค โ€” ๋ชฉ๋ก ์ž์ฒด๊ฐ€ ๋‹จ์ผ SSOT ์ด๊ณ  ๊ฐœ์ˆ˜๋Š” ํŒŒ์ƒ๊ฐ’์ด๋‹ค (#39 AC1)

๐Ÿ”ข ๋ฒˆํ˜ธ ์žฌ๋ฐฐ์ •(2026-09-13) โ€” ์ด ํ•ญ๋ชฉ์€ epic/33 ์—์„œ D-047 ๋กœ ๋ฐœ๊ธ‰๋์œผ๋‚˜, ๊ฐ™์€ ๋ฒˆํ˜ธ๋ฅผ project/2 ์˜ Epic #74(edit_locks)๊ฐ€ ๋จผ์ € ๊ฐ€์ ธ๊ฐ”๋‹ค(PR #206). Epic #33 ์„ project/2 ์— ํ•ฉ์น  ๋•Œ D-051 ๋กœ ์žฌ๋ฐฐ์ •ํ–ˆ๋‹ค โ€” #39 ์˜ PRยท์ฝ”๋ฉ˜ํŠธ์™€ ์ปค๋ฐ‹ ๋ฉ”์‹œ์ง€์— ๋‚จ์€ ์˜› ๋ฒˆํ˜ธ D-047 ๋Š” ์ด ํ•ญ๋ชฉ์„ ๊ฐ€๋ฆฌํ‚จ๋‹ค.

  • Date: 2026-09-13
  • Context: ์ด์Šˆ #39 ์ธ์ˆ˜์กฐ๊ฑด 1. ํ—ˆ์šฉ ํ˜ธ์ŠคํŠธ ๊ฐœ์ˆ˜๊ฐ€ ๋ฌธ์„œ 3๊ณณ์—์„œ ๊ฐˆ๋ ค ์žˆ์—ˆ๋‹ค โ€” D-018 ใ€Œํ•„์ˆ˜ ์ตœ์†Œ 11์ข…ใ€ ยท docs/planning-inputs-cocode.md ยง2.1 ํ‘œ 12ํ–‰ ยท D-021 Impact ใ€Œํ—ˆ์šฉ ํ˜ธ์ŠคํŠธ 12์ข…ใ€. docs/architecture-cocode.md ยง9 ๋ฏธ๊ฒฐ 11 ์ด ์ด ๋ถˆ์ผ์น˜๋ฅผ ๋ฏธ๊ฒฐ๋กœ ์ ์—ˆ๊ณ , ๊ทธ ๋ฏธ๊ฒฐ ๋•Œ๋ฌธ์— ยง5.3 ๊ธฐ๋ณธ ๋ชฉ๋กยทbddยท#36 ๊ตฌํ˜„์ด ๋ชจ๋‘ ใ€Œ๊ฐœ์ˆ˜๋ฅผ ์ธ์šฉํ•˜์ง€ ์•Š๋Š”๋‹คใ€๋กœ ์šฐํšŒํ•˜๊ณ  ์žˆ์—ˆ๋‹ค. D-050 โ‘ฃ ๋Š” ์ด ํ•ญ๋ชฉ์„ ์˜ค๋„ˆ ๊ฒฐ์ • #109 ์— ๋‚จ๊ฒผ๋‹ค.
  • Options:
    1. 11 ๋กœ ํ™•์ • โ€” D-018 ์˜ ์‹ค์ธก ๊ธฐ๋ก์„ ์ •๋ณธ์œผ๋กœ ์‚ผ๋Š”๋‹ค
    2. 12 ๋กœ ํ™•์ • โ€” planning-inputs ยง2.1 ํ‘œ์˜ ํ–‰ ์ˆ˜๋ฅผ ์ •๋ณธ์œผ๋กœ ์‚ผ๋Š”๋‹ค
    3. ๊ฐœ์ˆ˜๋ฅผ ์ •๋ณธํ™”ํ•˜์ง€ ์•Š๋Š”๋‹ค โ€” ํ—ˆ์šฉ ํ˜ธ์ŠคํŠธ ๋ชฉ๋ก์„ ๋‹จ์ผ SSOT ๋กœ ๋‘๊ณ  ๊ฐœ์ˆ˜๋Š” ๊ทธ ๋ชฉ๋ก์—์„œ ํŒŒ์ƒ๋˜๋Š” ๊ฐ’์œผ๋กœ ์ทจ๊ธ‰ํ•œ๋‹ค
  • Decision: ์˜ต์…˜ 3. ํ—ˆ์šฉ ํ˜ธ์ŠคํŠธ ๋ชฉ๋ก์ด ๋‹จ์ผ SSOT ๋‹ค. ์ฝ”๋“œ์˜ SandboxDefaults.hosts ์™€ planning-inputs ยง2.1 ํ‘œ๊ฐ€ ๊ฐ™์€ ํ–‰ ์ง‘ํ•ฉ์„ ๊ฐ–๊ณ , ๊ฐœ์ˆ˜๋Š” ๊ทธ ๋ชฉ๋ก์„ ์„ธ๋ฉด ๋‚˜์˜ค๋Š” ํŒŒ์ƒ๊ฐ’์ผ ๋ฟ์ด๋‹ค. ์–ด๋–ค ๋ฌธ์„œ๋„ ๊ฐœ์ˆ˜๋ฅผ ํŒ์ • ๊ธฐ์ค€์œผ๋กœ ์ธ์šฉํ•˜์ง€ ์•Š๋Š”๋‹ค.
  • Rationale: ์„ ํ˜ธ๊ฐ€ ์•„๋‹ˆ๋ผ ์ธก์ •์ด ์„ ํƒ์ง€ ๋‘˜์„ ํƒˆ๋ฝ์‹œ์ผฐ๋‹ค. #38 ์˜ 3-OS ํ”„๋กœ๋ธŒ๊ฐ€ ยง2.1 ํ‘œ(12ํ–‰)์— ์—†๋Š” ํ˜ธ์ŠคํŠธ api.github.com ์„ CocoaPods ๊ฒฝ๋กœ์—์„œ ์‹ค์ œ๋กœ ๊ด€์ธกํ–ˆ๊ณ (docs/sandbox-limits-cocode.md ยง3), ๊ฐ™์€ ์‹ค์ธก์ด Gradle/JVM ์€ HTTP_PROXY ๋ฅผ ๋ฌด์‹œํ•˜๊ณ  ์ง์ ‘ ๋‚˜๊ฐ„๋‹ค๋Š” ๊ฒƒ๋„ ํ™•์ธํ–ˆ๋‹ค โ€” ํ”„๋ก์‹œ์— ์˜ค์ง€ ์•Š๋Š” ํŠธ๋ž˜ํ”ฝ์€ ์• ์ดˆ์— ์„ธ์–ด์ง€์ง€๋„ ์•Š๋Š”๋‹ค. ์ฆ‰ 11 ๋„ 12 ๋„ ์ธก์ •๊ณผ ์–ด๊ธ‹๋‚œ๋‹ค. ๊ฐœ์ˆ˜๋ฅผ 11ยท12ยท13 ์–ด๋А ์ˆ˜๋กœ ๊ณ ์ •ํ•ด๋„ ๋‹ค์Œ ์‹ค์ธก์—์„œ ๊ฐ™์€ ๋ถˆ์ผ์น˜๊ฐ€ ์žฌ๋ฐœํ•˜๋ฏ€๋กœ, ํ•œ ์ˆ˜๋ฅผ ๊ณจ๋ผ ๋ด‰ํ•ฉํ•˜๋Š” ๋Œ€์‹  ์ˆซ์ž๋ฅผ ์ •๋ณธ์œผ๋กœ ๋‘๋Š” ๊ตฌ์กฐ ์ž์ฒด๋ฅผ ๋ฐ”๊พผ๋‹ค. ๋ชฉ๋ก์€ ์‹ค์ธก์ด ๋Š˜๋ฉด ํ–‰์ด ๋Š˜์–ด๋„ ์—ฌ์ „ํžˆ ์ •๋ณธ์ด์ง€๋งŒ, ๊ฐœ์ˆ˜๋Š” ๋Š˜์–ด๋‚˜๋Š” ์ˆœ๊ฐ„ ํ‹€๋ฆฐ ์ •๋ณธ์ด ๋œ๋‹ค.
  • Impact:
    • docs/architecture-cocode.md ยง9 ๋ฏธ๊ฒฐ 11 ํ–‰์ด ์ œ๊ฑฐ๋˜๊ณ  ์ด ๊ฒฐ์ • ๋ฒˆํ˜ธ ์ฐธ์กฐ๋กœ ๋Œ€์ฒด๋œ๋‹ค. ยง5.3 ใ€Œ๊ธฐ๋ณธ ๋ชฉ๋กใ€ ๋ฌธ๋‹จ์˜ ๊ฐœ์ˆ˜ ์ธ์šฉ(D-018 ยท ยง2.1 ํ‘œ ยท D-021 ๋น„๊ต)๋„ ํ•จ๊ป˜ ์‚ฌ๋ผ์ง„๋‹ค.
    • ๊ฐœ์ˆ˜ ์ธ์šฉ 3๊ณณ ์ •๋ฆฌ โ€” D-018 ์˜ ใ€Œํ•„์ˆ˜ ์ตœ์†Œ 11์ข…ใ€ยทD-021 Impact ์˜ ใ€Œํ—ˆ์šฉ ํ˜ธ์ŠคํŠธ 12์ข…ใ€ยทplanning-inputs ยง2.1 ํ‘œ๊ฐ€ ๋ชจ๋‘ ๋ชฉ๋ก ์ฐธ์กฐ๋กœ ๋ฐ”๋€๋‹ค. ์„ธ ๊ณณ ๋‹ค ๊ธฐ๋ก์€ ์ง€์šฐ์ง€ ์•Š๊ณ  ๊ทธ ์ˆ˜๊ฐ€ ์ •๋ณธ์ด ์•„๋‹˜์„ ๋ช…์‹œํ•˜๋Š” ํ˜•ํƒœ๋‹ค(append-only ์ผ์ง€์˜ ๊ธฐ์กด ์ •์ • ๊ด€๋ก€).
    • planning-inputs ยง2.1 ํ‘œ๊ฐ€ ์‹ค์ธก์„ ํก์ˆ˜ํ•œ๋‹ค โ€” api.github.com ๊ณผ trunk.cocoapods.org ๊ฐ€ ์ถœ์ฒ˜ ใ€Œ#38 3-OS ์‹ค์ธกใ€์œผ๋กœ ํ‘œ์— ๋“ค์–ด๊ฐ„๋‹ค. ์ด ๋‘˜์€ #36 ์ด ์ด๋ฏธ ์ฝ”๋“œ ๋ชฉ๋ก์— ๋„ฃ์–ด ๋‘” ํ–‰์ด๋ฉฐ(๋นผ๋ฉด pod ๊ฒฝ๋กœ๊ฐ€ fail-closed ๋กœ ๋ง‰ํžŒ๋‹ค), ์ด๋กœ์จ ์ฝ”๋“œ์™€ ํ‘œ์˜ ํ–‰ ์ง‘ํ•ฉ์ด ๊ฐ™์•„์ง„๋‹ค โ€” SSOT ๊ฐ€ ๋‘˜๋กœ ๊ฐˆ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค.
    • #36 ์˜ ํ˜„ํ–‰ ์šฐํšŒ๊ฐ€ ์˜๊ตฌ ๊ทœ์น™์œผ๋กœ ์Šน๊ฒฉ๋œ๋‹ค. ใ€ŒํŒ์ •์€ ใ€Ž๋น„์–ด ์žˆ์ง€ ์•Š๋‹คใ€ + ๋Œ€์กฐ ๊ฒ€์‚ฌ๋กœ๋งŒ ํ•˜๊ณ  ์ฝ”๋“œยทํ…Œ์ŠคํŠธ ์–ด๋””์—๋„ N์ข…์„ ์“ฐ์ง€ ์•Š๋Š”๋‹คใ€๋Š” ์ž„์‹œ ํšŒํ”ผ๊ฐ€ ์•„๋‹ˆ๋ผ ์ด ๊ฒฐ์ •์˜ ์ง‘ํ–‰ ํ˜•ํƒœ๋‹ค โ€” ๊ฑท์–ด๋‚ด์ง€ ์•Š๋Š”๋‹ค.
    • docs/prd-cocode.md ์˜ ๊ฐœ์ˆ˜ ๋ถˆ์ผ์น˜ ํ•ญ๋ชฉ๊ณผ docs/bdd-cocode.md ์˜ ใ€Œ๊ฐœ์ˆ˜๋ฅผ ์ธ์šฉํ•˜์ง€ ์•Š๋Š” ์ด์œ ใ€ ์ฃผ์„์ด ์ด ๊ฒฐ์ • ์ฐธ์กฐ๋กœ ๋ฐ”๋€๋‹ค.
  • Source: #39 AC1 (ํŒ์ • ์ฃผ์ฒด Planning โ€” architecture ยง9 '๋ˆ„๊ฐ€' ์—ด) ยท ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ๊ฒฐ์ • #109 (2026-09-13). D-050 โ‘ฃ ๊ฐ€ ๋‚จ๊ธด ์ž๋ฆฌ๋ฅผ ์ด ํ•ญ๋ชฉ์ด ์ฑ„์šด๋‹ค.

D-052: ใ€Œํƒ€๊ฒŸํ•˜๋Š” ํ”Œ๋žซํผใ€์˜ ํŒ์ • ์ž…๋ ฅ = ์›Œํฌ์ŠคํŽ˜์ด์Šค์˜ ํ”Œ๋žซํผ ๋””๋ ‰ํ„ฐ๋ฆฌ ์กด์žฌ (#39 AC2 ยท PRD D-21)

๐Ÿ”ข ๋ฒˆํ˜ธ ์žฌ๋ฐฐ์ •(2026-09-13) โ€” ์ด ํ•ญ๋ชฉ์€ epic/33 ์—์„œ D-048 ๋กœ ๋ฐœ๊ธ‰๋์œผ๋‚˜, ๊ฐ™์€ ๋ฒˆํ˜ธ๋ฅผ project/2 ์˜ Epic #74(edit_locks)๊ฐ€ ๋จผ์ € ๊ฐ€์ ธ๊ฐ”๋‹ค(PR #206). Epic #33 ์„ project/2 ์— ํ•ฉ์น  ๋•Œ D-052 ๋กœ ์žฌ๋ฐฐ์ •ํ–ˆ๋‹ค โ€” #39 ์˜ PRยท์ฝ”๋ฉ˜ํŠธ์™€ ์ปค๋ฐ‹ ๋ฉ”์‹œ์ง€์— ๋‚จ์€ ์˜› ๋ฒˆํ˜ธ D-048 ๋Š” ์ด ํ•ญ๋ชฉ์„ ๊ฐ€๋ฆฌํ‚จ๋‹ค.

  • Date: 2026-09-13
  • Context: ์ด์Šˆ #39 ์ธ์ˆ˜์กฐ๊ฑด 2. SandboxDefaults.hostsFor(targets) ๋Š” ๊ธฐ๋ณธ ํ˜ธ์ŠคํŠธ ๋ชฉ๋ก์„ ํƒ€๊ฒŸ ํ”Œ๋žซํผ์œผ๋กœ ๊ฑฐ๋ฅด๋Š”๋ฐ(planning-inputs ยง2.1 ใ€Œํ”Œ๋žซํผใ€ ์—ด โ€” Linux ๋ฐ์Šคํฌํ†ฑ ์ „์šฉ ๋นŒ๋“œ์— AndroidยทiOS ํ˜ธ์ŠคํŠธ๋Š” ๋ถˆํ•„์š”), ๊ทธ ํƒ€๊ฒŸ ์ง‘ํ•ฉ์„ ๋ฌด์—‡์œผ๋กœ ์ •ํ•˜๋Š”๊ฐ€๊ฐ€ PRD D-21 ยท architecture ยง9 ๋ฏธ๊ฒฐ 16 ์œผ๋กœ ๋น„์–ด ์žˆ์—ˆ๋‹ค. #36 ์€ ํŒ์ •์„ ๋ฐœ๋ช…ํ•˜์ง€ ์•Š๊ณ  ํƒ€๊ฒŸ ์ง‘ํ•ฉ์„ ์ธ์ž๋กœ ๋ฐ›์•„ ํ˜ธ์ถœ๋ถ€๋กœ ๋ฐ€์–ด ๋’€๋‹ค. ๋ฏธํŒ์ • ๋™์•ˆ์˜ ๊ธฐ๋ณธ๊ฐ’์€ ์ „ ํ”Œ๋žซํผ ํ•ฉ์ง‘ํ•ฉ์ด์—ˆ๊ณ , ยง9 ๋ฏธ๊ฒฐ 16 ์ž์‹ ์ด ๊ทธ ๊ธฐ๋ณธ๊ฐ’์ด AC-14 ๋ฅผ ๋А์Šจํ•˜๊ฒŒ ํ•œ๋‹ค๊ณ  ๊ฒฝ๊ณ ํ–ˆ๋‹ค.
  • Options:
    1. ํ”Œ๋žซํผ ๋””๋ ‰ํ„ฐ๋ฆฌ ์กด์žฌ โ€” ์›Œํฌ์ŠคํŽ˜์ด์Šค ๋ฃจํŠธ์˜ android/ยทios/ยทmacos/ยทwindows/ยทlinux/ยทweb/
    2. ๋นŒ๋“œ ๋ช…๋ น ์ธ์ž โ€” ์‹ค์ œ๋กœ ์‹คํ–‰๋œ flutter build <platform> ์˜ ์ธ์ž
    3. ์‚ฌ์šฉ์ž ์„ค์ • โ€” S-16 ์„ค์ • ํ™”๋ฉด์—์„œ ์‚ฌ๋žŒ์ด ๊ณ ๋ฅธ๋‹ค
    4. ์„ ์–ธ โ€” ๋งค๋‹ˆํŽ˜์ŠคํŠธ(pubspec.yaml)์— ์ ํžŒ ํ”Œ๋žซํผ
  • Decision: ์˜ต์…˜ 1 โ€” ์›Œํฌ์ŠคํŽ˜์ด์Šค์˜ ํ”Œ๋žซํผ ๋””๋ ‰ํ„ฐ๋ฆฌ ์กด์žฌ๋กœ ํŒ์ •ํ•œ๋‹ค. ํŒ์ • ๊ทœ์น™ 3๊ฐ€์ง€๋Š” ์ „๋ถ€ ์ขํžˆ๋Š” ๋ฐฉํ–ฅ์ด๋‹ค: โ“ ์ด๋ฆ„ ์ •ํ™• ์ผ์น˜(์†Œ๋ฌธ์ž โ€” ๋Œ€์†Œ๋ฌธ์ž ๋ฌด์‹œ ๋ณผ๋ฅจ์—์„œ MacOS/ ๊นŒ์ง€ ๋ฐ›์œผ๋ฉด ๋ชฉ๋ก์ด ๋„“์–ด์ง„๋‹ค) โ“‘ ์›Œํฌ์ŠคํŽ˜์ด์Šค ๋ฃจํŠธ ๋ฐ”๋กœ ์•„๋ž˜๋งŒ(ํ•˜์œ„ ์˜ˆ์ œยท์„œ๋ธŒํŒจํ‚ค์ง€์˜ android/ ๋Š” ์ด ์›Œํฌ์ŠคํŽ˜์ด์Šค์˜ ์„ ์–ธ์ด ์•„๋‹ˆ๋‹ค) โ“’ ํ•˜๋‚˜๋„ ์—†์œผ๋ฉด ๋นˆ ์ง‘ํ•ฉ์ด๊ณ  ํ•ฉ์ง‘ํ•ฉ์œผ๋กœ ๋˜๋Œ์•„๊ฐ€์ง€ ์•Š๋Š”๋‹ค(์ˆœ์ˆ˜ Dart ํŒจํ‚ค์ง€๋Š” BuildTarget.all ํ–‰๋งŒ ๋ฐ›๋Š”๋‹ค).
  • Rationale: ๊ฒฐ์ •์ ์ด๊ณ , ์ถ”๊ฐ€ ์ž…๋ ฅ๋„ ๋ฌผ์–ด๋ณด๋Š” ํ™”๋ฉด๋„ ํ•„์š” ์—†์œผ๋ฉฐ, Flutter ํ”„๋กœ์ ํŠธ๊ฐ€ ์‹ค์ œ๋กœ ํƒ€๊ฒŸ ํ”Œ๋žซํผ์„ ์„ ์–ธํ•˜๋Š” ๋ฐฉ์‹๊ณผ ์ผ์น˜ํ•œ๋‹ค. ๋‚˜๋จธ์ง€ ์…‹์€ ๊ฐ๊ฐ ๋‹ค๋ฅธ ์ด์œ ๋กœ ํŒ์ • ์ž…๋ ฅ์ด ๋  ์ˆ˜ ์—†๋‹ค โ€” โ‘ก๋Š” ๋ช…๋ น์„ ์‹คํ–‰ํ•ด์•ผ ์•Œ ์ˆ˜ ์žˆ์–ด ์›Œํฌ์ŠคํŽ˜์ด์Šค๋ฅผ ์—ฌ๋Š” ์‹œ์ ์—๋Š” ์กด์žฌํ•˜์ง€ ์•Š๊ณ (ํ—ˆ์šฉ ๋ชฉ๋ก์€ ๊ทธ๋•Œ ํ•ฉ์„ฑ๋ผ์•ผ ํ•œ๋‹ค), โ‘ข์€ ์‚ฌ๋žŒ์ด ์ฑ„์›Œ์•ผ ํ•˜๋ฏ€๋กœ ๋นˆ ๊ฐ’์˜ ๊ธฐ๋ณธ์„ ๋‹ค์‹œ ์ •ํ•ด์•ผ ํ•ด์„œ ๊ฐ™์€ ๋ฏธ๊ฒฐ์ด ํ•œ ๊ฒน ๋’ค๋กœ ๋ฐ€๋ฆด ๋ฟ์ด๊ณ , โ‘ฃ๋Š” Flutter ์•ฑ์ด pubspec.yaml ์— ํƒ€๊ฒŸ ํ”Œ๋žซํผ์„ ์ ์ง€ ์•Š๋Š”๋‹ค(platforms: ๋Š” ํ”Œ๋Ÿฌ๊ทธ์ธ ํŒจํ‚ค์ง€ ์ „์šฉ์ด๋ผ ์•ฑ ์›Œํฌ์ŠคํŽ˜์ด์Šค์—์„œ๋Š” ๋น„์–ด ์žˆ๋‹ค). โ‘ ๋งŒ ์›Œํฌ์ŠคํŽ˜์ด์Šค๋ฅผ ์—ฌ๋Š” ์ˆœ๊ฐ„ ์ด๋ฏธ ๋””์Šคํฌ์— ์žˆ๋Š” ์‚ฌ์‹ค์ด๋‹ค.
  • ๋ฒ”์œ„ ๋ฐ–: ์‚ฌ์šฉ์ž ์„ค์ •์— ์˜ํ•œ ๋ฎ์–ด์“ฐ๊ธฐ๋Š” ์ด ๊ฒฐ์ •์— ํฌํ•จํ•˜์ง€ ์•Š๋Š”๋‹ค(์˜ค๋„ˆ ๊ฒฐ์ • ๋ช…์‹œ). ํ•„์š”ํ•ด์ง€๋ฉด ํ›„์† ์ด์Šˆ๋กœ ๋ถ„๋ฆฌํ•˜๋ฉฐ, ๊ทธ๋•Œ๊นŒ์ง€ S-16 ์„ค์ • ํ™”๋ฉด์˜ ํŽธ์ง‘ ๋Œ€์ƒ์€ ๊ธฐ์กด๋Œ€๋กœ ์‚ฌ์šฉ์ž ์ถ”๊ฐ€๋ถ„๋ฟ์ด๊ณ  ํƒ€๊ฒŸ ์ง‘ํ•ฉ์€ ํŽธ์ง‘ ๋Œ€์ƒ์ด ์•„๋‹ˆ๋‹ค.
  • Impact:
    • docs/architecture-cocode.md ยง9 ๋ฏธ๊ฒฐ 16 ํ–‰์ด ์ œ๊ฑฐ๋˜๊ณ  ์ด ๊ฒฐ์ • ๋ฒˆํ˜ธ ์ฐธ์กฐ๋กœ ๋Œ€์ฒด๋œ๋‹ค. docs/prd-cocode.md D-21 ์ด ํ•ด์†Œ๋œ๋‹ค.
    • AC-14 ๊ฐ€ ์กฐ์ธ๋‹ค โ€” ๋ฏธํŒ์ • ๊ธฐ๋ณธ๊ฐ’์ด๋˜ ์ „ ํ”Œ๋žซํผ ํ•ฉ์ง‘ํ•ฉ์ด ์‚ฌ๋ผ์ง„๋‹ค. Linux ๋ฐ์Šคํฌํ†ฑ ์ „์šฉ ์›Œํฌ์ŠคํŽ˜์ด์Šค์˜ ํ—ˆ์šฉ ๋ชฉ๋ก์€ planning-inputs ยง2.1 ์ฃผ์„์ด ๋“  ๊ทธ๋Œ€๋กœ BuildTarget.all ํ–‰๋งŒ ๋‚จ๋Š”๋‹ค.
    • ๊ตฌํ˜„ 2๊ฐœ๊ฐ€ ์‹ ์„ค๋œ๋‹ค โ€” ํŒ์ • ๊ทœ์น™์€ core(L0)์˜ BuildTargetDetectionยทPlatformDirectory(์ˆœ์ˆ˜, ํŒŒ์ผ์‹œ์Šคํ…œ ์—†์ด ๊ฒ€์ฆ๋œ๋‹ค), ๋””์Šคํฌ๋ฅผ ๋ณด๋Š” ์ชฝ์€ workspace(L1)์˜ WorkspaceBuildTargets ๋‹ค. core ๋Š” dart:io ๋ฅผ ๊ฐ–์ง€ ์•Š๊ณ  toolchain ์€ ๊ฐ™์€ L1 ์ด๋ผ workspace ๋ฅผ ์˜์กดํ•  ์ˆ˜ ์—†์œผ๋ฏ€๋กœ ์ด ๋ฐฐ์น˜๊ฐ€ ์œ ์ผํ•˜๋‹ค. ์ฝ๊ธฐ(Directory.existsSync)๋งŒ ํ•˜๋ฏ€๋กœ DD-15 ์“ฐ๊ธฐ ํ—ˆ์šฉ ํŒŒ์ผ ๋ชฉ๋ก ๋Œ€์ƒ์ด ์•„๋‹ˆ๋‹ค.
    • SandboxSettings.targets ์˜ ์ƒ์‚ฐ์ž๊ฐ€ ์ •ํ•ด์กŒ๋‹ค โ€” ํ˜ธ์ถœ๋ถ€๋Š” WorkspaceBuildTargets.detect(workspaceRoot) ๋ฅผ ์“ด๋‹ค. SandboxDefaults ์ž์‹ ์€ ์—ฌ์ „ํžˆ ํƒ€๊ฒŸ ์ง‘ํ•ฉ์„ ์ธ์ž๋กœ ๋ฐ›๋Š”๋‹ค(ํŒ์ •์€ IO ๊ฐ€ ํ•„์š”ํ•˜๊ณ  ๊ทธ ์ธต์€ ์ˆœ์ˆ˜ํ•˜๋‹ค).
  • Source: #39 AC2 (ํŒ์ • ์ฃผ์ฒด Design โ€” architecture ยง9 '๋ˆ„๊ฐ€' ์—ด) ยท ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ๊ฒฐ์ • #109 (2026-09-13). D-050 โ‘ฃ ๊ฐ€ ๋‚จ๊ธด ์ž๋ฆฌ๋ฅผ ์ด ํ•ญ๋ชฉ์ด ์ฑ„์šด๋‹ค.

D-053: ์ž๊ฐ€ ๊ฒ€์ฆ ๋Œ€์ƒ์—†์Œ ์‚ฌ์œ  ์ฝ”๋“œ ํ์‡„ ์ง‘ํ•ฉ์„ 5์ข…์œผ๋กœ ํ™•์ • โ€” โ‘ค ์ „์šฉ ์ฝ”๋“œ ์‹ ์„ค

  • Date: 2026-09-13
  • Context: ์ด์Šˆ #64 ์ž”์—ฌ ๋ฒ”์œ„. #101(2026-08-27)์ด DD-21/21a/21b ๋ฅผ ๋น„์ค€ํ•ด โ‘ ~โ‘ฃ ์˜ ๋Œ€์ƒ์—†์Œ ์ฝ”๋“œ 4์ข…์€ ํ™•์ •๋์œผ๋‚˜, DD-21b ๊ฐ€ ์ •ํ•œ โ‘ค ์ž์‹ ์˜ ๋Œ€์ƒ์—†์Œ(๋“ฑ๋ก ํŒŒ์„œ ์—†์Œ)์„ ๊ธฐ๋กํ•  ์ž๋ฆฌ๊ฐ€ ํ์‡„ ์ง‘ํ•ฉ์— ์—†์—ˆ๋‹ค. DD-21b ๋Š” ๊ทธ ๊ฑฐ๋™(์™„๋ฃŒ ์ฐจ๋‹จ)๋งŒ ์ •ํ•˜๊ณ  ๊ธฐ๋ก ๊ฐ’์€ ์ •ํ•˜์ง€ ์•Š์•˜๋‹ค. ํ•จ๊ป˜, architecture ยง10 ํ•ญ๋ชฉ 12 ๊ฐ€ ๋‚จ๊ธด ใ€ŒC-04 โ‘ค ์„ธ ๋ฒˆ์งธ ์ ˆ์ด ๊ณตํ—ˆํ•˜๊ฒŒ ์ฐธ์ด ๋œ๋‹คใ€์˜ ์ฒ˜๋ถ„ ์Šน์ธ ์—ฌ๋ถ€๋„ ์—ด๋ ค ์žˆ์—ˆ๋‹ค.
  • Options:
    1. ์‹ ์„ค โ€” no_target:no_registered_parser ๋ฅผ ๋”ํ•ด ํ์‡„ ์ง‘ํ•ฉ์„ 5์ข…์œผ๋กœ
    2. ์ฝ”๋“œ ์—†์ด ์ฐจ๋‹จ๋งŒ โ€” โ‘ค ๋Œ€์ƒ์—†์Œ์€ no_target_code ์—†์ด result: ๋Œ€์ƒ์—†์Œ ๋งŒ ๊ธฐ๋ก
    3. โ‘ฃ ์ฝ”๋“œ ์žฌ์‚ฌ์šฉ โ€” no_target:file_not_analyzed ๋กœ ์ ๋Š”๋‹ค
  • Decision: ์˜ต์…˜ 1 โ€” no_target:no_registered_parser ์‹ ์„ค, ์ตœ์ข… ํ์‡„ ์ง‘ํ•ฉ = 5์ข…. ํ•จ๊ป˜ C-04 โ‘ค ์„ธ ๋ฒˆ์งธ ์ ˆ์˜ ๊ณตํ—ˆ์„ฑ์— ๋Œ€ํ•œ DD-21bยทยง10-12 ์˜ ์ฒ˜๋ถ„(ใ€ŒSeed Spec ๋ฌธ๋ฉด์˜ ๊ฒฐ๊ณผ์ด๋ฉฐ Design ์ด ์ขํžŒ ๊ฒƒ์ด ์•„๋‹ˆ๋‹ค ยท Seed Spec ๊ฐœ์ • ์‹œ ๊ฒ€ํ† ใ€)์„ ์Šน์ธํ•œ๋‹ค. ์‚ฐ์ถœ๋ฌผ์€ docs/verification-no-target-cocode.md.
  • Rationale: ์˜ต์…˜ 2 ๋Š” DD-23b ์˜ ใ€Œresult=๋Œ€์ƒ์—†์Œ ์ผ ๋•Œ๋งŒ ํ์‡„ ์ฝ”๋“œใ€ ๊ทœ์ •์„ ใ€Œ๋‹จ โ‘ค ๋Š” ์˜ˆ์™ธใ€๋กœ ๋ฐ”๊พธ๋ฉฐ, ๊ทธ ์˜ˆ์™ธ๋Š” โ“ ํ•„๋“œ๋ฅผ ์„ ํƒ์œผ๋กœ ๋งŒ๋“ค์–ด โ‘ ~โ‘ฃ ์—์„œ๋„ ์ฝ”๋“œ ์—†๋Š” ๋Œ€์ƒ์—†์Œ์„ ํ•ฉ๋ฒ•ํ™”ํ•˜๊ฑฐ๋‚˜ โ“‘ method ๋ณ„ ์Šคํ‚ค๋งˆ ๋ถ„๊ธฐ๋ฅผ ๋„์ž…ํ•œ๋‹ค โ€” ๋‘˜ ๋‹ค DD-21 ์ด ์—†์•ค ๋ถ„๊ธฐ๋ฅผ ๋˜๋Œ๋ฆฐ๋‹ค. ์˜ต์…˜ 3 ์€ โ‘ค ๊ฐ€ ์—ด๋ฆฌ๋Š” ์ƒํ™ฉ(โ‘ฃ ๊ฐ€ file_not_analyzed)์—์„œ โ‘ฃยทโ‘ค ๋‘ ๋ ˆ์ฝ”๋“œ๊ฐ€ ๊ฐ™์€ ์ฝ”๋“œ๋ฅผ ๊ฐ–๊ฒŒ ํ•ด, ์‚ฌ์šฉ์ž๊ฐ€ ใ€Œ๋ถ„์„ ๋Œ€์ƒ์— ๋„ฃ์–ด์•ผ ํ•˜๋Š”๊ฐ€ใ€์™€ ใ€ŒํŒŒ์„œ ๋“ฑ๋ก์„ ์š”์ฒญํ•ด์•ผ ํ•˜๋Š”๊ฐ€ใ€๋ฅผ ๊ตฌ๋ณ„ํ•  ์ˆ˜ ์—†๊ฒŒ ๋งŒ๋“ ๋‹ค. ์˜ต์…˜ 1 ์€ ๊ฐ’ ํ•˜๋‚˜๋ฅผ ๋”ํ•  ๋ฟ ์Šคํ‚ค๋งˆ ๋ฌธ์žฅ์ด ๋‹ซํžŒ ์ฑ„๋กœ ๋‚จ๋Š”๋‹ค. ๊ฑฐ๋™์€ ๋ฐ”๋€Œ์ง€ ์•Š๋Š”๋‹ค โ€” ์ฝ”๋“œ ์‹ ์„ค์€ ๊ธฐ๋ก์„ ์—ด ๋ฟ ์™„๋ฃŒ๋ฅผ ์—ด์ง€ ์•Š์œผ๋ฉฐ DD-21b ์˜ ์ฐจ๋‹จ ๋ฐฉํ–ฅ์ด ๊ทธ๋Œ€๋กœ๋‹ค.
  • ๋ฒ”์œ„ ๋ฐ–: โ“ verification_log JSON ์Šคํ‚ค๋งˆ ๋ธ”๋ก์˜ ๋ฌธ์„œ ํŽธ์ง‘๊ณผ ์ฝ”๋“œ ๋ฐ˜์˜์€ #63(์†Œ์œ  ๊ฒฝ๊ณ„ โ€” ์„ธ spike ๋Š” ๊ฒฐ์ •๋งŒ ์‚ฐ์ถœํ•œ๋‹ค) โ“‘ ํ™˜๊ฒฝ ์‹คํŒจ ๋ถ„๋ฅ˜(result enum ํ™•์žฅ ๋˜๋Š” failure_class ์‹ ์„ค)๋Š” #73 ์˜ ๋ณ„๊ฐœ ์ถ•์ด๋ฉฐ, ํ™˜๊ฒฝ ์‹คํŒจ๋ฅผ no_target_code ์— ์ ‘๋Š” ์•ˆ์€ ์ฑ„ํƒ ๋ถˆ๊ฐ€๋‹ค โ“’ ์–ด๋–ค ํ™•์žฅ์ž์— ํŒŒ์„œ๋ฅผ ๋“ฑ๋กํ•˜๋Š”๊ฐ€๋Š” #65(ยง9 ๋ฏธ๊ฒฐ 5) โ€” ์ด ๊ฒฐ์ •์€ ใ€Œ๋“ฑ๋ก์ด ์—†์„ ๋•Œใ€๋งŒ ์ •ํ•œ๋‹ค.
  • Impact:
    • docs/verification-no-target-cocode.md ์‹ ์„ค โ€” no_target_code ๊ฐ’ ์ง‘ํ•ฉ์˜ SSOT.
    • prd ยง4 D-2 ํ•ด์†Œ ยท bdd ยง0.5 U-8 ํ•ด์†Œ ยท architecture ยง10 ํ•ญ๋ชฉ 12 ์ฒ˜๋ถ„ ์Šน์ธ(์žฌ๊ฒ€ํ†  ์กฐ๊ฑด: Seed Spec ์ด C-04 โ‘ค ๋ฅผ ๊ฐœ์ •ํ•˜๋Š” ํšŒ์ฐจ).
    • #63 ์— ๋„˜์–ด๊ฐ€๋Š” ๋ฐ˜์˜ ์š”์ฒญ 4๊ฑด โ€” DD-23b ์ฃผ์„์˜ ใ€Œํ์‡„ 4์ข…ใ€โ†’ใ€Œ5์ข…ใ€, DD-21b ์— ๊ธฐ๋ก ๊ฐ’ ์กด์žฌ ๋ช…์‹œ, core ํ์‡„ enum 5์ข…(๊ฐ’ ๋ฌธ์ž์—ด ๋ฐ”์ดํŠธ ์ผ์น˜), ยง9 ๋ฏธ๊ฒฐ 5 ์˜ ใ€Œโ‘ค ๋Œ€์ƒ์—†์Œ ๊ธฐ๋ก ๊ฐ’ใ€ ์ถ• ๋‹ซํž˜ ํ‘œ์‹œ.
  • Source: #64 ์ธ์ˆ˜์กฐ๊ฑด 2ยท3ยท4 (ํŒ์ • ์ฃผ์ฒด Design) ยท ์„ ํ–‰ ๋น„์ค€ #101

D-054: โ‘ค ์ •๋ณธ ํŒŒ์„œ ๋“ฑ๋ก ๋ชฉ๋ก์„ 3์ข…์œผ๋กœ ํ™•์ • ยท โ‘ข ๊ด€์ฐฐ ์ฐฝ์€ ์‹ค์ธก ๊ทœ์•ฝ๋งŒ ํ™•์ •(๊ฐ’ ๋ฏธ์ •)

  • Date: 2026-09-13
  • Context: ์ด์Šˆ #65. architecture ยง9 ๋ฏธ๊ฒฐ 5 ๊ฐ€ ใ€Œโ‘ข ์˜ ๊ด€์ฐฐ ์ฐฝใ€๊ณผ ใ€Œโ‘ค ์˜ ํ˜•์‹๋ณ„ ์ •๋ณธ ํŒŒ์„œ ๋“ฑ๋ก ๋ชฉ๋กใ€์„ ๊ฐ’ ์—†์ด ๋‚จ๊ฒจ, AC-09 ๊ฐ€ ๊ธฐ๊ณ„์ ์œผ๋กœ ํŒ์ •๋˜์ง€ ์•Š์•˜๋‹ค. ํ•จ๊ป˜ โ‘ฃยทโ‘ค ์˜ ใ€Œ์ƒˆ๋กœ์šด ์˜ค๋ฅ˜ใ€ ๊ธฐ์ค€์„ ์€ ยง6.1 ํ•ญ๋ชฉ 4 ๊ฐ€ ์ด๋ฏธ ๊ณ ์ •ํ–ˆ์œผ๋ฏ€๋กœ ํ™•์ธ ๋Œ€์ƒ์ด์—ˆ๋‹ค.
  • Options:
    1. ๋‘ ๊ฐ’์„ ๋ชจ๋‘ ์ง€๊ธˆ ๊ณ ๋ฅธ๋‹ค(โ‘ข ์— ์ž ์ •๊ฐ’ ๋ถ€์—ฌ)
    2. โ‘ค ๋ชฉ๋ก์€ ํ™•์ •ํ•˜๊ณ  โ‘ข ์€ ์‹ค์ธก ๊ทœ์•ฝ๋งŒ ํ™•์ •ํ•œ๋‹ค
    3. ๋‘˜ ๋‹ค ์‹ค์ธก๊นŒ์ง€ ๋ฏธ๋ฃฌ๋‹ค
  • Decision: ์˜ต์…˜ 2. โ“ โ‘ค MVP ๋“ฑ๋ก ๋ชฉ๋ก = 3์ข… โ€” .dart(package:analyzer) ยท .yamlยท.yml(package:yaml) ยท .jsonยท.arb(dart:convert). โ“‘ โ‘ข ๊ด€์ฐฐ ์ฐฝ์˜ ๊ธธ์ดยท๊ด€์ฐฐ ์ด๋ฒคํŠธ ์ง‘ํ•ฉ์€ ใ€Œ๋ฏธ์ • โ€” ๊ฒฐ์ • ํ•„์š”ใ€(ํŒ์ • ์ฃผ์ฒด Design) ๋กœ ๋‚จ๊ธฐ๊ณ , ๋ฌด์—‡์„ ์–ด๋–ป๊ฒŒ ์‹ค์ธกํ• ์ง€๋ฅผ ํ™•์ •ํ•œ๋‹ค. โ“’ โ‘ฃยทโ‘ค ๊ธฐ์ค€์„ (๊ทธ ์ž‘์—…์˜ ์ฒซ ํŽธ์ง‘ ์ง์ „ dart analyze ๊ฒฐ๊ณผ, ์ž‘์—… ์‹œ์ž‘ ์‹œ 1ํšŒ ์ˆ˜์ง‘)์„ ์ฑ„ํƒ ํ™•์ธํ•œ๋‹ค. ์‚ฐ์ถœ๋ฌผ์€ docs/verification-parameters-cocode.md.
  • Rationale: โ‘ข ์—๋Š” ํ‘œ๋ณธ์ด ์—†๋‹ค โ€” ์ด ์ €์žฅ์†Œ ์–ด๋””์—๋„ ใ€Œํ•ซ ๋ฆฌ๋กœ๋“œ ํ›„ ๋Ÿฐํƒ€์ž„ ์˜ค๋ฅ˜ ๋„๋‹ฌ ์ง€์—ฐใ€ ๊ด€์ธก์น˜๊ฐ€ 0๊ฑด์ด๋‹ค. D-033(AC-08 20๋ถ„)์ด ์ •๋‹นํ–ˆ๋˜ ์ด์œ ๋Š” GitHub Actions 41๊ฑด์ด๋ผ๋Š” ์‹ค์ธก ํ‘œ๋ณธ์ด ์ด๋ฏธ ์žˆ์—ˆ๊ธฐ ๋•Œ๋ฌธ์ด๋ฉฐ, ํ‘œ๋ณธ ์—†์ด ๊ณ ๋ฅธ ์ˆซ์ž๋Š” D-013ยทD-015ยทD-020 ์ด ๊ฒฝ๊ณ„ํ•œ ํŒจํ„ด ๊ทธ๋Œ€๋กœ๋‹ค. ๋ฐ˜๋ฉด โ‘ค ๋ชฉ๋ก์€ ์‹ค์ธก์ด ํ•„์š” ์—†๋Š” ํŒ์ •์ด๋‹ค โ€” ๋“ฑ๋ก ์š”๊ฑด P-1(์ •๋ณธ ๋ฌธ๋ฒ• ์กด์žฌ)ยทP-2(๋ฌดํšจ ์ž…๋ ฅ์„ ์‹ค์ œ๋กœ ๊ฑฐ๋ถ€)ยทP-3(SDK ๋˜๋Š” dart-lang 1๊ธ‰ ๊ตฌํ˜„)์„ ๋งŒ์กฑํ•˜๋Š” ํ˜•์‹์ด ์—ด๊ฑฐ๋กœ ์ •ํ•ด์ง„๋‹ค. ๊ด€๋Œ€ํ•œ ํŒŒ์„œ๋ฅผ ๋“ฑ๋กํ•˜๋ฉด C-04 โ‘ค ์˜ ๋‘ ๋ฒˆ์งธ ์ ˆ์ด ํ•ญ์ƒ ์ฐธ์ด ๋˜์–ด โ‘ค ๊ฐ€ ๊ณ ๋ฌด๋„์žฅ์ด ๋˜๋ฏ€๋กœ(.mdยท.txt ๋ฐฐ์ œ ๊ทผ๊ฑฐ), ๋ชฉ๋ก์€ ๋„“ํž์ˆ˜๋ก ์ข‹์€ ๊ฒƒ์ด ์•„๋‹ˆ๋‹ค. .xml/.plist ๋Š” ๋ฐ”์ด๋„ˆ๋ฆฌ ๋ณ€์ข…์ด ใ€Œ์ฝ๊ธฐ ์‹คํŒจใ€์™€ ใ€ŒํŒŒ์„œ ์˜ค๋ฅ˜ใ€๋ฅผ ์„ž์–ด #73 ์˜ ํ™˜๊ฒฝ ์‹คํŒจ ์ถ•์„ ์˜ค์—ผ์‹œ์ผœ ๋ฐฐ์ œํ–ˆ๊ณ , .lock ์€ ํ™•์žฅ์ž ํ์‡„ ๋งคํ•‘(DD-21b)์„ ํŒŒ์ผ๋ช… ํŠน๋ก€๋กœ ๊นจ๋œจ๋ ค ๋ฐฐ์ œํ–ˆ๋‹ค. ์„ธ ํŒŒ์„œ ๋ชจ๋‘ ์ด๋ฏธ ์˜์กด ๊ทธ๋ž˜ํ”„ ์•ˆ์ด๊ฑฐ๋‚˜ SDK ๋‚ด์žฅ์ด๋ผ ๊ณ„์ธต ๋ž˜์นซยทphantom_edges ๋ฅผ ๊ฑด๋“œ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค.
  • ๋ฏธ์ • ์‹œ ๋™์ž‘(โ‘ข): ๋””๋ฒ„๊ทธ ์„ธ์…˜์ด ์—†์œผ๋ฉด ๋Œ€์ƒ์—†์Œ(no_target:no_debug_session)์ด๋ผ ์˜ํ–ฅ์ด ์—†๊ณ , ์žˆ์œผ๋ฉด โ‘ข ์€ ๋ฏธ์‹คํ–‰ ์ด๋ผ DD-21a-4 ๊ฐ€ ์™„๋ฃŒ๋ฅผ ๋ง‰๋Š”๋‹ค โ€” ์ฐจ๋‹จ ๋ฐฉํ–ฅ(์•ˆ์ „์ธก). ๋”ฐ๋ผ์„œ ์ด ๋ฏธ๊ฒฐ์€ ์ถœ์‹œ ์ฐจ๋‹จ์ด ์•„๋‹ˆ๋ผ ๊ธฐ๋Šฅ ์ถ•์†Œ ํ•ญ๋ชฉ์ด๋‹ค. ํ•จ๊ป˜ ํ™•์ •ํ•œ ๋ถ€๋“ฑ์‹: ๊ด€์ฐฐ ์ฐฝ < AC-08 ์‹œ๋„ ์ƒํ•œ(20๋ถ„) โ€” ์–ด๊ธฐ๋ฉด โ‘ข ์€ ์˜์›ํžˆ ๋๋‚˜์ง€ ์•Š๊ณ  ์‹œ๋„ ์ƒํ•œ์— ๋จผ์ € ๊ฑธ๋ฆฐ๋‹ค.
  • ์‹ค์ธก ๊ทœ์•ฝ(โ‘ข): ์ฐธ์กฐ ์›Œํฌ์ŠคํŽ˜์ด์Šค unibook @ 9db9015(D-019) ยท ์˜ค๋ฅ˜ 3์ข…(๋ฆฌ๋กœ๋“œ ์ฆ‰์‹œ / ๋‹ค์Œ ํ”„๋ ˆ์ž„ / ์ƒํ˜ธ์ž‘์šฉ ํ›„) ร— 3 ๋ฐ์Šคํฌํ†ฑ ํ”Œ๋žซํผ ร— 20ํšŒ ์ด์ƒ ยท ฮ” = tโ‚(์˜ค๋ฅ˜ ์ด๋ฒคํŠธ ๋„์ฐฉ) โˆ’ tโ‚€(reloadSources ๋ฐ˜ํ™˜) ยท ์‚ฐ์ •์€ D-033 ๊ณผ ๊ฐ™์€ ๊ทœ์น™(B-1 ์‹ค์ธก ์ตœ๋Œ€ ร— 2, B-3 ๊ณผ๋Œ€์ถ”์ •์ด ์•ˆ์ „์ธก). ๊ด€์ฐฐ ์ŠคํŠธ๋ฆผ์€ DebugยทExtension ์šฐ์„ ์ด๊ณ  Stderr ๋‹จ๋… ๊ทผ๊ฑฐ๋Š” ํŒ์ •์„ ๋„์ž…ํ•˜๋ฏ€๋กœ ๋ฐฐ์ œ ๊ฒ€ํ†  ๋Œ€์ƒ์ด๋‹ค.
  • Impact: architecture ยง9 ๋ฏธ๊ฒฐ 5 ๋ถ€๋ถ„ ํ•ด์†Œ(โ‘ค ๋ชฉ๋ก ์ถ• ๋‹ซํž˜, โ‘ข ์ถ•์€ ๊ฐ’ ๋ฏธ์ • + ๊ทœ์•ฝ ํ™•์ •, AgentRequest ํƒ€์ž„์•„์›ƒยทํ”„๋กœ์„ธ์Šค ์ข…๋ฃŒ ์œ ์˜ˆ ๋‘ ์ถ•์€ ๋ฒ”์œ„ ๋ฐ–). prd D-12ยทFR-301a ํ•ด์†Œ. #63 ์— ๋„˜์–ด๊ฐ€๋Š” ๋ฐ˜์˜ ์š”์ฒญ 4๊ฑด์€ ์‚ฐ์ถœ ๋ฌธ์„œ ยง5 ํ‘œ์— ์žˆ๋‹ค.
  • Source: #65 ์ธ์ˆ˜์กฐ๊ฑด 1ยท2ยท3ยท4 (ํŒ์ • ์ฃผ์ฒด Design โ€” architecture ยง9 '๋ˆ„๊ฐ€' ์—ด)

D-055: ๊ฒ€์ฆ ์‹คํŒจ ์›์ธ ๋ถ„๋ฅ˜ โ€” failure_class ํ์‡„ 5์ข… ์‹ ์„ค, ํ™˜๊ฒฝ ์‹คํŒจ๋Š” retry_count ๋ฅผ ์†Œ์ง„ํ•˜์ง€ ์•Š๋Š”๋‹ค

  • Date: 2026-09-13
  • Context: ์ด์Šˆ #73. verification_log ์˜ result ๋Š” ํ†ต๊ณผ|์‹คํŒจ|๋Œ€์ƒ์—†์Œ 3๊ฐ’์ด๋ผ ํ™˜๊ฒฝ ์‹คํŒจ๋ฅผ ๋‹ด์„ ์ž๋ฆฌ๊ฐ€ ์—†๊ณ , DD-21a-1 ์ด ๋ชจ๋“  ์‹คํŒจ ๋ฅผ ์žฌ์‹œ๋„ ๊ฒฝ๋กœ๋กœ ๋ณด๋‚ด๋ฏ€๋กœ ํˆด์ฒด์ธ ๋ถ€์žฌยท๋„คํŠธ์›Œํฌ ๋‹จ์ ˆยทํ”„๋กœ์„ธ์Šค ๊ธฐ๋™ ์‹คํŒจ๊ฐ€ retry_count ๋ฅผ ์†Œ์ง„ํ•œ๋‹ค โ€” ๊ทธ 3ํšŒ ์ƒํ•œ์€ D-008 ์ด ใ€Œ์œ ์ผํ•œ ์•ˆ์ „์žฅ์น˜ใ€๋กœ ์ ์€ ๊ฒƒ์ด๋‹ค. flow-permutation FP-111ยทI-8 ์ด ์ด๋ฅผ ใ€Œ์›์ธ ๊ตฌ๋ถ„์ด ์—†๋‹คใ€๋กœ ์ง€๋ชฉํ–ˆ๊ณ , allowed_hosts ์ฐจ๋‹จ(AC-14 โ“‘)๊ณผ ๋„คํŠธ์›Œํฌ ๋‹จ์ ˆ๋„ ๊ตฌ๋ถ„๋˜์ง€ ์•Š์•˜๋‹ค.
  • Options:
    1. result enum ์„ 4๊ฐ’์œผ๋กœ ํ™•์žฅํ•œ๋‹ค
    2. failure_class ์ •๋ จ ํ•„๋“œ๋ฅผ ์‹ ์„คํ•œ๋‹ค(result ๋Š” 3๊ฐ’ ๊ทธ๋Œ€๋กœ)
    3. ํ™˜๊ฒฝ ์‹คํŒจ๋ฅผ result: ๋Œ€์ƒ์—†์Œ ์œผ๋กœ ์ ‘๋Š”๋‹ค
  • Decision: ์˜ต์…˜ 2. โ“ failure_class ํ์‡„ 5์ข… โ€” failure:code_defect ยท failure:env_tool_unavailable ยท failure:env_tool_aborted ยท failure:env_network_unreachable ยท failure:policy_host_blocked. โ“‘ ๊ณ„์ˆ˜๋Š” code_defect ๋งŒ retry_count ๋ฅผ ์ฆ๊ฐ€์‹œํ‚จ๋‹ค. โ“’ ํ™˜๊ฒฝ ์‹คํŒจ์—๋Š” retry_count ์™€ ๋ณ„๊ฐœ์ธ ์ƒํ•œ์„ ๋‘๋˜ ๊ฐ’์€ ๋ฏธ์ • โ€” ๊ฒฐ์ • ํ•„์š”(Planning) ์ด๊ณ  ๋ฏธ์ • ๋™์•ˆ์€ ์ƒํ•œ 0(์ฒซ ํ™˜๊ฒฝ ์‹คํŒจ์— ์ฆ‰์‹œ ์‹คํŒจ ์ „์ด โ€” ์ฐจ๋‹จ ๋ฐฉํ–ฅ). โ““ ํ•œ ํšŒ์ฐจ์— ์—ฌ๋Ÿฌ ๋ถ„๋ฅ˜๊ฐ€ ์„ž์ด๋ฉด ์šฐ์„ ์ˆœ์œ„ code_defect > policy_host_blocked > env_* ์˜ ์ตœ๋Œ“๊ฐ’ ํ•˜๋‚˜๊ฐ€ ๊ทธ ํšŒ์ฐจ์˜ ๋ถ„๋ฅ˜๋‹ค. ์‚ฐ์ถœ๋ฌผ์€ docs/verification-failure-class-cocode.md.
  • Rationale: ์˜ต์…˜ 1 ์€ DD-21a ์˜ ๋„ค ๊ทœ์น™ ์ „๋ถ€๊ฐ€ ใ€Œ์ƒˆ ๊ฐ’์€ ์–ด๋А ์ชฝ์œผ๋กœ ์„ธ๋Š”๊ฐ€ใ€๋ฅผ ๋‹ค์‹œ ๋‹ตํ•˜๊ฒŒ ๋งŒ๋“ค๊ณ (๊ทœ์น™ 1 ์€ ์žฌ์‹œ๋„, ๊ทœ์น™ 3 ์€ โ‘ค ๊ฐœ๋ฐฉ์ด๋ผ ์„ฑ์งˆ์ด ๋‹ค๋ฅด๋‹ค) result ์˜ ๋ชจ๋“  ์†Œ๋น„์ž์— ๋ถ„๊ธฐ๋ฅผ ๋”ํ•œ๋‹ค. ์˜ต์…˜ 2 ๋Š” ๊ทธ ์žฌํ•ด์„์„ ํ•œ ๊ฑด๋„ ๋งŒ๋“ค์ง€ ์•Š์œผ๋ฉฐ โ€” result 3๊ฐ’ยทDD-21a ๋ฌธ๋ฉด ๋ถˆ๋ณ€ โ€” ์ด๋ฏธ result=๋Œ€์ƒ์—†์Œ ์„ ์ •๋ จํ•˜๋Š” no_target_code ์™€ ๋Œ€์นญ์ด๋ผ ์Šคํ‚ค๋งˆ์— ํŒจํ„ด์ด ํ•˜๋‚˜๋งŒ ๋‚จ๋Š”๋‹ค. ์˜ต์…˜ 3 ์€ ์ฑ„ํƒ ๋ถˆ๊ฐ€๋‹ค(DD-21 ํ™•์ •, #101 โ€” ๋‘ ์ถ•์€ ๋ณ„๊ฐœ ํ•„๋“œ). ํŒ์ • ์ ˆ์ฐจ๋Š” ์ˆœ์„œ ์žˆ๋Š” ์ „์—ญ ํ•จ์ˆ˜์ด๊ณ  ๋งˆ์ง€๋ง‰ ๊ฐˆ๋ž˜๊ฐ€ ํฌ๊ด„(code_defect)์ด๋ผ โ“ result=์‹คํŒจ ์ธ๋ฐ ๋ถ„๋ฅ˜๊ฐ€ ๋น„๋Š” ๊ฒฝ์šฐ๊ฐ€ ๊ตฌ์กฐ์ ์œผ๋กœ ์—†๊ณ  โ“‘ ์–‘์„ฑ ํ™˜๊ฒฝ ์‹ ํ˜ธ๊ฐ€ ์žˆ์„ ๋•Œ๋งŒ ๊ณ„์ˆ˜์—์„œ ๋น ์ง€๋ฏ€๋กœ ์•ˆ์ „์žฅ์น˜๋ฅผ ์‹ ํ˜ธ ์—†์ด ๋А์Šจํ•˜๊ฒŒ ํ•˜์ง€ ์•Š๋Š”๋‹ค. ๊ณ„์ˆ˜ ๊ทœ์น™์ด seed-spec:85ยทAC-07 ๊ณผ ๋ชจ์ˆœ๋˜์ง€ ์•Š๋Š” ์ด์œ : ๋‘ ๋ฌธ๋ฉด ๋ชจ๋‘ ใ€Œ์ƒํ•œ์„ ์ดˆ๊ณผํ•˜๋ฉด ์–ด๋–ป๊ฒŒ ๋˜๋Š”๊ฐ€ใ€๋งŒ ๊ทœ์ •ํ•˜๊ณ  ๋ฌด์—‡์ด ์นด์šดํ„ฐ๋ฅผ ์˜ฌ๋ฆฌ๋Š”์ง€๋Š” ๊ทœ์ •ํ•˜์ง€ ์•Š๋Š”๋‹ค โ€” ์ฆ๊ฐ€ ๊ทœ์น™์€ N3 ๊ณต๋ฐฑ์ด์—ˆ๊ณ  ์ด๋ฏธ state-machine ยง3 ์ด Design ์ธต์—์„œ ์ฑ„์šด ์ž๋ฆฌ๋‹ค.
  • ์ธต์œ„: Design ๋งŒ์œผ๋กœ ์„ฑ๋ฆฝํ•œ๋‹ค. verification_log ์˜ ์Šคํ‚ค๋งˆ๋Š” PRD ๊ฐ€ ใ€Œยง3 ์€ ๋‹ด์„ ๋‚ด์šฉ๋งŒ ๊ทœ์ •ํ•˜๊ณ  ํ˜•์‹์€ โ†’ Designใ€์œผ๋กœ ๋ช…์‹œ ์œ„์ž„ํ–ˆ๊ณ , ์ƒํ•œ์˜ ์กด์žฌ ์š”๊ฑด์€ AC-08 ๊ณผ ๊ฐ™์€ ํ˜•์‹์ด๋ฉฐ, ๋„์ฐฉ ์ƒํƒœ๋Š” ๊ธฐ์กด ์‹คํŒจ(49์นธ ํ‘œ์˜ โ‘ช ์นธ)๋ผ ์ƒˆ status ๊ฐ’๋„ ์ƒˆ ์ „์ด ์นธ๋„ ๋งŒ๋“ค์ง€ ์•Š๋Š”๋‹ค. Seed Spec ๊ฐœ์ • ๋ถˆ์š” โ€” seed-spec:8 ์˜ ๊ฐœ์ • ์ค‘๋‹จ ์ƒํƒœ์™€ ์ถฉ๋Œํ•˜์ง€ ์•Š๋Š”๋‹ค.
  • Impact:
    • docs/verification-failure-class-cocode.md ์‹ ์„ค โ€” failure_class ๊ฐ’ ์ง‘ํ•ฉ์˜ SSOT.
    • flow-permutation FP-111 ํ•ด์†Œ ยท I-8 ์•ž ์ ˆ๋ฐ˜ ํ•ด์†Œ(๋’ค ์ ˆ๋ฐ˜ = AC-08 ใ€Œ๊ธฐ๋ก vs ์ „์ดใ€๋Š” #67).
    • ux-spec ยง3.2 โ€” ์‹คํŒจ ์ง„์ž… ๊ฒฝ๋กœ 3์ข… โ†’ 4์ข…(E-4 ํ™˜๊ฒฝ ์‹คํŒจ ์ƒํ•œ ์ดˆ๊ณผ), ์‚ฌ์œ ๋Š” ํ์‡„ ๋ผ๋ฒจ. UX-D-25 ์‹ ์„ค(์ฝ”๋“œ ์ง‘ํ•ฉ์€ ๊ฒ€์ฆ ๋ฌธ์„œ ์†Œ์œ , ์ด ๋ฌธ์„œ๋Š” ๋ผ๋ฒจ๋งŒ ์†Œ์œ ). ใ€Œ์‚ฌ์œ  ๋ฏธ๊ทœ์ •ใ€ ์ž๋ฆฌํ‘œ์‹œ์ž๋Š” ๋น„์ •์ƒ ์ข…๋ฃŒ ์ž‘์—… ์ž์‹ ์˜ status ํ•˜๋‚˜๋กœ ์ข์•„์ง„๋‹ค(ยง9 ๋ฏธ๊ฒฐ 8, ๋ฒ”์œ„ ๋ฐ–).
    • bdd Feature 4 ์— Scenario: [AC-07] 3๊ฑด ์ถ”๊ฐ€(ํ™˜๊ฒฝ ์‹คํŒจ / ์ฝ”๋“œ ๊ฒฐํ•จ / ๊ฐ™์€ ์‹คํŒจ ํšŸ์ˆ˜์˜ ๋Œ€์กฐ).
    • #63ยท#66 ์— ๋„˜์–ด๊ฐ€๋Š” ๋ฐ˜์˜ ์š”์ฒญ 5๊ฑด์€ ์‚ฐ์ถœ ๋ฌธ์„œ ยง8 ํ‘œ์— ์žˆ๋‹ค. attempt_no ๋Š” retry_count ์™€ ๊ฐ™์€ ์‹œ์ ์— ์˜ค๋ฅด๋ฏ€๋กœ(seed-spec:92) ํ™˜๊ฒฝ ์žฌ์‹คํ–‰์€ ์ƒˆ ํšŒ์ฐจ๋ฅผ ๋งŒ๋“ค์ง€ ์•Š๋Š”๋‹ค.
  • Source: #73 ์ธ์ˆ˜์กฐ๊ฑด 1~10 (ํŒ์ • ์ฃผ์ฒด Design) ยท ์„ ํ–‰ ํ™•์ • #101 ยท ์ƒํ•œ ๊ฐ’์€ Planning(ยง9 ๋ฏธ๊ฒฐ 2 ์™€ ๊ฐ™์€ ํšŒ์ฐจ)

D-056: ์ž๊ฐ€ ๊ฒ€์ฆ ์‹œ๋„ ์‹œ๊ฐ„ ์ƒํ•œ ์ดˆ๊ณผ์˜ ์ •๋ณธ์€ ใ€Œ๊ธฐ๋กใ€ โ€” ์ „์ด๋Š” ์žฌ์‹œ๋„ ์˜ˆ์‚ฐ์ด ์†Œ์ง„๋  ๋•Œ๋งŒ

  • Date: 2026-09-13
  • Context: ์ด์Šˆ #67. seed-spec ์˜ ๋‘ ๋ฌธ๋ฉด์ด ์–ด๊ธ‹๋‚œ๋‹ค โ€” AC-08(ยง4)์€ ใ€Œ๊ทธ ์‹œ๋„๊ฐ€ ์ค‘๋‹จ๋˜๊ณ  ์‹คํŒจ๋กœ ๊ธฐ๋ก๋œ๋‹คใ€๋กœ ์ฃผ์–ด๊ฐ€ ์‹œ๋„์ด๊ณ , ๋ถˆ๋ณ€์‹ 4(ยง3)๋Š” ใ€Œ๋‹จ์ผ ์ž๊ฐ€ ๊ฒ€์ฆ ์‹œ๋„๊ฐ€ ์„ค์ •๋œ ์‹œ๊ฐ„ ์ƒํ•œ์„ ๋„˜๊ธฐ๋ฉด ใ€Œ์‹คํŒจใ€๋กœ ์ „์ดํ•˜๊ณ  ์‚ฌ๋žŒ์—๊ฒŒ ์—์Šค์ปฌ๋ ˆ์ด์…˜ํ•œ๋‹คใ€๋กœ ์ฃผ์–ด๊ฐ€ ์ž‘์—…์ด๋‹ค. ๋ฌธ์ž ๊ทธ๋Œ€๋กœ ์ฝ์œผ๋ฉด ํ•œ ๋ฒˆ์˜ ์ดˆ๊ณผ๊ฐ€ ๊ณง ์ž‘์—… ์ข…๊ฒฐ์ด๋ฉฐ, ๊ฒฐ๋ก ์— ๋”ฐ๋ผ ์ข…๊ฒฐ ์ƒํƒœ ์ƒ์„ฑ ์—ฌ๋ถ€๊ฐ€ ๊ฐˆ๋ฆฐ๋‹ค(prd ยง4.1 ยท flow-permutation I-8 ๋’ค ์ ˆ๋ฐ˜ ยท FP-104).
  • Options:
    1. ใ€Œ๊ธฐ๋กใ€์ด ์ •๋ณธ โ€” ์‹œ๋„๋งŒ ์ค‘๋‹จยท๊ธฐ๋กํ•˜๊ณ  ์ผ๋ฐ˜ ์‹คํŒจ ๊ฒฝ๋กœ๋กœ ํ•ฉ๋ฅ˜
    2. ใ€Œ์ „์ดใ€๊ฐ€ ์ •๋ณธ โ€” ์ฒซ ์ดˆ๊ณผ์—์„œ ์ฆ‰์‹œ ์‹คํŒจ ์ „์ด
  • Decision: ์˜ต์…˜ 1 โ€” ใ€Œ๊ธฐ๋กใ€์ด ์ •๋ณธ. ์‹œ๊ฐ„ ์ดˆ๊ณผ๋Š” ๊ทธ ์‹œ๋„๋งŒ ์ค‘๋‹จํ•˜๊ณ  verification_log ์— result: ์‹คํŒจ ๋ฅผ ๋‚จ๊ธฐ๋ฉฐ, ๊ทธ ๋’ค๋Š” ์ผ๋ฐ˜ ์ž๊ฐ€ ๊ฒ€์ฆ ์‹คํŒจ์™€ ์™„์ „ํžˆ ๊ฐ™์€ ๊ฒฝ๋กœ(DD-21a-1 โ†’ ์žฌ์‹œ๋„)๋‹ค. retry_count ๊ฐ€ 3 ์„ ์ดˆ๊ณผํ•  ๋•Œ ๋น„๋กœ์†Œ โ‘ช(์ž๊ฐ€๊ฒ€์ฆ์ค‘ โ†’ ์‹คํŒจ)๋กœ ๊ฐ„๋‹ค. ํ•จ๊ป˜ ์‹œ๊ฐ„ ์ดˆ๊ณผ ์‹œ๋„์˜ failure_class ๋ฅผ failure:code_defect ๋กœ ๊ท€์†์‹œํ‚ค๊ณ  D-055 ํŒ์ • ์ ˆ์ฐจ์— ๊ฐˆ๋ž˜ 0 ์„ ์ถ”๊ฐ€ํ•œ๋‹ค. ์‚ฐ์ถœ๋ฌผ์€ docs/verification-timeout-canon-cocode.md.
  • Rationale: ๊ฒฐ์ •์  ๊ทผ๊ฑฐ๋Š” D-033 ์ž์‹ ์ด๋‹ค. ์˜ค๋„ˆ๊ฐ€ ๋น„์ค€ํ•œ ๊ทธ ๊ฒฐ์ •์˜ ใ€ŒํŒŒ๊ธ‰ใ€ ์ฒซ ์ค„์ด ใ€ŒC-04 ์žฌ์‹œ๋„ 3ํšŒ์™€ ๊ณฑํ•ด ์ž‘์—…๋‹น ์ž๊ฐ€ ๊ฒ€์ฆ ์ƒ๊ณ„ 60๋ถ„ใ€์ธ๋ฐ, ์ด ๊ณฑ์…ˆ์€ ์‹œ๊ฐ„ ์ดˆ๊ณผ ์‹œ๋„๊ฐ€ ์žฌ์‹œ๋„๋œ๋‹ค๋Š” ๊ฒƒ์„ ์ „์ œํ•œ๋‹ค โ€” ใ€Œ์ „์ดใ€๊ฐ€ ์ •๋ณธ์ด๋ฉด ์ƒ๊ณ„๋Š” 20๋ถ„์ด๊ณ  ๊ณฑ์…ˆ์ด ์„ฑ๋ฆฝํ•˜์ง€ ์•Š๋Š”๋‹ค. ์ฆ‰ ๊ฐ’ ๊ฒฐ์ • ์ž์ฒด๊ฐ€ ใ€Œ๊ธฐ๋กใ€ ํ•ด์„ ์œ„์— ์„œ ์žˆ์—ˆ๊ณ  ์ด ๋ฌธ์„œ๋Š” ๊ทธ๊ฒƒ์„ ๋ช…์‹œ์ ์œผ๋กœ ๋งŒ๋“ค ๋ฟ์ด๋‹ค. ๋ณด์กฐ ๊ทผ๊ฑฐ ์…‹: โ“ ใ€Œ์ „์ดใ€๋ฅผ ๊ณ ๋ฅด๋ฉด ์‹œ๊ฐ„ ์ดˆ๊ณผ์— ๋Œ€ํ•œ ์žฌ์‹œ๋„๊ฐ€ 0ํšŒ๋ผ C-04 ๊ฐ€ ์ƒํ•œ๊ณผ ์žฌ์‹œ๋„๋ฅผ ๋‚˜๋ž€ํžˆ ๋‘” ๋ถ„์—…์ด ์‚ฌ๋ผ์ง„๋‹ค โ“‘ ๋‘ ๋ฌธ๋ฉด์˜ ์ฃผ์–ด๊ฐ€ ๋‹ค๋ฅด๋ฏ€๋กœ(์‹œ๋„ vs ์ž‘์—…) ใ€Œ๊ธฐ๋กใ€ ์•„๋ž˜์—์„œ๋Š” ๋ชจ์ˆœ์ด ์•„๋‹ˆ์ง€๋งŒ, ใ€Œ์ „์ดใ€ ์•„๋ž˜์—์„œ๋Š” AC-08 ์˜ ใ€Œ๊ธฐ๋ก๋œ๋‹คใ€๊ฐ€ ์•„๋ฌด ๋ฐ๋„ ์“ฐ์ด์ง€ ์•Š๋Š” ์ฃฝ์€ ๋ง์ด ๋œ๋‹ค โ“’ 20๋ถ„์€ ์‹ค์ธก(GHA ์ตœ๋Œ€ 8.9๋ถ„)์˜ 2๋ฐฐ ๋‚จ์ง“์ด๋ผ ์ •์ƒ ์ž‘์—…์ด ํ•œ ๋ฒˆ์ฏค ๋„˜๊ธธ ์ˆ˜ ์žˆ๋Š” ๊ฐ’์ด๊ณ , ์žฌ์‹œ๋„ ์—†์ด ์ฃฝ์ด๋Š” ๊ฒƒ์€ ์•ˆ์ „์ด ์•„๋‹ˆ๋ผ ๊ฑฐ์ง“ ์‹คํŒจ๋‹ค. ์–ด๋А ์ชฝ์„ ๊ณจ๋ผ๋„ ์ž‘์—…์€ ์œ ํ•œ ์‹œ๊ฐ„(โ‰ค 60๋ถ„)์— ๋ฐ˜๋“œ์‹œ ์ข…๊ฒฐํ•œ๋‹ค.
  • failure_class ๊ท€์†: ์‹œ๊ฐ„ ์ƒํ•œ์œผ๋กœ ์šฐ๋ฆฌ๊ฐ€ ์ฃฝ์ธ ํ”„๋กœ์„ธ์Šค๋Š” D-055 ยง3.2 ์˜ 4๋ฒˆ(ใ€Œ์‹œ๊ทธ๋„ ์ข…๋ฃŒ โ€ฆ ์ง„๋‹จ 0๊ฑดใ€)์— ๋จผ์ € ๊ฑธ๋ ค ํ™˜๊ฒฝ ์‹คํŒจ๋กœ ์˜ค๋ถ„๋ฅ˜๋˜๊ณ  ๊ณ„์ˆ˜๋˜์ง€ ์•Š์•„ 60๋ถ„ ์ƒ๊ณ„๊ฐ€ ๊นจ์ง„๋‹ค. ๊ทธ๋ž˜์„œ ๊ฐˆ๋ž˜ 0(์šฐ๋ฆฌ๊ฐ€ ์ง์ ‘ ์ค‘๋‹จํ–ˆ๋Š”๊ฐ€ โ†’ code_defect)์„ ๋งจ ์•ž์— ๋‘”๋‹ค โ€” ๊ทธ ์‹œ๊ทธ๋„์€ ์šฐ๋ฆฌ๊ฐ€ ๋ณด๋‚ธ ๊ฒƒ์ด๋ผ ๋„๊ตฌ์˜ ๊ฑฐ๋™ ์ •๋ณด๋ฅผ ๋‹ด์ง€ ์•Š๋Š”๋‹ค. code_defect ์ธ ์ด์œ : ์‹œ๊ฐ„ ์ดˆ๊ณผ๊ฐ€ ๊ฐ€์žฅ ํŠน์ด์ ์œผ๋กœ ์žก๋Š” ์‹คํŒจ ๋ชจ๋“œ๋Š” ์ˆ˜๋ ดํ•˜์ง€ ์•Š๋Š” ์ฝ”๋“œ(์—์ด์ „ํŠธ๊ฐ€ ๊ณ ์น  ์ˆ˜ ์žˆ๋‹ค)์ด๊ณ , ๊ณ„์ˆ˜ํ•˜๋Š” ์ชฝ์ด ํ˜„ํ–‰ ๊ฑฐ๋™์ด๋ผ ์•ˆ์ „์žฅ์น˜๋ฅผ ๋А์Šจํ•˜๊ฒŒ ํ•˜์ง€ ์•Š์œผ๋ฉฐ, ์ •๋ง๋กœ ๋А๋ฆฐ ํ™˜๊ฒฝ์˜ ํ•ด์†Œ ๊ฒฝ๋กœ๋Š” ์žฌ์‹œ๋„๊ฐ€ ์•„๋‹ˆ๋ผ ์ƒํ•œ ์„ค์ • ๋ณ€๊ฒฝ์ด๋‹ค(AC-08 ์ด ๊ฐ’์„ ์„ค์ • ํ•ญ๋ชฉ์œผ๋กœ ๋‘” ์ด์œ ). ํ์‡„ ์ง‘ํ•ฉ์€ ๊ทธ๋Œ€๋กœ 5์ข… โ€” ์ˆœ์„œ๋งŒ ๋ฐ”๋€Œ์—ˆ๋‹ค.
  • ์ „์ดํ‘œ ๋ฐ˜์˜: state-machine โ‘ช ํ–‰์—์„œ T-5 ๋ฅผ ์ง์ ‘ ํŠธ๋ฆฌ๊ฑฐ์—์„œ ์ œ์™ธํ•œ๋‹ค(์นธ์˜ ํŒ์ •์€ ๋ถˆ๋ณ€ โ€” ๋„๋‹ฌ ๊ฒฝ๋กœ๊ฐ€ ํ•˜๋‚˜ ์ค„ ๋ฟ). ยง6 ์˜ ใ€Œโ‘ช ์˜ ๋‹จ์ผ ์‹œ๋„ ์‹œ๊ฐ„ ์ƒํ•œ ๊ฐ’ใ€ ํ–‰์€ ํ•ด์†Œ(๊ฐ’ = 20๋ถ„ / D-033, ์˜๋ฏธ = ์ด ๊ฒฐ์ •). SelfVerificationTimedOut ์€ ์ „์ด ์‚ฌ๊ฑด์ด ์•„๋‹ˆ๋‹ค โ€” #66 ์ด ๊ทธ ๊ฑฐ๋ถ€ ๊ฒฝ๋กœ๋ฅผ ์ œ๊ฑฐํ•˜๊ณ  ๊ธฐ์กด SelfVerificationFailed ๋กœ ์ˆ˜๋ ด์‹œํ‚จ๋‹ค. ์ƒˆ status ๊ฐ’๋„ ์ƒˆ ์ „์ด ์นธ๋„ ๋งŒ๋“ค์ง€ ์•Š๋Š”๋‹ค.
  • ํ•จ๊ป˜ ๋‹ซํžŒ ๊ฒƒ: FP-104 ์˜ ใ€Œ์ค‘๋‹จ๋œ ์‹œ๋„์˜ ๋ถ€๋ถ„ ํŽธ์ง‘ ์ฒ˜๋ถ„ใ€ โ€” ๊ฒ€์ฆ ์ค‘๋‹จ์€ ํŽธ์ง‘์„ ๋งŒ๋“ค์ง€๋„ ์ง€์šฐ์ง€๋„ ์•Š๊ณ , ํŽธ์ง‘์€ EditSnapshot.attempt_no ๋กœ ํšŒ์ฐจ์— ๋ฌถ์—ฌ ๋ณด์กด๋˜๋ฉฐ(D-030) ์‹คํŒจํ•ด๋„ AC-19 ๊ฐ€ diffยท๋กค๋ฐฑ์„ ๋ณด์žฅํ•œ๋‹ค. ์ƒˆ ๊ทœ์น™์ด ํ•„์š” ์—†๋‹ค.
  • ยซ๊ฐœ์ • ์š”์ฒญยป(์˜ค๋„ˆ ํŒ์ •): seed-spec ยง3 ๋ถˆ๋ณ€์‹ 4 ์˜ ๋‘ ๋ฒˆ์งธ ์ด์ ‘์ง€๋ฅผ ์‹œ๋„ ์ˆ˜์ค€ ์‚ฌ๊ฑด์œผ๋กœ ์ฝํžˆ๊ฒŒ ๊ณ ์นœ๋‹ค. ยง3 ๋จธ๋ฆฌ๋ง์ด ๊ธฐ์กด ์—”ํ‹ฐํ‹ฐ ์ˆ˜์ • ๋ถˆ๊ฐ€๋ฅผ ๊ทœ์ •ํ•˜๊ณ  seed-spec:8 ์ด ๊ฐœ์ • ์ค‘๋‹จ ์ƒํƒœ๋ผ ๋ฌธ์„œ ๊ฒฐ์ •์ด๋‹ค. ํŒ์ • ์ „๊นŒ์ง€ ๊ตฌํ˜„์€ ์ด ์ •๋ณธ(๊ธฐ๋ก)์„ ๋”ฐ๋ฅธ๋‹ค โ€” ์˜ค๋„ˆ๊ฐ€ ์ด๋ฏธ ๋น„์ค€ํ•œ D-033 ์˜ 60๋ถ„ ์ƒ๊ณ„์™€ ์ •ํ•ฉํ•˜๋Š” ์œ ์ผํ•œ ์ฝ๊ธฐ์ด๊ธฐ ๋•Œ๋ฌธ์ด๋‹ค. ๊ธฐ๊ฐ๋˜๋ฉด โ‘ช ํ–‰์— T-5 ๋ฅผ ๋˜๋Œ๋ฆฌ๊ณ  D-033 ์˜ 60๋ถ„ ๋ฌธ์žฅ์„ 20๋ถ„์œผ๋กœ ์ •์ •ํ•ด์•ผ ํ•œ๋‹ค.
  • ์ƒํ•œ ๊ฐ’์˜ ์„ ํƒ ์ฃผ์ฒดยท์‹œ์ (์ธ์ˆ˜์กฐ๊ฑด 2): ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ยท 2026-09-10 ยท #106 โ†’ D-033 ยท 20๋ถ„(planning-inputs ยง7.1). ์กฐ์ •์€ Planning(#96 ์‹ค์ธก ํ›„ B-1 ์žฌ์‚ฐ์ •). ์ด Story ๋Š” ๊ฐ’์„ ์‚ฐ์ถœํ•˜์ง€ ์•Š์•˜๋‹ค.
  • Source: #67 ์ธ์ˆ˜์กฐ๊ฑด 1ยท2 (ํŒ์ • ์ฃผ์ฒด Design) ยท ์„ ํ–‰ ๊ฐ’ ๊ฒฐ์ • D-033 ยท ์„ ํ–‰ ๋ถ„๋ฅ˜ D-055

D-057: ์Šน์ธ ๊ทœ์น™ 5์ข… ํ™•์ • โ€” ๊ฑฐ๋ถ€ ๊ฒฝ๋กœ ยท ๋ฌด์‘๋‹ต ๋ฌด์ œํ•œ ยท ์Šน์ธ 2์ข… ์ˆœ์ฐจ ยท forward apply ์žฌ๊ฒ€์‚ฌ (override ๋Š” ์ž‘์—… ๊ฐ€์„ค)

  • Date: 2026-09-13
  • Context: ์ด์Šˆ #70. ์Šน์ธ ๊ณ„์—ด ๋ฏธ๊ฒฐ 5์ข…์ด ํ•œ ํ‘œ๋กœ ๋ฌถ์—ฌ ์žˆ์—ˆ๋‹ค โ€” โ“ ์Šน์ธ ๊ฑฐ๋ถ€๊ฐ€ ์–ด๋А status ๋กœ ๊ฐ€๋Š”์ง€ โ“‘ ์Šน์ธ๋„ ๋กค๋ฐฑ๋„ ์—†๋Š” ๋ฌด์‘๋‹ต์˜ ์ฒ˜๋ถ„(prd ํ๋ฆ„ 3-A 8๋‹จ๊ณ„) โ“’ ์™„๋ฃŒ์Šน์ธยทํ…Œ์ŠคํŠธ๋ณ€๊ฒฝ์Šน์ธ์ด ๋ชจ๋‘ ํ•„์š”ํ•  ๋•Œ์˜ ์ˆœ์„œยท๋ณต๊ท€ ์ƒํƒœยทpending_approval_kind ๋ฆฌ์…‹(flow C-2 / FP-208) โ““ completion_mode override ๊ฐ€๋ถ€(prd D-18) โ“” ์Šน์ธ ๋Œ€๊ธฐ ์ค‘ ์ž ๊ธˆ์ด ํ•ด์ œ๋˜์–ด ์ƒ๊ธฐ๋Š” forward apply ์ถฉ๋Œ(flow C-3 / FP-210).
  • Decision: ์‚ฐ์ถœ๋ฌผ์€ docs/approval-rules-cocode.md. ๋‹ค์„ฏ ๊ฒฐ๋ก :
    1. ๊ฑฐ๋ถ€ โ†’ ๊ฑฐ๋ถ€๋จ. ๊ฐ’์€ D-032(#105, ์˜ค๋„ˆ)๊ฐ€ ์ด๋ฏธ ์‹ ์„คํ–ˆ์œผ๋ฏ€๋กœ ์ด Story ๋Š” ์ „์ด ๊ทœ์น™์„ ์ •ํ•œ๋‹ค โ€” ์ถœ๋ฐœ์€ ์‚ฌ๋žŒ์Šน์ธ๋Œ€๊ธฐ ํ•˜๋‚˜์ด๊ณ  kind ๋‘ ์ข…๋ฅ˜๊ฐ€ ๊ฐ™๋‹ค. ๊ฑฐ๋ถ€๋Š” ์ ์šฉ์„ ๋งŒ๋“ค์ง€ ์•Š์œผ๋ฉฐ(๋˜๋Œ๋ฆฌ๋Š” ๊ฒƒ์€ ๋กค๋ฐฑ), ํŽธ์ง‘์€ ๋‚จ๊ณ (AC-23) ๊ฑฐ๋ถ€๋จ โ†’ ๋กค๋ฐฑ๋จ ์€ ์š”๊ตฌ๋œ๋‹ค.
    2. ๋ฌด์‘๋‹ต์— ์‹œ๊ฐ„ ์ƒํ•œ์„ ๋‘์ง€ ์•Š๋Š”๋‹ค. ์ž๋™ ์ „์ด ์—†์Œ.
    3. ์Šน์ธ 2์ข…์€ ์ˆœ์ฐจ ๋ฐฐ์น˜ โ€” ํ…Œ์ŠคํŠธ๋ณ€๊ฒฝ์Šน์ธ์ด ๋จผ์ €. ๋ณต๊ท€๋Š” ํ…Œ์ŠคํŠธ๋ณ€๊ฒฝ์Šน์ธ ยซ์Šน์ธยป โ†’ ํ•ญ์ƒ ์‹คํ–‰์ค‘(retry_count ๋ถˆ๋ณ€), ์™„๋ฃŒ์Šน์ธ ยซ์Šน์ธยป โ†’ ์™„๋ฃŒ, ๊ฑฐ๋ถ€ โ†’ ๊ฑฐ๋ถ€๋จ, ๋กค๋ฐฑ โ†’ ๋กค๋ฐฑ๋จ. ๋ฆฌ์…‹์€ ์—”ํ‹ฐํ‹ฐ ์ƒ์„ฑ์ž๊ฐ€ ๊ฐ•์ œํ•œ๋‹ค.
    4. completion_mode override ๋ถˆ๊ฐ€ โ€” โš ๏ธ ์ž‘์—… ๊ฐ€์„ค(ํ™•์ •์€ #111).
    5. forward apply ๋Š” ์ ์šฉ ์ง์ „์— ์žฌ๊ฒ€์‚ฌํ•˜๊ณ  ๋‹ค๋ฅด๋ฉด ์ž๋™ ์ ์šฉํ•˜์ง€ ์•Š๊ณ  ์ถฉ๋Œ ์ œ์‹œ. ์ถฉ๋Œ ์‹œ ์ž‘์—…์€ ์‚ฌ๋žŒ์Šน์ธ๋Œ€๊ธฐ ์— ๋จธ๋ฌธ๋‹ค.
  • Rationale:
    • 2(๋ฌด์‘๋‹ต): #77 ์ด ์ž ๊ธˆ ๋Œ€๊ธฐ์— ๋Œ€ํ•ด ์“ด ๊ฒƒ๊ณผ ๊ฐ™์€ ํ˜•ํƒœ์˜ ๋…ผ๊ฑฐ โ€” ์ƒํ•œ์„ ๋‘์ง€ ์•Š๋˜ ๊ทผ๊ฑฐ๊ฐ€ ใ€Œ๋ฌด๋ฐฉ๋น„ใ€๊ฐ€ ์•„๋‹ˆ๋ผ ๊ตฌ์กฐ์ ์ด๋‹ค. โ“ ์Šน์ธ ๋Œ€๊ธฐ๋Š” ๋ฆฌ์Šค๋ฅผ ํ•ด์ œํ•˜๊ณ (seed:74) ๋Œ€๊ธฐ์—ด๋„ ์žก์ง€ ์•Š์•„(#77 ยง4) ์ž์›์„ ์ ์œ ํ•˜์ง€ ์•Š์œผ๋ฏ€๋กœ C-5 ๊ฐ€ ๊ฒฝ๊ณ„ํ•œ ๋ฌดํ•œ ์ฒด๋ฅ˜์˜ ์ „์ œ๊ฐ€ ์—†๋‹ค โ“‘ ์ถœ๊ตฌ๊ฐ€ ๊ฑฐ๋ถ€(AC-23)ยท๋กค๋ฐฑ(โ‘ฌ) ์œผ๋กœ ํ•ญ์ƒ ๋‘˜ ์—ด๋ ค ์žˆ๊ณ , AC-23 ์˜ ใ€Œ๋ฌดํ•œ ๋Œ€๊ธฐํ•˜์ง€ ์•Š๋Š”๋‹คใ€๋Š” ์ถœ๊ตฌ์˜ ์กด์žฌ๋กœ ์ถฉ์กฑ๋˜๋Š” ์š”๊ฑด์ด๋‹ค(When ์ด ใ€Œ์‚ฌ์šฉ์ž๊ฐ€ ์Šน์ธ์„ ๊ฑฐ๋ถ€ํ•˜๋ฉดใ€์ด๋ผ ์‚ฌ์šฉ์ž ์ž…๋ ฅ์ด ์ „์ œ) โ“’ ์ž๋™ ์ข…๊ฒฐ์€ ๊ฐ’์„ ์ง€์–ด๋‚ด์•ผ ํ•˜๋Š”๋ฐ ใ€Œ์‚ฌ๋žŒ์ด ํœด๊ฐ€๋ฅผ ๊ฐ€๋Š” ๊ธฐ๊ฐ„ใ€์€ ๋„๊ตฌ๊ฐ€ ์žด ์ˆ˜ ์žˆ๋Š” ์–‘์ด ์•„๋‹ˆ๋‹ค โ““ ์ž๋™ ์ข…๊ฒฐ์€ ์‚ฌ๋žŒ๋งŒ ํ•  ์ˆ˜ ์žˆ๋Š” ํŒ์ •์„ ์‹œ์Šคํ…œ์ด ๋Œ€์‹ ํ•˜๋Š” ๊ฒƒ์ด๋ผ AC-10ยทAC-17 ์˜ ์ทจ์ง€๋ฅผ ์šฐํšŒํ•œ๋‹ค. ์ƒํ•œ ๋Œ€์‹  ๊ฐ€์‹œ์„ฑ(๋ณต๊ท€ ๋ณด๋“œ์˜ ใ€Œ์Šน์ธ ๋Œ€๊ธฐ Nใ€)์œผ๋กœ ์ฒ˜๋ถ„ํ•˜๋ฉฐ, ์‹œ๊ฐ ์†์„ฑ์ด ์—†์œผ๋ฏ€๋กœ ใ€ŒN์ผ ๊ฒฝ๊ณผใ€๋Š” ๊ทธ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค.
    • 3(์ˆœ์„œ): ์ƒˆ ๊ทœ์น™์ด ์•„๋‹ˆ๋ผ ์ •์˜์˜ ๊ท€๊ฒฐ์ด๋‹ค โ€” ํ…Œ์ŠคํŠธ๋ณ€๊ฒฝ์Šน์ธ์€ ใ€Œ์ ์šฉ ์ง์ „ใ€(C-05), ์™„๋ฃŒ์Šน์ธ์€ ใ€ŒํŽธ์ง‘์„ ๋งˆ์นœ ๋’คใ€(๋ถˆ๋ณ€์‹ 2)์ด๊ณ  ์ ์šฉ์€ ํŽธ์ง‘ ์™„๋ฃŒ๋ณด๋‹ค ์•ž์„ ๋‹ค. ๋ฐ˜๋Œ€ ์ˆœ์„œ๋Š” ์™„๋ฃŒ์Šน์ธ ํ™”๋ฉด์˜ diff ๊ฐ€ ์ตœ์ข…๋ณธ์ด ์•„๋‹ˆ๊ฒŒ ๋˜์–ด AC-10ยทAC-01 ์„ ๊นฌ๋‹ค. ๋”ฐ๋ผ์„œ ๋‘ kind ๊ฐ€ ๋™์‹œ์— ํ•„์š”ํ•œ ์‹œ์ ์ด ์—†๊ณ  ๋‹จ์ผ ๊ฐ’ enum ์œผ๋กœ ์ถฉ๋ถ„ํ•˜๋‹ค(C-2 ๊ฐ€ ์ ์—ˆ๋“ฏ ๊ฒฐํ•จ์€ ํ‘œํ˜„๋ ฅ์ด ์•„๋‹ˆ๋ผ ๊ทœ์น™ ๋ถ€์žฌ์˜€๋‹ค).
    • 3(๋ณต๊ท€): ์ง„์ž… ์ถœ๋ฐœ ์ƒํƒœ๋ฅผ ๋‹ด๋Š” ์†์„ฑ์ด ์—†์–ด ์„ธ ์•ˆ ์ค‘์—์„œ ๊ณจ๋ž๋‹ค. ์†์„ฑ ์‹ ์„ค์€ Seed Spec ๊ฐœ์ • ์„ ํ–‰(ยง3 ๋จธ๋ฆฌ๋ง)์ด๋ผ ๊ธฐ๊ฐ. ํ•ญ์ƒ ์‹คํ–‰์ค‘ ์ด ์˜๋ฏธ์ƒ์œผ๋กœ๋„ ์˜ณ๋‹ค โ€” ์ ์šฉ๋œ ๊ฒƒ์ด ํ…Œ์ŠคํŠธ ํŒŒ์ผ์ด๋ผ C-04 โ‘ก์˜ ๋Œ€์ƒ ์ž์ฒด๊ฐ€ ๋ฐ”๋€Œ์—ˆ๊ณ , ๊ทธ ์ด์ „ ์ž๊ฐ€ ๊ฒ€์ฆ ๊ฒฐ๊ณผ๋Š” ๋ฌดํšจ๋‹ค. ์ž๊ฐ€๊ฒ€์ฆ์ค‘ ์œผ๋กœ ๋˜๋Œ์•„๊ฐ€ ์ด์–ด์„œ ๊ฒ€์ฆํ•˜๋ฉด ์˜› ํ…Œ์ŠคํŠธ ๊ธฐ์ค€์˜ ํŒ์ •์„ ์“ด๋‹ค. retry_count ๋Š” ์ฆ๊ฐ€ํ•˜์ง€ ์•Š๋Š”๋‹ค โ€” ์ฆ๊ฐ€ ์ง€์ ์€ โ‘ง ํ•˜๋‚˜์ด๊ณ (state-machine ยง3), ์‚ฌ๋žŒ์˜ ์Šน์ธ ํ–‰์œ„๊ฐ€ ์žฌ์‹œ๋„ ์˜ˆ์‚ฐ์„ ๋จน์œผ๋ฉด ์•ˆ ๋œ๋‹ค.
    • 3(๋ฆฌ์…‹): ๊ทœ์น™์œผ๋กœ ์ ๊ณ  ๊ฐ ์ „์ด๊ฐ€ ์ง€ํ‚ค๊ธฐ๋ฅผ ๊ธฐ๋Œ€ํ•˜๋Š” ๋Œ€์‹  ์—”ํ‹ฐํ‹ฐ ์ƒ์„ฑ์ž์˜ ์ •ํ•ฉ์„ฑ ๊ฒ€์‚ฌ์— ๋งก๊ธด๋‹ค(status != awaitingApproval ์ด๋ฉด kind ๋Š” none). ๋ฆฌ์…‹์„ ๋น ๋œจ๋ฆฐ ์ „์ด๋Š” ์ฝ”๋“œ๊ฐ€ ๋งŒ๋“ค์–ด์ง€์ง€ ์•Š๋Š”๋‹ค โ€” C-2 ์˜ ใ€Œ์Šน์ธ ๋’ค ์‚ฌ๋žŒ์Šน์ธ๋Œ€๊ธฐ ์ž”๋ฅ˜ใ€๊ฐ€ ํ‘œํ˜„ ๋ถˆ๊ฐ€๋Šฅํ•ด์ง„๋‹ค.
    • 4(override): #111 ์˜ ์„ ํƒ์ง€ โ‘ก(์กฐ๊ฑด ์—†์ด ํ—ˆ์šฉ)๋Š” A-02 ๋ฏธ๊ฒ€์ฆ ์ƒํƒœ์—์„œ ์ž๊ฐ€๊ฒ€์ฆ ์™„๋ฃŒ ๊ฒฝ๋กœ๋ฅผ ์—ด์–ด AC-17 ์ „ํ™˜ ์กฐํ•ญ ์ž์ฒด๋ฅผ ๋ฌด๋ ฅํ™”ํ•œ๋‹ค โ€” C-04 ๊ฐ€ ๊ทธ ์ „ํ™˜์„ ใ€Œ์ œ์•ฝ์ด ๋ฏธ๋ฆฌ ๊ทœ์ •ํ•œ ๋™์ž‘ใ€์œผ๋กœ ์ ์€ ์ด์ƒ ํ† ๊ธ€ ํ•˜๋‚˜๋กœ ๊บผ์งˆ ์ˆ˜ ์—†๋‹ค. ์„ ํƒ์ง€ โ‘ข(์ „ํ™˜ ์กฐํ•ญ ๋ฏธ๋ฐœ๋™ ์‹œ์—๋งŒ ํ—ˆ์šฉ)์€ ์ง€๊ธˆ ํŒ์ • ๋ถˆ๊ฐ€๋‹ค: ๋ฐœ๋™ ์—ฌ๋ถ€๊ฐ€ A-02 ํ•ฉ๊ฒฉ ๊ธฐ์ค€์— ์ข…์†ํ•˜๋Š”๋ฐ ๊ทธ ๊ธฐ์ค€์ด ๋ฏธ์„ค์ •์ด๋ผ(bdd U-4) โ‘ข ์€ ํ˜„์žฌ ํ•ญ์ƒ ใ€Œ๋ฐœ๋™ ์ค‘ใ€ ์ด๊ณ  โ‘ ๊ณผ ๊ฑฐ๋™์ด ๊ฐ™์œผ๋ฉฐ, ๋‹ค๋ฅธ ์ ์€ #68 โ†” #80 ์‚ฌ์ด์— ์ƒํƒœ ์ „๋‹ฌ ๊ณ„์•ฝ์ด ํ•˜๋‚˜ ๋А๋Š” ๊ฒƒ๋ฟ์ด๋‹ค. โ‘  โ†’ โ‘ข ๋˜๋Œ๋ฆฌ๊ธฐ๋Š” ํ† ๊ธ€ ์ž ๊ธˆ ํ•ด์ œ ์กฐ๊ฑด ํ•˜๋‚˜๋ผ ์‹ธ๊ณ , โ‘ก ๋ฅผ ๋จผ์ € ์—ด์—ˆ๋‹ค๊ฐ€ ์ขํžˆ๋Š” ๊ฒƒ์€ ์ด๋ฏธ ์ƒ์„ฑ๋œ ์ž‘์—…์˜ ๋ชจ๋“œ๋ฅผ ์žฌํ•ด์„ํ•ด์•ผ ํ•œ๋‹ค.
    • 5(forward apply): DD-25 R4 ๊ฐ€ ๋กค๋ฐฑ ๋ฐฉํ–ฅ์—์„œ ์ด๋ฏธ ์„ธ์šด ๊ทœ์น™(ใ€Œ์‚ฌ๋žŒ์ด ์ด๋ฏธ ๊ฐ™์€ ๋‚ด์šฉ์œผ๋กœ ๊ณ ์ณ ๋‘” ๊ฒฝ์šฐ๋„ ์ถฉ๋Œ โ€” ๊ฒฐ๊ณผ์ ์œผ๋กœ ๊ฐ™์œผ๋‹ˆ ํ†ต๊ณผ๋ฅผ ๊ณ„์‚ฐํ•˜๊ธฐ ์‹œ์ž‘ํ•˜๋ฉด ๋ถˆ๋ณ€์‹์ด ํŒ์ • ๊ทœ์น™์œผ๋กœ ๋ณ€ํ•œ๋‹คใ€)์„ forward ๋ฐฉํ–ฅ์— ๊ทธ๋Œ€๋กœ ์ ์šฉํ•œ๋‹ค. ์ƒˆ ํŒ์ • ์ถ•์„ ๋งŒ๋“ค์ง€ ์•Š๋Š”๋‹ค. ๋น„๊ต ๋‹จ์œ„๋Š” (๊ฒฝ๋กœ, ํˆฌ์˜ ์ „์ด) ์Œ์ด๋ผ ์ƒ์„ฑยท์‚ญ์ œยท์ด๋ฆ„๋ณ€๊ฒฝ์˜ ๋Œ€๊ธฐ ๋ณ€๊ฒฝ๋„ ๋‹ด๊ธด๋‹ค. ์ ์šฉ์€ ํŽธ์ง‘ ์‹œ๋„๋ผ ๋ฆฌ์Šค๋ฅผ ๋‹ค์‹œ ํš๋“ํ•˜๋ฏ€๋กœ(D-045) ๊ฒ€์‚ฌ์™€ ์ ์šฉ ์‚ฌ์ด์— ์ฐฝ์ด ์—†๋‹ค. ใ€Œ๋ฎ์–ด์“ฐ๊ธฐใ€ ์„ ํƒ์ง€๋Š” ๋‚จ์˜ ํŽธ์ง‘์„ ์กฐ์šฉํžˆ ์ง€์šฐ๋Š” ๊ฒฝ๋กœ๋ผ ๋‘์ง€ ์•Š๊ณ , ์ถฉ๋Œ์„ ์ด์œ ๋กœ ์ž๋™ ์‹คํŒจ ์ „์ด๋„ ํ•˜์ง€ ์•Š๋Š”๋‹ค(2๋ฒˆ ๋…ผ๊ฑฐ ์œ„๋ฐ˜).
  • Impact:
    • docs/approval-rules-cocode.md ์‹ ์„ค โ€” ์Šน์ธ ์ดํƒˆ ๊ทœ์น™์˜ SSOT.
    • flow-permutation C-2ยทC-3ยทFP-208ยทFP-210ยทB-03ยทB-05 ํ•ด์†Œ.
    • state-machine ยง6 ์˜ ์Šน์ธ ๊ด€๋ จ 3ํ–‰ ํ•ด์†Œ(์Šน์ธ ์ดํƒˆ ์ „์ด ์ „์ฒด ยท ๊ฑฐ๋ถ€ ๊ฐ’ ์ถ”๊ฐ€ ์—ฌ๋ถ€ ยท ๋ฌด์‘๋‹ต ์ฒ˜๋ฆฌ N6). ์ „์ดํ‘œ 81์นธ ํ™•์žฅ์€ #71 ์ด ์ˆ˜ํ–‰ํ•œ๋‹ค.
    • prd ํ๋ฆ„ 3-A 8๋‹จ๊ณ„ ๋ฏธ๊ฒฐ ยท ํ๋ฆ„ 3-B ๋ฏธ๊ฒฐ A ํ•ด์†Œ. D-18 ์€ ์ž‘์—… ๊ฐ€์„ค๋กœ๋งŒ ๋‹ซํžŒ๋‹ค.
    • FP-409 ์˜ ์„ ํ–‰(C-3)์ด ์„œ์„œ #72 ๊ฐ€ ํŒ์ • ๊ฐ€๋Šฅํ•ด์ง„๋‹ค โ€” ์•ž ์Šน์ธ์ด ์ ์šฉ๋œ ์ˆœ๊ฐ„ ๋’ค ์Šน์ธ์˜ ์‚ฌ์ „๊ฒ€์‚ฌ๊ฐ€ ์ถฉ๋Œ๋กœ ๋–จ์–ด์ง€๋ฏ€๋กœ ใ€Œ๋‚˜์ค‘ ์Šน์ธ์ด ์•ž ์Šน์ธ์„ ์กฐ์šฉํžˆ ๋ฎ์ง€ ์•Š๋Š”๋‹คใ€๊ฐ€ ๊ด€์ฐฐ ๊ฐ€๋Šฅํ•œ ์กฐ๊ฑด์œผ๋กœ ์„ฑ๋ฆฝํ•œ๋‹ค. ์Šน์ธ granularityยท๋ถ€๋ถ„ ์Šน์ธยทPendingChange ๋Š” #72 ์†Œ๊ด€.
    • TaskTransition ์˜ ApprovalGranted(kind) ๊ฑฐ๋ถ€ ๊ฒฝ๋กœ ์ œ๊ฑฐ โ€” #68ยท#69 ๊ฐ€ ยง3.2 ํ‘œ๋Œ€๋กœ ๊ตฌํ˜„ํ•œ๋‹ค.
  • Source: #70 ์ธ์ˆ˜์กฐ๊ฑด 1~5 (ํŒ์ • ์ฃผ์ฒด Design) ยท ์„ ํ–‰ ๊ฐ’ ๊ฒฐ์ • D-032(#105, ์˜ค๋„ˆ) ยท override ๋Š” #111 ๋Œ€๊ธฐ

D-058: ์Šน์ธยท๋กค๋ฐฑ ์ž…๋ ฅ์€ ๋ฉฑ๋“ฑ(4์ข… ์ „๋ถ€ no-op ํก์ˆ˜) ยท ๋ถ€๋ถ„ ์Šน์ธ ๊ธˆ์ง€ ยท [์ ์šฉํ•˜์ง€ ์•Š์Œ] = ๊ฑฐ๋ถ€ ยท PendingChange ํ•„์š”

  • Date: 2026-09-13
  • Context: ์ด์Šˆ #72. flow-permutation I-9(์Šน์ธยท๋กค๋ฐฑ ์š”์ฒญ์˜ ๋ฉฑ๋“ฑ์„ฑยท์ค‘๋ณต ์ž…๋ ฅ โ€” ๊ทผ๊ฑฐ ์—ด์ด ๋ฌธ์ž ๊ทธ๋Œ€๋กœ ใ€Œ๋ฏธ๊ทœ์ •ใ€)์™€ I-10(์Šน์ธ granularity, ๊ฐ™์€ ํ…Œ์ŠคํŠธ ํŒŒ์ผ์— ๋‘ ์ž‘์—…์ด ๋Œ€๊ธฐ)์ด ์—ด๋ ค ์žˆ์—ˆ๊ณ , ๋‘ ํ•ญ๋ชฉ ๋ชจ๋‘ ํ™•์ • ์ฃผ์ฒด๊ฐ€ ์–ด๋А ๋ฌธ์„œ์—๋„ ์—†์—ˆ๋‹ค(ยง6.2 Important ํ‘œ์— ์ฃผ์ฒด ์—ด ์ž์ฒด๊ฐ€ ์—†๊ณ  ยง7.1 ์€ Critical ์œ ๋ž˜๋งŒ ๋ฎ์œผ๋ฉฐ architecture ยง9 ์—๋„ ๋ฏธ๋“ฑ์žฌ). ๋˜ ux-spec ์˜ ํ…Œ์ŠคํŠธ๋ณ€๊ฒฝ์Šน์ธ ์นด๋“œ์—๋Š” ๋ช…์‹œ์  [์ ์šฉํ•˜์ง€ ์•Š์Œ] ๋ฒ„ํŠผ์ด ์žˆ๋Š”๋ฐ flow :128 ์˜ ๋ฌดํšจ ์—ด์€ ใ€Œ๋ฏธ์Šน์ธ ๋ฐฉ์น˜ใ€๋ผ๋Š” ๋ถ€์ž‘์œ„๋งŒ ์ ์–ด ๋ฌธ์„œ๊ฐ€ ์–ด๊ธ‹๋‚˜ ์žˆ์—ˆ๋‹ค.
  • Decision: ์‚ฐ์ถœ๋ฌผ์€ docs/approval-idempotency-cocode.md. ์—ฌ์„ฏ ๊ฒฐ๋ก :
    1. ํ™•์ • ์ฃผ์ฒด = Design. ์˜ค๋„ˆ ํŒ์ • ๋ถˆ์š”.
    2. ์ž…๋ ฅ 4์ข… ์ „๋ถ€ โ“ no-op ํก์ˆ˜ โ€” ์™„๋ฃŒ์Šน์ธ ยท ํ…Œ์ŠคํŠธ๋ณ€๊ฒฝ์Šน์ธ ยท [์ ์šฉํ•˜์ง€ ์•Š์Œ] ยท ๋กค๋ฐฑ ์ง€์  ์„ ํƒ. ๊ฒ€์‚ฌ ์ฃผ์ฒด๋Š” TaskTransition(DD-05).
    3. [์ ์šฉํ•˜์ง€ ์•Š์Œ] = AC-23 ์˜ ๊ฑฐ๋ถ€ ์ž…๋ ฅ โ†’ ๊ฑฐ๋ถ€๋จ(์ข…๊ฒฐ). ๊ทธ ๋ณ€๊ฒฝ์€ ์ ์šฉ๋˜์ง€ ์•Š๊ณ  ์ด๋ฏธ ์ ์šฉ๋œ ํŽธ์ง‘์€ ๋‚จ๋Š”๋‹ค.
    4. ๋ถ€๋ถ„ ์Šน์ธ ๊ธˆ์ง€ โ€” ์Šน์ธ์€ ๋Œ€์ƒ ๋ณ€๊ฒฝ ์ „์ฒด์— ๋Œ€ํ•œ ๋‹จ์ผ ํŒ์ •์ด๊ณ  ์ ์šฉ์€ ์ „๋Ÿ‰์ด๊ฑฐ๋‚˜ ์ „๋ฌด๋‹ค. ํŒŒ์ผ๋ณ„ ์Šน์ธ ํ›„๋ณด๋Š” UX-D-13 ์ด ์ด๋ฏธ ๊ธฐ๊ฐํ–ˆ๋‹ค.
    5. FP-409: ์•ž ์Šน์ธ์ด ์ ์šฉ๋˜๋ฉด ๋’ค ์Šน์ธ์˜ ์‚ฌ์ „๊ฒ€์‚ฌ๊ฐ€ ์ถฉ๋Œ๋กœ ๋–จ์–ด์ง„๋‹ค โ€” ๊ด€์ฐฐ ์กฐ๊ฑด์€ ใ€Œ์ ์šฉ ์‹œ์ ์˜ ํ˜„์žฌ ํ•ด์‹œ โ‰  ์Šน์ธ ์‹œ์  base ์ด๋ฉด ์ ์šฉ๋˜์ง€ ์•Š๋Š”๋‹คใ€.
    6. PendingChange ๋Š” ํ•„์š”ํ•˜๋‹ค. ์ €์žฅ ์œ„์น˜ยท์ˆ˜๋ช…ยท์Šน๊ฒฉ ๊ทœ์น™์€ architecture ยง9 ๋ฏธ๊ฒฐ 23 ์œผ๋กœ ๋“ฑ์žฌ.
  • Rationale:
    • ์ฃผ์ฒด(0): ์ •ํ•  ๋Œ€์ƒ์ด ๊ฐ’์ด ์•„๋‹ˆ๋ผ ๊ทœ์น™์ด๊ณ (์˜ค๋„ˆ ํŒ์ •์„ ๋ฐ›์•„ ์˜จ D-032ยทD-033ยทD-037ยทD-044ยทD-051 ์€ ์ „๋ถ€ ๋ถˆ๋ณ€ ์ธต์œ„์˜ ๊ฐ’์ด๊ฑฐ๋‚˜ ๋ฒ”์œ„ ๊ฒฐ์ •์ด์—ˆ๋‹ค), ๋ฉฑ๋“ฑ์„ฑ์ด ์„ฑ๋ฆฝํ•ด์•ผ ํ•˜๋Š” ์ž๋ฆฌ๋Š” TaskTransition ํ•˜๋‚˜์ด๋ฉฐ(DD-05) granularity ๋Š” UX-D-13 ์ด ์ด๋ฏธ ์ ˆ๋ฐ˜์„ ์ •ํ–ˆ๋‹ค. ์–ด๋А ๊ฒฐ๋ก ๋„ statusยทpending_approval_kind ํ์‡„ ์ง‘ํ•ฉ์„ ๊ฑด๋“œ๋ฆฌ์ง€ ์•Š์•„ ๊ฐœ์ • ์ค‘๋‹จ ์ƒํƒœ(seed:8)์˜ ์˜ํ–ฅ์„ ๋ฐ›์ง€ ์•Š๋Š”๋‹ค.
    • โ“’(UI ๋„๋‹ฌ ๋ถˆ๊ฐ€) ๋‹จ๋… ์ฑ„ํƒ ๋ถˆ๊ฐ€: ๋ฒ„ํŠผ ๋น„ํ™œ์„ฑํ™”๋Š” ๋„๋ฉ”์ธ ํ•จ์ˆ˜ ๋ฐ–์˜ ๊ฒ€์‚ฌ๋ผ DD-05 ๋ฅผ ์šฐํšŒํ•œ๋‹ค โ€” ๋‹จ์ถ•ํ‚คยท๋ณต์›๋œ ์„ธ์…˜ยท์ž๋™ํ™” ๊ฐ™์€ ๋‹ค๋ฅธ ํ˜ธ์ถœ ๊ฒฝ๋กœ์—๋Š” ๋ณดํ˜ธ๊ฐ€ ์—†๋‹ค. UI ๋น„ํ™œ์„ฑํ™”๋Š” ํ•˜๋˜(ํ”ผ๋“œ๋ฐฑ) ๊ณ„์•ฝ์€ ๋„๋ฉ”์ธ ํ•จ์ˆ˜๊ฐ€ ์ง„๋‹ค.
    • โ“‘(๊ฑฐ๋ถ€+์‚ฌ์œ )๋ฅผ ๊ณ ๋ฅด์ง€ ์•Š์€ ์ด์œ : ์ค‘๋ณต ์ž…๋ ฅ์˜ ์••๋„์  ๋‹ค์ˆ˜๊ฐ€ ๋”๋ธ” ํด๋ฆญ์ด๋‹ค(flow :127 ์˜ ใ€Œ๋™์‹œยท๋ฐ˜๋ณตใ€ ์—ด). ์›ํ•œ ๊ฒฐ๊ณผ๊ฐ€ ์ด๋ฏธ ์ด๋ค„์กŒ๋Š”๋ฐ ์˜ค๋ฅ˜๋ฅผ ๋„์šฐ๋Š” ๊ฒƒ์€ ์‚ฌ์‹ค๊ณผ ๋‹ค๋ฅธ ์‹คํŒจ ์‹ ํ˜ธ๋‹ค. ๋ฐ˜๋Œ€๋กœ ใ€Œ๊ฐ™์€ ์ž…๋ ฅใ€์ด ์•„๋‹ˆ๋ผ ๋‚ก์€ ์ž…๋ ฅ(๊ทธ ์‚ฌ์ด ์ž‘์—…์ด ์˜ฎ๊ฒจ ๊ฐ)์€ ์ด ๊ทœ์น™์— ๊ฑธ๋ฆฌ์ง€ ์•Š๊ณ  ๊ธฐ์กด ์ „์ดํ‘œ๊ฐ€ ์ถœ๋ฐœ ์ƒํƒœ ๋ถˆ์ผ์น˜๋กœ ๊ฑฐ๋ถ€ํ•œ๋‹ค โ€” ๋‘ ๊ฒฝ์šฐ๋ฅผ ๊ตฌ๋ณ„ํ•˜๋Š” ์ˆ ์–ด๊ฐ€ ์ด๋ฏธ ์žˆ๋‹ค.
    • ๋กค๋ฐฑ(โ““)์€ ์ƒˆ ๊ทœ์น™์ด ์•„๋‹ˆ๋‹ค โ€” DD-25 R4 ๊ฐ€ ์ด๋ฏธ ใ€Œํ˜„์žฌ โˆ… ์ด๋ฉด ์ถฉ๋Œ ์—†์ด ์•„๋ฌด ์ผ๋„ ํ•˜์ง€ ์•Š๋Š”๋‹ค(๋ฉฑ๋“ฑ โ€” DD-11 7๋‹จ๊ณ„์™€ ๊ฐ™์€ ๊ทœ์น™)ใ€๋ฅผ ์ ์—ˆ๋‹ค. ์ด ๊ฒฐ์ •์€ ๊ทธ ๊ทœ์น™์ด ๋กค๋ฐฑ ์ž…๋ ฅ ์ „์ฒด์— ์ ์šฉ๋จ์„ ๋ช…์‹œํ•  ๋ฟ์ด๋‹ค.
    • [์ ์šฉํ•˜์ง€ ์•Š์Œ](2): ใ€Œ์ด ๋ณ€๊ฒฝ๋งŒ ๋ฒ„๋ฆฌ๊ณ  ์ž‘์—…์€ ๊ณ„์†ใ€ ์•ˆ์€ โ“ ์–ด๋А ์ŠคํŽ™์—๋„ ์—†๊ณ  โ“‘ ์—์ด์ „ํŠธ๊ฐ€ ๋งŒ๋“  ํŽธ์ง‘ ์ง‘ํ•ฉ๊ณผ ์‹ค์ œ ์ ์šฉ๋œ ์ง‘ํ•ฉ์ด ๊ฐˆ๋ผ์ง„ ์ฑ„ ์ž‘์—…์ด ์ด์–ด์ง€๋Š” ์ƒํƒœ๋ฅผ ์ƒˆ๋กœ ๋งŒ๋“ค๋ฉฐ โ“’ ๊ทธ ๋’ค ์—์ด์ „ํŠธ๊ฐ€ ๋ฌด์—‡์„ ํ•ด์•ผ ํ•˜๋Š”์ง€ ๊ทœ์น™์„ ๋˜ ์š”๊ตฌํ•œ๋‹ค. C-05 ์˜ ๋ฌธ๋ฉด์€ ใ€Œ์Šน์ธ์„ ๊ฑฐ์ณ์•ผ ์ ์šฉ๋œ๋‹คใ€์ด๊ณ  ์ ์šฉํ•˜์ง€ ์•Š์Œ = ์Šน์ธํ•˜์ง€ ์•Š์Œ์ด๋‹ค.
    • ๋ถ€๋ถ„ ์Šน์ธ ๊ธˆ์ง€(3): โ“ ํ‘œํ˜„ํ•  ์ž๋ฆฌ๊ฐ€ ์—†๋‹ค โ€” pending_approval_kind ๋Š” ์ž‘์—… 1๊ฑด์— ๊ฐ’ ํ•˜๋‚˜์ธ ํ์‡„ ์ง‘ํ•ฉ์ด๊ณ  architecture:176 ์ด ์ƒˆ ์Šน์ธ ์ข…๋ฅ˜ ๋„์ž…์„ ๊ธˆ์ง€ํ•œ๋‹ค โ“‘ ๋ถ€๋ถ„ ์ ์šฉ ์ƒํƒœ๋ฅผ ๋‹ด๋Š” ์–ดํœ˜๊ฐ€ ์—†๋‹ค(EditSnapshotยทattempt_noยทPendingChange ์–ด๋А ๊ฒƒ๋„) โ€” ๋‹ด๊ฒŒ ํ•˜๋ฉด AC-13 ๊ธ‰์˜ ์ƒˆ ์›์ž์„ฑ ๊ทœ์น™์ด ํ•˜๋‚˜ ๋” ํ•„์š”ํ•˜๋‹ค โ“’ C-05 ๋Š” ใ€ŒํŒ์ •์ด ํ•„์š” ์—†๊ฒŒ ํ•œ๋‹คใ€์ธ๋ฐ ๋ถ€๋ถ„ ์Šน์ธ์€ ํŒŒ์ผ๋ณ„ ํŒ์ •์„ ์‚ฌ์šฉ์ž์—๊ฒŒ ๋˜๋Œ๋ ค ์ค€๋‹ค.
    • PendingChange(5): FP-409 ํŒ์ •์˜ ์ž…๋ ฅ์ธ ใ€Œ์Šน์ธ ์‹œ์  baseใ€์™€ ์Šน์ธ ์‹œ ์“ธ ์ œ์•ˆ ๋ฐ”์ดํŠธ๋ฅผ ๋“ค๊ณ  ์žˆ์–ด์•ผ ํ•˜๋Š”๋ฐ EditSnapshot ์€ ์ ์šฉ๋œ ํŽธ์ง‘์˜ ๊ธฐ๋ก์ด๋ผ ๋‹ด์ง€ ์•Š๋Š”๋‹ค. ์Šน์ธ ๋Œ€๊ธฐ์— ์‹œ๊ฐ„ ์ƒํ•œ์ด ์—†์–ด(D-057 ยง2) ์•ฑ ์žฌ์‹œ์ž‘์„ ๊ฐ€๋กœ์ง€๋ฅด๋ฏ€๋กœ ์˜์†์ด ํ•„์š”ํ•˜๋‹ค โ€” ๋ฉ”๋ชจ๋ฆฌ์—๋งŒ ๋‘๋ฉด ์žฌ์‹œ์ž‘ ํ›„ ์นด๋“œ๋Š” ๋‚จ๋Š”๋ฐ ์ ์šฉํ•  ๊ฒƒ์ด ์—†๋‹ค.
  • Impact:
    • docs/approval-idempotency-cocode.md ์‹ ์„ค.
    • prd ยง1.4 ์— FR-405 ~ FR-409 ์‹ ์„ค โ€” ์ž…๋ ฅ 4์ข… ๊ฐ๊ฐ์— ใ€Œ๋ฉฑ๋“ฑใ€์ด ๋ช…์‹œ๋œ๋‹ค(#72 ์ธ์ˆ˜์กฐ๊ฑด 1 ์˜ grep ํŒ์ • ๊ธฐ์ค€). Seed Spec ์ด ์•„๋‹ˆ๋ผ PRD ๋ฅผ ๊ณ ๋ฅธ ์ด์œ ๋Š” flow ยง7.3 ์ด ใ€ŒSeed Spec ๋˜๋Š” PRD ๋ฐ˜์˜ใ€์„ ํ—ˆ์šฉํ•˜๊ณ  Seed Spec ์ด ๊ฐœ์ • ์ค‘๋‹จ ์ƒํƒœ์ด๋ฉฐ ์ด ๊ทœ์น™๋“ค์ด ยง2 ์ œ์•ฝ๋„ ยง4 ์ธ์ˆ˜ ๊ฒฝ๊ณ„๋„ ์•„๋‹Œ ๊ธฐ๋Šฅ ์š”๊ตฌ์‚ฌํ•ญ์ด๊ธฐ ๋•Œ๋ฌธ์ด๋‹ค.
    • prd ํ๋ฆ„ 3-A 8๋‹จ๊ณ„ ๋ฏธ๊ฒฐ ยท ํ๋ฆ„ 3-B ๋ฏธ๊ฒฐ A ํ•ด์†Œ ํ‘œ์‹œ.
    • flow-permutation I-9ยทI-10ยทFP-209ยทFP-409 ํ•ด์†Œ, ยง2 ์ž…๋ ฅ ์ˆœ์—ด 3ํ–‰(:127ยท:128ยท๋กค๋ฐฑ) ๊ฐฑ์‹ .
    • ux-spec โ€” UX-D-26 ์‹ ์„ค. ์™„๋ฃŒ์Šน์ธ ์นด๋“œ์—๋„ ๊ฑฐ๋ถ€ ์ž…๋ ฅ์ด ํ•„์š”ํ•จ์„ ์ง€์ (AC-23 ์€ kind ๋ฅผ ๊ฐ€๋ฆฌ์ง€ ์•Š๋Š”๋‹ค) โ€” ๋ฒ„ํŠผ ๋ฐฐ์น˜๋Š” #85.
    • architecture ยง9 ๋ฏธ๊ฒฐ 23 ๋“ฑ์žฌ(PendingChange ์ €์žฅ ์œ„์น˜ยท์ˆ˜๋ช…ยท์Šน๊ฒฉ ๊ทœ์น™).
    • โ›” BDD ์‹œ๋‚˜๋ฆฌ์˜ค 0๊ฑด(์ธ์ˆ˜์กฐ๊ฑด 6) โ€” flow ยง7.3 ์˜ ใ€Œ๊ทœ์น™ ํ™•์ • ์—†์ด ์‹œ๋‚˜๋ฆฌ์˜ค๋ฅผ ์“ฐ์ง€ ๋ง ๊ฒƒใ€ ๊ทธ๋Œ€๋กœ, ์‹œ๋‚˜๋ฆฌ์˜ค๋Š” ๋ณ„๋„ ํ›„์†์ด๋‹ค.
  • Source: #72 ์ธ์ˆ˜์กฐ๊ฑด 1~7 (ํŒ์ • ์ฃผ์ฒด Design โ€” ์ด ๊ฒฐ์ •์ด ์ •ํ–ˆ๋‹ค) ยท ์„ ํ–‰ D-057(C-3) ยท D-032(AC-23)

D-059: C-5 ์„ธ ์ถ• ์ฒ˜๋ถ„ ยท CancelReason ํ์‡„ 5์ข… ยท ์ „์ดํ‘œ 81์นธ ํ™•์žฅ โ€” Seed Spec ์ถ”๊ฐ€ ๊ฐœ์ • ๋ถˆ์š”

  • Date: 2026-09-13
  • Context: ์ด์Šˆ #71. flow-permutation C-5 ๊ฐ€ ๋ฌดํ•œ ์ฒด๋ฅ˜ 4์ง€์ (FP-105 ํŽธ์ง‘ ๋‹จ๊ณ„ ยท FP-106 ์ž‘์—… ์ด๋Ÿ‰ ยท FP-107 ํ”„๋กœ๋ฐ”์ด๋” ์‘๋‹ต ๋ถˆ๊ฐ€ ยท FP-405 ์ž ๊ธˆ ๋Œ€๊ธฐ)์„ ์ง€์ ํ–ˆ๊ณ , ์ž ๊ธˆ ์ถ•์€ #77 ์ด ๋‹ซ์•˜์œผ๋‚˜ ์„ธ ์ถ•์ด ์—ด๋ ค ์žˆ์—ˆ๋‹ค. ๋™์‹œ์— AgentSession.cancel(CancelReason) ์€ ํ˜ธ์ถœ๋ถ€๋ฅผ ์“ธ ์ˆ˜ ์—†๋Š” ์ฃฝ์€ API ์˜€๋‹ค โ€” CancelReason ์ด docs/ ์ „์ˆ˜ grep ์—์„œ ์„ ์–ธ๋ถ€ 1๊ฑด๋ฟ์ด๊ณ , ํ˜ธ์ถœ ๊ฒฝ๋กœ๋„ ์ค‘์ง€๋ฅผ ํ‘œํ˜„ํ•  status ๋„ ์—†์—ˆ๋‹ค. ๊ทธ๋ฆฌ๊ณ  D-032 ๊ฐ€ status ๋ฅผ 9์ข…์œผ๋กœ ๊ฐœ์ •ํ•œ ๋’ค state-machine ์ „์ดํ‘œ๊ฐ€ 7์ƒํƒœ(49์นธ) ๊ทธ๋Œ€๋กœ ๋‚จ์•„ ๋“œ๋ฆฌํ”„ํŠธ๊ฐ€ ์žˆ์—ˆ๋‹ค.
  • ์ „์ œ โ€” ๋ฐฉํ–ฅ์€ ์ด๋ฏธ ์˜ค๋„ˆ๊ฐ€ ์ •ํ–ˆ๋‹ค: D-032(#105, 2026-09-10)๊ฐ€ C-5 ์™€ UX-D-06 ์˜ ์ •๋ฉด ์ถฉ๋Œ์„ ใ€Œ์ค‘์ง€ ์ˆ˜๋‹จ ์‹ ์„คใ€ ์ชฝ์œผ๋กœ ์ฒ˜๋ถ„ํ–ˆ๊ณ  ใ€ŒUX-D-06 ์€ ์ด ๊ฒฐ์ •์œผ๋กœ ํ๊ธฐ๋œ๋‹คใ€๋ฅผ Impact ์— ์ ์—ˆ๋‹ค. ๋”ฐ๋ผ์„œ #71 ์€ ใ€Œ์ƒํ•œ์„ ๋‘˜๊นŒ ๋ง๊นŒใ€๋ฅผ ์ƒˆ๋กœ ๊ณ ๋ฅด๋Š” Story ๊ฐ€ ์•„๋‹ˆ๋ผ ๊ทธ ์ฒ˜๋ถ„์„ ์„ธ ์ถ•์— ๋ช…์‹œํ•˜๊ณ  ์ง‘ํ–‰ ๊ฐ€๋Šฅํ•˜๊ฒŒ ๋งŒ๋“œ๋Š” Story ๋‹ค.
  • Decision: ์‚ฐ์ถœ๋ฌผ์€ docs/stop-and-limits-cocode.md.
    1. FP-105 โ€” ์ž๋™ ์ƒํ•œ์„ ๋‘์ง€ ์•Š๋Š”๋‹ค. ์กฐ์šฉํ•œ ๋งค๋‹ฌ๋ฆผ์€ DD-22 S2(๋‹จ๊ณ„๋ฅผ ๊ฐ€๋ฆฌ์ง€ ์•Š๋Š” ์œ ํœด ์ดˆ๊ณผ)๊ฐ€ ์ด๋ฏธ ๋ฎ๊ณ , ๋‚จ๋Š” ใ€Œ์ด๋ฒคํŠธ๋ฅผ ๋‚ด๋ฉฐ ์ง„์ „ ์—†์Œใ€(๋ผ์ด๋ธŒ๋ฝ)์€ AC-22 ์ค‘์ง€ ์ž…๋ ฅ์ด ๋ฎ๋Š”๋‹ค.
    2. FP-106 โ€” ์ด๋Ÿ‰ ์ƒํ•œ์„ ๋‘์ง€ ์•Š๋Š”๋‹ค.
    3. FP-107 โ€” DD-22 ๋กœ ์ด๋ฏธ ๋ฎ์ธ๋‹ค(S1 โˆช S2). ์ž”์—ฌ๋Š” ๊ฐ’(#50)๊ณผ ๋น„์ค€(#112) ๋‘˜๋ฟ์ด๋ฉฐ ๋ฒ”์œ„ ๋ฐ–.
    4. FP-405 โ€” #77 ์˜ ๊ฒฐ๋ก ์„ ์ธ์šฉํ•œ๋‹ค(๊ตฌ์กฐ์  ์œ ํ•œ์„ฑ).
    5. CancelReason ํ์‡„ 5์ข… โ€” userStopped ยท userRolledBack ยท approvalRejected ยท taskFailed ยท workspaceClosing. ํ˜ธ์ถœ ์ˆœ์„œ๋Š” ์ „์ด๊ฐ€ ๋จผ์ €, cancel ์ด ๋‚˜์ค‘.
    6. ์ „์ดํ‘œ 81์นธ ํ™•์žฅ ์™„๋ฃŒ โ€” ์‹ ๊ทœ ์ „์ด 7์ข…(โ‘ฐโ‘ฑโ‘ฒโ‘ณใ‰‘ใ‰’ใ‰“), โฌœ ์นธ 0๊ฐœ.
    7. Seed Spec ์ถ”๊ฐ€ ๊ฐœ์ • ๋ถˆ์š” โ€” ํŒ๋‹จ ์ฃผ์ฒด Design, ์ผ์ž 2026-09-13.
  • Rationale:
    • FP-105: ใ€Œ์™„์ „ ๋ฌด๋ฐฉ๋น„ใ€๋Š” ๊ณผ์žฅ์ด์—ˆ๋‹ค โ€” S2 ๊ฐ€ ๋‹จ๊ณ„๋ฅผ ๊ฐ€๋ฆฌ์ง€ ์•Š์œผ๋ฏ€๋กœ ์กฐ์šฉํ•œ ๋งค๋‹ฌ๋ฆผ์€ ๋ฎ์ธ๋‹ค. ์‹ค์ œ ๊ณต๋ฐฑ์€ ๋ผ์ด๋ธŒ๋ฝ ํ•˜๋‚˜์ด๊ณ , ์ž๋™ ์ƒํ•œ์€ โ“ AC ์‹ ์„ค์„ ์š”๊ตฌํ•˜๋Š”๋ฐ flow ยง7.1 B-07 ์ด ๊ทธ ํ™•์ • ์ฃผ์ฒด๋ฅผ ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ๋กœ ์ง€์ •ํ•ด Design ์˜ ๊ถŒํ•œ ๋ฐ–์ด๊ณ  โ“‘ ๊ฐ’์˜ ํ‘œ๋ณธ์ด 0๊ฑด์ด๋ฉฐ โ“’ ใ€Œ์ง„์ „ใ€์„ ์ •์˜ํ•˜๋Š” ์ˆœ๊ฐ„ ํŒ์ •์ด ์ƒ๊ธด๋‹ค(DD-21 ์ด โ‘ ~โ‘ฃ ์—์„œ, DD-22 ๊ฐ€ ใ€Œ์—ฐ์† ์˜ค๋ฅ˜ ํšŸ์ˆ˜ใ€์—์„œ ์—†์•ค ๋ฐ”๋กœ ๊ทธ ์„ฑ์งˆ) โ““ ๋ผ์ด๋ธŒ๋ฝ์€ ์‚ฌ๋žŒ์ด ๋ณด๋ฉด ์ฆ‰์‹œ ์•„๋Š” ์ƒํƒœ๋ผ ์ค‘์ง€ ์ž…๋ ฅ์ด ๊ทธ ์ž๋ฆฌ๋ฅผ ์ •ํ™•ํžˆ ๋ฎ๋Š”๋‹ค. โš ๏ธ ์ž”์—ฌ ์œ„ํ—˜์„ ์ˆจ๊ธฐ์ง€ ์•Š๋Š”๋‹ค โ€” ์‚ฌ๋žŒ์ด ๋Œ์•„์˜ค๊ธฐ ์ „๊นŒ์ง€๋Š” ๊ณ„์† ๋Œ๊ณ , D-008 ์ด ์žฌ์‹œ๋„ ์ƒํ•œ์„ ๋„์ž…ํ•œ ๊ทผ๊ฑฐ๊ฐ€ ์ด ์ถ•์—๋Š” ์•„์ง ์ ์šฉ๋˜์ง€ ์•Š์•˜๋‹ค. ํ›„์† ํŒ์ • ์ฃผ์ฒด๋Š” ์˜ค๋„ˆ(B-07).
    • FP-106: ์ด๋Ÿ‰ ์‹์˜ ์„ธ ํ•ญ ์ค‘ ์ž๊ฐ€๊ฒ€์ฆ(โ‰ค 60๋ถ„ โ€” D-033 ร— 4, D-056)ยทํ™˜๊ฒฝ ์žฌ์‹คํ–‰(D-055 ยง5)ยท์ž ๊ธˆ ๋Œ€๊ธฐ(#77)๊ฐ€ ์ด๋ฏธ ์œ ํ•œํ•˜๊ณ  ๋‚จ์€ ๋ฌดํ•œ์€ ํŽธ์ง‘ ์ถ• ํ•˜๋‚˜๋‹ค. ์ด๋Ÿ‰ ์ƒํ•œ์€ ๊ฐ™์€ ๊ณต๋ฐฑ์— ๋‘ ๋ฒˆ์งธ ๊ทผ๊ฑฐ ์—†๋Š” ์‹œ๊ณ„๋ฅผ ๊ฑฐ๋Š” ๊ฒƒ์ด๊ณ , ์–ด๋А ๊ทœ์น™๋„ ์–ด๊ธฐ์ง€ ์•Š์€ ์ž‘์—…์„ ์‹œ๊ณ„ ํ•˜๋‚˜๋กœ ๋Š์œผ๋ฉด ์‚ฌ์šฉ์ž๊ฐ€ ๋ฐ›๋Š” ์‚ฌ์œ ๊ฐ€ ใ€Œ์˜ค๋ž˜ ๊ฑธ๋ ธ๋‹คใ€๋ฟ์ด๋ผ failure_class(D-055) ์–ด๋А ๊ฐ’์—๋„ ๋Œ€์‘ํ•˜์ง€ ์•Š๋Š”๋‹ค.
    • UX-D-06 ์˜ ๊ทผ๊ฑฐ๊ฐ€ ์™œ ์„ฑ๋ฆฝํ•˜์ง€ ์•Š์•˜๋‚˜: ใ€ŒAC-07ยทAC-08 ์ด ์ž๋™ ์ข…๋ฃŒ๋ฅผ ๋ณด์žฅใ€์ด์—ˆ๋Š”๋ฐ AC-08 ์˜ Given ์ด ใ€Œ์ž๊ฐ€ ๊ฒ€์ฆ ์‹œ๋„๊ฐ€ ์ง„ํ–‰ ์ค‘์ผ ๋•Œใ€(seed:110)๋กœ ํ•œ์ •๋ผ ํŽธ์ง‘ ๋‹จ๊ณ„ยท์ž ๊ธˆ ๋Œ€๊ธฐ๋ฅผ ๋ฎ์ง€ ๋ชปํ•œ๋‹ค. ์ธ์ˆ˜์กฐ๊ฑด 2 ๋Š” ํ•œ์ชฝ ์ •์ •๋งŒ ์š”๊ตฌํ–ˆ์œผ๋‚˜ ์–‘๋ฐฉํ–ฅ์œผ๋กœ ๋„ฃ์—ˆ๋‹ค โ€” ํ•œ์ชฝ๋งŒ ๊ณ ์น˜๋ฉด ๋ฐ˜๋Œ€ ๋ฐฉํ–ฅ์—์„œ ์ฝ๋Š” ์‚ฌ๋žŒ์ด ๋‚ก์€ ๋ฌธ์žฅ์„ ๋งŒ๋‚œ๋‹ค.
    • CancelReason(5): ๊ฐ’์ด ํ˜ธ์ถœ ์ง€์  ํ•˜๋‚˜์— ํ•˜๋‚˜์”ฉ ๋Œ€์‘ํ•˜๋ฏ€๋กœ ํ์‡„๊ฐ€ ์ž์—ฐ์Šค๋Ÿฝ๊ณ , ์ƒˆ ๊ฐ’์€ ์ƒˆ ํ˜ธ์ถœ ์ง€์ ์ด ์ƒ๊ธธ ๋•Œ๋งŒ ๋Š”๋‹ค. ์ „์ด๊ฐ€ ๋จผ์ €์ธ ์ด์œ  ์…‹: โ“ ์ค‘์ง€๋จ ์€ ์ข…๊ฒฐ ์ƒํƒœ์ด๊ณ  DD-05 ๊ฐ€ ์ „์ด์˜ ๋‹จ์ผ ์ง€์ ์„ ์š”๊ตฌํ•œ๋‹ค โ“‘ ์ „์ด๊ฐ€ ๊ฑฐ๋ถ€๋˜๋ฉด(์ด๋ฏธ ์ข…๊ฒฐยท๋Œ€๊ธฐ) ์„ธ์…˜์„ ์ฃฝ์ด์ง€ ์•Š์•„์•ผ ํ•˜๋Š”๋ฐ cancel ์ด ๋จผ์ €๋ฉด ๊ฑฐ๋ถ€๋œ ์š”์ฒญ์ด ํ”„๋กœ์„ธ์Šค๋งŒ ์ฃฝ์ธ๋‹ค โ“’ cancel ์‹คํŒจ๋Š” ๋Ÿฐ์ฒ˜์˜ ๊ฐ•์ œ ์ข…๋ฃŒ๊ฐ€ ๋ฎ์ง€๋งŒ, ๋ฐ˜๋Œ€ ์ˆœ์„œ์—๋Š” ๋Œ€์ฒด ์ˆ˜๋‹จ์ด ์—†๋‹ค.
    • โ‘ฎ(์ˆ˜๋™ ์žฌ๊ฐœ)๋ฅผ ๊ฑฐ๋ถ€๋จยท์ค‘์ง€๋จ ์— ์ฃผ์ง€ ์•Š๋Š” ์ด์œ : โ‘ฎ ์˜ ๊ทผ๊ฑฐ๋Š” ใ€ŒAC-07 ์ด ๊ธˆ์ง€ํ•œ ๊ฒƒ์€ ์ž๋™ ์žฌ์‹œ๋„๋‹คใ€ ํ•˜๋‚˜์ด๊ณ  ๊ทธ ๋ฌธ์žฅ์€ ์‹คํŒจ ์—๋งŒ ๊ฑธ๋ฆฐ๋‹ค. ๋‘ ์ƒˆ ์ƒํƒœ๋Š” ์‚ฌ๋žŒ์ด ๊ทธ๋งŒ๋‘๊ธฐ๋กœ ํ•œ ์ƒํƒœ๋ผ ์žฌ๊ฐœ ๊ฒฝ๋กœ๋ฅผ ๋‘๋ฉด ใ€Œ์ค‘์ง€ใ€์™€ ใ€Œ์ผ์‹œ์ •์ง€ใ€์˜ ๊ตฌ๋ณ„์ด ์‚ฌ๋ผ์ง„๋‹ค. ํŽธ์ง‘์€ ๋‚จ๊ณ  ๋กค๋ฐฑ(โ‘ณยทใ‰‘)๋„ ์—ด๋ ค ์žˆ์–ด ์žƒ๋Š” ๊ฒƒ์ด ์—†๋‹ค.
    • ๋ถˆ๋ณ€์‹ ์˜ํ–ฅ(์ „์ˆ˜): 1ยท2ยท3ยท4 ๋Š” ์˜ํ–ฅ ์—†์Œ(๊ฑฐ๋ถ€๋Š” ์™„๋ฃŒ๊ฐ€ ์•„๋‹ˆ๋ผ ๊ฑฐ๋ถ€๋จ ์ด๋ผ ๋ถˆ๋ณ€์‹ 2 ๋ฅผ ์˜คํžˆ๋ ค ๊ฐ•ํ™”ํ•œ๋‹ค). ๋ถˆ๋ณ€์‹ 5 ๋Š” ํ™•์žฅ โ€” โ‘ณยทใ‰‘ ์ด ์ถ”๊ฐ€๋˜๋‚˜ ใ€Œ์‚ฌ์šฉ์ž์˜ ๋ช…์‹œ์  ์š”์ฒญใ€์ด๋ผ๋Š” ํ•„์š”์กฐ๊ฑด๋งŒ ๊ทœ์ •ํ•˜๋ฏ€๋กœ ์ถœ๋ฐœ ์ƒํƒœ๊ฐ€ ๋Š˜์–ด๋„ ์œ„๋ฐ˜์ด ์•„๋‹ˆ๊ณ , AC-22ยทAC-23 ์ด ๋‘˜ ๋‹ค ๋กค๋ฐฑ ์ˆ˜๋‹จ์„ ์š”๊ตฌํ•˜๋ฏ€๋กœ ์„ ํƒ์ด ์•„๋‹ˆ๋‹ค. ์ข…๊ฒฐ ์ƒํƒœ ์ •์˜(seed:30)๊ฐ€ 5์ข…์œผ๋กœ ํ™•์žฅ๋ผ TaskStatus.isTerminal ์ด ๊ทธ๊ฒƒ์„ ๋‹ตํ•ด์•ผ ํ•œ๋‹ค.
    • Seed Spec ์ถ”๊ฐ€ ๊ฐœ์ • ๋ถˆ์š”(7): ํ•„์š”ํ•œ ๊ฐœ์ •์€ v3.3.0 ์—์„œ ์ด๋ฏธ ์™„๋ฃŒ๋๋‹ค(status 9์ข… ยท AC-22 ยท AC-23). ์ด ๋ฌธ์„œ์˜ ์–ด๋А ๊ฒฐ๋ก ๋„ ๊ทธ ์œ„์— ์ƒˆ ๋ฌธ๋ฉด์„ ์š”๊ตฌํ•˜์ง€ ์•Š๋Š”๋‹ค.
  • BDD: B-07 ์€ ์“ฐ์ง€ ์•Š๋Š”๋‹ค โ€” ๊ทธ ๋ฌธ๋ฉด(ใ€Œ์„ค์ •๋œ ์ƒํ•œ์„ ๋„˜๊ธฐ๋ฉดใ€)์ด ์ „์ œํ•˜๋Š” ์ƒํ•œ์„ ๋‘์ง€ ์•Š๊ธฐ๋กœ ํ–ˆ์œผ๋ฏ€๋กœ ์“ฐ๋ฉด ์กด์žฌํ•˜์ง€ ์•Š๋Š” ๊ทœ์น™์„ ๋‹จ์–ธํ•˜๊ฒŒ ๋œ๋‹ค(flow ยง7.3 ์›์น™). B-08 ์€ #77 ์†Œ๊ด€์ด๊ณ  ๊ทธ ํ–‰์ด ์ด๋ฏธ ํ˜•ํƒœ๊นŒ์ง€ ๋ฐ”๊ฟ” ์ ์—ˆ๋‹ค. ๋Œ€์‹  ๊ทธ ์ž๋ฆฌ๋ฅผ ๋ฎ๋Š” AC-22ยทAC-23 ์‹œ๋‚˜๋ฆฌ์˜ค 3๊ฑด์„ Feature 4 ์— ์ถ”๊ฐ€ํ–ˆ๋‹ค โ€” ์ƒˆ ์‹๋ณ„์ž ์—†์Œ.
  • Impact:
    • docs/stop-and-limits-cocode.md ์‹ ์„ค ยท state-machine ยง2 81์นธ ํ™•์žฅ(์‹ ๊ทœ ์ „์ด 7์ข… ยท ยง2.3 ์žฌ๊ฐœ ๋ฏธ๋ถ€์—ฌ ๊ทผ๊ฑฐ) ยท flow C-5ยทFP-105ยทFP-106ยทFP-107ยทB-07 ๊ฐฑ์‹  ยท ux-spec UX-D-06 ํ๊ธฐ ์ฃผ์„์— C-5 ๋ฌธ์ž ๊ทธ๋Œ€๋กœ ์ธ์šฉ ยท bdd Feature 4 ์‹œ๋‚˜๋ฆฌ์˜ค 3๊ฑด ยท architecture ยง3.1 ์— CancelReason ๊ฒฐ์ • ์ฃผ์„.
    • architecture ยง9 ๋ฏธ๊ฒฐ 22 ์˜ ์„ ํ–‰์ด ์„ฐ๋‹ค โ€” ใ€Œ๋ˆ„๊ฐ€ใ€ ์—ด์˜ ใ€Œ#71 ์˜ ์ค‘์ง€ ์ˆ˜๋‹จ์ด ์„ ํ–‰ํ•œ๋‹คใ€๊ฐ€ ํ•ด์†Œ๋๊ณ , ๋‚จ์€ ๊ฒƒ์€ EditLockRegistry.withLeases ์˜ ์ทจ์†Œ ํ†ต๋กœ ๊ณ„์•ฝ(Design).
    • โฌœ ์ƒˆ๋กœ ๋“ฑ์žฌ๋˜๋Š” ๋ฏธ๊ฒฐ: ํŽธ์ง‘ ๋‹จ๊ณ„ ์ƒํ•œ์„ AC ๋กœ ์‹ ์„คํ• ์ง€(ํŒ์ • ์ฃผ์ฒด ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ โ€” B-07 ์ง€์ • ๊ทธ๋Œ€๋กœ).
  • Source: #71 ์ธ์ˆ˜์กฐ๊ฑด 1~7 (ํŒ์ • ์ฃผ์ฒด Design, ๋‹จ ๋ฐฉํ–ฅ์€ D-032(์˜ค๋„ˆ)๊ฐ€ ์ด๋ฏธ ์ •ํ–ˆ๋‹ค) ยท #77(์ž ๊ธˆ ์ถ• ์ธ์šฉ) ยท D-055ยทD-056ยทD-057(์œ ํ•œ์„ฑ ๊ทผ๊ฑฐ)


D-060: AC-20 ์˜ ใ€Œ์‘๋‹ต ๋ถˆ๊ฐ€ใ€ = DD-22 ์˜ S1 โˆช S2 (#50 AC1 ยท PRD D-3 ยท bdd U-9) โ€” ์ž‘์—… ๊ฐ€์„ค

  • Date: 2026-09-13
  • Context: seed-spec AC-20 ์€ ใ€Œ๊ทธ ์ƒํƒœ๊ฐ€ ๊ฐ์ง€๋˜๋ฉดใ€์ด๋ผ๊ณ ๋งŒ ์“ฐ๊ณ  ๋ฌด์—‡์„ ์‘๋‹ต ๋ถˆ๊ฐ€๋กœ ๋ณผ์ง€ ๊ทœ์ •ํ•˜์ง€ ์•Š๋Š”๋‹ค(PRD D-3, bdd ยง0.5 U-9). architecture ยง6.2 ๊ฐ€ DD-22 ๋กœ ํ•ด์†Œ์•ˆ(S1 ์ „์†ก ์ข…๋ฃŒ โˆช S2 ์œ ํœด ์ดˆ๊ณผ)์„ ๋ƒˆ๊ณ  ๊ทธ ๋น„์ค€์„ ์˜ค๋„ˆ ๊ฒฐ์ • #112 ๋กœ ์˜ฌ๋ ค ๋‘์—ˆ๋‹ค. ๊ฐ์ง€ ๊ธฐ์ค€์ด ์—†์œผ๋ฉด AC-20 ์€ ๊ธฐ๊ณ„์  ํŒ์ •์ด ๋ถˆ๊ฐ€๋Šฅํ•˜๊ณ , #49(๊ฐ์ง€ยท์ „์ด ๊ตฌํ˜„)๋Š” ์ฐฉ์ˆ˜ํ•  ์ž…๋ ฅ์ด ์—†๋‹ค.
  • Options:
    1. S1 โˆช S2 โ€” ์ด๋ฒคํŠธ ์ŠคํŠธ๋ฆผ ํ•˜๋‚˜๋งŒ ๋ณด๋Š” ๋‘ ์‹ ํ˜ธ
    2. S1 โˆช S2 โˆช ์—ฐ์† ์˜ค๋ฅ˜ ํšŸ์ˆ˜ โ€” ์˜ค๋ฅ˜๊ฐ€ NํšŒ ์—ฐ์†์ด๋ฉด ์‘๋‹ต ๋ถˆ๊ฐ€
    3. ๋ฐฑ์—”๋“œ๋ณ„ ์‹ ํ˜ธ โ€” HTTP ์ƒํƒœ ์ฝ”๋“œยทJSON-RPC ์˜ค๋ฅ˜ ์ฝ”๋“œ๋ฅผ ๊ฐ ๋ฐฑ์—”๋“œ๊ฐ€ ํ•ด์„
  • Decision: ์˜ต์…˜ 1. S1(TransportClosed โ€” ์ž์‹ ํ”„๋กœ์„ธ์Šค exitยทstdio EOFยท์ŠคํŠธ๋ฆผ ์ข…๋ฃŒยท์ธ์ฆ ๊ฑฐ๋ถ€)๊ณผ S2(๋งˆ์ง€๋ง‰ AgentEvent ์ดํ›„ ๊ฒฝ๊ณผ > ์œ ํœด ์ƒํ•œ) ๋‘ ์‹ ํ˜ธ๋งŒ์œผ๋กœ ํŒ์ •ํ•œ๋‹ค. ์ „์ด ๋Œ€์ƒ์€ ์‹คํŒจ๋‹ค. โš ๏ธ ์ด ์ฑ„ํƒ์€ ์ž‘์—… ๊ฐ€์„ค์ด๋‹ค โ€” ๋น„์ค€ ์ฃผ์ฒด์ธ ์˜ค๋„ˆ ๊ฒฐ์ • #112 ์— ๊ฒฐ์ • ์ฝ”๋ฉ˜ํŠธ๊ฐ€ 0๊ฑด์ธ ์ƒํƒœ์—์„œ #49 ๊ฐ€ ์ด ๊ฐ€์„ค ์œ„์— ๊ตฌํ˜„ํ•œ๋‹ค(์‹ค์ธก: 2026-09-13).
  • Rationale: ๋Œ€์•ˆ ๋‘˜์ด ํŒ์ •์„ ์š”๊ตฌํ•ด์„œ ํƒˆ๋ฝํ•œ๋‹ค. โ‘ก๋Š” ใ€Œ์ด ์˜ค๋ฅ˜๊ฐ€ ์žฌ์‹œ๋„ ๊ฐ€๋Šฅํ•œ๊ฐ€ใ€๋ฅผ ๋จผ์ € ํŒ์ •ํ•ด์•ผ ์„ธ์–ด์ง€๊ณ  ๊ทธ ํŒ์ •์ด ๊ณง ๋ถ„์Ÿ ์ง€์ ์ด๋‹ค โ€” ๊ฒŒ๋‹ค๊ฐ€ ํ”„๋กœ๋ฐ”์ด๋” SDK ์˜ ์ž์ฒด ์žฌ์‹œ๋„๋Š” ์–ด์ฐจํ”ผ S2 ์˜ ์‹œ๊ณ„ ์•ˆ์—์„œ ์ผ์–ด๋‚˜๋ฏ€๋กœ ๋ฎ์ด์ง€ ์•Š๋Š” ๊ณต๋ฐฑ์ด ์—†๋‹ค. โ‘ข์€ ๋ฐฑ์—”๋“œ๋งˆ๋‹ค ํ•ด์„์ด ๊ฐˆ๋ ค AC-20 ์ด ๋ฐฑ์—”๋“œ๋ณ„๋กœ ๋‹ค๋ฅธ ์กฐ๊ฑด์ด ๋œ๋‹ค(agent ์—์„œ ์‘๋‹ต ๋ถˆ๊ฐ€์ธ ์ƒํƒœ๊ฐ€ acp ์—์„œ๋Š” ์•„๋‹Œ ์ƒํƒœ). โ‘ ๋งŒ AgentSession.events ๋ผ๋Š” ยง3.1 ์˜ ์œ ์ผํ•œ ๊ด€์ฐฐ ์ง€์  ์œ„์—์„œ ํŒ์ • ๊ฐœ์ž… ์—†์ด ์„ฑ๋ฆฝํ•œ๋‹ค. ๊ฐ€์„ค๋กœ ์ง„ํ–‰ํ•˜๋Š” ๊ทผ๊ฑฐ๋Š” ๋˜๋Œ๋ฆผ ๋น„์šฉ์˜ ๋น„๋Œ€์นญ์ด๋‹ค โ€” ๊ฐ์ง€๊ธฐ๋ฅผ ๋งŒ๋“ค์ง€ ์•Š์œผ๋ฉด AC-20 ์€ ์•„์˜ˆ ํŒ์ • ๋ถˆ๊ฐ€๋กœ ๋‚จ๊ณ , ๋งŒ๋“ค์–ด ๋‘๋ฉด ๊ธฐ์ค€์ด ๋ฐ”๋€” ๋•Œ ๊ฐˆ์•„ ๋ผ์šฐ๋Š” ๊ฒƒ์€ ๊ฐ์ง€๊ธฐ ํ•˜๋‚˜๋‹ค(์ „์ด ๊ฒฝ๋กœ๋Š” ๊ธฐ์ค€๊ณผ ๋ฌด๊ด€ํ•˜๋‹ค).
  • Impact:
    • docs/unresponsive-detection-cocode.md ยง1 ์ด ์ด ๊ฒฐ์ •์˜ ์ „๋ฌธ์ด๋‹ค. #49 ์˜ ๊ตฌํ˜„์ด ๊ทธ ๋ฌธ์„œ ยง4 ๋ฅผ ์ž…๋ ฅ์œผ๋กœ ๋ฐ›๋Š”๋‹ค.
    • ๊ฐ€์„ค์ž„์ด ์ฝ”๋“œ์— ๋‚จ๋Š”๋‹ค โ€” ๊ฐ์ง€๊ธฐ ์ฃผ์„๊ณผ #49 PR ๋ณธ๋ฌธ์— #112 ๋ฏธ๊ฒฐ์ด ์ธ์šฉ๋œ๋‹ค. ์˜ค๋„ˆ๊ฐ€ ๋’ค์ง‘์„ ๋•Œ ์˜ํ–ฅ ๋ฒ”์œ„๋Š” ๊ฐ์ง€๊ธฐ ยท bdd Feature 3 AC-20 Scenario Outline ยท architecture ยง6.2 ๋„ท๋ฟ์ด๋‹ค.
    • ์—ฐ์† ์˜ค๋ฅ˜ ํšŸ์ˆ˜๋Š” ๊ฐ์ง€ ๊ธฐ์ค€์—์„œ ์˜๊ตฌํžˆ ๋น ์ง„๋‹ค โ€” ์žฌ๋„์ž…ํ•˜๋ ค๋ฉด ์ด ๊ฒฐ์ •์„ ๋’ค์ง‘์–ด์•ผ ํ•œ๋‹ค.
  • Source: #50 AC1 (๋น„์ค€ ์ฃผ์ฒด ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ โ€” ๊ฒฐ์ • ์ด์Šˆ #112, ๋ฏธ๊ฒฐ). architecture ยง6.2 DD-22 ์˜ ํ•ด์†Œ์•ˆ์„ ๊ทธ๋Œ€๋กœ ์ฑ„ํƒ.

D-061: ์‹œ๊ฐ„ ์ƒํ•œ 3์ข…์€ ๋ณ„๊ฐœ ์„ค์ • ํ•ญ๋ชฉ์ด๊ณ  ์œ ํœด ์ƒํ•œ์€ AC-08 ์ถœํ•˜ ๊ธฐ๋ณธ๊ฐ’์˜ ์‹œ๋“œ ์žฌ์‚ฌ์šฉ์ด๋‹ค (#50 AC2ยทAC3)

  • Date: 2026-09-13
  • Context: ์ƒํ•œ์ด ์…‹ ์žˆ๋Š”๋ฐ(AC-08 ์ž๊ฐ€ ๊ฒ€์ฆ ์‹œ๋„ ์‹œ๊ฐ„ ์ƒํ•œ ยท AC-20 ์œ ํœด ์ƒํ•œ ยท architecture ยง3.1 ์˜ AgentRequest ์š”์ฒญ ์ˆ˜์ค€ ํƒ€์ž„์•„์›ƒ) ์…‹์˜ ๊ด€๊ณ„๊ฐ€ ์–ด๋””์—๋„ ์—†์—ˆ๋‹ค. architecture:527 ์€ ์œ ํœด ์ƒํ•œ์„ AC-08 ๊ธฐ๋ณธ๊ฐ’์˜ ์‹œ๋“œ ์žฌ์‚ฌ์šฉ์œผ๋กœ ์ •ํ–ˆ๊ณ  :623(ยง9 ๋ฏธ๊ฒฐ 2)์€ ๋‘ ๊ฐ’์„ ํ•œ ํ•ญ๋ชฉ์œผ๋กœ ๋ฌถ์—ˆ์œผ๋‚˜, ยง3.1 ์˜ ์š”์ฒญ ์ˆ˜์ค€ ํƒ€์ž„์•„์›ƒ์€ :256 ์—์„œ ใ€Œยง9 ๋ฏธ๊ฒฐ 5 ์™€ ๊ฐ™์€ ์ทจ๊ธ‰ใ€์œผ๋กœ๋งŒ ์–ธ๊ธ‰๋ผ ๋‚˜๋จธ์ง€ ๋‘˜๊ณผ์˜ ๊ด€๊ณ„๊ฐ€ ๋น„์–ด ์žˆ์—ˆ๋‹ค. ๊ด€๊ณ„๊ฐ€ ์—†์œผ๋ฉด ํ•œ ์ƒํ•œ์ด ๋‹ค๋ฅธ ์ƒํ•œ์„ ๊ฐ€๋ ค AC-20 ์ด๋‚˜ ๋ถˆ๋ณ€์‹ 3 ์ด ๊นจ์ง„๋‹ค.
  • Options:
    1. ํ•˜๋‚˜๋กœ ํ•ฉ์นœ๋‹ค โ€” ๋‹จ์ผ ใ€Œ์—์ด์ „ํŠธ ํƒ€์ž„์•„์›ƒใ€ ์„ค์ •
    2. ๋ณ„๊ฐœ 3์ข… + ํฌ๊ธฐ ๋ถ€๋“ฑ์‹ ๊ทœ์น™(์š”์ฒญ < ์œ ํœด < ์‹œ๋„ ๋“ฑ)์„ ๊ทœ์ •ํ•œ๋‹ค
    3. ๋ณ„๊ฐœ 3์ข… ยท ๋ถ€๋“ฑ์‹ ์—†์Œ โ€” ์„œ๋กœ ๋‹ค๋ฅธ ๊ฒƒ์˜ ๊ฒฝ๊ณผ๋ฅผ ์žฌ๋ฏ€๋กœ ์• ์ดˆ์— ๊ฐ™์€ ๊ตฌ๊ฐ„์„ ์žฌ์ง€ ์•Š๋Š”๋‹ค
  • Decision: ์˜ต์…˜ 3. ์…‹์€ ์žฌ๋Š” ๋Œ€์ƒ์ด ๋‹ค๋ฅด๋‹ค โ€” ์‹œ๋„ 1ํšŒ์˜ ๊ฒฝ๊ณผ / ๋งˆ์ง€๋ง‰ AgentEvent ์ดํ›„ ๊ฒฝ๊ณผ / ํ•œ ์š”์ฒญ์ด ๋ฏธ์ข…๊ฒฐ์ธ ์ฑ„ ํ๋ฅธ ์‹œ๊ฐ„. ์œ ํœด ์ƒํ•œ์˜ ์ตœ์ดˆ ๊ฐ’๋งŒ AC-08 ์ถœํ•˜ ๊ธฐ๋ณธ๊ฐ’์„ ์‹œ๋“œ๋กœ ๋ฐ›๊ณ , ๊ทธ ๋’ค๋กœ๋Š” ๋…๋ฆฝ ์กฐ์ •๋œ๋‹ค. ์ด ์ŠคํŒŒ์ดํฌ๋Š” ์ƒˆ ์ˆ˜์น˜๋ฅผ ๊ณ ๋ฅด์ง€ ์•Š๋Š”๋‹ค โ€” ๊ฐ’์€ ยง9 ๋ฏธ๊ฒฐ 2(์˜ค๋„ˆ ๋˜๋Š” Planning)ยท๋ฏธ๊ฒฐ 5(Design)๊ฐ€ ๊ทธ๋Œ€๋กœ ์†Œ์œ ํ•œ๋‹ค.
  • Rationale: โ‘ ์€ ๋ถˆ๋ณ€์‹ 3 ์„ ๊นฌ๋‹ค โ€” ์‚ฌ๋žŒ์˜ ์Šน์ธ์„ ๊ธฐ๋‹ค๋ฆฌ๋Š” PermissionRequested ๋Š” ์ •์ƒ ์ƒํƒœ(์‚ฌ๋žŒ์Šน์ธ๋Œ€๊ธฐ)์ธ๋ฐ, ํ•ฉ์นœ ๋‹จ์ผ ์ƒํ•œ ์•„๋ž˜์„œ๋Š” ๊ทธ ๋Œ€๊ธฐ๊ฐ€ ๊ณง ์„ธ์…˜์˜ ์‘๋‹ต ๋ถˆ๊ฐ€๊ฐ€ ๋œ๋‹ค. โ‘ก๋Š” ๊ฒ€์‚ฌ ์‹œ์ ์ด ์—†๋‹ค โ€” ์„ธ ๊ฐ’์ด ๋ชจ๋‘ ๋ฏธ์ •์ด๋ผ ๋ถ€๋“ฑ์‹์„ ์ง€๊ธˆ ๊ฒ€์‚ฌํ•  ์ˆ˜ ์—†๊ณ , ๋ถ€๋“ฑ์‹์„ ๊ทœ์น™์œผ๋กœ ๋„ฃ์œผ๋ฉด ์„ค์ • ํ™”๋ฉด์ด ๊ทธ๊ฒƒ์„ ๊ฒ€์ฆํ•ด์•ผ ํ•˜๋ฉฐ ๊ฒ€์ฆ ์‹คํŒจ ์‹œ ๋™์ž‘(๊ฑฐ๋ถ€? ๋ณด์ •?)์ด ๋˜ ํ•˜๋‚˜์˜ ๋ฏธ์ •์ด ๋œ๋‹ค. ๊ฒŒ๋‹ค๊ฐ€ ๋ถ€๋“ฑ์‹์ด ๊นจ์ ธ๋„ ํ‹€๋ฆฐ ๊ฒฐ๊ณผ๊ฐ€ ๋‚˜์˜ค์ง€ ์•Š๋Š”๋‹ค: architecture ยง6.2 ์˜ ใ€Œํ˜ธ์ŠคํŠธ๊ฐ€ ๋ฏธ์™„๋ฃŒ๋กœ ๋ถ™์žก์€ AgentRequest ๋Š” S2 ๋Œ€์ƒ์ด ์•„๋‹ˆ๋‹คใ€๊ฐ€ ๋‘ ์‹œ๊ณ„๋ฅผ ์• ์ดˆ์— ๋ถ„๋ฆฌํ•ด ๋‘์—ˆ๊ธฐ ๋•Œ๋ฌธ์ด๋‹ค. ๊ทธ ์ œ์™ธ ๊ทœ์น™๊ณผ ์š”์ฒญ ์ˆ˜์ค€ ํƒ€์ž„์•„์›ƒ์€ ๋Œ€์ฒด์žฌ๊ฐ€ ์•„๋‹ˆ๋ผ ํ•œ ์Œ์ด๋‹ค โ€” ์ œ์™ธ๊ฐ€ ์—†์œผ๋ฉด ํ˜ธ์ŠคํŠธ์˜ ์ง€์—ฐ์„ ์—์ด์ „ํŠธ ํƒ“์œผ๋กœ ๋Œ๋ฆฌ๊ณ , ์š”์ฒญ ํƒ€์ž„์•„์›ƒ์ด ์—†์œผ๋ฉด ์ œ์™ธ๋œ ์š”์ฒญ์— ์•„๋ฌด ์ƒํ•œ๋„ ๋‚จ์ง€ ์•Š๋Š”๋‹ค.
  • Impact:
    • docs/unresponsive-detection-cocode.md ยง3 ์˜ ํ‘œ๊ฐ€ 3์ข… ๊ด€๊ณ„์˜ SSOT ๋‹ค.
    • ๋ฏธ์ • ๋™์•ˆ์˜ ๋™์ž‘์ด ์ฐจ๋‹จ ๋ฐฉํ–ฅ์œผ๋กœ ๋ชป ๋ฐ•ํžŒ๋‹ค โ€” ์œ ํœด ์ƒํ•œ์ด ์ฃผ์–ด์ง€์ง€ ์•Š์œผ๋ฉด ๊ฐ์ง€๊ธฐ๋ฅผ ๊ตฌ์„ฑํ•  ์ˆ˜ ์—†๊ณ (๊ธฐ๋ณธ๊ฐ’ ์—†์Œ), 0 ์ดํ•˜ยท๋ฌดํ•œ ๊ฐ’์€ ๊ฑฐ๋ถ€๋œ๋‹ค. ์กฐ์šฉํžˆ ใ€Œ๋ฌดํ•œใ€์œผ๋กœ ๋„๋Š” ๊ฒฝ๋กœ๊ฐ€ ์—†๋‹ค. #44 ์˜ AgentRequestTimeouts ๊ฐ€ ๊ธฐ๋ณธ ์ƒ์„ฑ์ž๋ฅผ ๋‘์ง€ ์•Š์€ ๊ฒƒ๊ณผ ๊ฐ™์€ ํ˜•ํƒœ๋‹ค.
    • ์‹œ๋“œ ์›์ฒœ์€ ์ด๋ฏธ ์žˆ๋‹ค โ€” 20๋ถ„(D-033, ์˜ค๋„ˆ ๊ฒฐ์ • 2026-09-10). ๋”ฐ๋ผ์„œ AC-20 ์œ ํœด ์ƒํ•œ์˜ ์ถœํ•˜ ๊ธฐ๋ณธ๊ฐ’๋„ 20๋ถ„์ด๋ฉฐ, ์ด๊ฒƒ์€ ์ด ๊ฒฐ์ •์ด ๊ณ ๋ฅธ ์ˆ˜์น˜๊ฐ€ ์•„๋‹ˆ๋ผ ์‹œ๋“œ ๊ทœ์น™์˜ ํŒŒ์ƒ๊ฐ’์ด๋‹ค. #67 ์€ AC-08 ๊ธฐ๋ณธ๊ฐ’์˜ ์ตœ์ดˆ ์„ ํƒ์„ ์ž๊ธฐ ๋ฒ”์œ„ ๋ฐ–์œผ๋กœ ์ œ์™ธํ–ˆ์ง€๋งŒ, ๊ทธ ๊ฐ’์€ #67 ์ด ์•„๋‹ˆ๋ผ ์˜ค๋„ˆ๊ฐ€ D-033 ์œผ๋กœ ์ด๋ฏธ ๋งŒ๋“ค์–ด ๋’€๋‹ค.

      ๐Ÿ”ง ์ •์ •(2026-09-13) โ€” ์ด ํ•ญ๋ชฉ์˜ ์ดˆํŒ์€ ใ€Œ์‹œ๋“œ ์›์ฒœ์ด ์•„์ง ๋น„์–ด ์žˆ๋‹คใ€๊ณ  ์ ์—ˆ๋‹ค. architecture ยง9 ๋ฏธ๊ฒฐ 2 ํ–‰์ด D-033 ์ดํ›„ ๊ฐฑ์‹ ๋˜์ง€ ์•Š์•„ ๋‚ก์€ ์ƒํƒœ์˜€๊ณ  ๊ทธ ํ–‰๋งŒ ์ฝ๊ณ  ํŒ์ •ํ•œ ๊ฒƒ์ด ์›์ธ์ด๋‹ค. ๊ฐ™์€ PR ์ด ๊ทธ ํ–‰๋„ ใ€Œโœ… ํ•ด์†Œใ€๋กœ ๊ฐฑ์‹ ํ–ˆ๋‹ค. ๊ฒฐ๋ก ์ด ๋’ค์ง‘ํžŒ๋‹ค โ€” AC-20 ์€ ๊ฐ’์ด ์—†์–ด ๋ฏธ์ถฉ์กฑ์ธ ๊ฒƒ์ด ์•„๋‹ˆ๋ผ ๊ฐ’์ด ์žˆ์–ด ํŒ์ • ๊ฐ€๋Šฅํ•˜๋‹ค.

    • ํฌ๊ธฐ ๋ถ€๋“ฑ์‹์€ ๊ทœ์น™์ด ์•„๋‹ˆ๋ผ ๊ฐ’์„ ๊ณ ๋ฅผ ๋•Œ์˜ ๊ด€์ฐฐ๋กœ๋งŒ ๋‚จ๋Š”๋‹ค โ€” permission ์š”์ฒญ ํƒ€์ž„์•„์›ƒ์ด ๋‚˜๋จธ์ง€๋ณด๋‹ค ํฌ๋‹ค.
  • Source: #50 AC2ยทAC3. ๊ฐ’์˜ ํ™•์ • ์ฃผ์ฒด๋Š” architecture ยง9 ๋ฏธ๊ฒฐ 2(์˜ค๋„ˆ ๋˜๋Š” Planning, ์ดํ›„ ์กฐ์ •์€ Planning โ€” D-020)์™€ ๋ฏธ๊ฒฐ 5(Design) ๋ฌธ๋ฉด ๊ทธ๋Œ€๋กœ์ด๋ฉฐ ์ด ๊ฒฐ์ •์ด ๋ฐ”๊พธ์ง€ ์•Š๋Š”๋‹ค.

D-062: ACP v2 ๋ผ์šฐํŒ… seam = ํ˜‘์ƒ ์งํ›„์˜ ์™€์ด์–ด ์–ด๋Œ‘ํ„ฐ ์„ ํƒ ํ•œ ์ง€์  ยท ํ˜‘์ƒ์€ v1 ๊ณ ์ • + fail-closed (#51 AC1ยทAC4)

  • Date: 2026-09-13
  • Context: architecture ยง9 ๋ฏธ๊ฒฐ 13 = prd D-10 = planning-inputs ยง5.3 ์ด ใ€Œv2 ๋ผ์šฐํŒ… seam ์˜ ๊ตฌ์ฒด์  ์„ค๊ณ„ ์ง€์ ใ€์„ Design ์œผ๋กœ ๋„˜๊ฒผ๋‹ค. seam ์ด ์—†์œผ๋ฉด v2 ๊ฐ€ ์™”์„ ๋•Œ ๋ถ„๊ธฐ๊ฐ€ ํ˜ธ์ถœ ์ง€์ ๋งˆ๋‹ค ํฉ์–ด์ง€๊ณ , ใ€Œv2 ๋ฅผ ์ง€์›ํ•˜๋Š”๊ฐ€ใ€์˜ ๋‹ต์ด ์ฝ”๋“œ ํ•œ ๊ณณ์— ์—†๊ฒŒ ๋œ๋‹ค.
  • Options:
    1. ์ „์†ก ๊ณ„์ธต ์•„๋ž˜(JSON-RPC ์ฝ”๋ฑ)์—์„œ ๊ฐ€๋ฅธ๋‹ค
    2. AgentRuntime ๊ตฌํ˜„ ์ „์ฒด๋ฅผ ๋ฒ„์ „๋ณ„๋กœ ๋‘”๋‹ค
    3. ํ˜ธ์ถœ ์ง€์ ๋งˆ๋‹ค ๋ถ„๊ธฐํ•œ๋‹ค
    4. ํ˜‘์ƒ ์งํ›„ ์™€์ด์–ด ์–ด๋Œ‘ํ„ฐ๋ฅผ ๊ณ ๋ฅธ๋‹ค โ€” initialize ์‘๋‹ต์˜ protocolVersion ์œผ๋กœ ๊ตฌํ˜„์ฒด ์„ ํƒ
  • Decision: ์˜ต์…˜ 4. acp ์•ˆ์— AcpWireAdapter ์ธํ„ฐํŽ˜์ด์Šค๋ฅผ ๋‘๊ณ  AcpWireV1 ํ•˜๋‚˜๋ฅผ ๊ตฌํ˜„ํ•œ๋‹ค. ์„ ํƒ์€ ํ˜‘์ƒ ์งํ›„ ํ•œ ์ง€์ ์ด๋ฉฐ ๊ทธ ์œ„(๊ณ„์•ฝ)์™€ ๊ทธ ์•„๋ž˜(์ „์†ก)๋Š” ๋ฒ„์ „์„ ๋ชจ๋ฅธ๋‹ค. ํ˜‘์ƒ์€ v1 ์„ ์š”์ฒญํ•˜๊ณ  ์‘๋‹ต์ด != 1 ์ด๋ฉด ์—ฐ๊ฒฐ์„ ๊ฑฐ๋ถ€ํ•œ๋‹ค โ€” ์ž๋™ ๊ฐ•๋“ฑ๋„ ์ž๋™ ์Šน๊ฒฉ๋„ ์—†๋‹ค.
  • Rationale: โ‘ ์€ v1/v2 ์ฐจ์ด๊ฐ€ ๋ฉ”์„œ๋“œ ์ด๋ฆ„ยทํŽ˜์ด๋กœ๋“œ์ด์ง€ JSON-RPC ์ž์ฒด๊ฐ€ ์•„๋‹ˆ๋ผ์„œ ์ฝ”๋ฑ ์•ˆ์—์„œ ๋‹ค์‹œ ๋ถ„๊ธฐํ•ด์•ผ ํ•˜๊ณ  seam ์ด ๋‘˜์ด ๋œ๋‹ค. โ‘ก๋Š” describeProviders()ยท์—ฐ๊ฒฐ ๊ด€๋ฆฌยท์ž๊ฒฉ์ฆ๋ช… UI ์ฒ˜๋Ÿผ ๋ฒ„์ „๊ณผ ๋ฌด๊ด€ํ•œ ์ฝ”๋“œ๊นŒ์ง€ ๋‘ ๋ฒŒ์ด ๋˜์–ด ์กฐ์šฉํžˆ ๊ฐˆ๋ผ์ง„๋‹ค(#44 ๊ฐ€ ๊ณ„์•ฝ์—์„œ ์ง๋ ฌํ™”๋ฅผ ๋ฐฐ์ œํ–ˆ์œผ๋ฏ€๋กœ ๊ณ„์•ฝ ํ‘œ๋ฉด์— ๋ฒ„์ „์ด ์ƒˆ์–ด ๋‚˜์˜ฌ ์ž๋ฆฌ๊ฐ€ ์• ์ดˆ์— ์—†๋‹ค). โ‘ข์€ v2 ์ถ”๊ฐ€ ์‹œ ๋น ๋œจ๋ฆฐ ์ž๋ฆฌ๋ฅผ ์ปดํŒŒ์ผ๋Ÿฌ๊ฐ€ ์•Œ๋ ค ์ฃผ์ง€ ๋ชปํ•œ๋‹ค. โ‘ฃ๋งŒ ๋ถ„๊ธฐ๊ฐ€ ํ•œ ์ค„์ด๊ณ , ์ƒˆ ๋ฒ„์ „์ด ๊ตฌํ˜„ ์ถ”๊ฐ€๋กœ ๋๋‚˜๋ฉฐ, ๋น ๋œจ๋ฆฐ ๋ฉ”์„œ๋“œ๊ฐ€ ์ปดํŒŒ์ผ ์˜ค๋ฅ˜๋กœ ์žกํžŒ๋‹ค. fail-closed ํ˜‘์ƒ์˜ ๊ทผ๊ฑฐ๋Š” D-063 ๊ณผ ๊ณต์œ ํ•˜๋Š” ๋ฒ”์œ„ ์ „์ œ๋‹ค โ€” ใ€Œv2 ๋กœ ๋‹ตํ•  ์ˆ˜ ์žˆ๋Š” ์—์ด์ „ํŠธ๊ฐ€ ์—†๋‹คใ€๋Š” ๋””์ปดํŒŒ์ผ๋œ 2์ข…์—๋งŒ ์ฐธ์ด๊ณ  ๋‚˜๋จธ์ง€ 30์ข…์€ ๋ฏธํ™•์ธ์ด๋ฏ€๋กœ, ๋ฏธํ™•์ธ ์—์ด์ „ํŠธ๊ฐ€ v2 ๋กœ ๋‹ตํ•˜๋Š”๋ฐ ๊ทธ๊ฒƒ์„ v1 ์ธ ์ฒ™ ๋‹ค๋ฃจ๋ฉด ์šฐ๋ฆฌ๊ฐ€ ๋ณด๋‚ด๋Š” ์š”์ฒญ๊ณผ ์—์ด์ „ํŠธ๊ฐ€ ์ดํ•ดํ•˜๋Š” ์š”์ฒญ์ด ์–ด๊ธ‹๋‚œ ์ฑ„ ์„ธ์…˜์ด ์‹œ์ž‘๋œ๋‹ค. ๊ฑฐ๋ถ€๋Š” ๊ด€์ฐฐ ๊ฐ€๋Šฅํ•˜๊ณ  ์กฐ์šฉํ•œ ์˜คํ•ด๋Š” ๊ทธ๋ ‡์ง€ ์•Š๋‹ค(#34 EnvironmentNotAllowed ์™€ ๊ฐ™์€ ๋…ผ๋ฆฌ).
  • Impact:
    • docs/acp-integration-design-cocode.md ยง1 ์ด ์ „๋ฌธ์ด๋‹ค. #47 ์ด ๊ทธ ยง5 ๋ฅผ ์ž…๋ ฅ์œผ๋กœ ๋ฐ›๋Š”๋‹ค.
    • ์–ด๋Œ‘ํ„ฐ ๊ตฌํ˜„์ด ํ•˜๋‚˜๋ฟ์ธ๋ฐ๋„ ์ธํ„ฐํŽ˜์ด์Šค๋ฅผ ๋‘๋Š” ๊ทผ๊ฑฐ๊ฐ€ ๊ธฐ๋ก๋œ๋‹ค โ€” ๋ฏธํ™•์ธ 30์ข…์ด๋‹ค. ใ€Œ์–ด์ฐจํ”ผ v2 ๋Š” ์—†๋‹คใ€๋ฅผ ์ „์ œํ–ˆ๋‹ค๋ฉด ์‘๋‹ต ๋ฒ„์ „์„ ํ™•์ธํ•  ์ด์œ ์กฐ์ฐจ ์—†๋‹ค.
    • #48 ์ด 4์ข… ์‹ค๊ธฐ๋™ ์‹œ ํ˜‘์ƒ๋œ ๋ฒ„์ „์„ ๊ธฐ๋กํ•œ๋‹ค โ€” ๊ทธ ๊ธฐ๋ก์ด ๋ฏธํ™•์ธ ๋ฒ”์œ„๋ฅผ ์ค„์ธ๋‹ค.
  • Source: #51 AC1ยทAC4 (ํŒ์ • ์ฃผ์ฒด Design โ€” architecture ยง9 ๋ฏธ๊ฒฐ 13 '๋ˆ„๊ฐ€' ์—ด). ๋ฒ”์œ„ ์ „์ œ๋Š” planning-inputs ยง5.2 ์˜ ๋‘ ์ธต์œ„ ํ‘œ ๊ทธ๋Œ€๋กœ.

D-063: ACP ์ธ์ฆ ํ๋ฆ„์€ terminalยทagent ๋‘ ๊ฐ€์ง€๋ฅผ ๊ฐ๊ฐ ๋‹ค๋ฃจ๊ณ , ๋Šฅ๋ ฅ ์ฐจ์ด๋Š” ๋น„ํ™œ์„ฑ + ์‚ฌ์œ ๋‹ค (#51 AC2ยทAC3)

  • Date: 2026-09-13
  • Context: architecture ยง9 ๋ฏธ๊ฒฐ 13 ์˜ ๋‚˜๋จธ์ง€ ๋‘ ํ•ญ๋ชฉ. 4์ข…์˜ ์ธ์ฆ ๋ฐฉ์‹์ด ๊ฐˆ๋ฆฌ๊ณ (Claude Agent = terminal, Codex = agent โ€” planning-inputs ยง5.1) ๋Šฅ๋ ฅ ์กฐํ•ฉ๋„ ์„œ๋กœ ๋‹ฌ๋ผ, ๊ทœ์น™์ด ์—†์œผ๋ฉด ํ•œ ์—์ด์ „ํŠธ์—๋งŒ ๋งž๋Š” UI ๊ฐ€ ๋‚˜์˜จ๋‹ค.
  • Options (์ธ์ฆ): โ‘ terminal ๋งŒ ์ง€์› โ‘กagent ๋งŒ ์ง€์› โ‘ข๋‘˜ ๋‹ค โ€” ์—์ด์ „ํŠธ๊ฐ€ ์ •ํ•˜๋Š” ์‚ฌ์‹ค์ด๋ฏ€๋กœ ํƒ์ผ์ด ์•„๋‹ˆ๋‹ค
  • Options (๋Šฅ๋ ฅ ์ฐจ์ด): โ“๋ฏธ์ง€์› ๋Šฅ๋ ฅ์„ ์ž๋™ ๋Œ€์ฒด(fork โ†’ ์ƒˆ ์„ธ์…˜) โ“‘๋น„ํ™œ์„ฑ + ์‚ฌ์œ , ๋Œ€์ฒด๋Š” ์ œ์‹œ๋งŒ โ“’๋Šฅ๋ ฅ์ด ๋ถ€์กฑํ•œ ์—์ด์ „ํŠธ๋ฅผ ๋ชฉ๋ก์—์„œ ์ œ์™ธ
  • Decision: ์ธ์ฆ โ‘ข โ€” ๋‘˜ ๋‹ค, ์ž๋ฆฌ๋Š” S-15. ์™„๋ฃŒ ๊ด€์ธก์€ terminal ์ด๋ฉด ํ”„๋กœํ† ์ฝœ ์žฌ์งˆ์˜(initialize ์žฌ์ˆ˜ํ–‰), agent ๋ฉด authenticate ์˜ JSON-RPC ์‘๋‹ต์ด๋‹ค. ๋Šฅ๋ ฅ ์ฐจ์ด โ“‘ โ€” ๋น„ํ™œ์„ฑ + ์‚ฌ์œ , ๊ทœ์น™ G-1~G-5(์„ ์–ธ๋œ ๊ฒƒ๋งŒ ์ฐธ ยท ์ถ• ์‚ฌ์ด ํ•จ์˜ ์—†์Œ ยท ์ž๋™ ๋Œ€์ฒด ์—†์Œ ยท ๋Œ€์ฒด๋Š” ์ œ์‹œ๋งŒ ยท AC-06 ์„ ์ขํžˆ์ง€ ์•Š์Œ).
  • Rationale: ์ธ์ฆ์€ ํƒ์ผ์ด ์„ฑ๋ฆฝํ•˜์ง€ ์•Š๋Š”๋‹ค โ€” terminal/agent ๋Š” ์ œํ’ˆ์ด ๊ณ ๋ฅด๋Š” ๊ฒƒ์ด ์•„๋‹ˆ๋ผ ์—์ด์ „ํŠธ๊ฐ€ ์ •ํ•˜๋Š” ์‚ฌ์‹ค์ด๊ณ , 4์ข…์„ ๋‹ค ๋ถ™์ด๋ ค๋ฉด ๋‘˜ ๋‹ค ์žˆ์–ด์•ผ ํ•œ๋‹ค(AC-06 ์˜ ใ€Œ1๊ฐœ ์ด์ƒใ€์€ 1์ข…๋งŒ ๋ถ™์—ฌ๋„ ์ถฉ์กฑ๋˜์ง€๋งŒ A-05 ์˜ ๊ฒ€์ฆ ๊ณ„ํš์ด 4์ข…์ด๋‹ค). ์™„๋ฃŒ ๊ด€์ธก์„ ํ„ฐ๋ฏธ๋„ ์ถœ๋ ฅ ํŒŒ์‹ฑ์œผ๋กœ ํ•˜์ง€ ์•Š๋Š” ์ด์œ ๋Š” ์ด ์„ค๊ณ„๊ฐ€ ์ผ๊ด€๋˜๊ฒŒ ํ”ผํ•ด ์˜จ ใ€Œ๋ถ„์Ÿ ๊ฐ€๋Šฅํ•œ ํŒ์ •ใ€์ด๋‹ค โ€” ๋กœ๊ทธ์ธ ์„ฑ๊ณต ๋ฌธ๊ตฌ๋Š” ์—์ด์ „ํŠธ๋งˆ๋‹ค ๋‹ค๋ฅด๊ณ  ๋ฒ„์ „ยท์ง€์—ญํ™”๋กœ ๋˜ ๋ฐ”๋€๋‹ค. ํ”„๋กœํ† ์ฝœ์— ๋‹ค์‹œ ๋ฌผ์œผ๋ฉด ๊ทธ ๋‹ต์€ ์—์ด์ „ํŠธ ์ž์‹ ์˜ ๊ฒƒ์ด๋ผ ํŒ์ •์ด ์—†๋‹ค. ๋Šฅ๋ ฅ ์ฐจ์ด์—์„œ โ“๋Š” ์‚ฌ์šฉ์ž๊ฐ€ fork ๋๋‹ค๊ณ  ๋ฏฟ๋Š” ์ƒํƒœ๋ฅผ ๋งŒ๋“ ๋‹ค โ€” ์ด์–ด์ง„ ๋งฅ๋ฝ์ด ์—†๋Š”๋ฐ ์žˆ๋‹ค๊ณ  ๋ฏฟ๋Š” ์ชฝ์ด ๊ธฐ๋Šฅ ๋ถ€์žฌ๋ณด๋‹ค ๋‚˜์˜๋‹ค. โ“’๋Š” AC-06 โ“‘(ใ€Œ1๊ฐœ ์ด์ƒ ์—ฐ๊ฒฐใ€)์™€ ์–ด๊ธ‹๋‚œ๋‹ค โ€” loadSession ๋งŒ ๋˜๋Š” ์—์ด์ „ํŠธ๋„ ์—ฐ๊ฒฐ๋œ ์—์ด์ „ํŠธ๋‹ค. โ“‘๋งŒ ux-spec ยง4.5 R3(ใ€Œ๋น„ํ™œ์„ฑํ™”๋˜๊ณ  ์‚ฌ์œ ๊ฐ€ ๋ถ™๋Š”๋‹คใ€)์˜ ๊ธฐ์กด ํ˜•ํƒœ์™€ ๊ฐ™๊ณ  ์‚ฌ์šฉ์ž๊ฐ€ ์ƒํƒœ๋ฅผ ์ •ํ™•ํžˆ ์•ˆ๋‹ค.
  • Impact:
    • docs/acp-integration-design-cocode.md ยง2ยทยง3 ์ด ์ „๋ฌธ์ด๋‹ค. ํ™”๋ฉด ๊ณ„์•ฝ์€ S-15(ux-spec ยง10) ์ด๋ฉฐ ์œ„์ ฏ์€ ์…ธ Epic #53 ์˜ ๋ชซ์ด๋‹ค(S-16 ๊ณผ ๊ฐ™์€ ๋ถ„์—…).
    • G-1 fail-closed ์˜ ๊ท€๊ฒฐ: ๋Šฅ๋ ฅ์ด ๋ฏธํ™•์ธ์ธ ์—์ด์ „ํŠธ(Copilot CLI)๋Š” ์ „๋ถ€ ๋น„ํ™œ์„ฑ์œผ๋กœ ์‹œ์ž‘ํ•˜๊ณ , #48 ์‹ค์ธก์ด ์ฑ„์šฐ๋ฉด ์ž๋™์œผ๋กœ ๋„“์–ด์ง„๋‹ค. ๋ฐ˜๋Œ€ ๋ฐฉํ–ฅ(๋ฏธํ™•์ธ์„ ์ง€์›์œผ๋กœ ๊ฐ€์ •)์€ ์—†๋‹ค.
    • ACP ์—์ด์ „ํŠธ์˜ ์ž๊ฒฉ์ฆ๋ช…์€ ๋ณด๊ด€ํ•˜์ง€ ์•Š๋Š”๋‹ค โ€” CredentialVault(D-034ยท#46)๋Š” agent ์˜ LLM ํ‚ค๋งŒ ๋‹ด๋Š”๋‹ค. ํ„ฐ๋ฏธ๋„ ํ๋ฆ„์—์„œ ์‚ฌ์šฉ์ž๊ฐ€ ์นœ ๊ฒƒ๋„, ์—์ด์ „ํŠธ ํ๋ฆ„์˜ ํ† ํฐ๋„ ์šฐ๋ฆฌ ์ €์žฅ์†Œ์— ๋“ค์–ด์˜ค์ง€ ์•Š๋Š”๋‹ค.
    • ์ธ์ฆ๋˜์ง€ ์•Š์€ ์—์ด์ „ํŠธ๋Š” ๋ชฉ๋ก์—์„œ ์ˆจ๊ธฐ์ง€ ์•Š๊ณ  ใ€Œ์ธ์ฆ ํ•„์š”ใ€๋กœ ํ‘œ์‹œํ•œ๋‹ค โ€” ์ˆจ๊ธฐ๋ฉด ์‚ฌ์šฉ์ž๊ฐ€ ์™œ ์—†๋Š”์ง€ ์•Œ ์ˆ˜ ์—†๋‹ค. ์œ„์ž„ ์ƒ์„ฑ(S-05)์—์„œ ๊ณ ๋ฅด๋Š” ๊ฒƒ๋„ ๋ง‰์ง€ ์•Š๋Š”๋‹ค(๋ง‰์œผ๋ ค๋ฉด S-05 ๊ฐ€ ์ธ์ฆ ์ƒํƒœ๋ฅผ ํŒ์ •ํ•ด์•ผ ํ•˜๊ณ  ๊ทธ ํŒ์ •์€ ๊ณ ๋ฅด๋Š” ์ˆœ๊ฐ„๊ณผ ์‹คํ–‰ํ•˜๋Š” ์ˆœ๊ฐ„ ์‚ฌ์ด์— ๋‚ก๋Š”๋‹ค). ์ธ์ฆ๋˜์ง€ ์•Š์€ ์ฑ„ ์‹œ์ž‘ํ•˜๋ฉด ยง6.2 S1(์ธ์ฆ ๊ฑฐ๋ถ€๋Š” TransportClosed ์— ํฌํ•จ)์ด ์žก์•„ ์‹คํŒจ ๋กœ ์ „์ดํ•œ๋‹ค.
    • ํŒŒ์ผ IOยท๋ช…๋ น ์‹คํ–‰์€ degradation ๋Œ€์ƒ์ด ์•„๋‹ˆ๋‹ค โ€” ํด๋ผ์ด์–ธํŠธ ๋Šฅ๋ ฅ์€ ์—์ด์ „ํŠธ์˜ ๋Šฅ๋ ฅ์ด ์•„๋‹ˆ๋ผ ์šฐ๋ฆฌ์˜ ์˜๋ฌด๋‹ค(ยง3.3). ๋‹จ ACP v1 fs ๋Šฅ๋ ฅ์— ์‚ญ์ œยท์ด๋ฆ„๋ณ€๊ฒฝ์ด ์—†์–ด ACP ๊ฒฝ๋กœ๋กœ ๋“ค์–ด์˜ฌ ์ˆ˜ ์žˆ๋Š” FileEditOperation ์€ write ๋ฟ์ด๋ฉฐ, ์‚ญ์ œยท์ด๋ฆ„๋ณ€๊ฒฝ์˜ ์ฒ˜๋ถ„์€ #22ยท#37 ์†Œ์œ  ๋ฏธ๊ฒฐ๋กœ ๊ทธ๋Œ€๋กœ ๋‘”๋‹ค.
  • Source: #51 AC2ยทAC3 (ํŒ์ • ์ฃผ์ฒด Design โ€” architecture ยง9 ๋ฏธ๊ฒฐ 13). ๋Šฅ๋ ฅ ๊ฐ’์˜ ์ถœ์ฒ˜๋Š” planning-inputs ยง5.1 ์ด๊ณ  ์‹ค์ธก ํ™•์ธ์€ #48 ์ด๋‹ค.

D-064: ์ž๊ฒฉ์ฆ๋ช… ์ €์žฅ์€ pub ํŒจํ‚ค์ง€ ์—†์ด ์„ธ OS ์˜ ๊ณต์‹ ๋„๊ตฌยทAPI ์ง์ ‘ ํ˜ธ์ถœ (#46 AC1 ยท architecture ยง9 ๋ฏธ๊ฒฐ 7)

  • Date: 2026-09-13
  • Context: architecture ยง9 ๋ฏธ๊ฒฐ 7(ใ€Œ์ž๊ฒฉ์ฆ๋ช… ์ €์žฅ ํŒจํ‚ค์ง€ ์„ ์ •ใ€, Design, ๊ตฌํ˜„ ์ฐฉ์ˆ˜ ์‹œ). DD-23 ์€ ์ €์žฅ ์œ„์น˜๋ฅผ OS ์ž๊ฒฉ์ฆ๋ช… ์ €์žฅ์†Œ 3์ข…์œผ๋กœ ์ •ํ–ˆ์ง€๋งŒ ๋ฌด์—‡์œผ๋กœ ๋ถ€๋ฅผ์ง€๋Š” ๋น„์›Œ ๋’€๋‹ค. ์ œ์•ฝ์ด ๋‘˜ ์žˆ์—ˆ๋‹ค โ€” โ“ CredentialVault ๋ฅผ ์†Œ๋น„ํ•˜๋Š” agent(L2)์™€ ๊ณ„์•ฝ์ด ์‚ฌ๋Š” core(L0)๋Š” ์ˆœ์ˆ˜ Dart ์ด๊ณ  3-OS CI(verify.cocode-pure-tests.yaml)๊ฐ€ ๊ทธ ์„ฑ์งˆ์— ๊ฑธ๋ ค ์žˆ๋‹ค โ“‘ ์œ ์ผํ•˜๊ฒŒ Flutter ๋ฅผ ๋“ค ์ˆ˜ ์žˆ๋Š” ์ž๋ฆฌ์ธ cocode_app(L3)์— ์†๋Œ€๋ฉด DD-02a ์™„๊ฒฐ์„ฑ ํ…Œ์ŠคํŠธ ์ถ• 2ยท3 ์ด ํ™œ์„ฑํ™”๋˜์–ด ๊ณ„์•ฝ 12์ข… ๋ถ€ํŠธ์ŠคํŠธ๋žฉ ๋“ฑ๋ก์ด ํ•จ๊ป˜ ์š”๊ตฌ๋œ๋‹ค(์…ธ Epic #53 ์‚ฐ์ถœ๋ฌผ).
  • Options:
    1. flutter_secure_storage ^10.0.0 โ€” ์ด๋ฏธ ์›Œํฌ์ŠคํŽ˜์ด์Šค์— ์žˆ๊ณ (๋„๋„ˆ package/coreยทapp/cocode, win32 ํ˜ธํ™˜ override ๊นŒ์ง€ ์žกํ˜€ ์žˆ๋‹ค) ์„ธ ์ €์žฅ์†Œ์— 1:1 ๋Œ€์‘
    2. keyring/keyring_native(pub) โ€” ์ˆœ์ˆ˜ Dart ์ง„์ž…์ 
    3. ์„ธ OS ์˜ ๊ณต์‹ ๋„๊ตฌยทAPI ์ง์ ‘ ํ˜ธ์ถœ โ€” macOS /usr/bin/security ยท Linux secret-tool ยท Windows advapi32.dll(FFI)
  • Decision: ์˜ต์…˜ 3. toolchain(L1, ์ˆœ์ˆ˜ Dart)์— CredentialStoreBackend ํฌํŠธ๋ฅผ ๋‘๊ณ  ๋ฐฑ์—”๋“œ 3์ข…์„ ๋ถ™์ธ๋‹ค. macOSยทLinux ๋Š” ์ž์‹ ํ”„๋กœ์„ธ์Šค์˜ ํ‘œ์ค€ ์ž…๋ ฅ์œผ๋กœ ๋น„๋ฐ€์„ ๋„˜๊ธฐ๊ณ (๋‹จ์ผ ๋Ÿฐ์ฒ˜ DD-15 ๊ฒฝ์œ ), Windows ๋งŒ FFI(CredWriteW/CredReadW/CredDeleteW)๋‹ค.
  • Rationale: โ‘ ์€ Flutter ํ”Œ๋Ÿฌ๊ทธ์ธ์ด๋ผ ๋‘˜ ์ž๋ฆฌ๊ฐ€ ์—†๋‹ค โ€” ์œ„ ์ œ์•ฝ โ“โ“‘๊ฐ€ ๋™์‹œ์— ๋ง‰๋Š”๋‹ค. โ‘ก๋Š” ๋‹ค์šด๋กœ๋“œ 8๊ฑดยท์ข‹์•„์š” 0ยทpublisher ์—†์Œ์— Rust ํˆด์ฒด์ธ์„ ์š”๊ตฌํ•œ๋‹ค(2026-09-13 pub.dev ์‹ค์ธก). ๋ณด์•ˆ ๊ฒฝ๋กœ์— ๊ฒ€์ฆ๋˜์ง€ ์•Š์€ ์‹ ์ƒ ํŒจํ‚ค์ง€๋ฅผ ๋„ฃ๋Š” ๊ฒƒ์€ ์ด ๋ฌธ์„œ๊ฐ€ ํ”ผํ•ด ์˜จ ๋ฐฉํ–ฅ์ด๋‹ค. โ‘ข์ด ์„ฑ๋ฆฝํ•˜๋Š” ๊ทผ๊ฑฐ๋Š” ์‹ค์ธก์ด๋‹ค: macOS security add-generic-password โ€ฆ -w(๋งˆ์ง€๋ง‰ ์˜ต์…˜)๊ฐ€ ํ‘œ์ค€ ์ž…๋ ฅ์—์„œ ์ฝ๊ณ (ํ™•์ธ๊นŒ์ง€ 2ํšŒ), secret-tool store ๋„ ํ‘œ์ค€ ์ž…๋ ฅ์„ ์ฝ๋Š”๋‹ค โ€” ์ฆ‰ ๋น„๋ฐ€์ด argv ์— ์‹ค๋ฆฌ์ง€ ์•Š๋Š”๋‹ค(ํ”„๋กœ์„ธ์Šค ๋ชฉ๋ก์€ ๊ฐ™์€ ๋จธ์‹ ์˜ ๋‹ค๋ฅธ ์‚ฌ์šฉ์ž์—๊ฒŒ ๋ณด์ธ๋‹ค). Windows ๋งŒ ์˜ˆ์™ธ์ธ ์ด์œ ๋„ ์‹ค์ธก์ด๋‹ค: cmdkey ๋Š” ์“ฐ๊ธฐ์— /pass: ๋กœ ๊ฐ’์„ ์ธ์ž์— ์‹ฃ๊ณ , ๋ฌด์—‡๋ณด๋‹ค ์ €์žฅํ•œ ๋น„๋ฐ€์„ ๋˜์ฝ๋Š” ๊ธฐ๋Šฅ์ด ์—†๋‹ค โ€” ๋˜์ฝ์ง€ ๋ชปํ•˜๋ฉด ํ”„๋กœ๋ฐ”์ด๋” ํ‚ค ์กฐํšŒ ์ž์ฒด๊ฐ€ ๋ถˆ๊ฐ€๋Šฅํ•˜๋‹ค.
  • Impact:
    • ๊ตฌํ˜„์€ toolchain ์˜ OsCredentialVault + ๋ฐฑ์—”๋“œ 3์ข…. agentยทcore ๋Š” ์ˆœ์ˆ˜ Dart ๋กœ ๋‚จ๊ณ  3-OS CI ๊ฐ€ ๊ทธ๋Œ€๋กœ ๋ˆ๋‹ค. app/cocode ๋Š” ๊ฑด๋“œ๋ฆฌ์ง€ ์•Š์•˜๋‹ค โ€” #53 ์˜ ๋ถ€ํŠธ์ŠคํŠธ๋žฉ ์ž‘์—…์ด ์•ž๋‹น๊ฒจ์ง€์ง€ ์•Š๋Š”๋‹ค.
    • ์ƒˆ pub ์˜์กด์€ ffi ํ•˜๋‚˜(Dart ํŒ€ ๊ณต์‹, dart:ffi ์œ„์˜ ์–‡์€ ์œ ํ‹ธ โ€” ํ”Œ๋žซํผ ๋ฐ”์ธ๋”ฉ ์—†์Œ).
    • macOS ๋Š” ๊ฐ’์„ base64 ๋กœ ๊ฐ์‹ธ ๋„ฃ๋Š”๋‹ค. ์‹ค์ธก: security find-generic-password -w ๋Š” ์ €์žฅ ๋ฐ”์ดํŠธ๊ฐ€ ์ธ์‡„ ๊ฐ€๋Šฅํ•œ ASCII ๋ฉด ๊ทธ๋Œ€๋กœ, ์•„๋‹ˆ๋ฉด ์ ‘๋‘์‚ฌ ์—†๋Š” 16์ง„์œผ๋กœ ์ฐ๋Š”๋ฐ ๋‘˜์„ ๊ฐ€๋ฅด๋Š” ํ‘œ์ง€๊ฐ€ ์—†๋‹ค. ใ€Œ์ง์ˆ˜ ๊ธธ์ด + ์ „๋ถ€ 16์ง„ ๋ฌธ์žใ€๋กœ ์ถ”์ธกํ•˜๋ฉด deadbeef ๊ฐ™์€ ์ •์ƒ ํ‚ค๋ฅผ ์˜ค๋…ํ•œ๋‹ค โ€” ์ถ”์ธก์„ ์—†์• ๋ ค๊ณ  ํ•ญ์ƒ ASCII ๊ฐ€ ๋˜๊ฒŒ ๋งŒ๋“ ๋‹ค.
    • ์ž๊ฒฉ์ฆ๋ช… CLI ๋Š” ์ง‘ํ–‰ ํ”„๋กœํŒŒ์ผ(agent)๋กœ ๋„์šฐ์ง€ ์•Š๋Š”๋‹ค. AC-14 ์˜ Given ์€ ใ€Œ์—์ด์ „ํŠธ๊ฐ€ ์ž‘์—…์„ ์ˆ˜ํ–‰ํ•  ๋•Œใ€์ด๊ณ  ์ด๊ฒƒ์€ ํ˜ธ์ŠคํŠธ ์ž์‹ ์˜ ์„ค์ • ๋™์ž‘์ด๋ฉฐ, ๋ฌด์—‡๋ณด๋‹ค agent ์˜ ๊ฒฝ๋กœ ์ง‘ํ–‰์ด ์“ฐ๊ธฐ๋ฅผ ์›Œํฌ์ŠคํŽ˜์ด์Šค ์•ˆ์œผ๋กœ ๊ฐ€๋‘๋Š”๋ฐ OS ์ž๊ฒฉ์ฆ๋ช… ์ €์žฅ์†Œ๋Š” ์›Œํฌ์ŠคํŽ˜์ด์Šค ๋ฐ–์— ์žˆ์–ด์•ผ ํ•œ๋‹ค(DD-23 ์˜ ์š”๊ตฌ ์ž์ฒด). DD-23a ํ™˜๊ฒฝ๋ณ€์ˆ˜ ํ™”์ดํŠธ๋ฆฌ์ŠคํŠธ๋Š” ํ”„๋กœํŒŒ์ผ๊ณผ ๋ฌด๊ด€ํ•˜๊ฒŒ ์ ์šฉ๋˜๋ฏ€๋กœ ์œ ์ถœ ์ถ•์€ ์˜ํ–ฅ๋ฐ›์ง€ ์•Š๋Š”๋‹ค. โš ๏ธ enum ์— ใ€Œํ˜ธ์ŠคํŠธ ๋™์ž‘ใ€ ํ–‰์ด ์—†์–ด ์ง‘ํ–‰์„ ๋„๋Š” ๊ฐ’์ด humanTerminal ํ•˜๋‚˜๋ฟ์ด๋‹ค โ€” ์ด๋ฆ„์ด ์–ด๊ธ‹๋‚˜์ง€๋งŒ SandboxProfileRegistry(Epic #33)์˜ ๋น ์ง์—†๋Š” switch ๋ฅผ ํ•จ๊ป˜ ๋ฐ”๊ฟ”์•ผ ํ•ด ๊ฐ’์„ ๋Š˜๋ฆฌ์ง€ ์•Š๊ณ  ํ›„์† ๊ด€์ฐฐ๋กœ ๋‚จ๊ธด๋‹ค.
    • LaunchedProcess ์— stdin ์ด ์ถ”๊ฐ€๋๋‹ค โ€” ๋น„๋ฐ€์„ ํ‘œ์ค€ ์ž…๋ ฅ์œผ๋กœ ๋„˜๊ธฐ๋ ค๋ฉด ํ•„์š”ํ•˜๊ณ , #47 ์˜ ACP JSON-RPC over stdio ๋„ ๊ฐ™์€ ํ†ต๋กœ๋ฅผ ์“ด๋‹ค. #34 ์˜ ์ดˆํŒ์—๋Š” ์—†์—ˆ๋‹ค.
    • CREDENTIALW ๋ ˆ์ด์•„์›ƒ์€ ์–ด๋А OS ์—์„œ๋“  ๊ฒ€์ฆ๋œ๋‹ค(sizeOf = 80 + ํ•„๋“œ 13๊ฐœ ์˜คํ”„์…‹์„ ์›์‹œ ๋ฐ”์ดํŠธ ์„ผํ‹ฐ๋„ ์Šค์บ”์œผ๋กœ). ์ด ๊ฒ€์‚ฌ๊ฐ€ ์‹ค์ œ๋กœ ๊ฒฐํ•จ์„ ์žก์•˜๋‹ค โ€” ์ดˆํŒ์ด PersistยทAttributeCount ์‚ฌ์ด์— ํŒจ๋”ฉ์ด ์žˆ๋‹ค๊ณ  ๊ฐ€์ •ํ•ด 88 ์„ ๊ธฐ๋Œ€ํ–ˆ๊ณ , ๋‘˜์€ ์—ฐ์†๋œ DWORD ๋ผ ๋ถ™๋Š”๋‹ค.
  • Source: #46 AC1 (ํŒ์ • ์ฃผ์ฒด Design โ€” architecture ยง9 ๋ฏธ๊ฒฐ 7 '๋ˆ„๊ฐ€' ์—ด). macOSยทWindows CLI ๋™์ž‘์€ ์ด ์›ŒํฌํŠธ๋ฆฌ ์‹ค์ธก(2026-09-13, macOS 25.5), pub ํ›„๋ณด ํ‰๊ฐ€๋Š” ๊ฐ™์€ ๋‚  pub.dev ์กฐํšŒ.

D-065: AC-15 ์ธก์ • ๊ทœ์น™ โ€” ํ™˜๊ฒฝยท์‹œ๋‚˜๋ฆฌ์˜คยทํ‘œ๋ณธ ์ฐฝ์€ ํ™•์ •, ๋ชฉํ‘œ์น˜ยท๋ฐฑ๋ถ„์œ„๋Š” ์‹ค์ธก ๋’ค. ๋‹จ์ผ 10๋งŒ ์ค„ ํ”ฝ์Šค์ฒ˜๋Š” ํ•ฉ์„ฑํ•œ๋‹ค (#91)

  • Date: 2026-09-14
  • Context: planning-inputs ยง3.3 ์ด Planning ํ™•์ • ๋Œ€์ƒ์œผ๋กœ ์—ด๊ฑฐํ•œ ๋‹ค์„ฏ(ํ”„๋ ˆ์ž„ ํƒ€์ž„ ๋ชฉํ‘œ์น˜ยท๋ฐฑ๋ถ„์œ„ยท์ธก์ • ํ™˜๊ฒฝยท์‹œ๋‚˜๋ฆฌ์˜คยทํ‘œ๋ณธ ์ฐฝ)์ด ์ „๋ถ€ ๋ฏธ์ •์ด์—ˆ๊ณ , AC-15 ์˜ ํ”ฝ์Šค์ฒ˜์ธ ใ€Œ10๋งŒ ์ค„ ๊ทœ๋ชจ์˜ Dart ํŒŒ์ผใ€์„ ์–ด๋””์„œ ์–ป๋Š”์ง€๋„ ์ •ํ•ด์ ธ ์žˆ์ง€ ์•Š์•˜๋‹ค. PRD NFR-A ๊ฐ€ "docs/ 8๊ฐœ ๋ฌธ์„œ ์ „์ฒด grep ๊ฒฐ๊ณผ unibook ๊ณผ ยซ10๋งŒ ์ค„ยป์ด ํ•จ๊ป˜ ์–ธ๊ธ‰๋œ ๊ณณ์€ 0๊ฑด" ์ด๋ผ๊ณ  ๊ทธ ๊ณต๋ฐฑ ์ž์ฒด๋ฅผ ๊ธฐ๋กํ•ด ๋‘” ์ƒํƒœ์˜€๋‹ค.
  • Options:
    1. ๋‹ค์„ฏ์„ ํ•œ๊บผ๋ฒˆ์— ์ง€๊ธˆ ํ™•์ •ํ•œ๋‹ค
    2. ๋‹ค์„ฏ์„ ์ „๋ถ€ ์‹ค์ธก ๋’ค๋กœ ๋ฏธ๋ฃฌ๋‹ค
    3. ์ •์˜(๋ฌด์—‡์„ ์žฌ๋Š”๊ฐ€)๋Š” ์ง€๊ธˆ, ๊ฐ’(์–ด๋””์„œ ๋Š๋Š”๊ฐ€)์€ ์‹ค์ธก ๋’ค๋กœ ๋‚˜๋ˆˆ๋‹ค
  • Decision: ์˜ต์…˜ 3. ์ธก์ • ํ™˜๊ฒฝยท์‹œ๋‚˜๋ฆฌ์˜คยทํ‘œ๋ณธ ์ฐฝ์„ docs/ac15-measurement-rules-cocode.md ยง4.2~ยง4.4 ๋กœ ํ™•์ •ํ•˜๊ณ , ํ”„๋ ˆ์ž„ ํƒ€์ž„ ๋ชฉํ‘œ์น˜์™€ ๋ฐฑ๋ถ„์œ„๋Š” ใ€Œ๋ฏธ์ • โ€” ๊ฒฐ์ • ํ•„์š”(ํŒ์ • ์ฃผ์ฒด: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ / ์‹œ์ : #92 ์‹ค์ธก ๋ถ„ํฌ ์ดํ›„)ใ€ ๋กœ ๋‚จ๊ธด๋‹ค. ๋‹จ์ผ ๋Œ€์šฉ๋Ÿ‰ ํŒŒ์ผ ํ”ฝ์Šค์ฒ˜๋Š” ๊ฒฐ์ •๋ก ์  ์ƒ์„ฑ๊ธฐ๋กœ ํ•ฉ์„ฑํ•œ๋‹ค(์ƒ์„ฑ๊ธฐ๋ฅผ ์ปค๋ฐ‹, ์‚ฐ์ถœ๋ฌผ์€ ์ปค๋ฐ‹ํ•˜์ง€ ์•Š๊ณ  SHA-256 ์œผ๋กœ ๊ณ ์ •). CH-032 ใ€Œ๋‹ค์ˆ˜ ์ƒ์„ฑ ํŒŒ์ผ ๋™์‹œ ์˜คํ”ˆใ€ ์‹œ๋‚˜๋ฆฌ์˜ค๋Š” ์ธก์ • ๊ทœ์น™ ์ธต์œ„์—์„œ ๋ณต์›ํ•œ๋‹ค.
  • Rationale:
    • โ‘ ์€ ์ด ํ”„๋กœ์ ํŠธ๊ฐ€ v1.1.0~v2.1.0 ์— ๋„ค ๋ฒˆ ๋ฐ˜๋ณตํ•œ ์‹คํŒจ๋‹ค(D-013ยทD-015ยทPRD ใ€Œ์žฌ๋„์ž… ๊ธˆ์ง€ ๊ฐ’ใ€). โ‘ก๋Š” D-020 ์„ ๊ณผ์ž‰ ์ ์šฉํ•œ๋‹ค โ€” ๊ทธ ๊ฒฐ์ •์ด ๋ง‰์€ ๊ฒƒ์€ "์‹ค์ธก ๋ถ„ํฌ๋ฅผ ๋ณด๊ธฐ ์ „์— ์ˆซ์ž๋ฅผ ์ •ํ•˜๋Š” ๊ฒƒ" ์ด์ง€ ใ€Œ๋ฌด์—‡์„ ์žฌ๋Š”๊ฐ€ใ€์˜ ์ •์˜๊ฐ€ ์•„๋‹ˆ๋‹ค. ์ •์˜๊ฐ€ ์—†์œผ๋ฉด ๋ถ„ํฌ ์ž์ฒด๊ฐ€ ์˜๋ฏธ๋ฅผ ๊ฐ–์ง€ ๋ชปํ•œ๋‹ค.
    • ํ”ฝ์Šค์ฒ˜ ํ•ฉ์„ฑ์€ ์‹ค์ธก์ด ๊ฐ•์ œํ•œ ๊ฒฐ๋ก ์ด๋‹ค. ์ฐธ์กฐ ์›Œํฌ์ŠคํŽ˜์ด์Šค coco-de/unibook @ 9db9015(D-019)๋ฅผ ์‹ค์ฒดํฌ์•„์›ƒํ•ด ์žฌ๋ณด๋‹ˆ 10๋งŒ ์ค„ ์ด์ƒ์ธ ๋‹จ์ผ .dart ํŒŒ์ผ์ด 0๊ฐœ์ด๊ณ  ์ตœ๋Œ€๊ฐ€ 27,759 ์ค„(๋ชฉํ‘œ์˜ 27.8%)์ด๋‹ค. ์ƒ์œ„ 4๊ฐœ๋ฅผ ์ด์–ด๋ถ™์ด๋ฉด 95,323 ์ค„๋กœ ์‚ฐ์ˆ ์€ ๋งž์ง€๋งŒ ์ค‘๋ณต importยท์ค‘๋ณต ์„ ์–ธ์œผ๋กœ ํŒŒ์‹ฑ์ด ๊นจ์ ธ A-03 ์ด ์žฌ๋ ค๋Š” ๊ฒฝ๋กœ(ํŒŒ์„œยทํ•˜์ด๋ผ์ดํ„ฐยทLSP)๋ฅผ ํƒ€์ง€ ์•Š๋Š”๋‹ค.
    • ์‚ฐ์ถœ๋ฌผ์„ ์ปค๋ฐ‹ํ•˜์ง€ ์•Š๋Š” ์ด์œ ๋Š” check_large_files.py ์˜ ์ฒซ ๋ฌธ๋‹จ ๊ทธ๋Œ€๋กœ๋‹ค โ€” 2.62 MiB ๋Š” 50 MiB ์ƒํ•œ์— ์•ˆ ๊ฑธ๋ฆฌ์ง€๋งŒ ํ•œ ๋ฒˆ ๋“ค์–ด์˜จ blob ์€ ์ง€์›Œ๋„ ํžˆ์Šคํ† ๋ฆฌ์— ๋‚จ๋Š”๋‹ค. ์ƒ์„ฑ๊ธฐ + ๊ณ ์ • ํŒŒ๋ผ๋ฏธํ„ฐ + SHA-256 ์ด๋ฉด ์žฌํ˜„์— ํ•„์š”ํ•œ ๊ฒƒ์ด ์ „๋ถ€๋‹ค.
    • CH-032 ๋ณต์›์€ ์ƒˆ ์š”๊ตฌ๊ฐ€ ์•„๋‹ˆ๋ผ ์›์ƒํšŒ๋ณต์ด๋‹ค. v1.1.0 ์ด ๊ทธ ๋ฐ˜๋ก ์˜ ํ•ด์†Œ์ฑ…์œผ๋กœ "๋‹จ์ผ ๋Œ€์šฉ๋Ÿ‰ ํŒŒ์ผ + ๋‹ค์ˆ˜ ์ƒ์„ฑ ํŒŒ์ผ ๋™์‹œ ์˜คํ”ˆ ๋‘ ์‹œ๋‚˜๋ฆฌ์˜ค ๋ชจ๋‘" ๋ฅผ ์ฑ„ํƒํ–ˆ๊ณ , v2.0.0/v3.0.0 ์žฌ์ž‘์„ฑ์—์„œ ์œ ์‹ค๋๋‹ค(PRD NFR-A ๊ฐ€ ๊ทธ ์œ ์‹ค์„ ๊ธฐ๋ก). ๋‹ค๋งŒ ๋ณต์› ๋ฒ”์œ„๋Š” ์ธก์ • ๊ทœ์น™ ์ธต์œ„๊นŒ์ง€๋‹ค โ€” Seed Spec ยง4 ๋ณธ๋ฌธ ๋ณต์›์€ ๋ถˆ๋ณ€ ์ธต์œ„ ๊ฐœ์ •์ด๋ผ ์˜ค๋„ˆ ์†Œ๊ด€์œผ๋กœ ๋‚จ๊ธด๋‹ค.
  • Impact:
    • ์‹ ๊ทœ ์‚ฐ์ถœ๋ฌผ 3์ข…: docs/ac15-measurement-rules-cocode.md ยท scripts/spike/measure_dart_fixture_inventory.py ยท scripts/spike/generate_large_dart_fixture.py. ์›๋ณธ ๋ฐ์ดํ„ฐ scripts/spike/dart_inventory_unibook_9db9015.json.
    • planning-inputs ยง3.2 ์˜ ใ€Œ์ค„ ์ˆ˜ ์žฌ๊ฒ€์ฆใ€ ํ•ญ๋ชฉ์ด ๋‹ซํ˜”๋‹ค โ€” ์‹ค์ธก ๊ฒฐ๊ณผ .dart ์ด 1,578,533 ์ค„ / 9,713 ํŒŒ์ผ / 55,655,722 B, ๋ฐ”์ดํŠธ/์ค„ 35.26. ๊ธฐ์กด ~38 ์ถ”์ •์€ ์ด ์ค„ ์ˆ˜๋ฅผ 7.2% ์ ๊ฒŒ ๋ณธ๋‹ค. ํŒŒ์ผ ์ˆ˜ ์ฐจ์ด(9,931 โ†’ 9,713)๋Š” ์˜ค๋ฅ˜๊ฐ€ ์•„๋‹ˆ๋ผ ๊ธฐ์ค€ ์ปค๋ฐ‹ ์ฐจ์ด์ด๊ณ , ๊ณ ์ • SHA ๊ฐ€ ์žˆ๋Š” ์ด ํ‘œ๋ฅผ ์•ž์œผ๋กœ ์ธ์šฉํ•œ๋‹ค.
    • A-03 ์ธก์ •์˜ ์ฑ„๋„ ํ•œ๊ณ„๊ฐ€ ๋ช…์‹œ๋๋‹ค. D-025 ๊ฐ€ D-022(master ์ฑ„๋„)๋ฅผ ๋’ค์ง‘์–ด ์ธก์ •์€ stable 3.47.3 ์—์„œ ์ด๋ค„์ง„๋‹ค. sandbox-limits ์™€ ๋‹ฌ๋ฆฌ ํ”„๋ ˆ์ž„ ํƒ€์ž„์€ Flutter ์—”์ง„์˜ ์„ฑ์งˆ์ด๋ฏ€๋กœ ใ€Œ์ฑ„๋„ ๋ฌด๊ด€ใ€์ด ์•„๋‹ˆ๋ผ ๋ช…์‹œ๋œ ํ•œ๊ณ„๋‹ค โ€” master ๊ฐ€ flutter#128575 ๋ฅผ ๊ณ ์ณค๋Š”์ง€๋Š” ์ด ์ธก์ •์ด ๋‹ตํ•˜์ง€ ์•Š์œผ๋ฉฐ, #92 ๋Š” ๊ทธ๊ฒƒ์„ โž– unavailable ๋กœ ์ ๊ณ  ๊ฒฐ๊ณผ๊ฐ€ โŒ ์—ฌ๋„ ์žฌ์ธก์ • ์—†์ด ใ€Œ์—”์ง„ ํƒ“ใ€์ด๋ผ ์ ์ง€ ์•Š๋Š”๋‹ค.
    • ํ•ฉ์„ฑ ํ”ฝ์Šค์ฒ˜์˜ ํ•œ๊ณ„ ์…‹(์‹ฌ๋ณผ ๋‹ค์–‘์„ฑยทimport ๊ทธ๋ž˜ํ”„ ๋ถ€์žฌยท.freezed.dart ํ˜•ํƒœ ๋ถ€์žฌ)์€ ์ „๋ถ€ ๊ณผ์†Œ ์ถ”์ • ๋ฐฉํ–ฅ์ด๋‹ค โ€” ๋‚˜์œ ์ˆ˜๊ฐ€ ๋‚˜์˜ค๋ฉด ์‹ค๋ฌผ์€ ๋” ๋‚˜์˜๊ณ , ์ข‹์€ ์ˆ˜๋Š” ์‹ค๋ฌผ์˜ ๋ณด์ฆ์ด ๋˜์ง€ ์•Š๋Š”๋‹ค. #92 ๊ฒฐ๋ก ์— ์ด ๋น„๋Œ€์นญ์„ ๋ช…์‹œํ•œ๋‹ค.
    • โธ๏ธ ๋ฏธ์ •์œผ๋กœ ๋‚จ๊ธด ๊ฒƒ 2๊ฑด: โ“ ํ”„๋ ˆ์ž„ ํƒ€์ž„ ๋ชฉํ‘œ์น˜ยท๋ฐฑ๋ถ„์œ„(#92 ๋ถ„ํฌ ๋’ค, ์˜ค๋„ˆ) โ“‘ Seed Spec ยง4 AC-15 ๋ณธ๋ฌธ์— CH-032 ์‹œ๋‚˜๋ฆฌ์˜ค๋ฅผ ๋˜์‚ด๋ฆด์ง€(์˜ค๋„ˆ). โ“‘ ๊ฐ€ ๋‹ซํžˆ์ง€ ์•Š์œผ๋ฉด AC-15 ์˜ ๊ธฐ๊ณ„์  ํŒ์ •์€ S1 ๋งŒ์œผ๋กœ ์ด๋ค„์ง€๊ณ  S2 ๋Š” ๊ทผ๊ฑฐ ์ž๋ฃŒ๋กœ๋งŒ ๋‚จ๋Š”๋‹ค.
  • Source: #91 ์ธ์ˆ˜ ์กฐ๊ฑด 5์ข…. ์‹ค์ธก์€ ์ด ์›ŒํฌํŠธ๋ฆฌ(2026-09-14, macOS 25.5, Dart 3.13.3 / Flutter 3.47.3) โ€” unibook blobless clone โ†’ 9db9015 ์ฒดํฌ์•„์›ƒ โ†’ measure_dart_fixture_inventory.py.

D-066: A-03 โ€” ์ž์ฒด ๋ Œ๋”๋ง ํ…์ŠคํŠธ ๋ ˆ์ด์–ด๋กœ ๋ถ„๊ธฐํ•˜์ง€ ์•Š๋Š”๋‹ค(์œ ๋ณด). ํ”„๋ ˆ์ž„ CPU ์ž‘์—…์ด ๋ฌธ์„œ ํฌ๊ธฐ์— ํ‰ํ‰ํ•จ์„ ์‹ค์ธก (#92)

  • Date: 2026-09-14
  • Context: A-03("re_editor ๊ธฐ๋ฐ˜ ์—๋””ํ„ฐ ์ฝ”์–ด๊ฐ€ AC-15 ์˜ ์‹œ๋‚˜๋ฆฌ์˜ค๋ฅผ ์‹ค์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์„ฑ๋Šฅ์œผ๋กœ ์ง€์›ํ•œ๋‹ค")์€ Unverified ์ด๋ฉด์„œ MVP ๊ฒŒ์ดํŒ… ๋ฆฌ์Šคํฌ์˜€๊ณ , Seed Spec ยง5 ๊ฐ€ ์‹คํŒจ ์‹œ ๋ถ„๊ธฐ๋ฅผ "์ž์ฒด ๋ Œ๋”๋ง ํ…์ŠคํŠธ ๋ ˆ์ด์–ด ๊ฒ€ํ† " ๋กœ ๋ฏธ๋ฆฌ ์ง€์ •ํ•ด ๋‘์—ˆ๋‹ค. ์›์ธ์ด flutter#128575(์—”์ง„ ์ด์Šˆ)๋ฉด ์ž์ฒด ๋…ธ๋ ฅ์œผ๋กœ ํ•ด๊ฒฐ ๋ถˆ๊ฐ€์ผ ์ˆ˜ ์žˆ๋‹ค๋Š” ๊ฒƒ์ด ๊ทธ ์กฐํ•ญ์˜ ๋ฐฐ๊ฒฝ์ด๋‹ค.
  • Options:
    1. ์ ˆ๋Œ€ ํ”„๋ ˆ์ž„ ํƒ€์ž„์„ ๋ชป ์žฌ๋ฏ€๋กœ ํŒ์ •์„ ๋ฏธ๋ฃฌ๋‹ค(๋ฐ์Šคํฌํ†ฑ ๋Ÿฌ๋„ˆ๊ฐ€ ์ƒ๊ธธ ๋•Œ๊นŒ์ง€)
    2. flutter test ๋กœ ์žฐ ์ˆ˜๋ฅผ ํ”„๋ ˆ์ž„ ํƒ€์ž„์ด๋ผ ๋ถ€๋ฅด๊ณ  ํ†ต๊ณผ๋กœ ์ ๋Š”๋‹ค
    3. ๊ธฐ์šธ๊ธฐ๋ฅผ ์žฌ๊ณ (๋ฌธ์„œ ํฌ๊ธฐ ๋Œ€๋น„ ํ”„๋ ˆ์ž„ CPU ์ž‘์—…) ๊ทธ๊ฒƒ์œผ๋กœ ๋ถ„๊ธฐ ์กฐ๊ฑด๋งŒ ํŒ์ •ํ•œ๋‹ค โ€” ์ ˆ๋Œ€ ์ง€์—ฐ์€ โž– unavailable ๋กœ ๋‚จ๊ธด๋‹ค
  • Decision: ์˜ต์…˜ 3. ์ž์ฒด ๋ Œ๋”๋ง ํ…์ŠคํŠธ ๋ ˆ์ด์–ด๋กœ ๋ถ„๊ธฐํ•˜์ง€ ์•Š๋Š”๋‹ค. ๋‹จ ์ด๊ฒƒ์€ A-03 ์˜ ํ•ด์ œ๊ฐ€ ์•„๋‹ˆ๋ผ ์œ ๋ณด์ด๋ฉฐ, ์žฌ๊ฒ€ํ†  ์กฐ๊ฑด 3์ข…์„ ๋ช…์‹œํ•œ๋‹ค(docs/ac15-responsiveness-cocode.md ยง5).
  • Rationale:
    • โ‘ก๋Š” ์ด ๋ฌธ์„œ ์ „์ฒด๊ฐ€ ๊ฒฝ๊ณ„ํ•ด ์˜จ ์‹ค์ˆ˜๋‹ค โ€” docs/sandbox-limits-cocode.md ยง1.2 ๊ฐ€ "์žฌ์ง€ ๋ชปํ•œ ๊ฒƒ๊ณผ ์žฌ์„œ ํ†ต๊ณผํ•œ ๊ฒƒ์„ ์„ž์œผ๋ฉด ๊ทธ ํ‘œ๋Š” ๊ทผ๊ฑฐ๊ฐ€ ์•„๋‹ˆ๋ผ ์ธ์ƒ์ด ๋œ๋‹ค" ๋กœ ๊ฐ™์€ ์ž๋ฆฌ๋ฅผ ๋ชป๋ฐ•์•˜๋‹ค.
    • โ‘ ์€ ๊ณผ์ž‰์ด๋‹ค. ๋ถ„๊ธฐ ์กฐ๊ฑด ์ž์ฒด๊ฐ€ ๊ธฐ์šธ๊ธฐ์˜ ์ง„์ˆ ์ด๊ธฐ ๋•Œ๋ฌธ์ด๋‹ค โ€” A-03 ์ด ๋‘๋ ค์›Œํ•œ ๊ฒƒ์€ "ํ”„๋ ˆ์ž„๋งˆ๋‹ค ๋ฌธ์„œ ์ „์ฒด๋ฅผ ํ›‘๋Š” ๊ฒฝ๋กœ"์ด๊ณ , ๊ทธ ์กด์žฌ ์—ฌ๋ถ€๋Š” ์ ˆ๋Œ€ ์ง€์—ฐ ์—†์ด๋„ ํŒ์ •๋œ๋‹ค.
    • ์‹ค์ธก(macOS ยท 3ํšŒ ร— ์กฐ์ž‘๋‹น 30ํšŒ์ฐจ): ๋ฌธ์„œ๋ฅผ 1,000 โ†’ 100,000์ค„๋กœ 100๋ฐฐ ๋Š˜๋ ค๋„ ์Šคํฌ๋กค 2.98 โ†’ 2.32 ms, ์ปค์„œ(34์ค„) 4.29 โ†’ 4.56 ms, ์„ ํƒ(34์ค„) 4.38 โ†’ 4.93 ms ๋กœ ์ „๋ถ€ ๊ฐ™์€ ์ž๋ฆฌ์— ๋จธ๋ฌธ๋‹ค. re_editor ์˜ CodeLines ๊ฐ€ ์ค„ ๋ชฉ๋ก์ด ์•„๋‹ˆ๋ผ ์„ธ๊ทธ๋จผํŠธ ๊ตฌ์กฐ๋ผ ๋น„์šฉ์ด ์ค„ ์ˆ˜์— ๊ฑธ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค.
    • JIT ๋ผ์„œ ๋น„๊ด€์ ์ธ ๊ฒƒ์€ ์ ˆ๋Œ€๊ฐ’์ด๊ณ  ๊ธฐ์šธ๊ธฐ๊ฐ€ ์•„๋‹ˆ๋‹ค โ€” JIT/AOT ๋Š” ์ƒ์ˆ˜๋ฐฐ์ด์ง€ ๋ณต์žก๋„๋ฅผ ๋ฐ”๊พธ์ง€ ์•Š๋Š”๋‹ค. ๊ทธ๋ž˜์„œ ์ด ํšŒ์ฐจ๋กœ ๊ธฐ์šธ๊ธฐ๋ฅผ ํŒ์ •ํ•˜๋Š” ๊ฒƒ์€ ์„ฑ๋ฆฝํ•˜๊ณ , ์ ˆ๋Œ€๊ฐ’์„ ํŒ์ •ํ•˜๋Š” ๊ฒƒ์€ ์„ฑ๋ฆฝํ•˜์ง€ ์•Š๋Š”๋‹ค.
    • ์ž์ฒด ๋ Œ๋”๋ง์€ ์กฐํ•ฉ ์ž…๋ ฅ(AC-16)ยท์ ‘๊ทผ์„ฑยท์„ ํƒ/์Šคํฌ๋กค์„ ์ „๋ถ€ ๋‹ค์‹œ ๋งŒ๋“œ๋Š” ์ผ์ด๋ผ, ๊ทผ๊ฑฐ ์—†์ด ์ฐฉ์ˆ˜ํ•˜๋ฉด MVP ๋ฅผ ํ†ต์งธ๋กœ ๋ฐ€์–ด๋‚ธ๋‹ค. ์ฐฉ์ˆ˜ํ•˜์ง€ ์•Š์„ ๊ทผ๊ฑฐ๊ฐ€ ์‹ค์ธก์œผ๋กœ ์ƒ๊ฒผ๋‹ค.
  • Impact:
    • ์‹ ๊ทœ ์‚ฐ์ถœ๋ฌผ: docs/ac15-responsiveness-cocode.md ยท package/editor/benchmark/ac15_responsiveness_bench.dart ยท ์›๋ณธ ๋ฐ์ดํ„ฐ scripts/spike/ac15_bench_macos_run{1,2,3}.json.
    • AC-15 ๋Š” PENDING ๊ทธ๋Œ€๋กœ๋‹ค. D-065 ยง4.5 ๋Œ€๋กœ ๋ชฉํ‘œ์น˜ยท๋ฐฑ๋ถ„์œ„๊ฐ€ ๋ฏธ์ •์ด๋ผ ์ด ํšŒ์ฐจ๊ฐ€ MET ์„ ๋งŒ๋“ค ์ˆ˜ ์—†๋‹ค โ€” ์ด ๋ฌธ์„œ๋Š” ์˜ค๋„ˆ ๊ฒฐ์ •์˜ ์ž…๋ ฅ์ด๋‹ค.
    • ํฌ๊ธฐ์— ๋Œ๋ ค๊ฐ€๋Š” ๋น„์šฉ์ด ํ•˜๋‚˜ ์žˆ๋‹ค โ€” ์ตœ์ดˆ ์ ์žฌ. 10๋งŒ ์ค„ 122 ms(โ‰ˆ1.22 ยตs/์ค„, ์„ ํ˜•). ํ”„๋ ˆ์ž„ ๋น„์šฉ์ด ์•„๋‹ˆ๋ผ ํŒŒ์ผ์„ ์—ฌ๋Š” ์ˆœ๊ฐ„ 1ํšŒ์ด๊ณ , ์ฒซ ํ”„๋ ˆ์ž„ ์ž์ฒด๋Š” ํฌ๊ธฐ ๋ฌด๊ด€(17~29 ms)์ด๋‹ค.
    • โญ CH-032 ๋ณต์›(D-065 ยง5)์ด ์‹ค์ œ๋กœ ๊ฐ’์„ ๋ƒˆ๋‹ค. ์ „ ์ธก์ •์—์„œ ๊ผฌ๋ฆฌ๊ฐ€ ๋‘๊บผ์šด ๊ฐ’์€ S2 ํƒญ ์ „ํ™˜ ํ•˜๋‚˜๋‹ค(์ค‘์•™๊ฐ’ 7.5 ms / ์ตœ๋Œ€ 32 ms, ์ค‘์•™๊ฐ’์˜ 4๋ฐฐ). ๋‹จ์ผ ๋Œ€์šฉ๋Ÿ‰ ํŒŒ์ผ๋งŒ ๋ดค์œผ๋ฉด ์ด ์ˆ˜๋Š” ๋ณด๊ณ ์„œ์— ์—†์—ˆ๋‹ค โ€” v3.0.0 ์žฌ์ž‘์„ฑ์˜ ์‹œ๋‚˜๋ฆฌ์˜ค ์œ ์‹ค์ด ๊ด€์ธก ์†์‹ค์ด์—ˆ์Œ์ด ์ˆ˜๋กœ ํ™•์ธ๋๋‹ค. ๋ฐ˜๋ฉด ใ€Œ๋ฒ„ํผ๊ฐ€ ๋งŽ์œผ๋ฉด ๋А๋ ค์ง„๋‹คใ€๋Š” ๊ด€์ธก๋˜์ง€ ์•Š์•˜๋‹ค(๋ฒ„ํผ 20๊ฐœ๋ฅผ ์‚ด๋ ค ๋‘” ์ƒํƒœ์˜ ์Šคํฌ๋กค์ด ๋‹จ์ผ ํŒŒ์ผ๊ณผ ๊ฐ™๋‹ค) โ€” ๋น„์šฉ์€ ๋ฒ„ํผ ์ˆ˜๊ฐ€ ์•„๋‹ˆ๋ผ ์ „ํ™˜ ๊ทธ ์ž์ฒด์— ์žˆ๋‹ค.
    • ๐Ÿ”ด ์ƒ๋ฅ˜ ๊ฒฐํ•จ ๋ฐœ๊ฒฌ: re_editor 0.10.0 ์˜ moveCursorToPageDown()ยทmoveCursorToPageUp() ์ด ๋ณธ๋ฌธ ์—†์ด // TODO ๋‹ค(_code_line.dart:492). PageUp/PageDown ์ด ๋™์ž‘ํ•˜์ง€ ์•Š๋Š”๋‹ค. AC-15 ์˜ ์„ธ ์กฐ์ž‘์— ์—†์–ด ์ด ํŒ์ •์€ ๋ฐ”๋€Œ์ง€ ์•Š์ง€๋งŒ ๊ธฐ๋Šฅ ๊ฒฐํ•จ์ด๋ฏ€๋กœ ํ›„์† ์ด์Šˆ๋กœ ๋ถ„๋ฆฌํ•œ๋‹ค(์ƒ๋ฅ˜ ์ˆ˜์ • vs CocodeEditorView ์ธต ๋Œ€์ฒด ๊ตฌํ˜„์€ ๋ณ„๊ฐœ ์„ค๊ณ„ ๊ฒฐ์ •).
    • ์ธก์ • ํ•จ์ • 3์ข…์„ ๊ธฐ๋กํ–ˆ๋‹ค(๊ฐ™์€ ๋ฌธ์„œ ยง4): โ“ ์ฝ”๋“œ ํ‘œ๋ฉด ์œ„ ํฌ์ธํ„ฐ ๋“œ๋ž˜๊ทธ๋Š” ์Šคํฌ๋กค์ด ์•„๋‹ˆ๋ผ ํ…์ŠคํŠธ ์„ ํƒ์ด๋‹ค(์ดˆํŒ์—์„œ ์˜คํ”„์…‹ 0.0โ†’0.0) โ“‘ edit(TextEditingValue) ๋Š” ํ˜„์žฌ ์ค„ ์ „์ฒด๋ฅผ ๊ต์ฒดํ•œ๋‹ค โ“’ ์›Œ๋ฐ์—…์„ ๋ฒ„๋ฆฌ์ง€ ์•Š์œผ๋ฉด ์ฒซ ํฌ๊ธฐ๊ฐ€ JIT ๋ฅผ ํ˜ผ์ž ๋ฌผ์–ด ๊ฑฐ์ง“ ๊ธฐ์šธ๊ธฐ๊ฐ€ ๋‚˜์˜จ๋‹ค(์ฒซ ํ”„๋ ˆ์ž„ 376 ms vs ์ดํ›„ 17~29 ms). ์…‹ ๋‹ค ์ดˆํŒ์ด ์‹ค์ œ๋กœ ๋ฐŸ์•˜๊ณ , ์ฆ๊ฑฐ ํ•„๋“œ(scroll_movedยทcursor_index_afterยทselected_lines)๊ฐ€ ์—†์—ˆ์œผ๋ฉด no-op ์˜ ์‹œ๊ฐ„์„ ์„ฑ๋Šฅ์œผ๋กœ ๋ณด๊ณ ํ–ˆ์„ ๊ฒƒ์ด๋‹ค.
    • โž– ๋ชป ์žฐ ์ถ•(ํ†ต๊ณผ๊ฐ€ ์•„๋‹ˆ๋‹ค): GPU ๋ž˜์Šคํ„ฐํ™” ยท ํ•ฉ์„ฑ ์ด ์ง€์—ฐ ยท profile ๋ชจ๋“œ AOT ยท WindowsยทLinux ยท master ์ฑ„๋„(flutter#128575 ์ˆ˜์ • ์—ฌ๋ถ€).
  • Source: #92 ์ธ์ˆ˜ ์กฐ๊ฑด 5์ข…. ์‹ค์ธก์€ ์ด ์›ŒํฌํŠธ๋ฆฌ(2026-09-13T21:49Z, macOS 26.5.2 arm64 24-core, Dart 3.13.3 / Flutter 3.47.3). AC-3 ์˜ ใ€Œmaster ์ฑ„๋„ใ€์€ D-025 ๊ฐ€ D-022 ๋ฅผ ๋’ค์ง‘์–ด ์ „์ œ๊ฐ€ ์‚ฌ๋ผ์ง„ ํ•ญ๋ชฉ์ด๋ฉฐ, sandbox-limits ์™€ ๋‹ฌ๋ฆฌ ํ”„๋ ˆ์ž„ ํƒ€์ž„์€ ์—”์ง„์˜ ์„ฑ์งˆ์ด๋ฏ€๋กœ ใ€Œ์ฑ„๋„ ๋ฌด๊ด€ใ€์ด ์•„๋‹ˆ๋ผ ๋ช…์‹œ๋œ ํ•œ๊ณ„๋กœ ์ ์—ˆ๋‹ค(D-065 ยง4.2).

D-067: AC-16 ์ธก์ • ๊ทœ์น™ 4์ข… ํ™•์ • ยท ์ฝ”ํผ์Šค๋ฅผ ๋ฆฌํฌ์— ์ปค๋ฐ‹ ยท ์žฌ์‚ฌ์šฉ ์ปดํฌ๋„ŒํŠธ ๊ฒฐํ•จ์€ ์žฌํ˜„๋˜๋ฉฐ, ์šฐ๋ฆฌ ๊ฐ€๋“œ๋Š” ์•„์ง ๋ฐฐ์„ ๋˜์ง€ ์•Š์•˜๋‹ค (#93)

  • Date: 2026-09-14
  • Context: A-04(ํ•œ๊ธ€ IME)๋Š” Unverified ์ด๋ฉด์„œ ๋ฐ˜์ฆ ์‚ฌ๋ก€๊ฐ€ ์žˆ๋Š” MVP ๊ฒŒ์ดํŒ… ๋ฆฌ์Šคํฌ๋‹ค. planning-inputs ยง4.2 ๊ฐ€ ์ˆœ์„œ๋ฅผ ๊ทœ์ •ํ–ˆ๋‹ค โ€” "์ž์ฒด ๊ตฌํ˜„ ์ „์— ์žฌ์‚ฌ์šฉ ์ปดํฌ๋„ŒํŠธ์—์„œ ๊ฒฐํ•จ ์žฌํ˜„ ์—ฌ๋ถ€๋ฅผ ๋จผ์ € ํ™•์ธ". ๊ทธ ํ™•์ธ ์—†์ด๋Š” macOS ์ŠคํŒŒ์ดํฌ(#94)์˜ ๊ฒฐ๊ณผ๋ฅผ ํ•ด์„ํ•  ๊ทผ๊ฑฐ๊ฐ€ ์—†๋‹ค.
  • Decision: โ‘  ์ธก์ • ๊ทœ์น™ 4์ข…(์ž…๋ ฅ๊ธฐยท์ฝ”ํผ์Šคยท์‹œํ–‰ ํšŸ์ˆ˜ยท๊ด€์ฐฐ ๋ฐฉ๋ฒ•)์„ docs/ac16-measurement-rules-cocode.md ยง2 ๋กœ ํ™•์ •ํ•˜๊ณ  ์ฝ”ํผ์Šคยท๊ธฐ๋Œ€๊ฐ’์„ scripts/spike/ime_corpus/ ์— ์ปค๋ฐ‹ํ•œ๋‹ค. โ‘ก ์žฌ์ƒ ํ•˜๋‹ˆ์Šค 2์ข…(ํ„ฐ๋ฏธ๋„ยท์—๋””ํ„ฐ)์„ benchmark/ ์— ๋‘”๋‹ค. โ‘ข ใ€Œํ”Œ๋žซํผ๋ณ„ ๊ฒ€์ฆ ์‹œ์ ใ€์€ ๋ฏธ์ • โ€” ๊ฒฐ์ • ํ•„์š”(ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ) ๋กœ ๋‚จ๊ธฐ๊ณ  ์ œ์•ˆ๋งŒ ์ ๋Š”๋‹ค. โ‘ฃ WindowsยทLinux ๊ฒ€์ฆ์ด ์ถœ์‹œ ์กฐ๊ฑด์ž„์„ Planning ์žฌ๋Ÿ‰ ๋ฐ–์œผ๋กœ ๋ช…์‹œํ•œ๋‹ค.
  • Rationale (์žฌํ˜„ ํ™•์ธ ๊ฒฐ๊ณผ๊ฐ€ ํ•ต์‹ฌ์ด๋‹ค):
    • ๐Ÿ”ด xterm2 5.2.0 ์— Lumide #64 ์˜ ์›์ธ ๊ฒฝ๋กœ๊ฐ€ ๊ทธ๋Œ€๋กœ ์žˆ๋‹ค. ์†Œ์Šค ์‹ค์ธก: CustomTextEdit(IME ์ž…๋ ฅ ์—ฐ๊ฒฐ)์— onKeyEvent: _handleKeyEvent ๊ฐ€ ๋ถ™๋Š”๋ฐ, ๊ทธ ํ•ธ๋“ค๋Ÿฌ ๋ณธ๋ฌธ(terminal_view.dart:670โ€“:739)์— _composingText ์ฐธ์กฐ๊ฐ€ 0๊ฑด์ด๋‹ค(ํ•„๋“œ๋Š” :245 ์„ ์–ธ ยท :449 ๋ Œ๋”๋ง ยท :667 ์„ธํ„ฐ โ€” ์„ธ ๊ณณ ์ „๋ถ€ ํ•ธ๋“ค๋Ÿฌ ๋ฐ–). ์กฐํ•ฉ ์ค‘์—๋„ _printableTextForKeyEvent(:763 โ€” event.character)๊ฐ€ ๋‘๋ฒŒ์‹ ์žํŒ์˜ ํ˜ธํ™˜ ์ž๋ชจ๋ฅผ ๊บผ๋‚ด terminal.keyInput(text:) ๋กœ PTY ์— ๋ณด๋‚ด๊ณ  handled ๋ฅผ ๋Œ๋ ค์ค€๋‹ค. ์ด์Šˆ๊ฐ€ ๋ณด๊ณ ํ•œ ์ฝ”๋“œํฌ์ธํŠธ ์ง‘ํ•ฉ(U+314EยทU+314FยทU+3134ยทU+3131ยทU+3161ยทU+3139)์ด ์ •ํ™•ํžˆ ๊ทธ๊ฒƒ์ด๋‹ค. 5.2.0 ์€ ์ด์Šˆ ๋“ฑ๋ก 18์ผ ์ „ ๋ฆด๋ฆฌ์Šค์ด๋ฉฐ ์ดํ›„ ํŒ์ด ์—†๋‹ค โ€” ๋ฏธ์ˆ˜์ •์ด๋‹ค.
    • โœ… ์šฐ๋ฆฌ๋Š” ์žฌ์‚ฌ์šฉํ•˜์ง€ ์•Š์•˜๋‹ค. terminal pubspec ์— xterm2/flutter_pty2 ๊ฐ€ ์—†๊ณ , _onKey ์ฒซ๋จธ๋ฆฌ์— xterm2 ๊ฐ€ ๊ฐ–์ง€ ์•Š์€ if (_composing.isComposing) return .ignored; ๊ฐ€ ์žˆ๋‹ค. ์žฌ์ƒ ํ•˜๋‹ˆ์Šค๊ฐ€ ์–‘๋ฐฉํ–ฅ์œผ๋กœ ํ™•์ธํ–ˆ๋‹ค โ€” ์กฐํ•ฉ ์ค‘ ๋ˆ„์ถœ 0 ๋ฐ”์ดํŠธ, ๋Œ€์กฐ๊ตฐ(์กฐํ•ฉ ์•„๋‹ ๋•Œ ๊ฐ™์€ ํ‚ค)์€ ํ†ต๊ณผ. ๋Œ€์กฐ๊ตฐ์ด ์—†์œผ๋ฉด ใ€Œ๋ง‰ํ˜”๋‹คใ€๊ฐ€ ๊ฐ€๋“œ ๋•Œ๋ฌธ์ธ์ง€ ํ•˜๋‹ˆ์Šค๊ฐ€ ํ‚ค๋ฅผ ๋ชป ๋ณด๋‚ธ ๊ฒƒ์ธ์ง€ ๊ตฌ๋ถ„๋˜์ง€ ์•Š๋Š”๋‹ค.
    • ๐Ÿ”ด ๊ทธ๋Ÿฌ๋‚˜ ๊ทธ ๊ฐ€๋“œ๋Š” ์•„์ง ํ•œ ๋ฒˆ๋„ ๋ฐœ๋™ํ•  ์ˆ˜ ์—†๋‹ค. ๋ฆฌํฌ ์ „์ˆ˜ ์กฐํšŒ: CocodeComposingController ๋ฅผ ์“ฐ๋Š” ๊ณณ์ด ํ…Œ์ŠคํŠธ 3๊ณณ๋ฟ์ด๊ณ , package/cocode_*ยทapp/cocode/lib ์— TextInputClient/DeltaTextInputClient ๊ตฌํ˜„์ด 0๊ฑด์ด๋‹ค. ์‹ค๊ธฐ๊ธฐ์—์„œ isComposing ์€ ํ•ญ์ƒ false ์ด๋ฏ€๋กœ _onKey ์˜ default ๊ฐ€์ง€๊ฐ€ event.character ๋ฅผ ๊ทธ๋Œ€๋กœ ์ปค๋ฐ‹ํ•œ๋‹ค โ€” xterm2 ์™€ ๊ฐ™์€ ์ฝ”๋“œ ํ˜•ํƒœ์ด๊ณ  ๊ฐ™์€ ๊ฒฐ๊ณผ๋‹ค.
    • ์—๋””ํ„ฐ๋Š” ์‚ฌ์ •์ด ๋‹ค๋ฅด๋‹ค โ€” re_editor 0.10.0 ์ด _code_input.dart ์— ์ž์ฒด TextInputClient ๋ฅผ ๊ฐ–๊ณ  composing ์„ ์ง์ ‘ ๋‹ค๋ฃฌ๋‹ค(setComposingRect ํฌํ•จ). ํ‘œ๋ฉด๋ณ„๋กœ ์œ„ํ—˜์ด ๋น„๋Œ€์นญ์ด๋ผ๋Š” ์‚ฌ์‹ค ์ž์ฒด๊ฐ€ #94 ์„ค๊ณ„์˜ ์ž…๋ ฅ์ด๋‹ค.
    • ์ฝ”ํผ์Šค๋ฅผ 7์‹œํ–‰์œผ๋กœ ์ง  ์ด์œ : t3-jongseong-migration(๊ฐ„ โ†’ ๊ฐ€๋‚˜)์ด ์กฐํ•ฉ ์ค‘ ์•ž ๊ธ€์ž๊ฐ€ ๋ฐ”๋€Œ๋Š” ๊ฒฝ์šฐ๋ฅผ ์žก๋Š”๋‹ค. ๋‹จ์ˆœ ์กฐํ•ฉ๋งŒ ์žฌ๋Š” ์ฝ”ํผ์Šค๋Š” ์•ž ๊ธ€์ž๋ฅผ ์ด๋ฏธ ์ปค๋ฐ‹ํ•œ ๊ตฌํ˜„์„ ํ†ต๊ณผ์‹œํ‚จ๋‹ค. t2 ๋Š” ์ด์Šˆ ๋ณธ๋ฌธ์˜ ์ž…๋ ฅ ๋ฌธ์ž์—ด ๊ทธ๋Œ€๋กœ๋‹ค.
    • ๊ด€์ฐฐ์— ์ฝ”๋“œํฌ์ธํŠธ ๋ชฉ๋ก์„ ๋„ฃ์€ ์ด์œ : Compatibility Jamo(U+3131โ€“U+318E)์™€ Hangul Jamo(U+1100โ€“U+11FF)์˜ ๊ตฌ๋ถ„์ด ์›์ธ์„ ๊ฐ€๋ฅธ๋‹ค(์ „์ž = ์กฐํ•ฉ ์—”์ง„ ๋ฏธ๋™์ž‘, ํ›„์ž = preedit ์กฐ๊ธฐ ์ปค๋ฐ‹). ํ…์ŠคํŠธ๋งŒ ๋น„๊ตํ•˜๋ฉด ์ด ๊ตฌ๋ถ„์ด ์‚ฌ๋ผ์ง„๋‹ค. ํ•˜๋‹ˆ์Šค๋Š” fail:lumide-64-class ์™€ fail:early-commit ์„ ๋‹ค๋ฅธ ํŒ์ •์œผ๋กœ ๋‚ธ๋‹ค.
  • Impact:
    • ์‹ ๊ทœ ์‚ฐ์ถœ๋ฌผ: docs/ac16-measurement-rules-cocode.md ยท scripts/spike/ime_corpus/{corpus,expected}.json ยท ํ•˜๋‹ˆ์Šค 2์ข… ยท ์žฌ์ƒ ๊ฒฐ๊ณผ JSON 2์ข….
    • โญ #94 ์˜ ์ฒซ ๊ณผ์ œ๊ฐ€ ๋ฐ”๋€๋‹ค. ใ€ŒmacOS ์—์„œ ํ†ต๊ณผํ•˜๋Š”๊ฐ€ใ€๊ฐ€ ์•„๋‹ˆ๋ผ ใ€ŒIME ์—ฐ๊ฒฐ(TextInputClient)์„ ํ„ฐ๋ฏธ๋„์— ๋ฐฐ์„ ํ•˜๋Š” ๊ฒƒใ€ ์ด๋‹ค. ๋ฐฐ์„  ์—†์ด ์‹ค๊ธฐ๊ธฐ๋ฅผ ๋Œ๋ฆฌ๋ฉด ๊ฒฐ๊ณผ๋Š” โŒ ๋กœ ๋‚˜์˜ค๋ฉฐ, ๊ทธ โŒ ๋ฅผ ใ€Œ์ž์ฒด ๊ตฌํ˜„๋„ ์‹คํŒจํ–ˆ๋‹คใ€๋กœ ์ฝ์œผ๋ฉด ์›์ธ์„ ์ž˜๋ชป ์งš๋Š”๋‹ค.
    • ์ž…๋ ฅ๊ธฐยท๋ฐฐํฌํŒ์„ ๋ชป๋ฐ•์•˜๋‹ค: macOS ๋‚ด์žฅ 2-Set ยท Windows MS-IME ยท Linux ibus-hangul on Ubuntu 24.04 LTS(fcitx5 ๋Š” ๋ฒ”์œ„ ๋ฐ–). Wayland ๊ธฐ๋ณธ, ์‹คํŒจ ์‹œ X11 ์„ ๋Œ€์กฐ๊ตฐ์œผ๋กœ.
    • ์‹œํ–‰ ํšŸ์ˆ˜: ์žฌ์ƒ 1ํšŒ(๊ฒฐ์ •๋ก ) ยท ์‹ค๊ธฐ๊ธฐ 3ํšŒ, 3ํšŒ ์ค‘ ํ•œ ๋ฒˆ์ด๋ผ๋„ ์‹คํŒจํ•˜๋ฉด ๋ถˆํ†ต๊ณผ(๋‹ค์ˆ˜๊ฒฐ ์•„๋‹˜).
    • โธ๏ธ ๋ฏธ์ • 1๊ฑด: WindowsยทLinux ๊ฒ€์ฆ ์‹œ์ . ์ œ์•ˆ์€ ใ€Œํ‘œ๋ฉด์ด ์…ธ์— ํ†ตํ•ฉ๋ผ 3์ข… ๋ฆด๋ฆฌ์Šค ๋นŒ๋“œ๊ฐ€ ๋‚˜์˜ค๋Š” ์‹œ์ ใ€์ด๋ฉฐ, ๊ทผ๊ฑฐ๋Š” IME ๊ฐ€ ์ž„๋ฒ ๋”์™€ ํ‘œ๋ฉด์˜ ๋ฐฐ์„ ์— ๊ฑธ๋ฆฐ๋‹ค๋Š” ์œ„ ๊ด€์ฐฐ์ด๋‹ค. ๋Šฆ์ถ”๋Š” ๊ฒฐ์ •์ด ์ถœ์‹œ ์กฐ๊ฑด์„ ์™„ํ™”ํ•˜์ง€๋Š” ์•Š๋Š”๋‹ค.
    • ๋ถ€์ˆ˜: Lumide #64 ๋ณธ๋ฌธ์˜ ๋ณ„๊ฐœ ๋ณด๊ณ (Nerd Font Mono ๋ณ€ํ˜•์ด advance ๋ฅผ ๋‹จ์ผ ์…€๋กœ ๊ฐ•์ œํ•ด ํ•œ๊ธ€์ด ์ฐŒ๊ทธ๋Ÿฌ์ง„๋‹ค โ€” D2Coding Nerd Font 3.4.0 ์—์„œ ์ผ๋ฐ˜ 2.0 / Mono 1.0)๋Š” ์ด ๋ฆฌํฌ๊ฐ€ ์ด๋ฏธ check_mono_font_grid.py(#55)๋กœ ์ž ๊ทผ ์ถ•์ด๋‹ค. ๊ทธ ๊ฐ€๋“œ๊ฐ€ ํ•„์š”ํ•œ ์ด์œ ์˜ ์™ธ๋ถ€ ์‹ค์‚ฌ๋ก€๋กœ ๊ธฐ๋ก๋งŒ ํ•˜๊ณ  ์ƒˆ ์ž‘์—…์„ ๋งŒ๋“ค์ง€ ์•Š๋Š”๋‹ค.
  • Source: #93 ์ธ์ˆ˜ ์กฐ๊ฑด 5์ข…. xterm2 ์†Œ์Šค ์‹ค์ธก์€ pub.dev ์•„์นด์ด๋ธŒ xterm2-5.2.0.tar.gz(2026-09-14 ๋‚ด๋ ค๋ฐ›์Œ), ์ด์Šˆ ๋ณธ๋ฌธ์€ gh issue view 64 --repo SoFluffyOS/lumide(state OPEN).

D-068: ํ„ฐ๋ฏธ๋„ ํ”Œ๋žซํผ IME ์—ฐ๊ฒฐ ์‹ ์„ค โ€” ํ™•์ • ์ถ”์ ์€ ์˜คํ”„์…‹์ด ์•„๋‹ˆ๋ผ ๋‚ด์šฉ์œผ๋กœ (#94)

  • Date: 2026-09-14
  • Context: D-067(#93)์ด ๊ณต๋ฐฑ์„ ์ง€๋ชฉํ–ˆ๋‹ค โ€” ํ„ฐ๋ฏธ๋„์˜ I2 ๊ฐ€๋“œ(์กฐํ•ฉ ์ค‘ โ†’ ignored)๋Š” ์žˆ๋Š”๋ฐ ๊ทธ๊ฒƒ์„ ๋ฐœ๋™์‹œํ‚ฌ TextInputClient ๊ฐ€ ๋ฆฌํฌ์— 0๊ฑด์ด๋ผ, ์‹ค๊ธฐ๊ธฐ์—์„œ๋Š” isComposing ์ด ์˜์›ํžˆ false ์ด๊ณ  ๋‘๋ฒŒ์‹ ์žํŒ์˜ ํ˜ธํ™˜ ์ž๋ชจ๊ฐ€ ๊ทธ๋Œ€๋กœ PTY ๋กœ ๊ฐ„๋‹ค(Lumide #64 ์™€ ๊ฐ™์€ ๊ฒฐ๊ณผ). #94 ์˜ ์ฒซ ๊ณผ์ œ๋Š” ์ธก์ •์ด ์•„๋‹ˆ๋ผ ๋ฐฐ์„ ์ด์—ˆ๋‹ค.
  • Decision: CocodeTerminalImeConnection(terminal/lib/src/input/)์„ ์‹ ์„คํ•˜๊ณ  CocodeTerminalView ๊ฐ€ ํฌ์ปค์Šค ์—ฐ๋™์œผ๋กœ ์—ด๊ณ  ๋‹ซ๋Š”๋‹ค(enableIme ๊ธฐ๋ณธ true). ํ™•์ • ํ…์ŠคํŠธ ์ถ”์ ์€ ์˜คํ”„์…‹์ด ์•„๋‹ˆ๋ผ ๋‚ด์šฉ์œผ๋กœ ํ•œ๋‹ค. ์‹ค๊ธฐ๊ธฐ ๋Œ€์กฐ๋ฅผ ์œ„ํ•ด onImePlatformValue ์บก์ฒ˜ ํƒญ๊ณผ scripts/spike/verify_ime_capture.py ๋ฅผ ํ•จ๊ป˜ ๋‘”๋‹ค.
  • Rationale:
    • ์™œ ์—๋””ํ„ฐ์ฒ˜๋Ÿผ ํ•˜์ง€ ์•Š๋‚˜: re_editor ๋Š” ๋ฌธ์„œ ์ „์ฒด๋ฅผ TextEditingValue ๋กœ ๋“ค๊ณ  ํ”Œ๋žซํผ๊ณผ ์ฃผ๊ณ ๋ฐ›์ง€๋งŒ ํ„ฐ๋ฏธ๋„์—๋Š” ๊ทธ๋Ÿด ใ€Œ๋ฌธ์„œใ€๊ฐ€ ์—†๋‹ค โ€” ์นœ ๊ฒƒ์€ ์ฆ‰์‹œ ์ž์‹์—๊ฒŒ ํ˜๋Ÿฌ๊ฐ€๊ณ  ์šฐ๋ฆฌ ์ชฝ์— ๋‚จ์ง€ ์•Š๋Š”๋‹ค. ๊ทธ๋ž˜์„œ ์กฐํ•ฉ ๊ตฌ๊ฐ„๋งŒ ๋“ค๊ณ  ํ™•์ • ์ฆ‰์‹œ ํ”Œ๋žซํผ ๋ฒ„ํผ๋ฅผ ๋น„์šด๋‹ค(๋น„์šฐ์ง€ ์•Š์œผ๋ฉด ๋ฒ„ํผ๊ฐ€ ์„ธ์…˜ ๋‚ด๋‚ด ์ž๋ผ๊ณ  ํ›„๋ณด์ฐฝ ์œ„์น˜๊ฐ€ ๋ฐ€๋ฆฐ๋‹ค).
    • enableIme ๊ธฐ๋ณธ์ด ์ผœ์ง์ธ ์ด์œ : ๊บผ์ง„ ์ชฝ์ด ์œ„ํ—˜ํ•˜๋‹ค. ๊บผ์ ธ ์žˆ์œผ๋ฉด I2 ๊ฐ€๋“œ๊ฐ€ ํ•œ ๋ฒˆ๋„ ๋ฐœ๋™ํ•˜์ง€ ์•Š๋Š”๋‹ค โ€” ๊ทธ๊ฒƒ์ด D-067 ์ด ๊ธฐ๋กํ•œ ๊ทธ ์ƒํƒœ๋‹ค. ๋„๋Š” ์ž๋ฆฌ๋Š” ์กฐํ•ฉ ์ƒํƒœ๋ฅผ ๋ฐ–์—์„œ ๋ฐ€์–ด ๋„ฃ๋Š” ๊ณ„์ธก๊ธฐ๋ฟ์ด๋‹ค.
    • ๐Ÿ”ด ํ™•์ • ์ถ”์ ์„ ๋‚ด์šฉ์œผ๋กœ ๋ฐ”๊พผ ๊ฒƒ์€ ์‹ค์ธก์ด ๊ฐ•์ œํ–ˆ๋‹ค. ์ดˆํŒ์€ ์˜คํ”„์…‹(_committedLength)์œผ๋กœ ๋“ค์—ˆ๊ณ , ํ”Œ๋žซํผ ์ฑ„๋„ ์žฌ์ƒ์ด t6-mixed-latin-hangul ์—์„œ echo echo ํ•œ ์„ ๋ƒˆ๋‹ค(writes: ['echo ', 'echo ', 'ํ•œ']). ์›์ธ: ํ™•์ • ๋’ค ๋ฒ„ํผ๋ฅผ ๋น„์šฐ๋ฉฐ ๊ธธ์ด๋ฅผ 0 ์œผ๋กœ ๋˜๋Œ๋ฆฌ๋Š”๋ฐ, ๋น„์›€์ด ๋ฐ˜์˜๋˜๊ธฐ ์ „์˜ ๊ฐ’(์ด์ „ ๋ˆ„์  ํ…์ŠคํŠธ๋ฅผ ์ด์–ด ๋ณด๋‚ด๋Š” ๊ฐ’)์ด ์˜ค๋ฉด ํ™•์ • ์ ‘๋‘์‚ฌ๋ฅผ ๋‹ค์‹œ ๋ณด๋‚ธ๋‹ค. ๋‚ด์šฉ ๊ธฐ์ค€์ด๋ฉด ๋‘ ์ŠคํŠธ๋ฆผ์ด ๊ฐ™์€ ์‹์œผ๋กœ ํ’€๋ฆฐ๋‹ค โ€” ์ด๋ฏธ ๋ณด๋‚ธ ๊ฒƒ์œผ๋กœ ์‹œ์ž‘ํ•˜๋ฉด ๊ทธ ๋’ค๋งŒ, ์•„๋‹ˆ๋ฉด ์ „์ฒด๋ฅผ(๋น„์›€ ํ›„์—๋Š” ํ™•์ • ์ ‘๋‘์‚ฌ๊ฐ€ ๋น„์–ด ์žˆ์–ด no-op).
    • โญ ์ด ๊ฒฐํ•จ์€ ์ปจํŠธ๋กค๋Ÿฌ ๋ชจ๋“œ์—์„œ ๋ณด์ด์ง€ ์•Š์•˜๋‹ค. ํ•˜๋‹ˆ์Šค๊ฐ€ ์ปจํŠธ๋กค๋Ÿฌ๋ฅผ ์ง์ ‘ ๋ฐ€๋ฉด ํ”Œ๋žซํผ ๋ฒ„ํผ๊ฐ€ ์—†๊ณ  ใ€Œ๋น„์›€๊ณผ ์ง€์—ฐ ๋ฐ˜์˜ใ€์ด๋ผ๋Š” ์ƒํƒœ ์ž์ฒด๊ฐ€ ์กด์žฌํ•˜์ง€ ์•Š๋Š”๋‹ค. ์ œํ’ˆ ๊ฒฝ๋กœ๋กœ ํ•œ ๋ฒˆ ๋” ์žฌ๋Š” ๊ฒƒ(๋ชจ๋“œ B)์ด ์™œ ํ•„์š”ํ•œ์ง€์˜ ์‹ค์‚ฌ๋ก€๋‹ค.
    • ๋ชจ๋“œ B ํŒ์ •์— ime_attached ๋ฅผ ๋„ฃ์—ˆ๋‹ค โ€” ์—ฐ๊ฒฐ์ด ์•ˆ ์—ด๋ ธ๋Š”๋ฐ ใ€Œ๋ˆ„์ถœ 0ใ€์„ ํ†ต๊ณผ๋กœ ์ ์œผ๋ฉด D-067 ์ด ๊ธฐ๋กํ•œ ๋ฐฐ์„  ๋ถ€์žฌ๋ฅผ ์„ฑ๊ณต์œผ๋กœ ์˜ค๋…ํ•œ๋‹ค. ๋ฏธ๋ถ€์ฐฉ์€ inconclusive:not-attached ๋กœ ๋”ฐ๋กœ ๋‚ธ๋‹ค.
    • ์บก์ฒ˜ ํƒญ์„ ์ฝœ๋ฐฑ์œผ๋กœ ๋‘” ์ด์œ : cocode_*/lib ์˜ dart:io ์“ฐ๊ธฐ๋Š” DD-15 ํ—ˆ์šฉ ๋ชฉ๋ก ๋ฐ–์ด๋‹ค(check_dart_io_write_allowlist.py). ๊ธฐ๋ก ๋ฐฉ๋ฒ•์€ ๋ถ€๋ฅด๋Š” ์ชฝ์ด ์ •ํ•œ๋‹ค.
  • Impact:
    • ์‹ ๊ทœ: CocodeTerminalImeConnection(๋ฐฐ๋Ÿด export) ยท CocodeTerminalView.enableImeยทonImePlatformValue ยท ํ…Œ์ŠคํŠธ 12๊ฑด ยท scripts/spike/verify_ime_capture.py ยท docs/ac16-macos-spike-cocode.md.
    • terminal ํ…Œ์ŠคํŠธ 63 โ†’ 75๊ฑด. ์žฌ์ƒ ํ•˜๋‹ˆ์Šค๋Š” 2๋ชจ๋“œ(์ปจํŠธ๋กค๋Ÿฌยทํ”Œ๋žซํผ ์ฑ„๋„)๋กœ ๋Š˜์–ด 14 ์‹œํ–‰.
    • FakeTerminalBackend ์— writtenText ๊ฒŒํ„ฐ ์ถ”๊ฐ€(๊ธฐ์กด written ๋ฆฌ์ŠคํŠธ๋Š” ๊ทธ๋Œ€๋กœ โ€” ์กฐ๊ฐ ๊ฒฝ๊ณ„๊ฐ€ ํ™•์ • ๊ฒฝ๊ณ„์˜ ์ฆ๊ฑฐ๋ผ ๋ฆฌ์ŠคํŠธ๋ฅผ ์œ ์ง€ํ•œ๋‹ค).
    • โž– ๋ชป ์žฐ ๊ฒƒ: macOS 2-Set ์ž…๋ ฅ๊ธฐ๊ฐ€ ์ •๋ง ์ด ๋ธํƒ€ ์—ด์„ ๋‚ด๋Š”๊ฐ€(์‚ฌ๋žŒ 1ํšŒ ์บก์ฒ˜ ํ•„์š”) ยท preedit ์˜ ์‹œ๊ฐ์  ๊ตฌ๋ถ„(I1) ยท macOS ๋ฐ์Šคํฌํ†ฑ ๋Ÿฌ๋„ˆ ์‹คํ–‰(app/cocode ์— cocode_* ์˜์กด์„ ๋„ฃ์œผ๋ฉด DD-02a ์ถ• 2ยท3 ์ด ํ™œ์„ฑํ™”๋œ๋‹ค โ€” D-064 Context, ์…ธ ํ†ตํ•ฉ ์Šคํ† ๋ฆฌ ์†Œ๊ด€).
    • A-04 ๋Š” Unverified ์œ ์ง€. ์žฌ์ƒ ํ†ต๊ณผ๋Š” ใ€Œ์šฐ๋ฆฌ ์ฝ”๋“œ๊ฐ€ ๊ทœ์ •๋œ ๋ธํƒ€๋ฅผ ์˜ณ๊ฒŒ ๋‹ค๋ฃฌ๋‹คใ€์ด์ง€ ใ€Œ์ž…๋ ฅ๊ธฐ๊ฐ€ ๊ทธ ๋ธํƒ€๋ฅผ ๋‚ธ๋‹คใ€๊ฐ€ ์•„๋‹ˆ๋‹ค. ๋‹ค๋งŒ ๋ฐ˜์ฆ ์‚ฌ๋ก€์˜ ๊ฒฝ๋กœ๊ฐ€ ์šฐ๋ฆฌ ์ฝ”๋“œ์— ์—†์Œ์ด ์ œํ’ˆ ๊ฒฝ๋กœ๋กœ ํ™•์ธ๋๊ณ  ๋‚จ์€ ๋ฏธ์ง€์ˆ˜๊ฐ€ ํ•˜๋‚˜๋กœ ์ขํ˜€์กŒ๋‹ค.
    • AC-16 ์€ 6์กฐํ•ฉ ์ค‘ macOS 2์กฐํ•ฉ๋งŒ ์žฌ์ƒ ์ˆ˜์ค€์—์„œ ๋‹ซํ˜”๋‹ค. D-016 ์ด ์ •ํ•œ ๊ฒƒ์€ ์ˆœ์„œ์ด์ง€ ์ถœ์‹œ ์กฐ๊ฑด์˜ ์ถ•์†Œ๊ฐ€ ์•„๋‹ˆ๋‹ค.
  • Source: #94 ์ธ์ˆ˜ ์กฐ๊ฑด 4์ข…. ์‹ค์ธก์€ ์ด ์›ŒํฌํŠธ๋ฆฌ(2026-09-14, macOS 26.5.2 arm64, Dart 3.13.3 / Flutter 3.47.3).

D-069: AC-16 ์€ 6์กฐํ•ฉ ์ „๋ถ€ ๋ฏธ์ถฉ์กฑ โ€” ์ฝ”๋“œ ๊ฒฝ๋กœ๋Š” 3-OS ๋กœ ๋‹ซ๊ณ , ์ž…๋ ฅ๊ธฐ ์ถ•์€ unavailable ๋กœ ๋‚จ๊ธด๋‹ค (#95)

  • Date: 2026-09-14
  • Context: AC-16 ์€ 3ํ”Œ๋žซํผ ร— 2ํ‘œ๋ฉด = 6์กฐํ•ฉ์„ Must ๋กœ ์ž ๊ฐ”๊ณ (BDD Feature 2 Examples 6ํ–‰), #94 ๊ฐ€ macOS 2์กฐํ•ฉ์„ ใ€Œ์žฌ์ƒ ํ†ต๊ณผ ยท ์ž…๋ ฅ๊ธฐ ๋ฏธ์‹ค์ธกใ€์œผ๋กœ ๋‹ซ์•˜๋‹ค. ์ด Story ๋Š” WindowsยทLinux 4์กฐํ•ฉ์„ ๊ฐ™์€ ๊ธฐ์ค€์œผ๋กœ ์ฒ˜๋ฆฌํ•ด์•ผ ํ–ˆ๋‹ค.
  • Options:
    1. 3-OS ์žฌ์ƒ CI ์˜ ์ดˆ๋ก๋ถˆ์„ AC-16 ์ถฉ์กฑ์œผ๋กœ ์„ ์–ธํ•œ๋‹ค
    2. ์‹ค๊ธฐ๊ธฐ ์ž…๋ ฅ๊ธฐ๋ฅผ ๋ชป ์žฌ๋ฏ€๋กœ ์•„๋ฌด๊ฒƒ๋„ ํ•˜์ง€ ์•Š๊ณ  4์กฐํ•ฉ์„ ๋ฏธ์ฐฉ์ˆ˜๋กœ ๋‘”๋‹ค
    3. ์žฌ๋Š” ์ถ•๊ณผ ๋ชป ์žฌ๋Š” ์ถ•์„ ๋‚˜๋ˆ  ์žฌ๋Š” ์ถ•(์ฝ”๋“œ ๊ฒฝ๋กœ)์„ 3-OS ๋กœ ๋‹ซ๊ณ , ๋ชป ์žฌ๋Š” ์ถ•(์ž…๋ ฅ๊ธฐ)์„ unavailable ๋กœ ๋ช…์‹œํ•œ ๋’ค 6์กฐํ•ฉ ์ „๋ถ€ ์ถœ์‹œ ์กฐ๊ฑด ๋ฏธ์ถฉ์กฑ์œผ๋กœ ์ ๋Š”๋‹ค
  • Decision: ์˜ต์…˜ 3. probe.ac16-ime-replay.yaml(3-OS ๋งคํŠธ๋ฆญ์Šค)์„ ์‹ ์„คํ•ด ๋‘ ํ‘œ๋ฉด์˜ ์žฌ์ƒ์„ ubuntu-24.04ยทmacos-15ยทwindows-2022 ์—์„œ ๋Œ๋ฆฌ๊ณ , 6์กฐํ•ฉ ์ทจํ•ฉํ‘œ๋ฅผ docs/ac16-windows-linux-cocode.md ์— ๋‘”๋‹ค. ์—ฌ์„ฏ ์กฐํ•ฉ ์ „๋ถ€ โŒ ๋ฏธ์ถฉ์กฑ์ด๋‹ค.
  • Rationale:
    • โ‘ ์€ ์ด ๋ฌธ์„œ ์ง‘ํ•ฉ์ด ๋ฐ˜๋ณตํ•ด ๊ฒฝ๊ณ„ํ•œ ์‹ค์ˆ˜๋‹ค โ€” docs/sandbox-limits-cocode.md ยง1.2: "์žฌ์ง€ ๋ชปํ•œ ๊ฒƒ๊ณผ ์žฌ์„œ ํ†ต๊ณผํ•œ ๊ฒƒ์„ ์„ž์œผ๋ฉด ๊ทธ ํ‘œ๋Š” ๊ทผ๊ฑฐ๊ฐ€ ์•„๋‹ˆ๋ผ ์ธ์ƒ์ด ๋œ๋‹ค." AC-16 ์˜ Given ์€ "ํ•œ๊ธ€์„ ์กฐํ•ฉ ์ž…๋ ฅํ•˜๋ฉด" ์ด๊ณ , ์กฐํ•ฉ ์ž…๋ ฅ์ด ์—†์—ˆ์œผ๋ฉด Given ์ž์ฒด๊ฐ€ ์„ฑ๋ฆฝํ•˜์ง€ ์•Š๋Š”๋‹ค.
    • โ‘ก๋Š” ์‹ค์ œ๋กœ ๋‹ซ์„ ์ˆ˜ ์žˆ๋Š” ๊ฒƒ์„ ๋‚จ๊ฒจ ๋‘”๋‹ค. AC-16 ์˜ ์‹คํŒจ ์กฐ๊ฑด ์ค‘ ์ค‘๋ณต ์ž…๋ ฅยท์ปค์„œ ์œ„์น˜๋Š” ์šฐ๋ฆฌ ์ฝ”๋“œ๊ฐ€ ์กฐํ•ฉ ๋ธํƒ€๋ฅผ ์–ด๋–ป๊ฒŒ ๋‹ค๋ฃจ๋Š”์ง€์˜ ํ•จ์ˆ˜์ด๊ณ , ๊ทธ ์ฝ”๋“œ๊ฐ€ ํ”Œ๋žซํผ๋งˆ๋‹ค ๊ฐˆ๋ฆฌ์ง€ ์•Š๋Š”์ง€๋Š” 3 OS ์—์„œ ๊ฐ™์€ ๋‹ต์ด ๋‚˜์˜ค๋Š” ๊ฒƒ์œผ๋กœ๋งŒ ํ™•์ธ๋œ๋‹ค โ€” verify.cocode-pure-tests.yaml ์ด desktop_platform ์„ 3-OS ๋กœ ๋„๋Š” ์ด์œ ("๋™์ผ์„ฑ์€ ์„ธ OS ์—์„œ ๊ฐ™์€ ๋‹ต์ด ๋‚˜์˜ค๋Š” ๊ฒƒ์œผ๋กœ๋งŒ ํ™•์ธ๋œ๋‹ค")์™€ ๊ฐ™์€ ๋…ผ๋ฆฌ๋‹ค.
    • ์ด Story ๊ฐ€ ๋ฐ”๊พผ ๊ฒƒ์€ ๋ฏธ์ง€์ˆ˜์˜ ๊ฐœ์ˆ˜๋‹ค โ€” ใ€Œ์ฝ”๋“œ๊ฐ€ ํ”Œ๋žซํผ๋งˆ๋‹ค ๋‹ค๋ฅธ๊ฐ€ใ€์™€ ใ€Œ์ž…๋ ฅ๊ธฐ๊ฐ€ ๋ฌด์—‡์„ ๋‚ด๋Š”๊ฐ€ใ€ ๋‘˜์ด์—ˆ๋˜ ๊ฒƒ์ด ํ•˜๋‚˜๋กœ ์ค„์—ˆ๋‹ค.
    • ์™œ ์ž…๋ ฅ๊ธฐ๋ฅผ ๋ชป ์žฌ๋Š”๊ฐ€(6์กฐํ•ฉ ์ „๋ถ€): โ“ ์กฐํ•ฉ์€ ๋ฌผ๋ฆฌ ํ‚ค๋ฅผ ์ž…๋ ฅ๊ธฐ๊ฐ€ ํ•ด์„ํ•˜๋ฉฐ ์‹œ์ž‘๋˜๋Š”๋ฐ ๋Ÿฌ๋„ˆ์— ์ž…๋ ฅ๊ธฐ๊ฐ€ ์—†๊ณ , ์„ค์น˜ํ•ด๋„ ์กฐํ•ฉ์„ ์ž๋™์œผ๋กœ ์น  ๋ฐฉ๋ฒ•์ด ์—†๋‹ค โ€” ํ•ฉ์„ฑ ํ‚ค ์ด๋ฒคํŠธ๋Š” ์ž…๋ ฅ๊ธฐ๋ฅผ ์ง€๋‚˜์ง€ ์•Š๊ณ  ์•ฑ์— ๋ฐ”๋กœ ๋„์ฐฉํ•œ๋‹ค(๊ทธ๊ฒƒ์ด ์ •ํ™•ํžˆ Lumide #64 ์˜ ๊ฒฐํ•จ ๊ฒฝ๋กœ๋‹ค) โ“‘ ํ‘œ๋ฉด์„ ๋„์šฐ๋ ค๋ฉด app/cocode ๊ฐ€ cocode_* ๋ฅผ ์˜์กดํ•ด์•ผ ํ•˜๊ณ  ๊ทธ ์ˆœ๊ฐ„ DD-02a ์™„๊ฒฐ์„ฑ ํ…Œ์ŠคํŠธ ์ถ• 2ยท3 ์ด ํ™œ์„ฑํ™”๋œ๋‹ค(D-064 Context โ€” ์…ธ ํ†ตํ•ฉ ์Šคํ† ๋ฆฌ ์†Œ๊ด€) โ“’ ์ด ์„ธ์…˜์˜ ์ธก์ • ํ™˜๊ฒฝ์€ macOS 1๋Œ€๋‹ค.
    • ์›Œํฌํ”Œ๋กœ์— branches: ํ•„ํ„ฐ๋ฅผ ๋‘์ง€ ์•Š์€ ์ด์œ : ๋‘๋ฉด storyโ†’epic PR ์—์„œ ๋Œ์ง€ ์•Š๋Š”๋‹ค(์‹ค์ธก: branches ์—†๋Š” ์›Œํฌํ”Œ๋กœ 8์ข…์ด ๊ณ„์ธต PR ์—์„œ ๋ˆ๋‹ค โ€” _golden_testยทclaudeยทcleanup-pr-cachesยทgolden-autofix-cleanupยทprobe.sandbox-limitsยทprobe.windows-atomic-replaceยทverify.cocode-pure-testsยทverify.linux-build).
    • codegen ์Šคํ…์„ ๋‘์ง€ ์•Š์€ ์ด์œ : cocode_* ํŒจํ‚ค์ง€๋Š” ์ƒ์„ฑ ์ฝ”๋“œ๋ฅผ ์“ฐ์ง€ ์•Š๋Š”๋‹ค(์‹ค์ธก part '*.g.dart' 0๊ฑด ยท ๋””์Šคํฌ *.g.dartยท*.freezed.dart 0๊ฑด). verify.linux-build.yaml ์ด codegen ์„ ๋„๋Š” ๊ฒƒ์€ ๋„๋„ˆ feature/** ๋•Œ๋ฌธ์ด๋‹ค.
  • Impact:
    • ์‹ ๊ทœ: .github/workflows/probe.ac16-ime-replay.yaml(3-OS ยท ๊ฒŒ์ดํŠธ ์•„๋‹˜ ยท required check ์•„๋‹˜) ยท docs/ac16-windows-linux-cocode.md(6์กฐํ•ฉ ํ‘œ).
    • AC-16 PENDING ยท A-04 Unverified ์œ ์ง€. 6์กฐํ•ฉ ์ „๋ถ€ ์ถœ์‹œ ์กฐ๊ฑด โŒ ๋ฏธ์ถฉ์กฑ.
    • ๋‚จ์€ ์ ˆ์ฐจ๋Š” ํ”Œ๋žซํผ๋‹น ์‚ฌ๋žŒ 1ํšŒ ์บก์ฒ˜(D-068 ์˜ onImePlatformValue ํƒญ + verify_ime_capture.py). diff ๊ฐ€ ๋‚˜์˜ค๋ฉด ๊ณ ์น˜๋Š” ์ชฝ์€ ์ฝ”ํผ์Šค๋‹ค.
    • โ›” ์™„ํ™” ๊ฒฝ๋กœ๋ฅผ ๋ฌธ์„œ์— ๋‹ซ์•˜๋‹ค โ€” ใ€Œ3-OS CI ์ดˆ๋ก์ด๋‹ˆ ์ถฉ๋ถ„ํ•˜๋‹คใ€ยทใ€ŒD-016 ์ด macOS ๋จผ์ €๋žฌ๋‹คใ€ยทใ€Œ์ž…๋ ฅ๊ธฐ๋Š” OS ๋ชซใ€ยทใ€ŒmacOS ๊ฐ€ ๋์œผ๋‹ˆ ๋‚˜๋จธ์ง€๋„ ๋  ๊ฒƒใ€ ๋„ค ๊ฐ€์ง€๊ฐ€ ์™œ ์„ฑ๋ฆฝํ•˜์ง€ ์•Š๋Š”์ง€๋ฅผ ยง4 ํ‘œ์— ์ ์—ˆ๋‹ค. ํŠนํžˆ ๋„ท์งธ: Windows IMM32 ์™€ macOS NSTextInputClient ๋Š” ์กฐํ•ฉ ๋ชจ๋ธ์ด ๋‹ค๋ฅด๋‹ค.
  • Source: #95 ์ธ์ˆ˜ ์กฐ๊ฑด 3์ข…. 3-OS ์‹คํ–‰ ๊ฒฐ๊ณผ๋Š” ์›Œํฌํ”Œ๋กœ ์•„ํ‹ฐํŒฉํŠธ(ac16-ime-replay-{Linux,macOS,Windows})์™€ job summary ๊ฐ€ ์ •๋ณธ์ด๋ฉฐ, ๋ฌธ์„œ๋Š” ๊ทธ๊ฒƒ์„ ์ธ์šฉํ•˜๊ณ  ์ˆ˜์น˜๋ฅผ ๋ณต์ œํ•˜์ง€ ์•Š๋Š”๋‹ค(๋ณต์ œํ•˜๋ฉด ๋‹ค์Œ ์‹คํ–‰์—์„œ ์กฐ์šฉํžˆ ๋‚ก๋Š”๋‹ค).

D-070: A-02 ์‹ค์ธก ์„ค๊ณ„ โ€” ํ‘œ๋ณธ ์ˆ˜๋Š” ๊ทœ์น™ ์œ ๋„ 96๊ฑด, โ“‘ ๊ท€์†์€ EditSnapshot, ํ•ฉ๊ฒฉ ๊ธฐ์ค€์€ ์‹ค์ธก ๋’ค. AC-09 ๊ตฌ๋ฉ๊ณผ โ‘ค ๋น„์œจ์€ ๋ฏธ๊ฒฐ ๊ตฌํ˜„ ๊ฒฐ์ •์— ๋‹ฌ๋ ธ๋‹ค (#96)

  • Date: 2026-09-14
  • Context: A-02 ๋Š” ์ด ๋ฌธ์„œ ์ง‘ํ•ฉ์—์„œ ๊ฐ€์žฅ ๋ถ€๋‹ด์ด ํฐ ๊ฐ€์ •์ด์ž C-04 ์ „ํ™˜ ์กฐํ•ญ์˜ ํ•ด์ œ ์กฐ๊ฑด์ด๋‹ค. ํ‘œ๋ณธ ์ˆ˜ยทํ•ฉ๊ฒฉ ๊ธฐ์ค€ยทโ“‘ ์ •์˜๊ฐ€ ์ „๋ถ€ ๋ฏธ์ •์ด๋ผ ์„ค๊ณ„๋ถ€ํ„ฐ ์‹œ์ž‘ํ•ด์•ผ ํ–ˆ๊ณ , "๋‚ด์ƒ์  ์‹คํŒจ ๋ชจ๋“œ๋Š” ์ œ3์ž ์ฃผ์ž… ๊ฒฐํ•จ์œผ๋กœ ์ธก์ •๋˜์ง€ ์•Š๋Š”๋‹ค" ๋Š” ๊ฒƒ์ด โ“/โ“‘ ๋ถ„๋ฆฌ์˜ ์ด์œ ๋‹ค.
  • Decision:
    • ํ‘œ๋ณธ ์ˆ˜: ํด๋ž˜์Šค๋‹น 96๊ฑด(โ“ 96 + โ“‘ 96). Wilson ์ •๊ทœ๊ทผ์‚ฌ ์—ญ์‚ฐ n โ‰ฅ zยฒp(1โˆ’p)/wยฒ ์—์„œ z=1.96ยท์ตœ์•… p=0.5ยทw=0.10 โ†’ 96.04. ๋ถˆ๊ฐ€ ์‹œ ํ•˜ํ•œ 43(w=0.15)์ด๋ฉฐ ๊ทธ ๊ท€๊ฒฐ์„ ํŒ์ •๊ณผ ํ•จ๊ป˜ ์ ๋Š”๋‹ค(๋ฐ˜ํญ ยฑ15%p ๋ฉด ๊ตฌ๊ฐ„์ด ๊ทธ๋Ÿด๋“ฏํ•œ ๊ธฐ์ค€ ๋Œ€๋ถ€๋ถ„์„ ๊ฐ€๋กœ์งˆ๋Ÿฌ ใ€Œ๊ธฐ์ค€์„ ๋„˜์—ˆ๋Š”๊ฐ€ใ€์— ๋‹ตํ•  ์ˆ˜ ์—†๋‹ค).
    • โ“‘ ใ€Œ์—์ด์ „ํŠธ๊ฐ€ ๋งŒ๋“  ๊ฒฐํ•จใ€ ์ •์˜(ํ™•์ •): B1 ๊ทธ ํŒŒ์ผ์ด ์ด ์ž‘์—…์˜ editedPaths ์— ์žˆ๋‹ค โˆง B2 EditSnapshot ์˜ pre ์ƒํƒœ์— ๊ฐ™์€ ๊ฒฐํ•จ์ด ์—†๋‹ค โˆง B3 โ“ ์ฃผ์ž… ๋Œ€์žฅ๊ณผ ์„œ๋กœ์†Œ.
    • ํ•ฉ๊ฒฉ ๊ธฐ์ค€: โธ๏ธ ๋ฏธ์ • โ€” ๊ฒฐ์ • ํ•„์š”(์˜ค๋„ˆ / ์‹œ์ : ์‹ค์ธก ๋ถ„ํฌ ์ดํ›„, D-020). โ“ยทโ“‘ ์˜ ๊ฒฐํ•ฉ ๊ทœ์น™๋„ ํ•จ๊ป˜ ์ •ํ•ด์•ผ ํ•˜๋ฉฐ ๊ทธ๊ฒƒ์ด ๋น ์ง€๊ธฐ ์‰ฌ์šด ์ž๋ฆฌ์ž„์„ ๋ช…์‹œ.
    • โ“‘ ์˜ค๋ผํด์€ ์—์ด์ „ํŠธ๊ฐ€ ๋Œ๋ฆฌ์ง€ ์•Š์€ ๋ณด๋ฅ˜ ๊ฒ€์‚ฌ(์ „๋Ÿ‰ ๋ถ„์„ + ์ „์ฒด ํ…Œ์ŠคํŠธ + ๋นŒ๋“œ)๋‹ค.
  • Rationale:
    • ํ‘œ๋ณธ ์ˆ˜๋Š” ์ง€์–ด๋‚ด์ง€ ์•Š๊ณ  ์—ญ์‚ฐํ–ˆ๋‹ค. PRD R-4 ๊ฐ€ ๊ธˆ์ง€ํ•œ ๊ฒฐํ•จ 30๊ฑดยท๊ฒ€์ถœ๋ฅ  80% ๋Š” ์ด ๋ฌธ์„œ ์–ด๋””์—๋„ ๋ชฉํ‘œ์น˜๋กœ๋„ ์ฐธ์กฐ์ ์œผ๋กœ๋„ ์“ฐ์ง€ ์•Š๋Š”๋‹ค. w ๋Š” ์ด ์„ค๊ณ„๊ฐ€ ๊ณ ๋ฅธ ๊ฐ’์ด์ง€๋งŒ ยซ๊ฒ€์ถœ๋ฅ ์„ ยฑ10%p ์•ˆ์—์„œ ๋งํ•  ์ˆ˜ ์žˆ์–ด์•ผ ๊ธฐ์ค€ ๋น„๊ต๊ฐ€ ์„ฑ๋ฆฝํ•œ๋‹คยป ๋Š” ์š”๊ตฌ์—์„œ ๋‚˜์™”๊ณ  ๋„“ํžˆ๋ฉด ๋ฌด์—‡์„ ์žƒ๋Š”์ง€๊ฐ€ ํ•จ๊ป˜ ์ ํ˜€ ์žˆ๋‹ค โ€” ๊ฐ’์ด ์•„๋‹ˆ๋ผ ๊ทœ์น™๊ณผ ๊ท€๊ฒฐ์„ ๊ณ ์ •ํ•œ ๊ฒƒ์ด๋ฉฐ D-033ยทD-044 ๊ฐ€ ๋ณด์กด ์ •์ฑ… ๊ฐ’์—์„œ ์“ด ๋ฐฉ์‹๊ณผ ๊ฐ™๋‹ค.
    • โ“‘ ๊ท€์†์— EditSnapshot ์„ ์“ฐ๋Š” ์ด์œ : C-02 ๊ฐ€ "EditSnapshot ์„ ๋‚จ๊ธฐ์ง€ ์•Š๋Š” ์—์ด์ „ํŠธ ํŽธ์ง‘ ๊ฒฝ๋กœ๋Š” ์กด์žฌํ•˜์ง€ ์•Š๋Š”๋‹ค" ๋ฅผ ๋ณด์žฅํ•˜๋ฏ€๋กœ ๋ชจ๋“  ํŽธ์ง‘์— pre ์ƒํƒœ๊ฐ€ ์žˆ๋‹ค โ€” ์ƒˆ ์ถ”์  ์žฅ์น˜๋ฅผ ๋งŒ๋“ค์ง€ ์•Š๊ณ  ์ด๋ฏธ ๋ถˆ๋ณ€์‹์ธ ๊ฒƒ์— ์–น๋Š”๋‹ค.
    • ใ€Œ๋“œ๋Ÿฌ๋‚ธ ๊ฒฐํ•จใ€(revealed)์„ 0 ์œผ๋กœ ์ ‘์ง€ ์•Š๋Š”๋‹ค. ์—์ด์ „ํŠธ ํŽธ์ง‘์ด ์ž ๋ณต ๋ฒ„๊ทธ๋ฅผ ๊นจ์šด ๊ฒฝ์šฐ๋Š” ์ฑ…์ž„ ๊ท€์†์ด ๋…ผ์Ÿ์ ์ด๋ผ ๋ณ„๋„ ์ง‘๊ณ„ํ•œ๋‹ค. ํ•œ์ชฝ์œผ๋กœ ์ ‘์œผ๋ฉด ๊ทธ ์„ ํƒ์ด ๊ฒ€์ถœ๋ฅ ์„ ์กฐ์šฉํžˆ ์›€์ง์ธ๋‹ค.
    • ๊ฒฐํ•จ ์นดํƒˆ๋กœ๊ทธ์— ใ€Œ์–ด๋А ๋ฐฉ๋ฒ•๋„ ๋ชป ์žก๋Š” ๊ฒฐํ•จใ€์„ ๋ฐ˜๋“œ์‹œ ๋„ฃ๋Š”๋‹ค. ์—†์œผ๋ฉด ๊ฒ€์ถœ๋ฅ ์ด ยซ์šฐ๋ฆฌ ๋ฐฉ๋ฒ•์ด ์žก๋„๋ก ๋งŒ๋“  ๊ฒฐํ•จ์„ ์šฐ๋ฆฌ ๋ฐฉ๋ฒ•์ด ์žก๋Š”๊ฐ€ยป ๋ผ๋Š” ๋™์–ด๋ฐ˜๋ณต์ด ๋œ๋‹ค.
  • Impact:
    • ๐Ÿ”ด ๊ฐ€์žฅ ํฐ ๋ฐœ๊ฒฌ โ€” AC-09 ๊ตฌ๋ฉ๊ณผ C-04 โ‘ค ๋น„์œจ์ด ยซ์•„์ง ์•ˆ ๋‚ด๋ฆฐ ๊ตฌํ˜„ ๊ฒฐ์ •ยป์— ๋‹ฌ๋ ธ๋‹ค. ์ฐธ์กฐ ์›Œํฌ์ŠคํŽ˜์ด์Šค 3,455 ์ž‘์—…(first-parent 180์ผ, D-044 ์™€ ๊ฐ™์€ ํ”„๋ก์‹œ)์—์„œ:

      #63 ์‹คํ–‰์ž ๋ฒ”์œ„ โ‘ฃ ๊ฐ€ ํŽธ์ง‘ ๊ฒ€์‚ฌ ๊ตฌ๋ฉ(AC-4) โ‘ค ๊ฐœ๋ฐฉ(AC-5)
      ์›Œํฌ์ŠคํŽ˜์ด์Šค ์ „์ฒด 73.6% 26.4% 0.0%
      ํŽธ์ง‘ ๋ฒ”์œ„๋กœ ํ•œ์ • 73.6% 3.7% 22.6%

      ๋‘ ๋น„์œจ์ด ์ •๋ฐ˜๋Œ€๋กœ ์›€์ง์ด๋ฏ€๋กœ ๋‹จ์ผ ๊ฐ’์œผ๋กœ ์ ์„ ์ˆ˜ ์—†๋‹ค โ€” ๋ฒ”์œ„๋กœ ์ ๋Š” ๊ฒƒ์ด ์ •ํ™•ํ•œ ๋ณด๊ณ ๋‹ค. ์‹คํ–‰์ž๋Š” ์•„์ง ์—†๋‹ค(์‹ค์ธก: implements VerificationMethodExecutor ๊ฐ€ ํ…Œ์ŠคํŠธ fake 1๊ฑด๋ฟ).

    • ๊ตฌ๋ฉ์˜ ๊ตฌ์กฐ๋ฅผ ์‚ฌ์œ  ์ฝ”๋“œ ํ‘œ๋กœ ํŠน์ •ํ–ˆ๋‹ค โ€” โ‘ build_no_configured_targetยทโ‘กtest_zero_collected ๋Š” ์›Œํฌ์ŠคํŽ˜์ด์Šค ์„ฑ์งˆ, โ‘ขno_debug_session ์€ ์„ธ์…˜ ์„ฑ์งˆ์ด๊ณ , โ‘ฃfile_not_analyzed ํ•˜๋‚˜๋งŒ ํŽธ์ง‘ ๊ฒฝ๋กœ์— ์˜์กดํ•œ๋‹ค. ๊ทธ๋ž˜์„œ โ‘ฃ๊ฐ€ ๋Œ€์ƒ์—†์Œ ์ธ๋ฐ โ‘ โ‘ก๊ฐ€ ํ†ต๊ณผ ๋ฉด ํŒ์ •์€ ํ†ต๊ณผ์ด๊ณ  ๊ทธ ํ†ต๊ณผ๋Š” ํŽธ์ง‘ํ•œ ํŒŒ์ผ์„ ์—ด์ง€ ์•Š์•˜๋‹ค. ์‹ค์ธก ์‚ฌ๋ก€: CI yaml ๋งŒยท๊ทœ์น™ ๋ฌธ์„œ๋งŒยท์•„์ด์ฝ˜ png ๋งŒ ๊ณ ์นœ ์ž‘์—…. ํŽธ์ง‘ ๋ฒ”์œ„๋กœ ์ขํ˜€๋„ 0 ์ด ๋˜์ง€ ์•Š๋Š”๋‹ค(3.7% โ€” ๋นŒ๋“œ ๊ตฌ์„ฑ๋งŒ ๊ณ ์นœ ์ž‘์—…).

    • ๊ทธ ์„ฑ์งˆ์„ a02_loophole_demonstration_test.dart(6๊ฑด)๋กœ ๊ณ ์ •ํ–ˆ๋‹ค. โš ๏ธ ๋ฒ„๊ทธ๋กœ ๊ณ ์น˜๋ฉด ์•ˆ ๋œ๋‹ค โ€” ๊ณ ์น˜๋Š” ๊ฒƒ์€ AC-09 ์˜ ๊ฐœ์ •์ด๋ฉฐ ๋ถˆ๋ณ€ ์ธต์œ„ ์‚ฌํ•ญ์ด๋‹ค. ์„ฑ์งˆ์ด ๋ฐ”๋€Œ๋ฉด ์ด ํ…Œ์ŠคํŠธ๊ฐ€ ๋จผ์ € ๊นจ์ง€๊ณ  ์„ค๊ณ„ ๋ฌธ์„œ๋„ ํ•จ๊ป˜ ๊ณ ์ณ์•ผ ํ•œ๋‹ค๋Š” ์‹ ํ˜ธ๊ฐ€ ๋œ๋‹ค. ๋Œ€์กฐ๊ตฐ(โ‘ฃ๊ฐ€ ์‹คํŒจ๋ฉด โ‘ โ‘ก๊ฐ€ ํ†ต๊ณผํ•ด๋„ ์ฐจ๋‹จ)์„ ํ•จ๊ป˜ ๋‘ฌ ใ€ŒํŒ์ •๊ธฐ๊ฐ€ ๋Š˜ ํ†ต๊ณผ๋ฅผ ๋‚ธ๋‹คใ€์™€ ๊ตฌ๋ถ„ํ–ˆ๋‹ค.

    • 26.4%/3.7% ๋Š” ๋…ธ์ถœ ยซ๋ฉด์ ยป ์ด์ง€ ๋ฐœ๋™๋ฅ ์ด ์•„๋‹ˆ๋‹ค โ€” ํ˜ผ๋™ํ•˜์ง€ ์•Š๋Š”๋‹ค. ๋ฐœ๋™์€ โ“ ์นดํƒˆ๋กœ๊ทธ์— โ‘ฃ๊ฐ€ ๋ณด์ง€ ์•Š๋Š” ํŒŒ์ผ์˜ ๊ฒฐํ•จ์„ ๋„ฃ์–ด ์‹ค์ œ๋กœ ์žฐ๋‹ค.

    • ์ „ํ™˜ ์กฐํ•ญ์˜ ๊ท€๊ฒฐ: A02VerificationState ๋„ค ๊ฐ’ ์ค‘ met ํ•˜๋‚˜๋งŒ ์ž๊ฐ€๊ฒ€์ฆ์„ ์—ด๊ณ , ํ˜„์žฌ๋Š” criteriaUnset ์ด๋‹ค. โš ๏ธ ์‹ค์ธก โ€” met ์„ ๊ตฌ์„ฑํ•˜๋Š” ์ฝ”๋“œ๊ฐ€ ๋ฆฌํฌ์— 0๊ฑด์ด๋ผ ์ง€๊ธˆ์€ ์–ด๋–ค ๊ฒฝ๋กœ๋กœ๋„ ์ž๊ฐ€๊ฒ€์ฆ ๊ธฐ๋ณธ๊ฐ’์ด ์—ด๋ฆฌ์ง€ ์•Š๋Š”๋‹ค.

    • ์ด ์„ค๊ณ„๊ฐ€ ๋ชป ์žฌ๋Š” ๊ฒƒ: ์˜ค๋ผํด์ด ๋ชป ์ฐพ๋Š” ๊ฒฐํ•จ์€ ๋ถ„๋ชจ์— ์—†๋‹ค(๊ฒ€์ถœ๋ฅ  ๊ณผ๋Œ€ ์ถ”์ •) ยท โ“‘ ํ‘œ๋ณธ์€ ๋งŒ๋“ค ์ˆ˜ ์—†์–ด ํšŒ์ฐจ๋ฅผ ๋‚˜๋ˆ ์•ผ ํ•œ๋‹ค ยท โ‘ข ์€ ๋””๋ฒ„๊ทธ ์„ธ์…˜์ด ์žˆ์–ด์•ผ ์žฐ๋‹ค ยท โ“/โ“‘ ๊ฒ€์ถœ๋ฅ ์˜ ์‹คํ–‰ ์ž์ฒด๋Š” #63 ์‹คํ–‰์ž ๊ตฌํ˜„ ์ดํ›„๋‹ค.

  • Source: #96 ์ธ์ˆ˜ ์กฐ๊ฑด 6์ข…. ์‹ค์ธก์€ ์ด ์›ŒํฌํŠธ๋ฆฌ(2026-09-14) โ€” unibook @ 9db9015 first-parent 180์ผ 3,455 ์ž‘์—…, ๋ถ„๋ฅ˜ ๊ทœ์น™์€ docs/verification-no-target-cocode.md ยง5 ํ์‡„ 5์ข… ์‚ฌ์œ  ์ฝ”๋“œ(D-053).

D-071: A-06 ใ€Œ์„ค์น˜ ์šฉ๋Ÿ‰ใ€์€ ๋‘ ์ •์˜๋กœ ์žฐ๋‹ค โ€” ๋‘ ๊ฐ’์ด ์ฐธ์กฐ์ ์˜ ๋ฐ˜๋Œ€ํŽธ์— ๋–จ์–ด์ง„๋‹ค. ๋ชฉํ‘œ์น˜๋Š” ์„ธ์šฐ์ง€ ์•Š๋Š”๋‹ค (#97)

  • Date: 2026-09-14
  • Context: A-06 ์€ ๋ชฉํ‘œ์น˜๊ฐ€ ๋ฏธํ™•์ •์ด๊ณ  ์ฐธ์กฐ์ ์€ Lumide 0.20.0 ์˜ ์„ค์น˜ 55.8MB ํ•˜๋‚˜๋ฟ์ธ๋ฐ ์› ๊ธฐ์žฌ์— ๋ฌด์—‡์„ ์žฐ ๊ฐ’์ธ์ง€๊ฐ€ ์—†๋‹ค(planning-inputs ยง6). ์ฝœ๋“œ ์Šคํƒ€ํŠธยท๋ฉ”๋ชจ๋ฆฌ์—๋Š” ์ฐธ์กฐ์ ์ด ์•„์˜ˆ ์—†๋‹ค. ๊ทธ ์ƒํƒœ๋กœ๋Š” ์–ด๋–ค ์‹ค์ธก์น˜๋„ ํ•ด์„๋˜์ง€ ์•Š๋Š”๋‹ค.
  • Decision: ใ€Œ์„ค์น˜ ์šฉ๋Ÿ‰ใ€์„ A ๋ฐฐํฌ ์•„์นด์ด๋ธŒ / B ์„ค์น˜ ํ›„ ๋””์Šคํฌ ์ ์œ  ๋‘˜๋กœ ๋‚˜๋ˆ  ๋‘˜ ๋‹ค ์žฌ๊ณ , ๋น„๊ตํ•  ๋•Œ ์–ด๋А ์ •์˜์ธ์ง€ ๋ฐ˜๋“œ์‹œ ๋ฐํžŒ๋‹ค. ์ธก์ • ๋Œ€์ƒ์€ app/cocode ๊ฐ€ ์•„๋‹ˆ๋ผ ์ฒ˜์Œ๋ถ€ํ„ฐ ๋งŒ๋“  ์ตœ์†Œ ์…ธ 3์ธต(bare / bare+agent / bare+shell)์ด๋‹ค. ๋ชฉํ‘œ์น˜๋Š” ์„ธ์šฐ์ง€ ์•Š๋Š”๋‹ค.
  • Rationale:
    • ๐Ÿ”ด ์ •์˜๋ฅผ ๋‚˜๋ˆˆ ๊ฒƒ์ด ์‹ค์ธก์œผ๋กœ ์ •๋‹นํ™”๋๋‹ค. ์ตœ์†Œ ์…ธ์€ ์ •์˜ A ๋กœ 25.7 MB(โˆ’54%), ์ •์˜ B ๋กœ 61.1 MB(+9.5%) ๋‹ค โ€” ๊ฐ™์€ ์•ฑ์— ๋Œ€ํ•ด ใ€Œ์ ˆ๋ฐ˜๋„ ์•ˆ ๋œ๋‹คใ€์™€ ใ€Œ์ด๋ฏธ ๋„˜์—ˆ๋‹คใ€๊ฐ€ ๋™์‹œ์— ์„ฑ๋ฆฝํ•œ๋‹ค. ์ •์˜ ์—†์ด 55.8MB ์™€ ๋น„๊ตํ•˜๋Š” ๋ฌธ์žฅ์€ ์–ด๋А ์ชฝ์œผ๋กœ๋„ ์“ธ ์ˆ˜ ์žˆ์–ด ๊ทผ๊ฑฐ๊ฐ€ ๋˜์ง€ ๋ชปํ•œ๋‹ค. (55.8MB ์ž์ฒด๋„ MB/MiB ๋ถˆ๋ช…์ด๋ผ ๋ฐ”์ดํŠธ๋ฅผ ๋ณ‘๊ธฐํ•œ๋‹ค.)
    • app/cocode ๋ฅผ ์žฌ์ง€ ์•Š๋Š” ์ด์œ : ๋„๋„ˆ์—์„œ ํ†ต์งธ๋กœ ์˜จ ์•ฑ์ด๋ผ cocode ADE ๊ฐ€ ์“ฐ์ง€ ์•Š๋Š” ์˜์กด์ด ๋ถ™์–ด ์žˆ๊ณ (#8 ์ •๋ฆฌ ๋Œ€์ƒ), ์žฌ๋ฉด ๋„๋„ˆ์˜ ๋น„์šฉ์„ ์žฌ๊ฒŒ ๋œ๋‹ค.
    • ์ธต์„ ๋‚˜๋ˆˆ ์ด์œ : ํ•œ ์ˆ˜๋Š” ํ•ด์„ํ•  ์ˆ˜ ์—†๋‹ค. ์ธต๋ณ„ ํ•œ๊ณ„๋น„์šฉ์ด ๋‚˜์™€์•ผ ใ€Œ๋ฌด์—‡์„ ์ค„์ด๋ฉด ์–ผ๋งˆ๊ฐ€ ์ฃผ๋Š”๊ฐ€ใ€๊ฐ€ ๋ณด์ธ๋‹ค.
    • ํšŒ์ฐจ๋ณ„ ๊ฐ’์„ ํ‰๊ท ์œผ๋กœ ์ ‘์ง€ ์•Š๋Š” ์ด์œ : ์ฒซ ํšŒ์ฐจ๋งŒ ์ง„์งœ ์ฝœ๋“œ๋‹ค(OS ํŽ˜์ด์ง€ ์บ์‹œยทdyld ๊ณต์œ  ์บ์‹œ). ์‹ค์ธก 905 ms vs 189 ms โ€” ์•ฝ 4.8๋ฐฐ. ํ‰๊ท ์„ ๋‚ด๋ฉด ๊ทธ ์ฐจ์ด๊ฐ€ ์‚ฌ๋ผ์ง€๋Š”๋ฐ ์‚ฌ์šฉ์ž๊ฐ€ ๊ฒช๋Š” ๊ฒƒ์€ ๋‘˜ ๋‹ค๋‹ค.
  • Impact:
    • ์‹ค์ธก(macOS 26.5.2 arm64, release AOT, Flutter 3.47.3):

      ์ธต A ์•„์นด์ด๋ธŒ B ๋””์Šคํฌ ์ฒซ ํ”„๋ ˆ์ž„ ์ฝœ๋“œ/์›Œ์—„ ์œ ํœด RSS
      bare 15,613,322 B (14.89 MiB) 38,047,744 B (36.29 MiB) 905 / 189 ms ~105 MiB
      bare+agent +926 B +0 B 914 / 175 ms ~106 MiB
      bare+shell +9.62 MiB โ†’ 24.51 MiB +22.00 MiB โ†’ 58.29 MiB 967 / 186 ms ~109 MiB
    • ๋น„์šฉ์€ Flutter ์—”์ง„ ๋ฐ”๋‹ฅ์—์„œ ์˜จ๋‹ค. ์ฝœ๋“œ ์Šคํƒ€ํŠธ๋Š” ์ตœ์†Œ ์…ธ์ด ๋ฐ”๋‹ฅ ๋Œ€๋น„ +62 ms(์ฝœ๋“œ)ยท์›Œ์—„์€ ์ฐจ์ด ์—†์Œ, ์œ ํœด ๋ฉ”๋ชจ๋ฆฌ๋Š” +3 MiB. ์ฆ‰ ๊ทธ ๋‘ ์ถ•์€ ์šฐ๋ฆฌ๊ฐ€ ์ค„์ผ ์ˆ˜ ์žˆ๋Š” ๊ฒƒ์ด ์•„๋‹ˆ๋‹ค โ€” ์ค„์ผ ์—ฌ์ง€๋Š” ์„ค์น˜ ์šฉ๋Ÿ‰ ํ•˜๋‚˜์ด๊ณ  ๊ทธ๋งˆ์ € ์ ˆ๋ฐ˜ ์ด์ƒ์ด ์—”์ง„์ด๋‹ค.

    • โš ๏ธ +926 B ๋ฅผ ใ€Œ๋Ÿฐํƒ€์ž„์ด ๊ณต์งœใ€๋กœ ์ฝ์ง€ ์•Š๋Š”๋‹ค. AOT ํŠธ๋ฆฌ ์…ฐ์ดํ‚น์€ ์ง„์ž…์ ์—์„œ ๋„๋‹ฌ ๊ฐ€๋Šฅํ•œ ์ฝ”๋“œ๋งŒ ๋‚จ๊ธฐ๋ฏ€๋กœ, ์žฐ ๊ฒƒ์€ ํŒจํ‚ค์ง€ ํฌ๊ธฐ๊ฐ€ ์•„๋‹ˆ๋ผ ๊ทธ ์ง„์ž…์ ์ด ๋‹ฟ๋Š” ๋ถ€๋ถ„์ด๋‹ค. ๊ฐ™์€ ์ด์œ ๋กœ bare+shell ์€ ์‹ฌ๋ณผ ์ฐธ์กฐ๊ฐ€ ์•„๋‹ˆ๋ผ CocodeEditorView ๋ฅผ ์‹ค์ œ๋กœ ๋งˆ์šดํŠธํ•ด ์žฐ๋‹ค.

    • ๋ชฉํ‘œ์น˜๋ฅผ ์„ธ์šฐ์ง€ ์•Š๋Š”๋‹ค โ€” ๊ทธ๋ฆฌ๊ณ  ๊ทธ๊ฒƒ์ด ์ถœ์‹œ๋ฅผ ๋ง‰์ง€ ์•Š๋Š”๋‹ค. PRD NFR-D ์š”์•ฝํ‘œ Dํ–‰์ด ์ด ์ง€ํ‘œ๊ตฐ์— ใ€Œ๋Œ€์‘ AC ์—†์Œใ€ ์„ ๋ช…์‹œํ•œ๋‹ค. ํ๊ธฐ๊ฐ’(์„ค์น˜ 150MBยท์ฝœ๋“œ ์Šคํƒ€ํŠธ 2์ดˆยท์œ ํœด ๋ฉ”๋ชจ๋ฆฌ 400MB, D-013)์€ ๋ชฉํ‘œ์น˜๋กœ๋„ ์ฐธ์กฐ์ ์œผ๋กœ๋„ ์ ์ง€ ์•Š์œผ๋ฉฐ, ์‹ค์ธก์น˜๊ฐ€ ๊ทธ์™€ ์šฐ์—ฐํžˆ ๊ฐ€๊น๋”๋ผ๋„ ๋น„๊ต ๋ฌธ์žฅ์„ ๋งŒ๋“ค์ง€ ์•Š๋Š”๋‹ค. Lumide 55.8MB ๋Š” ํ•˜ํ•œ ์ฐธ์กฐ์ ์ด์ง€ ๋ชฉํ‘œ๊ฐ€ ์•„๋‹ˆ๋‹ค.

    • โž– ๋ชป ์žฐ ๊ฒƒ: WindowsยทLinux(์ธก์ • ํ™˜๊ฒฝ์ด macOS 1๋Œ€ โ€” ๋‘ ์ •์˜ ๋ชจ๋‘ ํ”Œ๋žซํผ๋งˆ๋‹ค ๋‹ค๋ฅด๋ฏ€๋กœ ์Šน๊ณ„ํ•˜์ง€ ์•Š๋Š”๋‹ค) ยท ์„ค์น˜ ๊ด€๋ฆฌ์ž(.dmg/MSIX/AppImage) ๊ฒฝ์œ ์˜ ์‹ค์ œ ์„ค์น˜ ์šฉ๋Ÿ‰(#11 ์†Œ๊ด€) ยท ์™„์„ฑ๋œ ์…ธ์˜ ๊ฐ’.

    • ์Šคํฌ๋ฆฝํŠธ ๋ถ€์‚ฐ๋ฌผ: ์›Œํฌ์ŠคํŽ˜์ด์Šค ๋ฐ– ์ธก์ •์„ ์œ„ํ•ด ๋ฃจํŠธ dependency_overrides ๋ฅผ ํ†ต์งธ๋กœ ์˜ฎ๊ธด๋‹ค โ€” coui ํ•ญ๋ชฉ๋งŒ ๊ณ ๋ฅด๋ฉด file_picker ^12.2.0 โ†” syntax_highlight >=0.5.0 ์ถฉ๋Œ๋กœ ํ•ด์„์ด ๊นจ์ง„๋‹ค(์‹ค์ธก). ๋ฐ˜๋Œ€๋กœ coui ๋ฅผ ์“ฐ์ง€ ์•Š๋Š” ์ธต์— ๋ถ™์ด๋ฉด ์“ฐ์ง€๋„ ์•Š๋Š” ๊ทธ๋ž˜ํ”„๋ฅผ ํ•ด์„ํ•˜๋‹ค ๊ฐ™์€ ์ถฉ๋Œ๋กœ ์‹คํŒจํ•œ๋‹ค(์‹ค์ธก) โ€” ๊ทธ๋ž˜์„œ ํ•„์š”ํ•œ ์ธต์—๋งŒ ๋ถ™์ธ๋‹ค.

  • Source: #97 ์ธ์ˆ˜ ์กฐ๊ฑด 5์ข…. ์‹ค์ธก์€ ์ด ์›ŒํฌํŠธ๋ฆฌ(2026-09-14).

D-072: Must-Not 3์ข…์˜ ๋ถ€์žฌ ์ฆ๋ช…์€ ์‹๋ณ„์ž ์Šค์บ” ๊ฐ€๋“œ๋กœ ํ•œ๋‹ค ยท BDD ์˜ ํ•ด์†Œ๋œ ๋ณด๋ฅ˜ ํ‘œ๊ธฐ๋ฅผ ๊ฑท๊ณ  ์„ธ ๊ณณ์˜ ์ˆ˜๋ฅผ ๋งž์ถ˜๋‹ค (#98)

  • Date: 2026-09-14
  • Context: Seed Spec ยง4 ์˜ Must-Not ์€ "โ€ฆ๋Š” ์กด์žฌํ•˜์ง€ ์•Š๋Š”๋‹ค" ํ˜•ํƒœ์ธ๋ฐ ๋ถ€์žฌ๋ฅผ ์–ด๋–ป๊ฒŒ ๊ด€์ฐฐํ•˜๋Š”์ง€๊ฐ€ ์ •ํ•ด์ ธ ์žˆ์ง€ ์•Š์•˜๋‹ค(BDD U-12 โ€” ๊ทธ๋‚˜๋งˆ AC-04ยทAC-05 ๋งŒ ๋‹ค๋ฃจ๊ณ  AC-21 ์€ U-12 ์— ๋“ค์–ด ์žˆ์ง€๋„ ์•Š๋‹ค. v3.1.0 ์‹ ์„ค์ด๋ผ U-12 ๋ณด๋‹ค ๋Šฆ๋‹ค). ๋™์‹œ์— BDD ๋Š” v3.1.0ยทarchitecture ๊ฐœ์ •์œผ๋กœ ์ด๋ฏธ ํ•ด์†Œ๋œ ํ•ญ๋ชฉ์„ ์•„์ง ใ€ŒํŒ์ • ๋ณด๋ฅ˜ใ€๋กœ ๋ฌถ๊ณ  ์žˆ์—ˆ๊ณ , ๊ฐ™์€ ๋Œ€์ƒ์„ ์„ธ๋Š” ์ˆ˜๊ฐ€ ์„ธ ๊ณณ์—์„œ ๋‹ฌ๋ž๋‹ค.
  • Decision:
    • ๊ด€์ฐฐ ๋ฐฉ๋ฒ•: .github/scripts/check_mvp_scope_must_not.py โ€” cocode ADE ์ž์‹ ์˜ ์†Œ์Šค(package/cocode_*/lib|bin, app/cocode ๊ฐ€ core ๋ฅผ ์˜์กดํ•˜๊ธฐ ์‹œ์ž‘ํ•˜๋ฉด app/cocode/lib)์—์„œ ์„ธ Must-Not ์„ ๊ฐ€๋ฆฌํ‚ค๋Š” ์‹๋ณ„์ž์˜ ๋ถ€์žฌ๋ฅผ ํ™•์ธํ•œ๋‹ค. AC-21 ์˜ ๊ด€์ฐฐ ๋ฐฉ๋ฒ•์€ #98 ์ด ์ƒˆ๋กœ ์ •ํ•œ ๊ฒƒ์ด๋‹ค.
    • BDD ์ •์ •: U-7ยทU-8ยทU-9ยทU-10ยทU-12 ์˜ ใ€Œ๋ฏธ์ •ยทํŒ์ • ๋ณด๋ฅ˜ใ€ ํ‘œ๊ธฐ๋ฅผ ๊ฑท๊ณ , AC-21 ์‹œ๋‚˜๋ฆฌ์˜ค 2๊ฑด์„ ์‹ ์„คํ•˜๋ฉฐ, ยง0.4 ์†์„ฑ ๋ชฉ๋ก์— result_content_hash ๋ฅผ ๋”ํ•˜๊ณ , ์„ธ ๊ณณ์˜ ์ˆ˜๊ฐ€ ๊ฐ๊ฐ ๋ฌด์—‡์„ ์„ธ๋Š”์ง€ ๋ช…์‹œํ•œ๋‹ค.
  • Rationale:
    • ๋ถ€์žฌ๋Š” ์ปดํŒŒ์ผ๋กœ๋„ ๋Ÿฐํƒ€์ž„์œผ๋กœ๋„ ์ฆ๋ช…๋˜์ง€ ์•Š๋Š”๋‹ค โ€” ์—†๋Š” ๊ฒƒ์€ ์ฐธ์กฐํ•  ์ˆ˜ ์—†์–ด ํƒ€์ž… ์‹œ์Šคํ…œ์ด ๋ณผ ๋Œ€์ƒ์ด ์—†๊ณ , ์—†๋Š” ํ™”๋ฉด์€ ๋„์šธ ์ˆ˜ ์—†๋‹ค. ๋‚จ๋Š” ๊ด€์ฐฐ์€ ์†Œ์Šค ํ‘œ๋ฉด์— ๊ทธ ๊ฐœ๋…์ด ๋“ฑ์žฅํ•˜์ง€ ์•Š์Œ์ด๋ฉฐ ์ด ๋ฆฌํฌ๊ฐ€ check_window_api_seal.py(C7)ยทcheck_flutter_bloc_residue.py ์—์„œ ์ด๋ฏธ ์“ฐ๋Š” ๋ฐฉ์‹์ด๋‹ค.
    • โš ๏ธ ํ•œ๊ณ„๋ฅผ ๊ฐ€๋“œ ์•ˆ์— ์ ์—ˆ๋‹ค: ใ€Œ๊ทธ ์ด๋ฆ„์œผ๋กœ ๋“ค์–ด์˜ค๋Š” ๊ฒƒใ€๋งŒ ๋ง‰๋Š”๋‹ค. ๋‹ค๋ฅธ ์ด๋ฆ„์˜ ๊ฐ™์€ ๊ธฐ๋Šฅ์€ ์žก์ง€ ๋ชปํ•˜๋ฏ€๋กœ ์œ ์ผํ•œ ๋ฐฉ์–ด๊ฐ€ ์•„๋‹ˆ๋ผ ์žฌ์œ ์ž… ๊ฒฝ๋ณด์ด๊ณ  ๋ฒ”์œ„ ํŒ์ • ์ž์ฒด๋Š” ์‚ฌ๋žŒ์˜ ๋ฆฌ๋ทฐ๊ฐ€ ํ•œ๋‹ค.
    • โ›” AC-12 ๋ฅผ ์žก์ง€ ์•Š๋„๋ก ํŒจํ„ด์„ ์ขํ˜”๋‹ค. AC-21 ๋ณธ๋ฌธ์ด "ํ•œ ์›Œํฌ์ŠคํŽ˜์ด์Šค ์•ˆ์—์„œ ๋ณต์ˆ˜ DelegatedTask ๋ฅผ ๋™์‹œ ์ง„ํ–‰ํ•˜๊ณ  ํŒŒ์ผ ๋‹จ์œ„๋กœ ์ž ๊ทธ๋Š” AC-12 ๋Š” ์ด ์ œํ•œ๊ณผ ๋ฌด๊ด€ํ•˜๋‹ค" ๋กœ ๋ช…์‹œํ•œ๋‹ค. ๊ทธ๋ž˜์„œ edit_locksยท์ž ๊ธˆ ํยท๋™์‹œ ์ž‘์—… ์‹๋ณ„์ž๋Š” ํŒจํ„ด์— ๋„ฃ์ง€ ์•Š๊ณ , ์˜คํƒ ๊ธˆ์ง€๋ฅผ ํšŒ๊ท€ ํ…Œ์ŠคํŠธ๋กœ ๊ณ ์ •ํ–ˆ๋‹ค(๊ทธ ๊ฒฝ๊ณ„๊ฐ€ ๊นจ์ง€๋ฉด ์ •์ƒ ๊ธฐ๋Šฅ์ด ๋ฒ”์œ„ ์œ„๋ฐ˜์œผ๋กœ ๋ณด๊ณ ๋œ๋‹ค).
    • โญ ๋ถ€์žฌ ๊ฐ€๋“œ๋Š” ์•„๋ฌด๊ฒƒ๋„ ์—†์„ ๋•Œ ํ†ต๊ณผํ•œ๋‹ค โ€” ํŒจํ„ด์ด ์˜คํƒ€๋กœ ๊นจ์ ธ๋„, ์Šค์บ” ๊ฒฝ๋กœ๊ฐ€ ์–ด๊ธ‹๋‚˜๋„, ๊ทœ์น™์ด ํ†ต์งธ๋กœ ๋น ์ ธ๋„ ๋˜‘๊ฐ™์ด ์ดˆ๋ก๋ถˆ์ด๋‹ค. ์‹คํ–‰๋˜์ง€ ์•Š๋Š” ๊ฐ€๋“œ๊ฐ€ ๊ฐ€๋“œ๊ฐ€ ์•„๋‹ˆ๋“ฏ ๋ฐœ๋™ํ•˜์ง€ ์•Š๋Š” ๊ฐ€๋“œ๋„ ๊ฐ€๋“œ๊ฐ€ ์•„๋‹ˆ๋‹ค. ๊ทธ๋ž˜์„œ ์œ„๋ฐ˜ ํ”ฝ์Šค์ฒ˜ 8์ข…์˜ ๋ฐœ๋™์„ ํ•จ๊ป˜ ๊ณ ์ •ํ–ˆ๊ณ , ๊ทธ ํ…Œ์ŠคํŠธ๊ฐ€ ์‹ค์ œ๋กœ ๊ตฌ๋ฉ์„ ์žก์•˜๋‹ค โ€” ์ดˆํŒ์˜ \bdreamer\b ๋Š” DreamerModeController ๋ฅผ ๋†“์ณค๋‹ค(Dreamer ์™€ Mode ์‚ฌ์ด์— ๋‹จ์–ด ๊ฒฝ๊ณ„๊ฐ€ ์—†๋‹ค). ๊ฐ€์žฅ ํ”ํ•œ ํ˜•ํƒœ๋ฅผ ๋ชป ์žก๋Š” ๊ฐ€๋“œ์˜€๋‹ค.
    • ์ˆ˜ ์„ธ ๊ฐœ๊ฐ€ ์„œ๋กœ ๋‹ค๋ฅธ ๊ฒƒ์„ ์„ธ๊ณ  ์žˆ์—ˆ๋‹ค: ยง2 ๋Œ€์‘ํ‘œ์˜ 4๊ฑด = AC-02 ์‹œ๋‚˜๋ฆฌ์˜ค ์ด์ˆ˜(๋งž๋‹ค) ยท ยง3 ์•ˆ์ „ ์ž„๊ณ„ํ‘œ์˜ 2๊ฑด = ๊ทธ์ค‘ ์ถฉ๋Œ ํŒ์ •์— ๊ฑธ๋ฆฌ๋Š” ๋ถ€๋ถ„์ง‘ํ•ฉ(๋งž๋‹ค) ยท U-10 ํ–‰๊ณผ ยง3-5 ์˜ ใ€Œ3๊ฑดใ€ = ๋ฌด์—‡์„ ์„ธ๋Š”์ง€ ๊ทผ๊ฑฐ๊ฐ€ ์—†์—ˆ๋‹ค. U-10 ์ด ํ•ด์†Œ๋˜์–ด ๋ณด๋ฅ˜ ์‹œ๋‚˜๋ฆฌ์˜ค๊ฐ€ 0๊ฑด์ด ๋œ ์ง€๊ธˆ ๊ทธ ์ˆ˜๋Š” ํ๊ธฐํ•œ๋‹ค โ€” ์ด์ˆ˜๋ฅผ ์Šน๊ณ„์‹œํ‚ค์ง€ ์•Š๋Š”๋‹ค(#98 ์ธ์ˆ˜์กฐ๊ฑด 5๊ฐ€ ๊ทธ ์ „์ œ๋ฅผ ๋‘์ง€ ๋ง๋ผ๊ณ  ๋ช…์‹œํ•œ๋‹ค).
  • Impact:
    • ์‹ ๊ทœ: check_mvp_scope_must_not.py + test_check_mvp_scope_must_not.py(๋ฐœ๋™ 8 ยท ์˜คํƒ 6 ยท ์Šค์บ” ๊ฒฝ๋กœ 1 ยท ๋ฆฌํฌ ์ „์ˆ˜ 1), ci.yml changes ์žก ๋ฐฐ์„ .
    • BDD AC ์ปค๋ฒ„๋ฆฌ์ง€๊ฐ€ AC-01~AC-20 โ†’ AC-01~AC-21 ๋กœ ๋„“์–ด์กŒ๋‹ค. breakdown-cocode.md:425 ๊ฐ€ "์—ญ๋ฐฉํ–ฅ ๊ณ ์•„(์‹œ๋‚˜๋ฆฌ์˜ค๊ฐ€ ์—†๋Š” AC) 1๊ฑด โ€” ์ด์ชฝ์ด ๋” ์‹ฌ๊ฐํ•˜๋‹ค" ๋กœ ๊ธฐ๋กํ•œ ๊ทธ ๊ณต๋ฐฑ์ด ๋‹ซํ˜”๋‹ค(๋Œ€์‘ํ‘œ ์„œ๋ฌธ์ด ๋ฒ”์œ„๋ฅผ AC-20 ๊นŒ์ง€๋กœ ์ ์–ด AC-21 ์„ ์• ์ดˆ์— ๋ฐฐ์ œํ•˜๊ณ  ์žˆ์—ˆ๋‹ค).
    • ยง0.4 ์†์„ฑ ๋ชฉ๋ก์— result_content_hash ์ถ”๊ฐ€ โ€” v3.1.0 โ‘  ์ด ์‹ ์„คํ–ˆ๋Š”๋ฐ ๋ชฉ๋ก์—์„œ ๋น ์ ธ ์žˆ์—ˆ๋‹ค. ๋น ์ง„ ์ฑ„๋กœ ๋‘๋ฉด ์‹œ๋‚˜๋ฆฌ์˜ค๊ฐ€ base_content_hash ๋งŒ ๋ณด๊ณ  ใ€Œ๋ชจ๋“  ๋กค๋ฐฑ์ด ์ถฉ๋Œใ€์ด๋ผ๋Š” v3.1.0 ์ด ๊ณ ์นœ ๋ฐ”๋กœ ๊ทธ ๋ฒ„๊ทธ๋กœ ๋˜๋Œ์•„๊ฐ„๋‹ค.
    • ํ•ด์†Œ ํ‘œ๊ธฐ๋ฅผ ๊ฑด ๋‹ค์„ฏ ํ•ญ๋ชฉ: U-7(v3.1.0 โ‘ก ๊ฒฝ๋กœ ๊ธฐ๋ฐ˜) ยท U-8(D-053 ํ์‡„ 5์ข…) ยท U-9(architecture ยง6.2 DD-22 / D-060 โ€” ์‹ ํ˜ธ S1ยทS2, ํŒ์ • ๋ฌด๊ฐœ์ž…) ยท U-10(v3.1.0 โ‘  result_content_hash) ยท U-12(์ด ๊ฒฐ์ •). ๊ทธ ๊ฒฐ๊ณผ Feature 5 ์ „์ฒด ยท AC-09 โ‘ค ยท AC-20 ยท AC-02 ยท AC-04ยทAC-05ยทAC-21 ์ด ํŒ์ • ๊ฐ€๋Šฅํ•ด์กŒ๋‹ค.
    • โธ๏ธ ๋‚จ์€ ๋ฏธ์ •๋„ ์ •ํ™•ํžˆ ์ ์—ˆ๋‹ค: U-1(์‹œ๊ฐ„ ์ƒํ•œ ๊ธฐ๋ณธ๊ฐ’) ยท U-2(ํ”„๋ ˆ์ž„ ํƒ€์ž„ ๋ชฉํ‘œ์น˜ โ€” #91 ์ด ๊ทœ์น™ ํ™•์ •, ๊ฐ’์€ ์˜ค๋„ˆ) ยท U-3(#91 ์ด 9db9015 ๋กœ ๊ณ ์ • โ€” ์‚ฌ์‹ค์ƒ ํ•ด์†Œ) ยท U-4(#96 ์ด ํ‘œ๋ณธ ์ˆ˜ยทโ“‘ ์ •์˜ ํ™•์ •, ํ•ฉ๊ฒฉ ๊ธฐ์ค€์€ ์˜ค๋„ˆ) ยท U-5(D-050 ํ•ด์†Œ) ยท U-6(#93 ํ™•์ •) ยท U-11.
    • โš ๏ธ U-9 ์˜ ์œ ํœด ์ƒํ•œ ยซ๊ฐ’ยป ์€ ์—ฌ์ „ํžˆ ๋ฏธ์ •์ด๋‹ค(U-1 ๊ณผ ๊ฐ™์€ ํ•ญ๋ชฉ) โ€” ๊ฐ์ง€ ๊ธฐ์ค€์ด ์ •ํ•ด์ง„ ๊ฒƒ๊ณผ ํ˜ผ๋™ํ•˜์ง€ ์•Š๋Š”๋‹ค.
  • Source: #98 ์ธ์ˆ˜ ์กฐ๊ฑด 6์ข…. ๊ฐ€๋“œ ์‹ค์ธก: ํŒ์ • ๋Œ€์ƒ 142๊ฐœ ํŒŒ์ผ์— ์œ„๋ฐ˜ 0๊ฑด.

D-073: Q-08 ์ข…๊ฒฐ โ€” โ“ ์žฌ๋ฐฐํฌ ์•„ํ‹ฐํŒฉํŠธ์— SSPL-1.0 ์ฝ”์–ด๋ฅผ ํฌํ•จํ•˜์ง€ ์•Š๋Š”๋‹ค. ๊ทผ๊ฑฐ๋Š” ใ€Œ์ œ๊ฑฐใ€๊ฐ€ ์•„๋‹ˆ๋ผ ํŒจํ‚ค์ง• ๊ฒฝ๊ณ„ ์ฆ๋ช… (#99)

  • Date: 2026-09-14
  • Context: PRD Q-08(prd-cocode.md:249) โ€” "Serverpod 4 ์ž„๋ฒ ๋“œ/์žฌ๋ฐฐํฌ ๊ณ„ํš ์œ ๋ฌด ๋ฐ SSPL-1.0 ๋ฒ•๋ฌด ๊ฒ€ํ† ". Discovery ยงRecommendations 5๋ฒˆ์ด "๊ณ„ํš์ด ์žˆ๋‹ค๋ฉด ์‚ฌ์ „ ๋ฒ•๋ฌด ๊ฒ€ํ†  ํ•„์š”" ๋กœ ์กฐ๊ฑด๋ถ€ ์ œ๊ธฐํ–ˆ๊ณ  ๊ณ„ํš ์œ ๋ฌด ์ž์ฒด๊ฐ€ ๋ฏธํ™•์ •์ด์—ˆ๋‹ค. ์›๋ž˜ ์ด Story ๋Š” โ“‘(backend/cocode_server ์กด์น˜ ์—ฌ๋ถ€)์˜ ๋‹ต์ด ใ€Œ์ œ๊ฑฐใ€์ด๋ฉด SSPL ๋…ธ์ถœ๋ฉด์ด ์‚ฌ๋ผ์ ธ ๋ฒ•๋ฌด ๊ฒ€ํ† ๋ฅผ ์ƒ๋žตํ•  ์ˆ˜ ์žˆ๋Š” ๊ฒฝ๋กœ๋ฅผ ์—ด์–ด ๋’€์œผ๋‚˜, 2026-08-27 D-026(#102)์ด ์กด์น˜๋ฅผ ํ™•์ •ํ•˜๋ฉฐ ๊ทธ ๊ฒฝ๋กœ๊ฐ€ ๋‹ซํ˜”๋‹ค. ๋™์‹œ์— ๋ฆฌํฌ์—๋Š” ์ œ3์ž OSS ๊ณ ์ง€ ํ‘œ๋ฉด์ด ์ „๋ฌดํ–ˆ๋‹ค(๋ฃจํŠธ LICENSEยทNOTICEยทTHIRD_PARTY* ๋ถ€์žฌ ยท showLicensePage ๋ฅ˜ 0๊ฑด ยท ์›Œํฌํ”Œ๋กœ์˜ 'license' ํžˆํŠธ๋Š” ์ „๋ถ€ Xcode/Android SDK ์ˆ˜๋ฝ).
  • Decision:
    • โ“: ํฌํ•จํ•˜์ง€ ์•Š๋Š”๋‹ค. ๋ฐ์Šคํฌํ†ฑ ์žฌ๋ฐฐํฌ ์•„ํ‹ฐํŒฉํŠธ์— SSPL-1.0 ์ธ serverpod ์ฝ”์–ด๋ฅผ ๋„ฃ์ง€ ์•Š๋Š”๋‹ค. ๊ทผ๊ฑฐ๋Š” ํŒจํ‚ค์ง• ๊ฒฝ๊ณ„ ์ฆ๋ช…์ด๋‹ค(์•„๋ž˜).
    • โ“‘ ๋Š” ๋‹ค์‹œ ํŒ์ •ํ•˜์ง€ ์•Š๋Š”๋‹ค โ€” D-026 ์ด ใ€Œ์กด์น˜ํ•œ๋‹คใ€๋กœ ํ™•์ •ํ–ˆ๊ณ  ์ด ๊ฒฐ์ •์€ ๊ทธ๊ฒƒ์„ ์ธ์šฉ๋งŒ ํ•œ๋‹ค.
    • ๋ฒ•๋ฌด ๊ฒ€ํ† ๋Š” ์ƒ๋žตํ•œ๋‹ค. โ“ ๊ฐ€ ใ€Œํฌํ•จํ•˜์ง€ ์•Š์Œใ€์ด๋ฏ€๋กœ. ์ƒ๋žต์˜ ๊ทผ๊ฑฐ๋ฅผ ์žฌํ˜„ ๊ฐ€๋Šฅํ•œ ๋ช…๋ น + CI ์ƒ์‹œ ๊ฒ€์ฆ์œผ๋กœ ๋‚จ๊ธด๋‹ค.
    • ๊ณ ์ง€ ๋ชฉ๋ก์€ pubspec.lock ์—์„œ ๊ธฐ๊ณ„ ์ƒ์„ฑํ•˜๊ณ  CI ๊ฐ€ ์ปค๋ฐ‹๋ณธ๊ณผ ๋Œ€์กฐํ•œ๋‹ค.
  • Rationale:
    • ใ€Œ๋ฆฌํฌ์— ์žˆ์ง€๋งŒ ์•ฑ์ด ์•ˆ ์“ด๋‹คใ€๋Š” ๋ถˆํ•ฉ๊ฒฉ์ด๋‹ค(#99 ์ธ์ˆ˜์กฐ๊ฑด 4). ์ง์ ‘ ์˜์กด ๋ชฉ๋ก์€ ํ•œ ๊ฒน๋งŒ ๋ณด์—ฌ ์ฃผ๊ณ  ์ „์ด ์˜์กด์œผ๋กœ SSPL ์ด ๋”ธ๋ ค ์˜ฌ ์ˆ˜ ์žˆ๋‹ค. ๊ทธ๋ž˜์„œ ์ „์ด ์˜์กด ํํฌ๋กœ ์ฆ๋ช…ํ•œ๋‹ค โ€” cocode(๋ฐ์Šคํฌํ†ฑ ์•ฑ) ํํฌ 436๊ฐœ ํŒจํ‚ค์ง€์— serverpod ์—†์Œ(serverpod ๊ณ„์—ด 14๊ฐœ๋Š” ์ „๋ถ€ BSD ํด๋ผ์ด์–ธํŠธยทflutter ๊ณ„์—ด). ๋Œ€์กฐ๊ตฐ: cocode_server ํํฌ 212๊ฐœ์—๋Š” ์žˆ๋‹ค โ€” ๊ทธ๊ฒƒ์ด ํํฌ ๊ณ„์‚ฐ์ด ์‹ค์ œ๋กœ SSPL ์„ ์ฐพ์•„๋‚ธ๋‹ค๋Š” ์ฆ๊ฑฐ๋‹ค(๋Œ€์กฐ ์—†์ด๋Š” ใ€Œ๊ฐ€๋“œ๊ฐ€ ๋Š˜ ์ดˆ๋กใ€๊ณผ ๊ตฌ๋ถ„๋˜์ง€ ์•Š๋Š”๋‹ค).
    • ํํฌ๊ฐ€ ์ฆ๋ช…์˜ ์ƒํ•œ์ด๋‹ค โ€” Dart AOT ๋Š” ํŒจํ‚ค์ง€ ๊ทธ๋ž˜ํ”„ ๋ฐ–์˜ ์ฝ”๋“œ๋ฅผ ๋งํฌํ•  ๋ฐฉ๋ฒ•์ด ์—†์œผ๋ฏ€๋กœ ํํฌ์— ์—†์œผ๋ฉด ๋“ค์–ด๊ฐˆ ์ˆ˜ ์—†๋‹ค. ๋ฐ˜๋Œ€๋กœ ํํฌ์— ์žˆ์œผ๋ฉด ๋“ค์–ด๊ฐˆ ์ˆ˜ ์žˆ๋‹ค(ํŠธ๋ฆฌ ์…ฐ์ดํ‚น์€ ๋ณด์žฅ์ด ์•„๋‹ˆ๋‹ค). โž– ๋ฒˆ๋“ค ๋‚ด์šฉ๋ฌผ ์Šค์บ”์€ ํŒจํ‚ค์ง• ํŒŒ์ดํ”„๋ผ์ธ์ด ์žˆ์–ด์•ผ ํ•˜๋ฏ€๋กœ ๋ชป ํ–ˆ๋‹ค(#11 ์†Œ๊ด€) โ€” ๊ทธ ํ•œ๊ณ„๋ฅผ ์ ์—ˆ๋‹ค.
    • ๋ฒ•๋ฌด ํŒ๋‹จ ์ž์ฒด๋Š” ์—ฌ์ „ํžˆ ๋ฏธ์ •์ด๋‹ค(ํŒ์ • ์ฃผ์ฒด: ์˜ค๋„ˆ๊ฐ€ ์ง€์ •ํ•  ์™ธ๋ถ€ ๋ฒ•๋ฌด โ€” ๋ฆฌํฌยทdocs ์— ๊ฒ€ํ†  ์ฃผ์ฒดยทํšŒ์‹  ๊ธฐํ•œ ๊ธฐ๋ก 0๊ฑด). ๋‹ค๋งŒ โ“ ๊ฐ€ ใ€Œํฌํ•จํ•˜์ง€ ์•Š์Œใ€์ธ ๋™์•ˆ ๊ทธ ํŒ๋‹จ์€ ํ•„์š”ํ•˜์ง€ ์•Š๊ณ , ๊ฐ€๋“œ๊ฐ€ ๊นจ์ง€๋Š” ๋‚  ํ•ญ๋ชฉ์ด ์ž๋™์œผ๋กœ ๋‹ค์‹œ ์—ด๋ฆฐ๋‹ค. ์™„๋ฃŒ ์กฐ๊ฑด์€ ํŒ๋‹จ ๋‚ด์šฉ์ด ์•„๋‹ˆ๋ผ ์ ˆ์ฐจ๋ผ๋Š” ์ธ์ˆ˜์กฐ๊ฑด 4์˜ ๊ทœ์ • ๊ทธ๋Œ€๋กœ๋‹ค.
    • ๊ณ ์ง€๋ฅผ ๊ธฐ๊ณ„ ์ƒ์„ฑํ•˜๋Š” ์ด์œ : ๋Œ€์ƒ์ด pub.dev hosted 539๊ฐœ๋‹ค. ์†์œผ๋กœ ์œ ์ง€ํ•  ์ˆ˜ ์žˆ๋Š” ๊ทœ๋ชจ๊ฐ€ ์•„๋‹ˆ๋ฉฐ ์†์œผ๋กœ ๋งŒ๋“  ๋ชฉ๋ก์€ ํ‹€๋ฆฐ ์ค„ ๋ชจ๋ฅด๋Š” ์ฑ„ ๋‚ก๋Š”๋‹ค. ํŒ์ •์€ pub.dev ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ๊ฐ€ ์•„๋‹ˆ๋ผ ํŒจํ‚ค์ง€๊ฐ€ ๋™๋ด‰ํ•œ LICENSE ๋ณธ๋ฌธ์œผ๋กœ ํ•˜๊ณ , ์•Œ์•„๋ณด์ง€ ๋ชปํ•˜๋ฉด ์ถ”์ธกํ•˜์ง€ ์•Š๊ณ  ์‹คํŒจ๋กœ ์ ๋Š”๋‹ค โ€” ใ€Œ๋ชจ๋ฅด๊ฒ ๋‹คใ€๋ฅผ permissive ๋กœ ์ ‘์œผ๋ฉด ๊ณ ์ง€๊ฐ€ ๊ทผ๊ฑฐ๊ฐ€ ์•„๋‹ˆ๋ผ ์ธ์ƒ์ด ๋œ๋‹ค.
  • Impact:
    • ์‹ค์ธก(2026-09-14 lock): ์ „์ฒด 563 = hosted 539 ยท git 19 ยท sdk 5. ์‹๋ณ„ ์„ฑ๊ณต 539 ยท ์‹คํŒจ 0. ๋ถ„ํฌ BSD-3-Clause 259 ยท MIT 186 ยท Apache-2.0 75 ยท BSD-2-Clause 12 ยท ISC 3 ยท MPL-2.0 3 ยท SSPL-1.0 1. โš ๏ธ #99 ๋ณธ๋ฌธ์˜ 550(526ยท19ยท5)์€ ๊ทธ ์‹œ์ ์˜ lock ์ด๋‹ค โ€” ๊ณ ์ •๋œ ์ˆ˜๋ฅผ ๊ทœ๋ฒ”์œผ๋กœ ์‚ผ์ง€ ์•Š๋Š”๋‹ค(CI ๊ฐ€ ๋งค๋ฒˆ ๋‹ค์‹œ ๋งŒ๋“ ๋‹ค).
    • ๋„คํŠธ์›Œํฌ/๊ฐ•ํ•œ copyleft = 1ํ–‰: serverpod 4.0.1 ยท SSPL-1.0 ยท backend/cocode_server/pubspec.yaml:49. ๊ฐ™์€ ๋ฆด๋ฆฌ์Šค์˜ ๋‚˜๋จธ์ง€ serverpod ๊ณ„์—ด 22๊ฐœ๋Š” ์ „๋ถ€ BSD-3-Clause ๋ผ ํ‘œ์— ์—†๋‹ค.
    • ๐Ÿ”ด ์‹ค์ œ๋กœ ์žก์€ ์˜ค๋ถ„๋ฅ˜ โ€” MPL-2.0 ์ด GPL ๋กœ ์ฐํ˜”๋‹ค. ์ดˆํŒ์€ LICENSE ๋ณธ๋ฌธ ์ „์ฒด์—์„œ ์ด๋ฆ„์„ ์ฐพ์•˜๋Š”๋ฐ, MPL-2.0 ์€ ยง1.12 ใ€ŒSecondary Licenseใ€ ์ •์˜์—์„œ GPL/LGPL/AGPL ์„ ์ธ์šฉํ•œ๋‹ค. ์‹ค์ธก์—์„œ dbus 0.7.15ยทgtk 2.2.0ยทnm 0.5.0 ์„ธ ๊ฐœ๊ฐ€ GPL ๋กœ ์˜ค๋ถ„๋ฅ˜๋๊ณ , ๊ทธ๋Œ€๋กœ ๋‘๋ฉด ๊ฐ•ํ•œ copyleft ํ‘œ์— ์—†๋Š” ์œ„ํ—˜ 3๊ฑด์ด ์‹ค๋ ค ์ธ์ˆ˜์กฐ๊ฑด 2์˜ ใ€Œserverpod 1ํ–‰ ์žฌํ˜„ใ€์ด ๊นจ์ง„๋‹ค. ์ˆ˜์ •: copyleft ๊ณ„์—ด์€ ์ œ๋ชฉ ๊ตฌ๊ฐ„(์•ž 600์ž)๋งŒ ๋ณธ๋‹ค. ํšŒ๊ท€ ๊ณ ์ •์ด ๊ทธ ๊ฒฐํ•จ์„ ์žฌํ˜„ํ•œ๋‹ค.
    • DD-01 ํ‘œ ๋ถˆ์ผ์น˜๋ฅผ ๋Œ€์กฐํ•ด ๊ธฐ๋กํ–ˆ๋‹ค โ€” ยง1.3 ํ‘œ 12ํ–‰์€ ์ „๋ถ€ cocode_* ์ด๊ณ  backend ํ•ญ๋ชฉ์ด ์—†๋Š”๋ฐ backend/cocode_server ๋Š” ์˜๋„์ ์œผ๋กœ ์กด์น˜ํ•œ๋‹ค. ใ€Œยง1.3 ๋ฒ”์œ„ ๋ฐ– ์กด์น˜ใ€๋กœ ์ฝ๋Š”๋‹ค(DD-01 ๊ฐฑ์‹  ์•„๋‹˜): ๊ทผ๊ฑฐ๋Š” ์‹ค์ธก์ด๋‹ค โ€” backend ๋Š” ๋ฐ์Šคํฌํ†ฑ ์•ฑ ํํฌ ๋ฐ–์— ์žˆ์–ด cocode ADE ์˜ ๊ตฌ์„ฑ๋ฌผ์ด ์•„๋‹˜์ด ๊ด€์ธก์œผ๋กœ ํ™•์ธ๋œ๋‹ค. โธ๏ธ ๋‹ค๋งŒ ใ€Œ์กด์น˜ํ•˜๋˜ MVP ๋ฏธ์‚ฌ์šฉใ€์ธ์ง€ ใ€ŒMVP ์‚ฌ์šฉใ€์ธ์ง€๋Š” ์—ฌ์ „ํžˆ ๋ฏธ์ •(D-026 ๋ฏธ๊ฒฐ ยท #4 ๋ฐฐ์น˜ํ‘œ๊ฐ€ ๊ธฐ๋ก์ฒ˜)์ด๊ณ , ใ€ŒMVP ์‚ฌ์šฉใ€์ด ๋˜๋ฉด ์ด ์ฝ๊ธฐ๋„ โ“ ํŒ์ •๋„ ๋‹ค์‹œ ์—ด๋ฆฐ๋‹ค.
    • ์‹ ๊ทœ CI ์žก verify.oss-notices.yaml โ€” ํšŒ๊ท€ ๊ณ ์ • ยท ์ƒ์„ฑ ๋Œ€์กฐ ยท ๋ฒˆ๋“ค ๊ฒฝ๊ณ„ ์ฆ๋ช… 3์ข…. branches: ํ•„ํ„ฐ๋ฅผ ๋‘์ง€ ์•Š์•˜๋‹ค: ๋‘๋ฉด ๊ณ„์ธต PR ์—์„œ ๋Œ์ง€ ์•Š๊ณ , ์ด Epic ์˜ PR ์€ development ๊ฐ€ ์•„๋‹ˆ๋ผ project/2 ๋กœ ๊ฐ€๋ฏ€๋กœ ci.yml ์— ๋„ฃ์œผ๋ฉด ์ด ์ž‘์—…์ด ์Šค์Šค๋กœ๋ฅผ ๊ฒ€์ฆํ•˜์ง€ ๋ชปํ•œ๋‹ค. ๐Ÿ“Œ #99 ๋ณธ๋ฌธ์˜ ์‹ค์ธก ์ •์ • โ€” "ํ•„ํ„ฐ ์—†๋Š” ๊ฒƒ์€ 4์ข…๋ฟ" ์ด๋ผ ์ ํ˜€ ์žˆ์œผ๋‚˜ 2026-09-14 ์žฌ์‹ค์ธก ๊ฒฐ๊ณผ 8์ข…์ด๋‹ค(_hierarchy_check.yaml ์€ ๊ทธ ์‚ฌ์ด branches ๊ฐ€ ์ƒ๊ฒผ๊ณ , probe/verify ๊ณ„์—ด 4์ข…์ด ๋Š˜์—ˆ๋‹ค).
    • โธ๏ธ ๋ฏธ์ • 2๊ฑด: โ“ ๊ณ ์ง€ ๋…ธ์ถœ ๋ฐฉ์‹ยท๋ฐฐ์น˜(์•ฑ ๋‚ด ํ™”๋ฉด / ๋ฒˆ๋“ค ๋™๋ด‰ ํ…์ŠคํŠธ / ๋‘˜ ๋‹ค โ€” ์†Œ์œ  ํ›„๋ณด๋Š” cocode_app. ํŒ์ • ์ฃผ์ฒด ์˜ค๋„ˆ. โš ๏ธ ๊ณ ์ง€ UI ๊ตฌํ˜„์€ ๊ทธ ํ™•์ • ์ดํ›„๋กœ ๋ถ„๋ฆฌํ•œ๋‹ค) โ“‘ ํ”Œ๋žซํผ๋ณ„ ๊ณ ์ง€ ๊ฒฝ๋กœ 3์ข… ์ „๋ถ€(ํŒ์ • ์ฃผ์ฒด: ๋ฐ์Šคํฌํ†ฑ ํŒจํ‚ค์ง• ์„ ํ–‰ ์Šคํ† ๋ฆฌ #11 โ€” ์ง€๊ธˆ ์ •ํ•˜๋ฉด ํŒจํ‚ค์ง•์ด ์ƒ๊ธธ ๋•Œ ๋‹ค์‹œ ์ •ํ•ด์•ผ ํ•˜๊ณ  ๊ทธ ์‚ฌ์ด ๋ฌธ์„œ๊ฐ€ ํ‹€๋ฆฐ ์ฑ„๋กœ ๋‚จ๋Š”๋‹ค).
  • Source: #99 ์ธ์ˆ˜ ์กฐ๊ฑด 7์ข…. ์‹ค์ธก์€ ์ด ์›ŒํฌํŠธ๋ฆฌ(2026-09-14) โ€” pubspec.lock ยท pub ์บ์‹œ์˜ LICENSE ๋ณธ๋ฌธ ยท dart pub deps --json ํํฌ. D-026(#102) ์ธ์šฉ, prd-cocode.md:249 ์ถœ์ฒ˜.

D-074: ์—๋””ํ„ฐ D-013 ์Šน์ธ โ€” ๋กค๋ฐฑ ์‚ฌ์ „๊ฒ€์‚ฌ๊ฐ€ ใ€Œ์ฒด์ธ ๋ถˆ์—ฐ์†ใ€์„ ์ถฉ๋Œ๋กœ ์ œ์‹œํ•œ๋‹ค (#373)

  • Date: 2026-09-28
  • Context: ํ’€์Šคํƒ ์ฝ”๋”ฉ ์—๋””ํ„ฐ(Project #305)๊ฐ€ D-013 ์—์„œ ์ƒ์œ„ ๊ฒฐ์ •์„ ์š”์ฒญํ–ˆ๋‹ค. ๊ฐ™์€ ์ž‘์—…์˜ ์—ฐ์† ์Šค๋ƒ…์ƒท ์‚ฌ์ด์— ์‚ฌ๋žŒ ํŽธ์ง‘์ด ๋ผ๋ฉด, ์ง€๊ธˆ ์‚ฌ์ „๊ฒ€์‚ฌ(D-036)๋Š” ๋งˆ์ง€๋ง‰ ์Šค๋ƒ…์ƒท์˜ result ํ•ด์‹œ๋งŒ ๋Œ€์กฐํ•˜๋ฏ€๋กœ ํ†ต๊ณผํ•˜๊ณ  ์‚ฌ๋žŒ ํŽธ์ง‘์ด ๊ณ ์ง€ ์—†์ด ์‚ฌ๋ผ์ง„๋‹ค.
  • Decision: ์Šน์ธ. RollbackTargets.compute ๊ฐ€ next.base โ‰  prev.result ๋ฅผ ChainDiscontinuityConflict ๋กœ ์ œ์‹œํ•œ๋‹ค. ๊ตฌํ˜„์€ #372 ๋‹ค.
  • Rationale: AC-02 ์˜ ๊ฐ•ํ™”(์ถฉ๋Œ์„ ๋” ๋ณด๊ณ )์ด๋ฉฐ ์™„ํ™”๊ฐ€ ์•„๋‹ˆ๋‹ค. ์‚ฌ์ „๊ฒ€์‚ฌ์™€ ์ ์šฉ ์—”์ง„์ด ๊ฐ™์€ ์ˆœ์ˆ˜ ํ•จ์ˆ˜๋ฅผ ์“ฐ๋ฏ€๋กœ ํ•œ ๊ณณ์„ ๋ฐ”๊พธ๋ฉด ์–‘์ชฝ์— ๊ฑธ๋ฆฐ๋‹ค.
  • Impact: AC-02 ํŒ์ •์— ์ฒด์ธ ๋ถˆ์—ฐ์† ์กฐ๊ฑด์ด ๋”ํ•ด์ง„๋‹ค. ์—๋””ํ„ฐ decision-log D-078.
  • Source: ์˜ค๋„ˆ ์œ„์ž„(2026-09-28) ยท ์—๋””ํ„ฐ D-013 ยท #373

D-075: UX-D-30 ํ•ด์†Œ โ€” ๊ธฐ์กด ๋กœ์ปฌ ํด๋” ์—ด๊ธฐ๋Š” ์ •์‹ ๊ฒฝ๋กœ์ด๊ณ , .cocode/ ๋Š” ์ฒซ ์œ„์ž„ ๋•Œ ์ดˆ๊ธฐํ™”ํ•œ๋‹ค (#375)

  • Date: 2026-09-28
  • Context: UX-D-30 ์€ ใ€Œ๊ธฐ์กด ์›Œํฌ์ŠคํŽ˜์ด์Šค(๋กœ์ปฌ ํด๋”) ์—ด๊ธฐใ€๋ฅผ ๋ฏธ์ •์œผ๋กœ ๋‚จ๊ฒผ๋‹ค. #437 ์ด ใ€Œํด๋” ์—ด๊ธฐโ€ฆใ€๋ฅผ ์ž„์‹œ ๊ฒฝ๋กœ๋กœ ๋„ฃ์—ˆ๊ณ , ์ด๊ฒƒ์ด ์‚ฌ์‹ค์ƒ ๊ธฐ๋ณธ ์ง„์ž…์ ์ด ๋๋‹ค.
  • Decision: ์—๋””ํ„ฐ D-018 ์˜ต์…˜ (aโ€ฒ).
    • ์—ฌ๋Š” ๊ฒƒ์€ .cocode/ ๋ฅผ ๋งŒ๋“ค์ง€ ์•Š๋Š”๋‹ค. ์ฒซ ์œ„์ž„ ์ง์ „์— ํ™•์ธ์„ ๋ฐ›์•„ .cocode/ ๋ฅผ ๋งŒ๋“ค๊ณ  applied_bricks = [] ๋กœ ๋‘”๋‹ค.
    • ๋”ฐ๋ผ์„œ Workspace applied_bricks ์˜ ใ€ŒMVP ์›์†Œ 1ใ€(FR-105 ยท D-037)์„ ใ€Œ์ƒ์„ฑ ์›Œํฌ์ŠคํŽ˜์ด์Šค 1 ยท ์œ„์ž„ํ•œ ๊ธฐ์กด ํด๋” 0ใ€์œผ๋กœ ๊ฐœ์ •ํ•œ๋‹ค. ๊ฐœ์ •์€ ์—์ด์ „ํŠธ ๋ฃจํ”„ ์•ฑ ๋ฐฐ์„ (#447)์˜ Seed ์—์„œ ํ•œ๋‹ค.
    • S-17 ์ฒซ ์‹คํ–‰ ํ™”๋ฉด์˜ ์ฃผ ๋™์ž‘์€ ๋‘˜์ด ๋œ๋‹ค โ€” ใ€Œํด๋” ์—ด๊ธฐโ€ฆใ€ ยท ใ€Œ์ƒˆ ์›Œํฌ์ŠคํŽ˜์ด์Šคโ€ฆใ€.
  • Rationale: 1์ฐจ ๊ณ ๊ฐ(D-005)์˜ ์ฒซ ๋™์„ ์ด ๊ธฐ์กด ์ €์žฅ์†Œ ์—ด๊ธฐ๋‹ค. ์—ฌ๋Š” ๊ฒƒ๋งŒ์œผ๋กœ ์‚ฌ์šฉ์ž ์ €์žฅ์†Œ๋ฅผ ๋ฐ”๊พธ์ง€ ์•Š๋Š”๋‹ค.
  • Impact: ์—๋””ํ„ฐ decision-log D-079. ์Šค์ฝ”ํ”„ ๊ณ„์•ฝ 3์ข…์˜ ๋“ฑ๋ก ์‹œ์ ์ด ใ€Œ์ฒซ ์œ„์ž„ใ€์œผ๋กœ ์ •ํ•ด์กŒ๋‹ค.
  • Source: ์˜ค๋„ˆ ์œ„์ž„(2026-09-28) ยท #375

D-076: ์—์ด์ „ํŠธ ๋ฃจํ”„(์œ„์ž„ ยท ์ž๊ฐ€ ๊ฒ€์ฆ ยท ๋˜๋Œ๋ฆฌ๊ธฐ)์˜ ์•ฑ ๋ฐฐ์„ ์„ ์ƒˆ Project #447 ๋กœ ์„ธ์šด๋‹ค (#446)

  • Date: 2026-09-28
  • Context: MVP(Project #2, 2026-09-14)๋Š” ์—์ด์ „ํŠธ ๋ฃจํ”„๋ฅผ ํŒจํ‚ค์ง€์™€ ๊ณ„์•ฝ์œผ๋กœ ๋งŒ๋“ค์—ˆ๋‹ค. ๊ทธ๋Ÿฌ๋‚˜ ์•ฑ(app/cocode)์€ ๊ณ„์•ฝ 13์ข… ์ค‘ 5์ข…๋งŒ ๋“ฑ๋กํ•˜๊ณ  agent ยท acp ๋ฅผ ์˜์กดํ•˜์ง€ ์•Š๋Š”๋‹ค. ๋‹ด๋‹น ์ƒ์œ„ Epic ๋“ค์€ ๋‹ซํ˜”๋‹ค.
  • Decision: ์ƒˆ Project #447 ์„ ์„ธ์šฐ๊ณ  ์—๋””ํ„ฐ ํ™•์žฅ(#305) ์ž”์—ฌ์™€ ๋ณ‘ํ–‰ํ•œ๋‹ค. ์ฒซ ๋ชฉํ‘œ๋Š” ๋ฐฑ์—”๋“œ 1์ข… ยท ๊ฒ€์ฆ ์‹คํ–‰๊ธฐ 1์ข…์œผ๋กœ ์•ฑ์—์„œ ๋ฃจํ”„๋ฅผ ๊ด€ํ†ตํ•˜๋Š” ์ˆ˜์ง ์Šฌ๋ผ์ด์Šค๋‹ค. D-006(๋‘ ๋ฐฑ์—”๋“œ ๋ชจ๋‘ MVP ํ•„์ˆ˜)์€ ๊ทธ๋Œ€๋กœ์ด๊ณ , ์ˆœ์„œ๋งŒ ์Šฌ๋ผ์ด์Šค ๋‹จ์œ„๋กœ ๋‚˜๋ˆˆ๋‹ค.
  • Rationale: ์ฐจ๋ณ„์ (์œ„์ž„ ๋ฃจํ”„)์ด ์•ฑ์— ์—†์œผ๋ฉด AC-01 ยท 02 ยท 06 ยท 07 ยท 08 ยท 09 ๋ฅผ ํŒ์ •ํ•  ์ˆ˜ ์—†๋‹ค. ์—๋””ํ„ฐ Seed ์— ๋„ฃ์œผ๋ฉด ๊ทธ Seed ๊ฐ€ Level ์žฌ๋ถ„๋ฅ˜๋œ๋‹ค.
  • Impact: ์—๋””ํ„ฐ decision-log D-081. D-075 ์˜ ์ดˆ๊ธฐํ™” ยท applied_bricks ๊ฐœ์ •์ด ์ด Project ๋กœ ๋ชจ์ธ๋‹ค.
  • Source: ์˜ค๋„ˆ ์œ„์ž„(2026-09-28) ยท #446

D-077: ๋ชจ๋ฐ”์ผ E2E ยท ๋ชจ๋ฐ”์ผ ๋ฐฐํฌ ๊ฒฝ๋กœ๋Š” ์ œํ’ˆ ๋ฒ”์œ„ ๋ฐ–์ด๋‹ค โ€” ์˜ˆ์•ฝ ์‹คํ–‰ ์ค‘์ง€ ยท maestro ์‚ญ์ œ ยท ๋ชจ๋ฐ”์ผ ๋ ˆ์ธ์€ ์ฒซ main ๋ฆด๋ฆฌ์Šค ์ „์— ์ •๋ฆฌ (#444)

  • Date: 2026-09-28
  • Context:
    • patrol-test.yml nightly ๊ฐ€ ์ฒซ ์‹คํ–‰(2026-09-21)๋ถ€ํ„ฐ 7/7 ์‹คํŒจํ–ˆ๋‹ค.
    • flavor ์ง„์ž…์  4์ข…(main_{development,staging,production,donor}.dart)์ด ๋„๋„ˆ ์•ฑ์„ ๋„์šฐ๋Š”๋ฐ, ๋„๋„ˆ ์•ฑ์€ ์—†๋Š” ํŒจํ‚ค์ง€๋ฅผ import ํ•ด ์ปดํŒŒ์ผ๋˜์ง€ ์•Š๋Š”๋‹ค.
    • ๋ฐ์Šคํฌํ†ฑ ๋ฆด๋ฆฌ์Šค๋Š” fastforge ๊ฐ€ lib/main.dart ๋ฅผ ๋นŒ๋“œํ•˜๋ฏ€๋กœ ๋ฌด๊ด€ํ•˜๋‹ค(app/cocode/distribute_options.yaml).
    • CI ์ธ๋ฒคํ† ๋ฆฌ๋Š” patrol-test.yml ์„ ใ€Œ๋ณด๋ฅ˜(์˜ค๋„ˆ ๊ฒฐ์ •)ใ€, maestro-test.yml ์„ ใ€Œ์‚ญ์ œใ€๋กœ ํŒ์ •ํ•ด ๋‘์—ˆ๋‹ค.
  • Decision:
    • patrol-test.yml ์˜ ์˜ˆ์•ฝ ์‹คํ–‰์„ ๋ฉˆ์ถ˜๋‹ค. ์ˆ˜๋™ ์‹คํ–‰๋งŒ ๋‚จ๊ธด๋‹ค.
    • maestro-test.yml ์„ ์ง€์šด๋‹ค(์ธ๋ฒคํ† ๋ฆฌ ํŒ์ • ์ดํ–‰).
    • ์ฒซ main ๋ฆด๋ฆฌ์Šค ์ „์— ๋‘ ๊ฐ€์ง€๋ฅผ ์ •๋ฆฌํ•œ๋‹ค(#449): build.yaml ์˜ ๋ชจ๋ฐ”์ผ ๋ ˆ์ธ(push:main ์—์„œ TARGET_OS=all ๋กœ ์ผœ์ง€๋Š” call-ios ยท call-android)๊ณผ, ์ธ๋ฒคํ† ๋ฆฌ๊ฐ€ ใ€Œ์‚ญ์ œใ€๋กœ ํŒ์ •ํ•œ ๋ชจ๋ฐ”์ผ ๋ฐฐํฌ ์›Œํฌํ”Œ๋กœ 5์ข….
    • ๋„๋„ˆ ์‹œ๋‚˜๋ฆฌ์˜ค ยท app_initializer.dart ยท flavor ์ง„์ž…์  4์ข…์€ D-026 ๋Œ€๋กœ ์กด์น˜ํ•œ๋‹ค. ๋„๋„ˆ ์ •๋ฆฌ๋ฅผ ๊ฒฐ์ •ํ•  ๋•Œ ํ•จ๊ป˜ ๊ฑท๋Š”๋‹ค. main.dart ๋จธ๋ฆฌ ์ฃผ์„์ด ๋„ท ๋ชจ๋‘๋ฅผ ๋„๋„ˆ ์ง„์ž…์ ์œผ๋กœ ์ ๋Š”๋‹ค.
  • Rationale: C-01(๋ฐ์Šคํฌํ†ฑ 3์ข…)์— ๋ชจ๋ฐ”์ผ์ด ์—†๋‹ค. ์‹ ํ˜ธ ์—†๋Š” red ๊ฐ€ ๋งค์ผ ์ž์ฒด ํ˜ธ์ŠคํŠธ ๋Ÿฌ๋„ˆ๋ฅผ ~34๋ถ„ ์ ์œ ํ•˜๊ณ , ์ง„์งœ red ๋ฅผ ๊ฐ€๋ฆฐ๋‹ค.
  • Impact: ์ธ๋ฒคํ† ๋ฆฌ์˜ patrol-test.yml ยท maestro-test.yml ยท build.yaml ํ–‰์„ ๊ฐฑ์‹ ํ–ˆ๋‹ค.
  • Source: ์˜ค๋„ˆ ์œ„์ž„(2026-09-28) ยท #444 ยท docs/ci-inventory-cocode.md

D-078: GitHub Actions ์˜ PR ์ƒ์„ฑ์„ ํ—ˆ์šฉํ•œ๋‹ค โ€” ์กฐ์ง ์ •์ฑ…์ด ๋ง‰๊ณ  ์žˆ์–ด ์กฐ์ง ๊ด€๋ฆฌ์ž ๊ถŒํ•œ์œผ๋กœ ์ ์šฉํ•œ๋‹ค (#445)

  • Date: 2026-09-28
  • Context:
    • ์„ธ ์›Œํฌํ”Œ๋กœ๊ฐ€ ๋ชจ๋‘ PR ์ƒ์„ฑ ๋‹จ๊ณ„์—์„œ ใ€ŒGitHub Actions is not permitted to create or approve pull requestsใ€๋กœ ์‹คํŒจํ•œ๋‹ค: upstream-bump.yml(cocode) ยท ใ€Œunibook bricks syncใ€(bricks) ยท release-please(co-bricks).
    • co-bricks ๋Š” ๊ทธ ๋•Œ๋ฌธ์— v0.4.0 ์ดํ›„ ๋ฆด๋ฆฌ์Šค๊ฐ€ ์—†๊ณ , cob dev ๊ฐ€ ์ถœ์‹œ๋˜์ง€ ๋ชปํ–ˆ๋‹ค(#298).
    • ์„ธ ์ €์žฅ์†Œ ๋ชจ๋‘ ๋ธŒ๋žœ์น˜ ๋ณดํ˜ธ ยท ruleset ์ด ์—†๋‹ค. ๊ทธ๋ž˜์„œ ์Šน์ธ ๊ถŒํ•œ์ด ๋ฆฌ๋ทฐ ์š”๊ฑด์„ ์šฐํšŒํ•˜๋Š” ๊ฒฝ๋กœ๊ฐ€ ๋˜์ง€ ์•Š๋Š”๋‹ค.
  • Decision: ํ—ˆ์šฉํ•œ๋‹ค(์˜ต์…˜ โ“).
    • ์ €์žฅ์†Œ ์ˆ˜์ค€ ์„ค์ •์€ ์กฐ์ง ์ •์ฑ… ๋•Œ๋ฌธ์— 409 ๋กœ ๊ฑฐ๋ถ€๋๋‹ค(2026-09-28 ์‹ค์ธก). ๋”ฐ๋ผ์„œ ์กฐ์ง ์„ค์ • ใ€ŒAllow GitHub Actions to create and approve pull requestsใ€๋ฅผ ์ผ  ๋’ค ์„ธ ์ €์žฅ์†Œ์— ์ ์šฉํ•œ๋‹ค.
    • ์ ์šฉ์—๋Š” admin:org ๋ฒ”์œ„๊ฐ€ ํ•„์š”ํ•˜๋‹ค.
    • GITHUB_TOKEN ์ด ์—ฐ PR ์—๋Š” pull_request CI ๊ฐ€ ๋Œ์ง€ ์•Š๋Š”๋‹ค. ๊ทธ๋ž˜์„œ ๊ฐฑ์‹  PR ์€ ์‚ฌ๋žŒ์ด ๋‹ซ์•˜๋‹ค ๋‹ค์‹œ ์—ด์–ด CI ๋ฅผ ๋Œ๋ฆฐ๋‹ค.
  • Rationale: ์„ธ ์›Œํฌํ”Œ๋กœ๊ฐ€ ๊ฐ™์€ ์›์ธ์œผ๋กœ ๋ฉˆ์ถฐ ์žˆ๊ณ , ์„ค์ • ํ•˜๋‚˜๋กœ ํ’€๋ฆฐ๋‹ค. App ํ† ํฐ(โ“‘)์€ CI ๊ฐ€ ๋ˆ๋‹ค๋Š” ์žฅ์ ์ด ์žˆ์ง€๋งŒ ์กฐ์ง์— App ๊ธฐ๋ฐ˜์ด ์—†์–ด ๋น„์šฉ์ด ํฌ๋‹ค. ํ•„์š”ํ•ด์ง€๋ฉด ๊ทธ๋•Œ ์˜ฎ๊ธด๋‹ค.
  • Impact: ์ ์šฉ ์ „๊นŒ์ง€ ์„ธ ์›Œํฌํ”Œ๋กœ๋Š” ๊ณ„์† ์‹คํŒจํ•œ๋‹ค. ์ ์šฉํ•œ ๋’ค ์ฒซ ์‹คํ–‰์—์„œ PR ์ด ์—ด๋ฆฌ๋Š”์ง€ ํ™•์ธํ•˜๊ณ  #445 ๋ฅผ ๋‹ซ๋Š”๋‹ค.
  • Source: ์˜ค๋„ˆ ์œ„์ž„(2026-09-28) ยท #445

D-087: ๋„๋„ˆ(unibook) featureยทํŒจํ‚ค์ง€ยท์ฝ˜์†”์„ ์‚ญ์ œํ•œ๋‹ค โ€” D-026ยทD-031 ๋Œ€์ฒด (#458)

  • Date: 2026-09-28
  • Context:
    • D-026(#102)์€ ๋„๋„ˆ ์ž์‚ฐ์„ ใ€Œ์ถ”ํ›„ ๋ฐฑ์—”๋“œ๊ฐ€ ํ•„์š”ํ•  ์ˆ˜๋„ ์žˆ์–ด์„œใ€ ์กด์น˜ํ–ˆ๋‹ค. D-031(#141)์€ ๊ทธ ์ž์‚ฐ์˜ ํŒŒ์ผ์€ ๋‘๊ณ  ๋ถ„์„ยท๋นŒ๋“œ ๋Œ€์ƒ์—์„œ๋งŒ ๋นผ์„œ CI ๋ฅผ ์‚ด๋ ธ๋‹ค.
    • ๊ทธ ๋’ค๋กœ๋„ ๋„๋„ˆ ํ‘œ๋ฉด์€ exclude ๋ชฉ๋ก ยท melos ignore ยท CI ๊ฐ€๋“œ ์˜ˆ์™ธ ยท ๊ณ„์ธต ๋ž˜์นซ ๋ฒ ์ด์Šค๋ผ์ธ ๊ณณ๊ณณ์— ๋น„์šฉ์„ ๋‚จ๊ฒผ๋‹ค. core โ†’ core ๊ฐ™์€ ์ด๋ฆ„ ์ •๋ฆฌ๋„ ๋ง‰์•˜๋‹ค โ€” ๋„๋„ˆ package/core ์™€ ์ด๋ฆ„์ด ๊ฒน์นœ๋‹ค.
    • ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ์š”์ฒญ(2026-09-28): ใ€Œ์‚ฌ์šฉํ•˜์ง€ ์•Š๋Š” ํŒจํ‚ค์ง€๋‚˜ ๊ธฐ๋Šฅ ๋ชจ๋“ˆ๋“ค์„ ๋ชจ๋‘ ์ œ๊ฑฐํ•˜๊ณ  โ€ฆ ํŒจํ‚ค์ง€ ์ด๋ฆ„์—์„œ cocode_ ๋ฅผ ๋ชจ๋‘ ์ œ๊ฑฐํ•ด์ค˜ใ€.
  • Decision: cocode ADE ๊ฐ€ ์“ฐ์ง€ ์•Š๋Š” ์›Œํฌ์ŠคํŽ˜์ด์Šค ํŒจํ‚ค์ง€๋ฅผ ์‚ญ์ œํ•œ๋‹ค.
    • ํŒ์ • ๊ธฐ์ค€์€ ์˜์กด ํํฌ๋‹ค. ์›Œํฌ์ŠคํŽ˜์ด์Šค 132๊ฐœ์˜ ํํฌ(dependencies + dev_dependencies)๋ฅผ app/cocode ยท app/cocode_widgetbook ยท backend/cocode_{server,client} ยท package/cocode_* 12์ข…์—์„œ ๊ณ„์‚ฐํ•˜๊ณ , ํํฌ ๋ฐ– 111๊ฐœ๋ฅผ ์ง€์šด๋‹ค โ€” feature/** 97 ยท app/cocode_console ยท ๋„๋„ˆ package/* 12 ยท shared/dependencies.
    • app/cocode ์•ˆ์˜ ๋„๋„ˆ ์ž”์žฌ๋„ ํ•จ๊ป˜ ์ง€์šด๋‹ค โ€” lib/app ยท lib/core ยท bootstrap.dart ยท flavor ์ง„์ž…์  4์ข… ยท test_donor_* ยท ๋„๋„ˆ E2E 73ํŒŒ์ผ(์˜ค๋„ˆ ํ™•์ธ).
    • ๋ฐฑ์—”๋“œ(backend/cocode_{server,client})์™€ ๊ทธ๊ฒƒ๋งŒ ์“ฐ๋Š” shared/{config,flavor,i10n_web} ์€ ๋‚จ๊ธด๋‹ค. cob dev ์ž๊ธฐ ์‹คํ–‰(#303)์ด ์“ฐ๊ณ , D-026 ์˜ ๋ฐฑ์—”๋“œ ์กด์น˜ ์˜๋„๋„ ๊ทธ๋Œ€๋กœ๋‹ค(์˜ค๋„ˆ ํ™•์ธ).
  • Rationale: ์“ฐ์ง€ ์•Š๋Š” ์ฝ”๋“œ๋ฅผ ใ€Œ์กด์น˜ํ•˜๋˜ ์ œ์™ธใ€๋กœ ๋‘๋Š” ๋น„์šฉ์ด ๊ณ„์† ์Œ“์˜€๋‹ค. ์ง€์šด ํŒŒ์ผ์€ git ์ด๋ ฅ์— ๋‚จ์œผ๋ฏ€๋กœ ํ•„์š”ํ•ด์ง€๋ฉด ๋˜์‚ด๋ฆด ์ˆ˜ ์žˆ๋‹ค.
  • Impact:
    • D-031 ์˜ excludeยทignore ๋Š” ๋Œ€์ƒ๊ณผ ํ•จ๊ป˜ ์‚ฌ๋ผ์ง€๊ณ  backend/cocode_server ํ•œ ์ค„๋งŒ ๋‚จ๋Š”๋‹ค.
    • ๊ณ„์ธต ๋ž˜์นซ S1: maxSCC 1 ยท SCC 0 ยท ๊ณ„์ธต ์œ„๋ฐ˜ 1 ยท ์œ ๋ น ์—ฃ์ง€ 0 โ€” architecture DD-03 ๋ชฉํ‘œ์น˜๋ฅผ ๋‹ฌ์„ฑํ–ˆ๋‹ค.
    • pubspec.lock ์—์„œ hosted ์˜์กด 168๊ฐœ๊ฐ€ ๋น ์กŒ๋‹ค. ๋‚จ์€ ํŒจํ‚ค์ง€์˜ ๋ฒ„์ „ ๋ณ€ํ™”๋Š” 0 ์ด๋‹ค.
    • ci.yml ์˜ console-web-build ์žก๊ณผ ๊ทธ ์˜ํ–ฅ ํŒ์ • ์Šคํฌ๋ฆฝํŠธ๋ฅผ ์ง€์› ๋‹ค.
    • ๋‚จ์€ ์ •๋ฆฌ(ํ›„์†): ๋ฆด๋ฆฌ์Šค ํŒŒ์ดํ”„๋ผ์ธ build.yaml ์˜ console ํ”Œ๋žซํผ ๋ ˆ์ธ๊ณผ ๋ชจ๋ฐ”์ผ ๋ ˆ์ธ(#449) ยท ๋ฐฑ์—”๋“œ ์ฝ˜์†” ์—”๋“œํฌ์ธํŠธ ์Šคํ…(#428) ยท package/cocode_* ๊ฐœ๋ช…(#459).
  • Supersedes: D-026(์กด์น˜) ยท D-031(๋ถ„์„ยท๋นŒ๋“œ ๋ฒ”์œ„ ์ œ์™ธ). ๋ฐฑ์—”๋“œ ์กด์น˜ ๋ถ€๋ถ„์€ ์œ ์ง€ํ•œ๋‹ค.
  • Source: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ์š”์ฒญ(2026-09-28) ยท #458

D-088: ADE ํŒจํ‚ค์ง€ 12์ข…์—์„œ cocode_ ์ ‘๋‘์‚ฌ๋ฅผ ๋—€๋‹ค โ€” cocode_platform ๋งŒ desktop_platform (#459)

  • Date: 2026-09-28
  • Context: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ์š”์ฒญ(2026-09-28)์˜ ๋’ท๋ถ€๋ถ„์ด๋‹ค โ€” ใ€Œ์•„๋ž˜ ํŒจํ‚ค์ง€ ์ด๋ฆ„์—์„œ cocode_ ๋ฅผ ๋ชจ๋‘ ์ œ๊ฑฐํ•ด์ค˜ใ€. ๋„๋„ˆ package/core ์™€ ์ด๋ฆ„์ด ๊ฒน์ณ D-087(#458)์˜ ์‚ญ์ œ๊ฐ€ ๋จผ์ € ํ•„์š”ํ–ˆ๋‹ค.
  • Decision:
    • package/cocode_{acp,agent,bricks,core,editor,lsp,runner,terminal,toolchain,ui,workspace} โ†’ package/{โ€ฆ}. ๋””๋ ‰ํ„ฐ๋ฆฌ ยท pubspec name: ยท ๋ฐฐ๋Ÿด ํŒŒ์ผ(lib/<์ด๋ฆ„>.dart) ยท import URI ยท ์˜์กด ์„ ์–ธ ยท ๊ณ„์ธต ์„ ์–ธ ยท CI ์Šคํฌ๋ฆฝํŠธ ยท ๋ฌธ์„œ๋ฅผ ํ•จ๊ป˜ ๋ฐ”๊พผ๋‹ค.
    • cocode_platform ์€ desktop_platform ์ด๋‹ค(์˜ค๋„ˆ ํ™•์ธ). pub.dev ์˜ platform 3.1.6 ์ด melos ยท process ยท path_provider_platform_interface ๊ฒฝ์œ ๋กœ ์ด๋ฏธ ์˜์กด ๊ทธ๋ž˜ํ”„์— ์žˆ์–ด, ๊ฐ™์€ ์ด๋ฆ„์˜ ์›Œํฌ์ŠคํŽ˜์ด์Šค ํŒจํ‚ค์ง€๋ฅผ ๋‘๋ฉด version solving ์ด ์‹คํŒจํ•œ๋‹ค(๋นˆ ์›Œํฌ์ŠคํŽ˜์ด์Šค๋กœ ์žฌํ˜„).
    • ๋ฐ”๊พธ์ง€ ์•Š๋Š” ๊ฒƒ: ํด๋ž˜์Šคยท์‹ฌ๋ณผ(Cocode*)๊ณผ ๊ทธ ์ด๋ฆ„์— ๋งž์ถ˜ ํŒŒ์ผ ์ด๋ฆ„, app/cocode* ยท backend/cocode_* ยท shared/config(cocode_config). ๋„๋ฉ”์ธ ๊ฐ’ agent_backend_kind(cocode_agent | cocode_acp) ๋„ ๊ทธ๋Œ€๋กœ ๋‘”๋‹ค โ€” ํŒจํ‚ค์ง€ ์ด๋ฆ„์ด ์•„๋‹ˆ๋ผ AgentBackendKind { cocodeAgent, cocodeAcp } ์˜ ๊ฐ’์ด๋‹ค.
    • ์ด๋ฆ„ ์ ‘๋‘์‚ฌ๋กœ ๋ฒ”์œ„๋ฅผ ์žก๋˜ CI ๊ฐ€๋“œ 4์ข…(dart:io ์“ฐ๊ธฐ ยท ํ”„๋กœ์„ธ์Šค ๊ธฐ๋™ ยท ์ฐฝ seam ยท MVP ๋ฒ”์œ„)๊ณผ ์ˆœ์ˆ˜ ํŒจํ‚ค์ง€ ์Šคํ…Œ์ด์ง• ์Šคํฌ๋ฆฝํŠธ๋Š” ์ ‘๋‘์‚ฌ ๋Œ€์‹  package/*(ํ…Œ์ŠคํŠธ ๋„๊ตฌ test_driver ์ œ์™ธ) ์™€ ๋ฐœ๊ฒฌํ•œ ํŒจํ‚ค์ง€ ์ด๋ฆ„์œผ๋กœ ๋ฒ”์œ„๋ฅผ ์žก๋Š”๋‹ค. ๋„๋„ˆ๊ฐ€ ์‚ฌ๋ผ์ง„ ๋’ค๋กœ package/ ๊ฐ€ ๊ณง ADE ์ด๊ณ , ์ƒˆ ํŒจํ‚ค์ง€๊ฐ€ ์ƒ๊ธฐ๋ฉด ์ž๋™์œผ๋กœ ๋Œ€์ƒ์ด ๋œ๋‹ค.
  • Rationale: ์ ‘๋‘์‚ฌ๋Š” ๋„๋„ˆ ํŒจํ‚ค์ง€์™€ ์„ž์—ฌ ์žˆ๋˜ ์‹œ์ ˆ์˜ ๊ตฌ๋ถ„์ž์˜€๋‹ค. ๋„๋„ˆ๊ฐ€ ์‚ญ์ œ๋œ ๋’ค๋กœ๋Š” ๊ตฌ๋ถ„ํ•  ๋Œ€์ƒ์ด ์—†๋‹ค.
  • Impact: ํŒŒ์ผ 527๊ฐœ ยท ์ฐธ์กฐ 2,652๊ณณ. ๊ฐ€๋“œ ํŒ์ • ํŒŒ์ผ ์ˆ˜(235 ยท 262 ยท 262 ยท 265)์™€ ๊ณ„์ธต ๋ž˜์นซ ์ง€ํ‘œ๋Š” ๊ฐœ๋ช… ์ „ํ›„ ๋™์ผํ•˜๋‹ค. ์—ด๋ฆฐ PR ์ค‘ package/cocode_* ๋ฅผ ๊ฑด๋“œ๋ฆฌ๋Š” ๊ฒƒ์€ ์ด๊ด€์ด ํ•„์š”ํ•˜๋‹ค(์ด๋ฆ„ ํ‘œ + ์น˜ํ™˜ ๋ช…๋ น์„ PR ์— ์•ˆ๋‚ด).
  • Source: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ์š”์ฒญ(2026-09-28) ยท #459

When adding a new decision, copy the template above and increment the number.

D-089: IA v1 โ€” ์…ธ์„ ์‚ฌ์ด๋“œ๋ฐ” ยท ๋ชจ๋“œ ์ „ํ™˜(์ฑ„ํŒ… | ์ฝ”๋“œ) ยท ๋ชจ๋“œ๋ณ„ ์šฐ์ธก ํŒจ๋„๋กœ ์žฌํŽธํ•œ๋‹ค (#513)

  • Date: 2026-10-02
  • Context: ์˜ค๋„ˆ๊ฐ€ ๋ฐ์Šคํฌํ†ฑ ์•ฑ์„ ์ง์ ‘ ๋ณด๋ฉฐ ๋ฆฌ๋ทฐํ–ˆ๋‹ค. ์š”๊ตฌ๋Š” ์„ธ ๊ฐ€์ง€์˜€๋‹ค โ€” ํ”„๋กœ์ ํŠธ๋ฅผ ๋ชฉ๋ก์œผ๋กœ ์ถ”๊ฐ€(ํด๋” ยท URL ๋ณต์ œ ยท ์ƒˆ ํ”„๋กœ์ ํŠธ) ยท ์„ ํƒ ยท ์ œ๊ฑฐ, ํŒŒ์ผ ํŠธ๋ฆฌ๋ฅผ ์šฐ์ธก ํŒจ๋„๋กœ, ๋นŒ๋”๋ฅผ Claude Code ์‹ ์ „์ฒด ํ™”๋ฉด ์ฑ„ํŒ…์œผ๋กœ(์ขŒ์ธก ๋ ˆ์ผ). ์š”๊ตฌ๊ฐ€ ๋Œ€ํ™” ์ค‘ ๊ณ„์† ๋Š˜์–ด, ์˜ค๋„ˆ ์ œ์•ˆ์œผ๋กœ ์ •๋ณด๊ตฌ์กฐ(IA)๋ฅผ ๋จผ์ € ํ™•์ •ํ•˜๊ณ  ๋””์ž์ธ ์‹œ์•ˆ 6์žฅ์„ ์Šน์ธ๋ฐ›์€ ๋’ค ๊ตฌํ˜„ํ•œ๋‹ค.
  • Decision (์˜ค๋„ˆ ํ™•์ • 5๊ฑด):
    1. ์ขŒ์ธก์€ ์ ‘ํžˆ๋Š” ์‚ฌ์ด๋“œ๋ฐ”(ํŽผ์น˜๋ฉด ๋ชฉ๋ก, ์ ‘์œผ๋ฉด ์•„์ด์ฝ˜ ๋ ˆ์ผ)
    2. ์„ธ์…˜์€ ํ”„๋กœ์ ํŠธ์— ์†ํ•œ๋‹ค โ€” ยซ๋งŒ๋“ค๊ธฐยป ๋Œ€ํ™”๋Š” ์ƒ์„ฑ ๋’ค ์ƒˆ ํ”„๋กœ์ ํŠธ๋กœ ์˜ฎ๊ธด๋‹ค
    3. ํ”„๋กœ์ ํŠธ ์‚ญ์ œ๋Š” ๋ชฉ๋ก์—์„œ๋งŒ ์ œ๊ฑฐ โ€” ๋””์Šคํฌ ํด๋”๋Š” ๊ทธ๋Œ€๋กœ
    4. ์ฝ”๋“œ โ†” ์ฑ„ํŒ…์€ ์ƒ๋‹จ ๋ชจ๋“œ ์ „ํ™˜์œผ๋กœ๋งŒ(1์ฐจ์— ์šฐ์ธก ์ฑ„ํŒ… ํƒญ ์—†์Œ)
    5. ์ฒซ ํ™”๋ฉด ยท ํ”„๋กœ์ ํŠธ ์—†์Œ = ์ฑ„ํŒ… ๋นˆ ๋Œ€ํ™”
  • AC-03 ํ•ด์„: ยซ์‹คํ–‰ ์‹œ ์—๋””ํ„ฐ ยท ํŒŒ์ผํŠธ๋ฆฌ ยท ํ„ฐ๋ฏธ๋„ ์ œ๊ณตยป์€ ์ฝ”๋“œ ๋ชจ๋“œ๊ฐ€ ์ง€ํ‚จ๋‹ค. ์„ธ ํ‘œ๋ฉด์€ ์ฒซ ํ™”๋ฉด์—์„œ๋„ ๋งˆ์šดํŠธ๋œ ์ฑ„ ์ƒ๋‹จ ์ „ํ™˜ ํ•œ ๋ฒˆ ๊ฑฐ๋ฆฌ์— ์žˆ๋‹ค(UX-D-30 ์˜ ์ž๋ฆฌ ์œ ์ง€ ์›์น™์„ ๋ชจ๋“œ ๋‹จ์œ„๋กœ ์ฝ๋Š”๋‹ค).
  • Consequences: ux-spec-cocode UX-D-32 ์‹ ์„ค ยท UX-D-03 ยท K2 ๊ฐœ์ •(#514). ํŠธ๋ฆฌ ์œ„์น˜๋ฅผ ยซnavigation ์Šฌ๋กฏยป์œผ๋กœ ์ ์€ AC-01 ยท bdd-fullstack-code-editor ยท cocode_shell_tree.feature ยท ux-spec-fullstack-code-editor ยง1 ์€ S4(#517)๊ฐ€, D-079(ยซํด๋” ์—ด๊ธฐโ€ฆยป ยท ์ตœ๊ทผ ๋ชฉ๋ก #448)๋Š” S2(#515)๊ฐ€ ๊ฐœ์ •ํ•œ๋‹ค. package/ui CocodeShellScaffold ์— sidebar ยท workbenchWrapper ์Šฌ๋กฏ์„ ๋”ํ–ˆ๊ณ , CocodePaneId.navigation ์€ ์ˆจ๊ธด ์ฑ„ ๋‚จ๊ธด๋‹ค(์ œ๊ฑฐ๋Š” ํ›„์†).
  • Source: IA ํ™•์ • v1 https://claude.ai/artifact/88v7GRenDFustTNYT1Qadi ยท ๋””์ž์ธ ์‹œ์•ˆ https://claude.ai/artifact/J8eMDcMymyDsevtA4Vns5m ยท Epic #513

D-090: ์‚ฌ์ด๋“œ๋ฐ” ํ”„๋กœ์ ํŠธ ๋ชฉ๋ก์ด ์ตœ๊ทผ ๋ชฉ๋ก(#448)์„ ๋Œ€์‹ ํ•œ๋‹ค โ€” ์—๋””ํ„ฐ D-079 ์˜ ใ€Œ์ตœ๊ทผ ๋ชฉ๋กใ€ ๊ฐœ์ • (#515)

  • Date: 2026-10-02
  • Context: D-075(์—๋””ํ„ฐ D-079)๋Š” ยซํด๋” ์—ด๊ธฐโ€ฆยป ยท ๋งˆ์ง€๋ง‰ ํด๋” ๊ธฐ์–ต์„ ์ •์‹ ๊ฒฝ๋กœ๋กœ ๋‘๊ณ  ์ตœ๊ทผ ๋ชฉ๋ก ยท CLI ์ธ์ž๋ฅผ #448 ๋กœ ๋ฏธ๋ค˜๋‹ค. IA v1(D-089)์€ ํ”„๋กœ์ ํŠธ๋ฅผ 1๊ธ‰ ๋Œ€์ƒ์œผ๋กœ ์˜ฌ๋ ค ์‚ฌ์ด๋“œ๋ฐ”์—์„œ ์ถ”๊ฐ€ ยท ์„ ํƒ ยท ์ œ๊ฑฐํ•œ๋‹ค. ๋‘˜์„ ํ•จ๊ป˜ ๋‘๋ฉด ๊ฐ™์€ ํด๋”๊ฐ€ ๋‘ ์ž๋ฆฌ์— ์„œ๊ณ  ์–ด๋А ์ชฝ์ด ์ •๋ณธ์ธ์ง€ ๊ฐˆ๋ฆฐ๋‹ค.
  • Decision:
    • ์‚ฌ์ด๋“œ๋ฐ” ยซํ”„๋กœ์ ํŠธยป ๋ชฉ๋ก์ด ์ตœ๊ทผ ๋ชฉ๋ก์„ ๋Œ€์‹ ํ•œ๋‹ค. ๋ฉ”๋‰ด ยซํด๋” ์—ด๊ธฐโ€ฆยป(OS ์„ ํƒ๊ธฐ ์งํ–‰)๋กœ ์—ฐ ํด๋”๋„ ๋ชฉ๋ก์— ๋“ค์–ด๊ฐ„๋‹ค โ€” ์—ฐ ํ”„๋กœ์ ํŠธ๋Š” ์–ธ์ œ๋‚˜ ๋ชฉ๋ก์— ์žˆ๋‹ค.
    • ๋ชฉ๋ก์€ ์•ฑ ์ˆ˜๋ช…(ProjectRegistry)์ด๊ณ  ์„ค์ • cocode.projects.v1 ์— ๋‘”๋‹ค โ€” ๊ฒฝ๋กœ ยท ์ด๋ฆ„ ยท ์ถœ์ฒ˜(local ยท cloned ยท created) ยท ๋„ฃ์€ ๋•Œ ยท ๋งˆ์ง€๋ง‰ ์—ด๋žŒ. ํ‚ค๋Š” ์ •๊ทœํ™”ํ•œ ์ ˆ๋Œ€ ๊ฒฝ๋กœ๋ผ ๊ฐ™์€ ํด๋”๋Š” ํ•œ ์ค„์ด๋‹ค. ์ˆœ์„œ๋Š” ๋„ฃ์€ ์ˆœ์„œ๋‹ค(๊ณ ๋ฅผ ๋•Œ๋งˆ๋‹ค ์ค„์ด ์›€์ง์ด์ง€ ์•Š๋Š”๋‹ค).
    • ์ฒซ ์‹คํ–‰์€ #437 ์˜ ใ€Œ๋งˆ์ง€๋ง‰ ์›Œํฌ์ŠคํŽ˜์ด์Šคใ€(cocode.workspace.last_root)๋ฅผ ์ฒซ ์ค„๋กœ ์˜ฎ๊ฒจ ๋‹ด๋Š”๋‹ค. ๋งˆ์ง€๋ง‰ ํด๋”๋กœ ๋ฐ”๋กœ ์—ฌ๋Š” ๋™์ž‘(D-075)์€ ๊ทธ๋Œ€๋กœ๋‹ค.
    • ์ œ๊ฑฐ๋Š” ๋ชฉ๋ก์—์„œ๋งŒ์ด๋‹ค(D-089 ๊ฒฐ์ • 3). ์‚ฌ๋ผ์ง„ ํด๋”๋„ ๋‚จ๊ธฐ๊ณ  ยซ์ฐพ์„ ์ˆ˜ ์—†์Œยป์œผ๋กœ ํ‘œ์‹œํ•œ๋‹ค โ€” ๊ณ ๋ฅด๋ฉด ๊ทธ ์‚ฌ์‹ค์„ ์•Œ๋ฆฌ๊ณ  ์ œ๊ฑฐ๋ฅผ ๊ถŒํ•œ๋‹ค.
    • ์ถ”๊ฐ€๋Š” ยซํ”„๋กœ์ ํŠธ ์ถ”๊ฐ€ยป ๋Œ€ํ™”์ƒ์ž๋‹ค โ€” ํด๋” ์ฐพ์•„๋ณด๊ธฐ ยท URL์—์„œ ๋ณต์ œ ยท ์ƒˆ ํ”„๋กœ์ ํŠธ ๋งŒ๋“ค๊ธฐ. ์ถ”๊ฐ€ํ•œ ํ”„๋กœ์ ํŠธ๋Š” ์„ ํƒ๋˜์–ด ์ฝ”๋“œ ๋ชจ๋“œ๋กœ ์—ด๋ฆฐ๋‹ค(IA F2). ๋ชฉ๋ก์—์„œ ๊ณ ๋ฅธ ํ”„๋กœ์ ํŠธ๋Š” ์ง€๊ธˆ ๋ชจ๋“œ ๊ทธ๋Œ€๋กœ ์—ฐ๋‹ค.
    • git clone ยท git init ์€ ์•ฑ ๋Ÿฐ์ฒ˜์˜ humanTerminal ํ”„๋กœํŒŒ์ผ๋กœ ๋„์šด๋‹ค โ€” ์‚ฌ๋žŒ์˜ ๋™์ž‘์ด๊ณ , agent ํ”„๋กœํŒŒ์ผ์€ ์•ฑ ๋Ÿฐ์ฒ˜์— ์—†๋Š” ์ •์ฑ… ํ”„๋ก์‹œ๋ฅผ ์š”๊ตฌํ•œ๋‹ค(DD-16). ์ƒˆ ๋นˆ ํด๋”๋Š” HumanEditWriter.createDirectory(DD-15 ํ—ˆ์šฉ ๊ฒฝ๋กœ)๊ฐ€ ๋งŒ๋“ ๋‹ค.
    • CLI ์ธ์ž๋กœ ์—ด๊ธฐ๋Š” ์ด ๊ฒฐ์ •์˜ ๋ฒ”์œ„ ๋ฐ–์ด๋‹ค โ€” #448 ์— ๋‚จ๋Š”๋‹ค.
  • Rationale: ๋ชฉ๋ก์ด ํ•˜๋‚˜์—ฌ์•ผ ยซ์ง€๊ธˆ ์–ด๋–ค ํ”„๋กœ์ ํŠธ๋“ค์ด ์žˆ๋Š”๊ฐ€ยป์— ํ•œ ๊ณณ์ด ๋‹ตํ•œ๋‹ค. ๋„ฃ์€ ์ˆœ์„œ๋Š” Claude ๋ฐ์Šคํฌํ†ฑ ยท Orca ์˜ ํ”„๋กœ์ ํŠธ ๋ชฉ๋ก๊ณผ ๊ฐ™์€ ์•ˆ์ •์„ฑ์„ ์ค€๋‹ค.
  • Impact: ์—๋””ํ„ฐ decision-log D-079 ์˜ ใ€Œ์ตœ๊ทผ ๋ชฉ๋ก ยท CLI ์ธ์ž๋Š” #448 ์ด ์ฑ„์šด๋‹คใ€ ์ค‘ ์ตœ๊ทผ ๋ชฉ๋ก ๋ถ€๋ถ„์„ ๊ฐœ์ •ํ•œ๋‹ค. ux-spec-cocode UX-D-30 ์— IA v1 ์ฒซ ์‹คํ–‰ ์ง„์ž…์„ ๋ง๋ถ™์˜€๋‹ค. workspace ์— ์‚ฌ๋žŒ์˜ ํด๋” ๋งŒ๋“ค๊ธฐ(HumanEditWriter.createDirectory)๊ฐ€ ์ƒ๊ฒผ๋‹ค.
  • Source: Epic #513 ยท #515 ยท IA ํ™•์ • v1(F2 ยท F3) ยท ์‹œ์•ˆ ยซํ”„๋กœ์ ํŠธ ์ถ”๊ฐ€ยป

D-091: ๋นŒ๋” ์‹คํ–‰ ์‹คํŒจ๋Š” cob ์˜ ์‚ฌ์œ  ํ•œ ์ค„์„ ๋น„๋ฐ€์„ ๊ฐ€๋ฆฐ ๋’ค ๋ณด์ด๊ณ , Pages ๊ฒŒ์‹œ๋Š” ์ƒ์„ฑ๊ณผ ๋‚˜๋ˆˆ๋‹ค (#529)

  • Date: 2026-10-02
  • Context: S3(#516) ์˜ ProcessCobClient ๋Š” ยซstderr ์—๋Š” ๋ฏผ๊ฐํ•œ CLI ์ •๋ณด๊ฐ€ ์„ž์ผ ์ˆ˜ ์žˆ๋‹คยป๋ฉฐ stderr ๋ฅผ ๋ณด์ด์ง€ ์•Š์•˜๋‹ค(๊ณ„ํš ๋‹จ๊ณ„์˜ bricks ๋ˆ„๋ฝ ๋ฌธ์žฅ ๋Œ€์กฐ๋งŒ). ์‹ค์ œ ์•ฑ E2E ์—์„œ ๋‹ค ๋งŒ๋“ค์–ด์ง„ ํ”„๋กœ์ ํŠธ๊ฐ€ --pages ๊ฒŒ์‹œ ๊ฑฐ๋ถ€(์ด๋ฏธ ์žˆ๋Š” ์ €์žฅ์†Œ) ํ•˜๋‚˜๋กœ ยซfullstack ์‹คํŒจ (์ข…๋ฃŒ ์ฝ”๋“œ 69)ยป ๋กœ๋งŒ ๋ณด์˜€๋‹ค โ€” ์‚ฌ์œ ๋Š” stderr ์—๋งŒ ์žˆ์—ˆ๋‹ค. cob ๋Š” --json-events ์ผ ๋•Œ ์‚ฌ๋žŒ์šฉ ๋กœ๊ทธ๋ฅผ stderr ๋กœ ๋ณด๋‚ด๊ณ , NDJSON error ๋‹จ๊ณ„๋Š” ์ข…๋ฃŒ ์ฝ”๋“œ๋งŒ ์‹ฃ๋Š”๋‹ค.
  • Decision:
    • ์‹คํ–‰ ๋‹จ๊ณ„(์‚ฌ์ „ ์ ๊ฒ€ ยท ์ƒ์„ฑ ยท ๊ฒ€์ฆ ยท ๊ฒŒ์‹œ)๊ฐ€ ์‹คํŒจํ•˜๋ฉด cob ์ถœ๋ ฅ์—์„œ ํ•œ ์ค„(์ตœ๋Œ€ 240์ž)์„ ๊ณ ๋ฅธ๋‹ค โ€” โœ—/โŒ ๊ฒŒ์ดํŠธ ์ค„์ด ๋จผ์ €์ด๊ณ , ๊ฒฝ๊ณ ([WARN] ยท โš ) ยท ์„ ํ–‰ ์‹คํŒจ๋กœ ๊ฑด๋„ˆ๋›ด ๊ฒŒ์ดํŠธ(โญ โ€ฆ skip() ยท ์Šคํƒ ํ”„๋ ˆ์ž„ ยท pub ํ•ด์„ ์žก์Œ์€ ๊ณ ๋ฅด์ง€ ์•Š๋Š”๋‹ค.
    • ๊ทธ ์ค„์€ ๋น„๋ฐ€ ๊ฐ€๋ฆผ(redactSecrets)์„ ๊ฑฐ์นœ๋‹ค โ€” URL userinfo(insteadOf ๋กœ ๋ฐ•ํžŒ PAT), gh?_ ยท github_pat_, sk-โ€ฆ, AIzaโ€ฆ, AKIA ยท ASIAโ€ฆ, Bearer โ€ฆ, token|secret|password|api_key = โ€ฆ.
    • ๊ณ„ํš ๋‹จ๊ณ„์˜ stderr ๋Š” ์—ฌ์ „ํžˆ ๋ณด์ด์ง€ ์•Š๋Š”๋‹ค.
    • Pages ๊ฒŒ์‹œ๋Š” fullstack --pages ๊ฐ€ ์•„๋‹ˆ๋ผ ๋งˆ์ง€๋ง‰ ๋ณ„๋„ ๋‹จ๊ณ„(cob publish --apply)๋‹ค. ์ƒ์„ฑ์ด ๋๋‚˜๋ฉด ๊ฒฝ๋กœ๋ฅผ ๋ฐ”๋กœ ์•Œ๋ ค, ๋’ค ๋‹จ๊ณ„๊ฐ€ ์‹คํŒจํ•ด๋„ ยซ์ƒˆ ํ”„๋กœ์ ํŠธ ์—ด๊ธฐยป๊ฐ€ ๋‚จ๋Š”๋‹ค. ๊ณ„ํš ์นด๋“œ๋Š” Pages ๋ฅผ ์ผœ๋ฉด ๋งŒ๋“ค ์ €์žฅ์†Œ(coco-de/<์ด๋ฆ„>)์™€ ๋™์ž‘์„ ํ™•์ธ ์ „์— ๋ณด์ธ๋‹ค.
  • Rationale: ์‚ฌ์œ ๊ฐ€ ์—†์œผ๋ฉด ์‚ฌ์šฉ์ž๋Š” ๊ฐ™์€ ์‹คํŒจ๋ฅผ ๋˜ํ’€์ดํ•  ๋ฟ์ด๋‹ค. ๋…ธ์ถœ ๋ฉด์€ ์‹คํŒจํ•œ ์‹คํ–‰์˜ ํ•œ ์ค„๋กœ ์ขํžˆ๊ณ , ์•Œ๋ ค์ง„ ์ž๊ฒฉ ์ฆ๋ช… ๋ชจ์–‘์€ ๊ฐ€๋ฆฐ๋‹ค. org ์— ์ €์žฅ์†Œ๋ฅผ ๋งŒ๋“ค๊ณ  ๋ฐฐํฌํ•˜๋Š” ๋™์ž‘์€ ๋กœ์ปฌ ์ƒ์„ฑ๊ณผ ์œ„ํ—˜์ด ๋‹ฌ๋ผ ๋‹จ๊ณ„์™€ ๋™์˜๋ฅผ ๋‚˜๋ˆˆ๋‹ค.
  • Impact: project_builder ์— BuilderEvent.detail ยท cobFailureReason ยท redactSecrets ๊ฐ€ ์ƒ๊ฒผ๋‹ค. ์‹คํ–‰ ์‹คํŒจ๋Š” ๋Œ€ํ™” ํ•˜๋‹จ ๋ฐฐ๋„ˆ๊ฐ€ ์•„๋‹ˆ๋ผ ์‹คํ–‰ ์นด๋“œ๊ฐ€ ๋งํ•œ๋‹ค(๋ฐฐ๋„ˆ์˜ ยซ๋‹ค์‹œ ์‹œ๋„ยป๋Š” ๊ณ„ํš ํ„ด ์žฌ์ „์†ก์ด๋‹ค). ๊ฐ€๋ฆผ ๋ชฉ๋ก ๋ฐ–์˜ ๋น„๋ฐ€ ๋ชจ์–‘์ด ๋‚˜์˜ค๋ฉด ์—ฌ๊ธฐ์™€ _secrets ์— ํ•จ๊ป˜ ๋”ํ•œ๋‹ค.
  • Source: #529 ยท PR #535 ยท Epic #513 ยท co-bricks#795 ยท co-bricks#796

โš ๏ธ D-112(2026-11-18)๋กœ ๋Œ€์ฒด๋๋‹ค โ€” IDE ๊ฐ€ ์‚ฌ์šฉ์ž ๊ธฐ๊ธฐ์—์„œ cob ์„ ์‹คํ–‰ํ•˜๋˜ ๋นŒ๋” ์‹คํ–‰(์‚ฌ์ „ ์ ๊ฒ€ ยท ์ƒ์„ฑ ยท ๊ฒ€์ฆ ยท ๊ฒŒ์‹œ)๊ณผ ๊ทธ ๊ณ„ํš ยท ์‹คํ–‰ ์นด๋“œ, cob publish ๊ฒŒ์‹œ๊ฐ€ ์ œ๊ฑฐ๋ผ ์ด ๊ฒฐ์ •์ด ์ •ํ•œ ๋™์ž‘ ์ „์ฒด๊ฐ€ ์—†์–ด์กŒ๋‹ค. ์ƒˆ ์•ฑ์€ ์„œ๋ฒ„ ์ชฝ ์ž‘์—… ๊ณต๊ฐ„ ํ˜ธ์ŠคํŠธ์—์„œ ๋งŒ๋“ ๋‹ค.

D-092: ๋ฉˆ์ถ˜ ๋นŒ๋” ์‹คํ–‰์€ ๊ทธ ๋‹จ๊ณ„๋ถ€ํ„ฐ ๋‹ค์‹œ ๋Œ๋ฆฌ๊ณ , ๊ฒŒ์‹œ ์ „์— ์ €์žฅ์†Œ ์ด๋ฆ„ ์ถฉ๋Œ์„ ํ™•์ธํ•œ๋‹ค (#536)

  • Date: 2026-10-02
  • Context: D-091 ๋กœ ์‹คํ–‰ ์‹คํŒจ๊ฐ€ ์‚ฌ์œ ์™€ ํ•จ๊ป˜ ๋ณด์ด๊ณ  ์ƒ์„ฑ๋œ ํ”„๋กœ์ ํŠธ๋Š” ์—ด ์ˆ˜ ์žˆ๊ฒŒ ๋์ง€๋งŒ, ๋‹ค์‹œ ๋Œ๋ฆฌ๋ ค๋ฉด ์ƒˆ ๋Œ€ํ™”๋กœ ๊ณ„ํš๋ถ€ํ„ฐ ์„ธ์›Œ์•ผ ํ–ˆ๊ณ  ๊ฐ™์€ ํด๋”๊ฐ€ ์ด๋ฏธ ์žˆ์–ด ๊ณ„ํš ์นด๋“œ๊ฐ€ ํ™•์ธ์„ ๋ง‰์•˜๋‹ค. Pages ๊ฒŒ์‹œ๊ฐ€ ยซ์ €์žฅ์†Œ๊ฐ€ ์ด๋ฏธ ์žˆ์Šต๋‹ˆ๋‹คยป๋กœ ๋ง‰ํ˜€๋„ ๋‹ค๋ฅธ ์ด๋ฆ„์œผ๋กœ ๊ฒŒ์‹œํ•  ๊ธธ์ด ์—†์—ˆ๋‹ค. ๊ทธ ์ถฉ๋Œ์€ ์ƒ์„ฑ ยท ๊ฒ€์ฆ์„ ๋‹ค ์ง€๋‚œ ๋งˆ์ง€๋ง‰ ๋‹จ๊ณ„์—์„œ์•ผ ๋“œ๋Ÿฌ๋‚ฌ๋‹ค. ๊ฒ€์ฆ์€ cob ์ชฝ ๊ฒฐํ•จ(co-bricks#795 ยท #796)์œผ๋กœ ์ง€๊ธˆ ๋Š˜ ๋ฉˆ์ถ˜๋‹ค.
  • Decision:
    • ์‹คํŒจํ•œ ๋งˆ์ง€๋ง‰ ์‹คํ–‰ ์นด๋“œ๊ฐ€ ์ด์–ด ๋Œ ์ˆ˜ ์žˆ๋Š” ๋‹จ๊ณ„๋ฅผ ๋ณด์ธ๋‹ค โ€” ์‚ฌ์ „ ์ ๊ฒ€ ์‹คํŒจ๋Š” ยซ๋‹ค์‹œ ์‹คํ–‰ยป(์•„๋ฌด๊ฒƒ๋„ ๋งŒ๋“ค์ง€ ์•Š์•˜๋‹ค), ๊ฒ€์ฆ ์‹คํŒจ๋Š” ยซ๊ฒ€์ฆ๋ถ€ํ„ฐ ๋‹ค์‹œยป, ๊ฒŒ์‹œ ์‹คํŒจ๋Š” ์ €์žฅ์†Œ ์ด๋ฆ„์„ ๊ณ ์ณ ยซ์ด ์ด๋ฆ„์œผ๋กœ ๊ฒŒ์‹œยป. ์ƒ์„ฑ ์ค‘๊ฐ„์˜ ์‹คํŒจ๋Š” ๋ฐ˜์ฏค ๋งŒ๋“  ํด๋”๊ฐ€ ๋‚จ์•„ ์ด์–ด ๋Œ์ง€ ์•Š๊ณ , ๊ทธ ์‚ฌ์‹ค๋งŒ ๋งํ•œ๋‹ค. ๋‹ค์‹œ ๋Œ๋ฆฐ ์‹คํ–‰์€ ์ƒˆ ์นด๋“œ์ด๊ณ  ๊ฑด๋„ˆ๋›ด ๋‹จ๊ณ„๋Š” ๊ทธ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค.
    • Pages ๋ฅผ ์ผ  ๊ณ„ํš์ด ๊ฒ€์ฆ์—์„œ ๋ฉˆ์ถ”๋ฉด ยซ๊ฒ€์ฆ ์—†์ด Pages ๊ฒŒ์‹œโ€ฆยป ๋ฅผ ๋‘”๋‹ค โ€” ๊ฒ€์ฆ์„ ์ง€๋‚˜์ง€ ๋ชปํ•œ ์†Œ์Šค๋ฅผ org ์— ๋‚ด๋ณด๋‚ด๋Š” ์„ ํƒ์ด๋ผ, ๋งŒ๋“ค ์ €์žฅ์†Œ์™€ ๋™์ž‘์„ ๋ณด์ด๋Š” ์–‘์‹์„ ์—ฐ ๋’ค์—๋งŒ ์‹œ์ž‘ํ•œ๋‹ค.
    • ๊ณ„ํš ์นด๋“œ๋Š” Pages ์ €์žฅ์†Œ ์ด๋ฆ„์„ ํ”„๋กœ์ ํŠธ ์ด๋ฆ„์—์„œ ์ด๋Œ๋˜(์†๋Œ€๋ฉด ๊ทธ ๊ฐ’์„ ์ง€ํ‚จ๋‹ค) ๊ณ ์น  ์ˆ˜ ์žˆ๊ฒŒ ํ•˜๊ณ , gh repo view ๋กœ ์ด๋ฏธ ์žˆ๋Š”์ง€ ํ™•์ธ ์ „์— ๋ฌป๋Š”๋‹ค. ์ด๋ฏธ ์žˆ์œผ๋ฉด ํ™•์ธ์„ ๋ง‰๊ณ , gh ๊ฐ€ ์—†๊ฑฐ๋‚˜ ์‘๋‹ต์ด ์—†์œผ๋ฉด(unknown) ๋ง‰์ง€ ์•Š๋Š”๋‹ค โ€” cob ๊ฐ€ ๊ฒŒ์‹œ ๋‹จ๊ณ„์—์„œ ๋‹ค์‹œ ๊ฑฐ๋ฅธ๋‹ค.
    • ์กฐํšŒ๋Š” ์•ฑ ๋Ÿฐ์ฒ˜์˜ humanTerminal ํ”„๋กœํŒŒ์ผ๋กœ ๋„์šด๋‹ค โ€” ์‚ฌ๋žŒ์ด ๊ณ„ํš ์นด๋“œ๋ฅผ ๋ณด๋ฉฐ ๋ถ€๋ฅด๋Š” ์ฝ๊ธฐ ์ „์šฉ ์กฐํšŒ์ด๊ณ , agent ๋Š” ์•ฑ ๋Ÿฐ์ฒ˜์— ์—†๋Š” ์ •์ฑ… ํ”„๋ก์‹œ๋ฅผ ์š”๊ตฌํ•œ๋‹ค(DD-16). 8์ดˆ ์•ˆ์— ๋‹ต์ด ์—†์œผ๋ฉด unknown ์ด๋‹ค.
  • Rationale: ์‹คํŒจ ์‚ฌ์œ ๋ฅผ ๋ณด์˜€์œผ๋ฉด ๊ทธ ๋‹ค์Œ ๋™์ž‘์ด ๊ฐ™์€ ์ž๋ฆฌ์— ์žˆ์–ด์•ผ ํ•œ๋‹ค. ์ด๋ฆ„ ์ถฉ๋Œ์€ ๊ณ„ํš ๋‹จ๊ณ„์—์„œ ์•Œ ์ˆ˜ ์žˆ๋Š” ์‚ฌ์‹ค์ด๋ผ ํ™•์ธ ์ „์— ์•Œ๋ฆฐ๋‹ค. ๊ฒ€์ฆ ์—†๋Š” ๊ฒŒ์‹œ๋Š” cob ๊ฒฐํ•จ์ด ํ’€๋ฆฌ๊ธฐ ์ „๊นŒ์ง€ ๊ฒŒ์‹œ์— ๋‹ฟ๋Š” ์œ ์ผํ•œ ๊ธธ์ด์ง€๋งŒ, ์™ธ๋ถ€๋กœ ๋‚˜๊ฐ€๋Š” ๋™์ž‘์ด๋ผ ๊ธฐ๋ณธ ๊ฒฝ๋กœ๋กœ ๋‘์ง€ ์•Š๋Š”๋‹ค.
  • Impact: CobClient.execute(plan, from:) ยท BuilderPhase ยท BuilderRequest.pagesRepository ยท PagesRepositoryProbe(project_builder), ๋นŒ๋” bloc resume. ๋‹ค๋ฅธ ์‚ฌ๋žŒ์˜ ๋น„๊ณต๊ฐœ ์ €์žฅ์†Œ์ฒ˜๋Ÿผ ๋ณด์ด์ง€ ์•Š๋Š” ์ด๋ฆ„์€ ยซ์‚ฌ์šฉ ๊ฐ€๋Šฅยป์œผ๋กœ ๋ณด์ด๊ณ  cob ๊ฐ€ ๊ฒŒ์‹œ ๋•Œ ๊ฑฐ๋ฅธ๋‹ค โ€” ์ด์ „๊ณผ ๊ฐ™์€ ๊ฒฐ๊ณผ๋‹ค.
  • Source: #536 ยท D-091 ยท co-bricks#795 ยท co-bricks#796

โš ๏ธ D-112(2026-11-18)๋กœ ๋Œ€์ฒด๋๋‹ค โ€” ๋ฉˆ์ถ˜ ์‹คํ–‰ ์ด์–ด ๋Œ๋ฆฌ๊ธฐ(CobClient.execute(plan, from:) ยท ๋นŒ๋” bloc resume) ยท ยซ๊ฒ€์ฆ ์—†์ด Pages ๊ฒŒ์‹œโ€ฆยป ยท ๊ฒŒ์‹œ ์ „ ์ €์žฅ์†Œ ์ด๋ฆ„ ํ™•์ธ(PagesRepositoryProbe)์ด ๋นŒ๋” ์‹คํ–‰๊ณผ ํ•จ๊ป˜ ์ œ๊ฑฐ๋ผ ์ด ๊ฒฐ์ •์ด ์ •ํ•œ ๋™์ž‘ ์ „์ฒด๊ฐ€ ์—†์–ด์กŒ๋‹ค.

D-093: CI ์˜ Claude ์ž๋™ ์ฝ”๋“œ๋ฆฌ๋ทฐ๋ฅผ ์ œ๊ฑฐํ•œ๋‹ค โ€” ๋ฆฌ๋ทฐ ยท ์ž๋™ ์ˆ˜์ • ยท ์ œ์•ˆ ์•„์นด์ด๋น™ 3์ข…, ํ…œํ”Œ๋ฆฟ๊นŒ์ง€ (#546)

  • Date: 2026-10-02
  • Context: PR ๋งˆ๋‹ค ๋„๋Š” claude-code-review.yml ์€ ๊ตฌ๋… ์ฃผ๊ฐ„ ํ•œ๋„ 429(#486)๋กœ ๋ฆฌ๋ทฐ๋ฅผ ๋‚ด์ง€ ๋ชปํ–ˆ๋‹ค. ๊ทธ๋Ÿฐ๋ฐ ์žก์ด continue-on-error: true ๋ผ ์ฒดํฌ๋Š” ๋…น์ƒ‰์ด์—ˆ๋‹ค. ๋Œ€ํ˜• PR ์—๋Š” ์Šคํ‚ต ์•ˆ๋‚ด ์ฝ”๋ฉ˜ํŠธ๋งŒ ๋‚จ์•˜๋‹ค. ๋ฆฌ๋ทฐ ์ฝ”๋ฉ˜ํŠธ๋ฅผ ์ž…๋ ฅ์œผ๋กœ ๋ฐ›๋Š” claude-auto-fix.yml ยท claude-suggestions-to-discussions.yml ์€ ์‹คํ–‰ 181ํšŒ๊ฐ€ ์ „๋ถ€ skipped ์˜€๋‹ค. suggestions ๋Š” ๋„๋„ˆ ๊ฐ’์œผ๋กœ ํ•˜๋“œ์ฝ”๋”ฉ๋œ Discussions ์นดํ…Œ๊ณ ๋ฆฌ ID ๋ฅผ ์ผ๊ณ , ์ด ์ €์žฅ์†Œ๋Š” Discussions ๊ฐ€ ๊บผ์ ธ ์žˆ๋‹ค. ์„ธ ํŒŒ์ผ์€ monorepo ๋ธŒ๋ฆญ ์Šค์บํด๋“œ์—์„œ ์™”๋‹ค. ๋„๋„ˆ(unibook)๋Š” ์ด๋ฏธ ์ง€์šด ์ƒํƒœ์˜€๋‹ค.
  • Decision:
    • ์„ธ ์›Œํฌํ”Œ๋กœ๋ฅผ ํ•จ๊ป˜ ์ง€์šด๋‹ค. ๋ฆฌ๋ทฐ๋งŒ ์ง€์šฐ๋ฉด ์†Œ๋น„์ž ๋‘˜์ด ์ž…๋ ฅ ์—†์ด ๋‚จ๋Š”๋‹ค(#547).
    • claude.yml(@claude ๋ฉ˜์…˜ ์‘๋‹ต)๊ณผ CLAUDE_CODE_OAUTH_TOKEN ์€ ์œ ์ง€ํ•œ๋‹ค. ์ž๋™ ๋ฆฌ๋ทฐ๊ฐ€ ์•„๋‹ˆ๋ผ ์‚ฌ๋žŒ์ด ๋ถ€๋ฅด๋Š” ์‘๋‹ต์ด๋‹ค. ์ง€๊ธˆ๊นŒ์ง€ PR ์œ„ ๋ฉ˜์…˜์—๋Š” ๋‘ ์›Œํฌํ”Œ๋กœ๊ฐ€ ๋™์‹œ์— ๋ฐ˜์‘ํ–ˆ๋Š”๋ฐ, ์ด์ œ ํ•˜๋‚˜๋งŒ ๋ฐ˜์‘ํ•œ๋‹ค.
    • ์žฌ์œ ์ž… ๊ฒฝ๋กœ๋„ ๋‹ซ๋Š”๋‹ค. monorepo ๋ธŒ๋ฆญ์—์„œ ๊ฐ™์€ 3์ข…์„ ์ง€์› ๋‹ค(bricks#446). cc-dev pr-lifecycle-agent ๋Š” PR ํŠธ๋ฆฌ๊ฑฐ AI ๋ฆฌ๋ทฐ ์›Œํฌํ”Œ๋กœ์™€ ์ตœ๊ทผ AI ๋ฆฌ๋ทฐ ํ”์ ์ด ๋ชจ๋‘ ์—†์œผ๋ฉด 5๋ถ„ ๋ฆฌ๋ทฐ ๋Œ€๊ธฐ๋ฅผ ์ƒ๋žตํ•˜๊ณ  not-configured ๋กœ ๊ธฐ๋กํ•œ๋‹ค(skills#510).
  • Rationale: ๊ฒฐ๊ณผ๋ฅผ ๋‚ด์ง€ ๋ชปํ•˜๋Š” ๋…น์ƒ‰ ์ฒดํฌ๋Š” ๋ฆฌ๋ทฐ๊ฐ€ ๋œ ๊ฒƒ์ฒ˜๋Ÿผ ์ฝํžˆ๊ฒŒ ๋งŒ๋“ ๋‹ค โ€” ์—†๋Š” ๊ฒŒ์ดํŠธ๋ณด๋‹ค ๋‚˜์˜๋‹ค. ํ•œ๋„๋ฅผ ๋ณต๊ตฌํ•˜๊ฑฐ๋‚˜ API ๊ณผ๊ธˆ์œผ๋กœ ๋ฐ”๊พธ๋Š” ๊ธธ(#486 ์กฐ์น˜ 4)์€ ๊ณผ๊ธˆ ๊ฒฐ์ •์ด ๋”ฐ๋กœ ํ•„์š”ํ•˜๊ณ , ์˜ค๋„ˆ๋Š” ๋ฆฌ๋ทฐ ์ž์ฒด๋ฅผ ๋นผ๊ธฐ๋กœ ํ–ˆ๋‹ค.
  • Impact: ์ด ์ €์žฅ์†Œ์— PR ์ž๋™ AI ๋ฆฌ๋ทฐ์–ด๊ฐ€ ์—†๋‹ค. ๋ฆฌ๋ทฐ๊ฐ€ ๋‹ฌ๋ฆฌ์ง€ ์•Š์€ ๊ฒƒ์„ ยซ์ง€์  ์—†์Œยป์œผ๋กœ ์ฝ์ง€ ์•Š๋Š”๋‹ค. exchange-money ยท good-teacher ์˜ ๊ฐ™์€ ์›Œํฌํ”Œ๋กœ๋Š” ์ด ๊ฒฐ์ •์˜ ๋ฒ”์œ„๊ฐ€ ์•„๋‹ˆ๋‹ค(#486 ์—ด๋ฆผ). cob update ์˜ ci ๋ฒ”์ฃผ ๋น„๊ต๋Š” co-bricks#797 ์ด ๊ณ ์ณ์ง€๊ธฐ ์ „๊นŒ์ง€ ๋ธŒ๋ฆญ ํŒŒ์ผ์„ ๋Œ€์‘์‹œํ‚ค์ง€ ๋ชปํ•œ๋‹ค.
  • Source: ํ”„๋กœ์ ํŠธ ์˜ค๋„ˆ ์š”์ฒญ(2026-10-02) ยท #546 ยท #547 ยท #486 ยท bricks#445/#446 ยท skills#509/#510

D-094: ๋ฐฑ์—”๋“œ(cocode_server)๋ฅผ ๋ถ„์„ยทDCMยทํฌ๋งทยทCI ๊ฒŒ์ดํŠธ์— ํŽธ์ž…ํ•œ๋‹ค โ€” D-031 ์˜ ๋งˆ์ง€๋ง‰ ์ œ์™ธ ํ•ด์ œ (#552)

  • Date: 2026-10-02
  • Context: D-031 ์€ ๋„๋„ˆ ํ‘œ๋ฉด์„ ๋ถ„์„ยท๋นŒ๋“œ ๋ฒ”์œ„์—์„œ ๋บ๊ณ , #458(D-087) ๋’ค์— ๋‚จ์€ ์ œ์™ธ๋Š” ๋ฐฑ์—”๋“œ ํ•˜๋‚˜์˜€๋‹ค(analysis_options.yaml ์˜ backend/cocode_server/** ยท melos ignore:). #429 ๊ฒฐ์ •(2026-09-21)์€ ใ€ŒํŽธ์ž…์€ cocode ๊ฐ€ ๋ฐฑ์—”๋“œ ๊ณ ์œ  ๊ธฐ๋Šฅ์„ ์ฒ˜์Œ ๋ถ™์ด๋Š” ์Šคํ† ๋ฆฌ์—์„œ, ๊ทธ PR ์ด ๋ฒ ์ด์Šค๋ผ์ธ์„ ํ•จ๊ป˜ ์„ธ์šด๋‹คใ€์˜€๊ณ , ๋ธ”๋กœ๊ทธ API(Project #548)๊ฐ€ ๊ทธ ์ฒซ ๊ณ ์œ  ๊ธฐ๋Šฅ์ด๋‹ค. ์‹ค์ธกํ•˜๋‹ˆ ์ œ์™ธ์˜ ์‹ค์ œ ํšจ๊ณผ๋Š” ๋ถ„์„๋งŒ์ด ์•„๋‹ˆ์—ˆ๋‹ค โ€” ๋ฐฑ์—”๋“œ๋งŒ ๋ฐ”๊พผ PR ์€ ๋ถ„์„ ๋Œ€์ƒ 0๊ฐœ๋กœ dart analyzeยทDCM ์„ ํ†ต์งธ๋กœ ๊ฑด๋„ˆ๋›ฐ์—ˆ๊ณ (analyze_changed_packages.py ๊ธ€๋กญ์— backend/ ์—†์Œ), ๋ฐฑ์—”๋“œ ํ†ตํ•ฉ ํ…Œ์ŠคํŠธ ์žก์€ detect_backend_impact.sh ๊ฐ€ ๋Š˜ ์Šคํ‚ต์‹œ์ผœ ์ƒ์„ฑ๋ฌผยทpasswords.yaml ์—†์ด ๋Œ๋ฉด ์ฃฝ๋Š”๋‹ค๋Š” ์‚ฌ์‹ค์กฐ์ฐจ ๋“œ๋Ÿฌ๋‚˜์ง€ ์•Š์•˜๋‹ค.
  • Decision:
    • ๋ฃจํŠธ analysis_options.yaml ์˜ ์„œ๋ฒ„ ์ œ์™ธ(analyzer ยท DCM)์™€ melos ignore: - cocode_server ๋ฅผ ์ง€์šด๋‹ค. ์ƒ์„ฑ ํด๋ผ์ด์–ธํŠธ(backend/cocode_client)์™€ ๋ฐฐํฌ ์ธํ”„๋ผ(deploy/aws) ์ œ์™ธ๋Š” ๊ทธ๋Œ€๋กœ๋‹ค.
    • CI ๋ถ€ํŠธ์ŠคํŠธ๋žฉ์€ backend_changed ์™€ ๋ฌด๊ด€ํ•˜๊ฒŒ ๋งค ์‹คํ–‰ backend:pod:generate ๋ฅผ ๋Œ๋ฆฌ๊ณ (์›Œํฌ์ŠคํŽ˜์ด์Šค ๋‹จ์ผ ๋ถ„์„์ด ์„œ๋ฒ„ ์†Œ์Šค๋ฅผ ๋ณธ๋‹ค), CRITICAL_FILES ๊ฐ€ lib/src/generated/{endpoints,protocol}.dart ๋ฅผ ์š”๊ตฌํ•œ๋‹ค. ๋“œ๋ฆฌํ”„ํŠธ ๊ฒŒ์ดํŠธ๋Š” ์ข…์ „๋Œ€๋กœ ๋ฐฑ์—”๋“œ ๋ณ€๊ฒฝ ์‹คํ–‰์—๋งŒ ๋ฌถ๋Š”๋‹ค.
    • ์„œ๋ฒ„๋ฅผ ๋ถ„์„ ๋Œ€์ƒ ํ›„๋ณด(analyze_changed_packages.py)์— ๋„ฃ๋Š”๋‹ค. ์ด๋ฆ„ ๊ธฐ๋ฐ˜ ์ œ์™ธ ๊ทœ์น™์€ ์—†์•ค๋‹ค.
    • ใ€Œ์„œ๋ฒ„๊ฐ€ ignore: ๋ฉด ์ƒ๋žตใ€ ๊ฐ•๋“ฑ ๊ฒฝ๋กœ ๋‘ ๊ฐœ(์—”๋“œํฌ์ธํŠธ ์ธ์ฆ ๊ฒŒ์ดํŠธ์˜ ์ „์ˆ˜ ๋Œ€์กฐ ์ƒ๋žต ยท ํ†ตํ•ฉ ํ…Œ์ŠคํŠธ ์Šคํ‚ต)๋ฅผ ์ž๊ธฐํ๊ธฐ ์กฐ๊ฑด๋Œ€๋กœ ํ๊ธฐํ•œ๋‹ค.
    • ๋ฐฑ์—”๋“œ ํ†ตํ•ฉ ํ…Œ์ŠคํŠธ ์žก์ด bootstrap ์•„ํ‹ฐํŒฉํŠธ(์ƒ์„ฑ๋ฌผ)๋ฅผ ํŽผ์น˜๊ณ  test ๋Ÿฐ๋ชจ๋“œ passwords.yaml ์„ ๋Ÿฌ๋„ˆ 1ํšŒ์šฉ ๊ฐ’์œผ๋กœ ๋งŒ๋“ ๋‹ค.
    • ๋ฒ ์ด์Šค๋ผ์ธ: ์„œ๋ฒ„ dart analyze error 0 ยท warning 0(๋‚ก์€ FutureCall @override 14๊ฑด ๋“ฑ 18๊ฑด ์ˆ˜์ •) ยท info 315(directives_ordering 296 ๋“ฑ ๋„๋„ˆ ์Šคํƒ€์ผ โ€” ๋น„์น˜๋ช…), DCM 1.38.3 error 0 ยท warning 54 ยท style 222. CI ๊ฒŒ์ดํŠธ๋Š” ์ข…์ „๊ณผ ๊ฐ™์ด error ๋งŒ ๋ง‰๋Š”๋‹ค.
  • Rationale: ๊ณ ์œ  ๊ธฐ๋Šฅ์ด ๋ถ™๋Š” ์ˆœ๊ฐ„๋ถ€ํ„ฐ ๊ทธ ์ฝ”๋“œ๋Š” ๊ฒŒ์ดํŠธ ์•„๋ž˜ ์žˆ์–ด์•ผ ํ•œ๋‹ค. ์ œ์™ธ๋ฅผ ๋‚จ๊ธด ์ฑ„ ๋ธ”๋กœ๊ทธ API ๋ฅผ ๋ถ™์ด๋ฉด ์ƒˆ ์ฝ”๋“œ๊ฐ€ ๋ถ„์„ยทํ…Œ์ŠคํŠธ ์—†์ด ๋จธ์ง€๋œ๋‹ค.
  • Impact: ๋ฐฑ์—”๋“œ๋ฅผ ๊ฑด๋“œ๋ฆฌ์ง€ ์•Š์€ PR ๋„ bootstrap ์—์„œ ์„œ๋ฒ„ ์ƒ์„ฑ(๋กœ์ปฌ ์‹ค์ธก ์•ฝ 30์ดˆ)์„ ํ•œ๋‹ค. ๋ฐฑ์—”๋“œ PR ์€ ํ†ตํ•ฉ ํ…Œ์ŠคํŠธ ์žก์ด ์‹ค์ œ๋กœ ๋ˆ๋‹ค(๋กœ์ปฌ ์‹ค์ธก unit 777 ยท integration 553 ํ†ต๊ณผ).
  • Source: #552 ยท #429 ยท D-031 ยท D-087 ยท Project #548

D-095: serverpod ์„ 4.1.0-beta.1 ๋กœ ์˜ฌ๋ฆฐ๋‹ค โ€” ์„œ๋ฒ„ยทํด๋ผ์ด์–ธํŠธยทADE ์•ฑยทCI CLI ํ•€ (#589)

  • Date: 2026-10-02
  • Context: ์˜ค๋„ˆ ์š”์ฒญ ใ€Œserverpod 4.1.0-beta ๋กœ ๋ชจ๋‘ ์—…๋ฐ์ดํŠธใ€. ๋ธ”๋กœ๊ทธ ๋ฐฑ์—”๋“œ(Project #548)๊ฐ€ ์ง„ํ–‰ ์ค‘์ด๊ณ , ์ด ๋จธ์‹ ์˜ ์ „์—ญ serverpod_cli ๋„ ์ด๋ฏธ 4.1.0-beta.1 ์ด์—ˆ๋‹ค. 4.0.1 โ†’ 4.1.0-beta.1 ๋ณ€๊ฒฝ ๊ธฐ๋ก์— ๊นจ์ง€๋Š” ๋ณ€๊ฒฝ์€ ์—†๋‹ค(4.1.0-beta.1: serverpod runner ยท ์‹คํ–‰ ์ค‘ ์„œ๋ฒ„ attach ยท Model.db.watch, 4.0.2: postgres ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์ƒํ–ฅ ยท ์ˆ˜์ •).
  • Decision: ์ €์žฅ์†Œ์˜ serverpod ํŒจํ‚ค์ง€ 16์ข…๊ณผ CLI ํ•€ 5๊ณณ(backend/cocode_server/pubspec.yaml SSOT ยท ci.yml ยท build.yaml ยท patrol-test.yml ยท activate_serverpod_cli.sh)์„ 4.1.0-beta.1 ๋กœ ์˜ฌ๋ฆฐ๋‹ค. ๋ธ”๋กœ๊ทธ ๋ฐฑ์—”๋“œ Epic(#549) ์•ˆ์—์„œ ์ฒ˜๋ฆฌํ•ด ๋‚จ์€ ๋ฐฑ์—”๋“œ ์ž‘์—…์ด ๊ฐ™์€ ๋ฒ„์ „ ์œ„์—์„œ ๋๋‚˜๊ฒŒ ํ•˜๊ณ , ์ตœ์ข… Project โ†’ development PR ์˜ ์ „์ฒด CI ๋กœ ๊ฒ€์ฆํ•œ๋‹ค. coco-de ํฌํฌ(serverpod-auth-kr ^4.0.0-beta.2 ยท serverpod-clickhouse >=3.2.0 <5.0.0)๋Š” ๊ทธ๋Œ€๋กœ ํ•ด์„๋ผ override ๋ฅผ ์Œ“์ง€ ์•Š์•˜๋‹ค.
  • Rationale: ํ”„๋ฆฌ๋ฆด๋ฆฌ์Šค์ง€๋งŒ ์˜ค๋„ˆ๊ฐ€ ์ƒํƒœ๊ณ„๋ฅผ 4.1 ๋กœ ์˜ฎ๊ธฐ๋Š” ์ค‘์ด๊ณ , ๊ธฐ๋Šฅ ๋ณ€๊ฒฝ์ด ์ถ”๊ฐ€ํ˜•์ด๋ผ ์œ„ํ—˜์ด ๋‚ฎ๋‹ค. ํ•€์„ ํ•œ ๊ณณ์ด๋ผ๋„ ๋‚จ๊ธฐ๋ฉด check_serverpod_cli_version.py ๊ฐ€ ๋ง‰๋Š”๋‹ค.
  • Impact: create-migration ๊ฒฐ๊ณผ ์Šคํ‚ค๋งˆ ๋ณ€ํ™” ์—†์Œ(๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ 0). ๋ฐฑ์—”๋“œ unit 1035 ยท integration 718 ํ†ต๊ณผ(4.1.0-beta.1). patrol-test.yml ์˜ CLI ๋ฒ„์ „ ๋น„๊ต๊ฐ€ ํ”„๋ฆฌ๋ฆด๋ฆฌ์Šค ๊ผฌ๋ฆฌ๋ฅผ ๋ฒ„๋ฆฌ๊ณ  ๋‚ก์€ "4.0.0" ๊ณผ ๋น„๊ตํ•˜๋˜ ๊ฒฐํ•จ์„ ํ•จ๊ป˜ ๊ณ ์ณค๋‹ค. ๊ณ ์ง€ ์žฌ์ƒ์„ฑ.
  • Source: #589 ยท #424 ยท D-094 ยท Project #548

D-096: ํ™ˆํŽ˜์ด์ง€ ๋ฒˆ๋“ค ์˜ˆ์‚ฐ์— ์ž‘์„ฑ์ž ํŽ˜์ด์ง€ ํด๋ž˜์Šค(220 KB gz)๋ฅผ ์‹ ์„คํ•œ๋‹ค โ€” ๋กœ๊ทธ์ธ ยท ์ฝœ๋ฐฑ ยท ๊ธ€์“ฐ๊ธฐ ์ŠคํŠœ๋””์˜ค (#560)

  • Date: 2026-10-03

  • Context: ๊ธ€์“ฐ๊ธฐ ์ŠคํŠœ๋””์˜ค(#560)๋Š” ํŽธ์ง‘๊ธฐ ยท ํ™•์ธ ๋Œ€ํ™”์ƒ์ž ยท ํƒญ ยท ๊ฒ€์ฆ์„ ์‹ฃ๋Š”๋‹ค. ์„ฌ์„ ์–ด๋–ป๊ฒŒ ๊ตฌ์„ฑํ•ด๋„ ๊ธฐ์กด ใ€Œ์„ฌ ํŽ˜์ด์ง€ใ€ ์˜ˆ์‚ฐ(192 KB gz)์— ๋“ค์ง€ ์•Š์•˜๋‹ค. ๊ธฐ๋Šฅ์„ ์ผ  ๋นŒ๋“œ๋กœ ์‹ค์ธกํ•œ ๊ฒฐ๊ณผ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™๋‹ค.

    • ๋กœ๊ทธ์ธ ์„ฌ์— ์ŠคํŠœ๋””์˜ค ๋‹จ๊ณ„๋ฅผ ๋”ํ•ด ์„ฌ ํ•˜๋‚˜๋กœ ๋‘๋ฉด, ๋กœ๊ทธ์ธ ยท ์ฝœ๋ฐฑ ยท ์ŠคํŠœ๋””์˜ค๊ฐ€ 216.7 KB ์ด๊ณ  ๋‹ค๋ฅธ ์˜ˆ์‚ฐ์€ ๋ชจ๋‘ ์ง€์ผœ์ง„๋‹ค.
    • ์ŠคํŠœ๋””์˜ค ์„ฌ์„ ๋”ฐ๋กœ ๋‘๋ฉด, ๋ชจ๋“  ํŽ˜์ด์ง€๊ฐ€ 1.8 KB ์ปค์ง€๊ณ  ๋ฌธ์˜ ํŽ˜์ด์ง€ 193.8 KB ยท ์ŠคํŠœ๋””์˜ค 213.7 KB ๊ฐ€ ๋œ๋‹ค.
    • ์ŠคํŠœ๋””์˜ค๋ฅผ ์ง€์—ฐ import ํ•˜๋ฉด, ํ—ค๋”๋งŒ ์žˆ๋Š” ํŽ˜์ด์ง€๊ฐ€ 151.6 KB(์˜ˆ์‚ฐ 150)๊ฐ€ ๋œ๋‹ค.

    ์„ฌ์ด ํ•˜๋‚˜ ๋Š˜ ๋•Œ๋งˆ๋‹ค dart2js ๊ฐ€ ๊ณต์œ  ์ฝ”๋“œ๋ฅผ ๋” ์ž˜๊ฒŒ ์ชผ๊ฐœ ๋ชจ๋“  ํŽ˜์ด์ง€๊ฐ€ ์•ฝ 2 KB ์ปค์ง„๋‹ค(#559 dump-info). ์˜ˆ์‚ฐ ๋ณ€๊ฒฝ์€ ๋ฆฌ๋“œ ์Šน์ธ ์‚ฌํ•ญ์ด๋‹ค(ํ™ˆํŽ˜์ด์ง€ README).

  • Options:

    1. ์ž‘์„ฑ์ž ํŽ˜์ด์ง€ ์˜ˆ์‚ฐ ์‹ ์„ค โ€” ์„ฌ ํ•˜๋‚˜ ๊ตฌ์„ฑ
    2. ์ŠคํŠœ๋””์˜ค ์„ฌ ๋ถ„๋ฆฌ + ์˜ˆ์‚ฐ 2๊ณณ ์ƒํ–ฅ
    3. ์ŠคํŠœ๋””์˜ค ๋ณด๋ฅ˜
  • Decision: ์˜ต์…˜ 1(์˜ค๋„ˆ ์Šน์ธ). ์ƒ‰์ธํ•˜์ง€ ์•Š๋Š” ์ž‘์„ฑ์ž ์ „์šฉ ํŽ˜์ด์ง€ ์…‹(login ยท loginCallback ยท blogStudio)์— 220 KB gz ์˜ˆ์‚ฐ ํด๋ž˜์Šค๋ฅผ ๋‘”๋‹ค. ๋‚˜๋จธ์ง€ ์˜ˆ์‚ฐ(main 68 ยท ํ—ค๋” 150 ยท ํ™ˆ 240 ยท ์„ฌ ํŽ˜์ด์ง€ 192 ยท ํŒŒํŠธ 46)์€ ๋ฐ”๊พธ์ง€ ์•Š๋Š”๋‹ค. ์„ฌ์€ ์•ฑ ํŒจํ‚ค์ง€์˜ author_flow ํ•˜๋‚˜์ด๊ณ , ์„ธ ํŽ˜์ด์ง€๋ฅผ ๋‹จ๊ณ„๋กœ ๋‚˜๋ˆ  ๋งก๋Š”๋‹ค.

  • Rationale: ๋Š˜์–ด๋‚œ ๋ฌด๊ฒŒ๋Š” ๋ฐฉ๋ฌธ์ž๊ฐ€ ์•„๋‹ˆ๋ผ ์ž‘์„ฑ์ž๊ฐ€ ์ง„๋‹ค. ์ผ๋ฐ˜ ๋ฐฉ๋ฌธ์ž ํŽ˜์ด์ง€๋Š” ๋ฌด๊ฒŒ๊ฐ€ ๊ทธ๋Œ€๋กœ์ด๊ณ , ์ž‘์„ฑ์ž ํŽ˜์ด์ง€๋Š” ๊ฒ€์ƒ‰ ์œ ์ž…์ด ์—†๋Š” ๋„๊ตฌ ํŽ˜์ด์ง€๋‹ค. ์„ฌ์„ ๋Š˜๋ฆฌ๋Š” ๋Œ€์•ˆ์€ ๋ชจ๋“  ๋ฐฉ๋ฌธ์ž์—๊ฒŒ ๋น„์šฉ์„ ๋ฌผ๋ฆฐ๋‹ค.

  • Impact:

    • site/homepage/scripts/verify_build.sh ์˜ V-22 ์— ํด๋ž˜์Šค๋ฅผ ์ถ”๊ฐ€ํ•œ๋‹ค. ๋Œ€์ƒ ํŽ˜์ด์ง€๋Š” ๊ฒฝ๋กœ๋ฅผ ์†์œผ๋กœ ์ ์ง€ ์•Š๊ณ  ๋งค๋‹ˆํŽ˜์ŠคํŠธ id ๋กœ ์ •ํ•œ๋‹ค.
    • ๋กœ๊ทธ์ธ ยท ์ฝœ๋ฐฑ ํŽ˜์ด์ง€๋„ ์ŠคํŠœ๋””์˜ค ์ฝ”๋“œ๋ฅผ ํ•จ๊ป˜ ๋ฐ›๋Š”๋‹ค(182 โ†’ ์•ฝ 217 KB).
  • Source: #560 ยท #559 DDR-L18 ยท Project #548

D-097: ํ’€์Šคํƒ feature ๋ฒˆ๋“ค ํ‘œ์ค€ v2 ๋ฅผ ์ฑ„ํƒํ•œ๋‹ค โ€” ์„ ์–ธ ๋‘ ํŒŒ์ผ ยท ์„ธ์…˜ ์ธ์ง€ ํฌํŠธ ยท ๊ตฌ SDK ๊ณ„์•ฝ ยท ์กฐ๊ฑด๋ถ€ Go (#854)

  • Date: 2026-10-07
  • Context: ๊ธฐ๋Šฅ ํ•˜๋‚˜๋ฅผ feature/<domain>/{app,console,server,client} ํ•œ ํด๋”์—์„œ ๊ฐœ๋ฐœํ•˜๋Š” ๊ตฌ์กฐ(Initiative #850)๋ฅผ ๋„๊ตฌยท๋ธŒ๋ฆญยทdonorยท๋ฐ๋ชจ์˜ ๊ธฐ๋ณธ๊ฐ’์œผ๋กœ ๋ฐ”๊พธ๊ธฐ ์ „์— PoC(Epic #852)๋กœ ๋‘ ์†Œ๋น„ ๊ฒฝ๋กœ๋ฅผ ๋๊นŒ์ง€ ๋Œ๋ ธ๋‹ค.
    • ์ƒ์„ฑ ๊ฒฝ๋กœ(#853): kernel + ๋ฒˆ๋“ค + notice_board
    • donor ๊ฒฝ๋กœ(unibook#14766): ์šด์˜ ์ค‘์ธ ai_chat ์ด๊ด€
    • syncโ†’apply ์‚ฌ์Šฌ(co-bricks#823)
    • ์‹ค์ธก ๊ฒฐ๊ณผ์™€ ๋งํฌ๋Š” docs/fullstack-bundle-poc/adr-v2.md ์— ์žˆ๋‹ค.
  • Decision: ๋กค์•„์›ƒ Go(์กฐ๊ฑด๋ถ€). ๊ฒฐ์ • AD-1~AD-11 ์˜ ์š”์ง€๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™๋‹ค(์ „๋ฌธ์€ ADR).
    • ์„ ์–ธ ํŒŒ์ผ์€ ๋‘˜๋กœ ๋‚˜๋ˆˆ๋‹ค. bundle.json ์€ ์กฐ๋ฆฝ ์„ ์–ธ(์—ญํ• โ†’๊ฒฝ๋กœ)์ด๊ณ , host-integration.json ์€ ์‹ค์ œ ์ด๋ฆ„ยทํฌํŠธยท์‹๋ณ„์žยทlegacy endpoint ๋‹ค.
    • ๋ชจ๋“ˆ์€ ํ˜ธ์ŠคํŠธ๋ฅผ import ํ•˜์ง€ ์•Š๋Š”๋‹ค. ํ˜ธ์ŠคํŠธ ๊ธฐ๋Šฅ์€ <Feature>HostBindings.bind/forSession ์„ธ์…˜ ์ธ์ง€ ํฌํŠธ๋กœ ๋ฐ›๋Š”๋‹ค.
    • ๋ฐฐํฌ๋œ ํด๋ผ์ด์–ธํŠธ๊ฐ€ ์žˆ๋Š” donor ๋Š” thin wrapper + ๊ณต์‹ extraClasses ๋ณ„์นญ + ๋ถˆ๋ณ€ ๊ตฌ SDK ์Šค๋ƒ…์ƒท ๊ณ„์•ฝ ํ…Œ์ŠคํŠธ๋ฅผ ์›จ์ด๋ธŒ๋งˆ๋‹ค ๊ฑฐ์นœ๋‹ค.
    • ์‹๋ณ„์ž ๋„๋ฉ”์ธ์€ donor ๊ฐ€ ์ •๋ณธ์ด๋‹ค(unibook User.id).
    • PostgreSQL ์†Œ์œ ๊ถŒ ์ด์ „์€ DDL 0 ์ด๋‹ค. ํด๋ผ์ด์–ธํŠธ SQLite ์ƒ์„ฑ๊ธฐ ํ•œ๊ณ„(4.1-beta)๋Š” CI ์ƒ์‹œ 3์ข… ์ฆ๋ช…์„ ๋ถ™์ธ ์กฐ๊ฑด๋ถ€ ์˜ˆ์™ธ๋‹ค(unibook#14785).
    • ์‹ ๊ทœ ํ”„๋กœ์ ํŠธ๋Š” bundle, ๊ธฐ์กด ํ”„๋กœ์ ํŠธ๋Š” marker ๋ณด์กด. kernel ๊ธฐ๋ณธ Serverpod ๋Š” ์ •์‹ ์•ˆ์ •ํŒ(4.0.3) ๊ทธ๋Œ€๋กœ๋‹ค.
    • donor UI ์—ญํ• ์€ donor ์ „์šฉ ์˜์กด(app 13 ยท console 7) ๋•Œ๋ฌธ์— ์ปค๋„ ํ”„๋กœ์ ํŠธ์˜ ์„ค์น˜ ๋Œ€์ƒ์ด ์•„๋‹ˆ๋‹ค. ๊ทธ๋ž˜์„œ monorepo ์Šค๋ƒ…์ƒท ๋ธŒ๋ฆญ์€ ์œ ์ง€ํ•œ๋‹ค.
    • ๊ธฐ๋Šฅ ๋ฒˆ์—ญ์€ ๊ธฐ๋Šฅ์ด ์†Œ์œ ํ•œ๋‹ค(feature/<d>/{app,console}/lib/src/i18n/).
    • donor ํ…Œ์ŠคํŠธ๋Š” TZ=UTC ์—์„œ๋„ ํ†ต๊ณผํ•ด์•ผ ํ•œ๋‹ค.
  • Rationale: ๊ณจ๊ฒฉ ์กด์žฌ๊ฐ€ ์•„๋‹ˆ๋ผ ์‹ค์ธก์œผ๋กœ ํŒ๋‹จํ–ˆ๋‹ค.
    • ์ƒ์„ฑ ๊ฒฝ๋กœ: ์‹ค์ œ HTTP SDKโ†’ํ˜ธ์ŠคํŠธโ†’๋ชจ๋“ˆโ†’๊ฒฉ๋ฆฌ Postgres ๋ฅผ ํฌํ•จํ•œ 139 ํ…Œ์ŠคํŠธ, ์ƒ์„ฑ drift 0 ยท ๊ณ„์ธต ์œ„๋ฐ˜ 0.
    • donor ๊ฒฝ๋กœ: ๋ชจ๋“ˆ 91 ยท ํ˜ธ์ŠคํŠธ ๋‹จ์œ„ 3,704 ยท ํ†ตํ•ฉ 3,934, ๊ตฌ SDK ๊ณ„์•ฝ 3, DDL 0 ์ฆ๋ช… 4.
    • ์‚ฌ์Šฌ: ์ •์‹ 4.0.3 ์ˆ˜์šฉ ํ˜ธ์ŠคํŠธ์—์„œ ai_chat 91(UTC ยท KST).
    • ์ฆ๋ช…๋˜์ง€ ์•Š์€ ๋‹ค๊ธฐ๋Šฅ ์ˆœํ™˜์€ identity ๊ธฐ๋ฐ˜ ๋ชจ๋“ˆ(unibook#14770)์„ Wave DยทE ์˜ ์„ ํ–‰ ์กฐ๊ฑด์œผ๋กœ ๋ฌถ์—ˆ๋‹ค.
  • Impact:
    • ๋กค์•„์›ƒ Epic ์˜ AC ๋ฅผ ์ด ๊ฒฐ์ •์œผ๋กœ ๊ฐฑ์‹ ํ•œ๋‹ค: co-bricks#824 ยท bricks#472 ยท coco-de/kernel#17 ยท unibook#14767 ยท skills#520 ยท #865.
    • bricks#477(donor ์žฌ sync)์˜ ์€ํ‡ด ๋ฒ”์œ„๋Š” prebuilt ์˜ legacy ํ…œํ”Œ๋ฆฟ ๊ฒฝ๋กœ๋กœ ์ขํžŒ๋‹ค. monorepo ์Šค๋ƒ…์ƒท ๋ธŒ๋ฆญ์€ ์œ ์ง€ํ•œ๋‹ค.
    • PoC ์—์„œ ๊ณต๊ธ‰ ๊ฒฐํ•จ ์ˆ˜์ •๊ณผ sync ์‚ฌ์Šฌ๋กœ ๋จธ์ง€๋œ PR: co-bricks#832 ยท #833, bricks#478 ยท #479 ยท #480, kernel#18, unibook#14788 ยท #14795.
  • Source: #854 ยท Epic #852 ยท docs/fullstack-bundle-poc/adr-v2.md ยท feature-bundle-poc ๋ณด๊ณ ์„œ

D-098: ๋ฒˆ๋“ค ์กฐ๋ฆฝ ์„ ์–ธ์— ํ•œ์ • UI ์—ญํ•  ์Šฌ๋กฏ์„ ํ—ˆ์šฉํ•œ๋‹ค โ€” ๊ธฐ๋ฐ˜ ์—ญํ•  ์ƒ์† ยท ์‹ค์ œ ์ด๋ฆ„์€ ํ˜ธ์ŠคํŠธ ๊ณ„์•ฝ (#924)

  • Date: 2026-10-08
  • Context: common/application ๋“ฑ UI ํŒจํ‚ค์ง€๊ฐ€ ์—ฌ๋Ÿฌ ๊ฐœ์ธ ๋„๋ฉ”์ธ์„ ํ•œ ๋ฒˆ๋“ค๋กœ ์˜ฎ๊ธธ ๋•Œ ๊ณ ์ • 6์—ญํ• ๋งŒ์œผ๋กœ๋Š” ํŒจํ‚ค์ง€๋ฅผ ๊ฐ๊ฐ ์„ ์–ธํ•  ์ˆ˜ ์—†๋‹ค. kernel#20๊ณผ co-bricks#828์ด ํ•œ์ • ์—ญํ•  ๋ฌธ๋ฒ•์„ ๋จผ์ € ๋จธ์ง€ํ–ˆ์œผ๋ฉฐ, #855์˜ cocode v2 ๊ฐ€๋“œ์™€ ๋ฌธ์„œ๋ฅผ ๊ฐ™์€ ๊ณ„์•ฝ์œผ๋กœ ๋งž์ถ˜๋‹ค.
  • Decision:
    • bundle.json.packages๋Š” ๊ธฐ๋ณธ 6์—ญํ• ๊ณผ ^(app|console)_[a-z][a-z0-9_]*$๋ฅผ ๋ฐ›๋Š”๋‹ค. ๊ฐ’์€ ๋ฒˆ๋“ค ์ƒ๋Œ€ ๊ฒฝ๋กœ ๋ฌธ์ž์—ด์ด๋ฉฐ, ํ•œ์ • ์Šฌ๋กฏ์€ ๊ฐ™์€ ์ด๋ฆ„์˜ ํ˜•์ œ ๋””๋ ‰ํ„ฐ๋ฆฌ์— ๋‘”๋‹ค. ์—ญํ•  ๊ฐ„ ๋””๋ ‰ํ„ฐ๋ฆฌ ๊ณต์œ ์™€ ๊ธฐ๋ฐ˜ app/console ์—ญํ•  ๋ˆ„๋ฝ์„ ๊ฑฐ์ ˆํ•œ๋‹ค.
    • ๊ธฐ๋ณธ ์ด๋ฆ„์€ app_<sub> โ†’ <d>_<sub>, console_<sub> โ†’ console_<d>_<sub>๋‹ค. ๋‹ค๋ฅธ ์‹ค์ œ ์ด๋ฆ„์€ host-integration.json.packageNames[<slot>]๋กœ ์„ ์–ธํ•˜๊ณ , ๋ฏธ์„ ์–ธ ์—ญํ• ์˜ ์ด๋ฆ„ ํ‚ค๋Š” ๊ฑฐ์ ˆํ•œ๋‹ค.
    • ๊ณ„์ธตยท๋Ÿฐํƒ€์ž„์€ ๊ธฐ๋ฐ˜ ์—ญํ• ์„ ์ƒ์†ํ•˜๊ณ  ๋ผ์šฐํ„ฐ ํŠน์ˆ˜ ๊ฒฝ๋กœ ๊ทœ์น™๋„ ์ƒ์†ํ•œ๋‹ค. ๊ธฐ์กด ๋ช…์‹œ DAG ๊นŠ์ดยท๋ž˜์นซ์„ ์œ ์ง€ํ•˜๋ฉฐ runtime_violations ๊ธฐ์ค€์€ 0์ด๋‹ค. ํ•œ์ • ์—ญํ• ์ด ์—†๋Š” blog/identity ๋ฒˆ๋“ค ๊ฒฐ๊ณผ๋Š” ๋ถˆ๋ณ€์ด๋‹ค.
  • Rationale: ์กฐ๋ฆฝ ๊ฒฝ๋กœ๋ฅผ ๊ธฐ์กด packages์— ๋”ํ•˜๋ฉด AD-1์˜ ์กฐ๋ฆฝ/ํ˜ธ์ŠคํŠธ ์†Œ์œ ๊ถŒ ๋ถ„๋ฆฌ๋ฅผ ์œ ์ง€ํ•˜๋ฉด์„œ ๋‹ค์ค‘ UI ํŒจํ‚ค์ง€์™€ donor ์‹ค์ œ ์ด๋ฆ„์„ ํ•จ๊ป˜ ๋ณด์กดํ•  ์ˆ˜ ์žˆ๋‹ค. kernel๊ณผ co-bricks์˜ ์ •๊ทœ์‹ยท๊ธฐ๋ณธ ์ด๋ฆ„ยท์˜ค๋ฅ˜ ์˜๋ฏธ๋ฅผ ์žฌ์‚ฌ์šฉํ•œ๋‹ค.
  • Rejected alternative: host-integration.json.rolePackages๋Š” ์กฐ๋ฆฝ ๊ฒฝ๋กœ๋ฅผ ํ˜ธ์ŠคํŠธ ๊ณ„์•ฝ์œผ๋กœ ์˜ฎ๊ฒจ AD-1์„ ๊นจ๊ณ  ๋™์ผํ•œ ๊ฐ€๋“œ ๋ณ€๊ฒฝ๋„ ํ•„์š”ํ•˜๋ฏ€๋กœ ๊ธฐ๊ฐํ•œ๋‹ค.
  • Impact: cocode check/list/generate/test/test-host/flutter-codegen๊ณผ ๊ณ„์ธตยท๋Ÿฐํƒ€์ž„ ๊ฐ€๋“œ ๋ฐ ํšŒ๊ท€๋ฅผ ๊ฐฑ์‹ ํ•œ๋‹ค. plan_codegen_targets.py์˜ ์ผ๋ฐ˜ ํŒจํ‚ค์ง€ ๊ธ€๋กญ์€ ์ด๋ฏธ ํ˜•์ œ ์Šฌ๋กฏ์„ ๋ฐœ๊ฒฌํ•˜๋ฉฐ, detect_backend_impact.sh์˜ server/client ํŒ์ •์€ ์ƒˆ UI ์Šฌ๋กฏ๊ณผ ๋ณ„๊ฐœ๋กœ ์œ ์ง€๋œ๋‹ค. ADR AD-1๊ณผ v2 ยง1.1์ด ์ด ๋ณด๊ฐ•์˜ ๋ฌธ์„œ ์ •๋ณธ์ด๋‹ค.
  • Source: #924 ยท Parent coco-de/skills#520 ยท #855 ยท kernel#21 6efd76a4 ยท co-bricks#849 8a0740b2 ยท docs/fullstack-bundle-poc/adr-v2.md AD-1

D-099: ํ™ˆํŽ˜์ด์ง€ ๋ฒˆ๋“ค ์˜ˆ์‚ฐ์˜ ํŽ˜์ด์ง€ ์„ฌ ํด๋ž˜์Šค๋ฅผ 192 โ†’ 194 KB gz ๋กœ ์˜ฌ๋ฆฐ๋‹ค โ€” coui_web-v0.156.0 (#935)

  • Date: 2026-10-08

  • Context: ์‚ฌ์ดํŠธ์˜ CoUI ํ•€์„ 86930350 ์—์„œ coui_web-v0.156.0(d11a1e27)์œผ๋กœ ์˜ฌ๋ฆฌ์ž(#935) ํด๋ผ์ด์–ธํŠธ JS ๊ฐ€ ๋ฒˆ๋“ค ์ „์ฒด๋กœ +2,159 B gz(+0.69 %, 312,210 โ†’ 314,369) ๋Š˜์—ˆ๋‹ค. dart2js ์ง€์—ฐ ํŒŒํŠธ ๋ฒˆํ˜ธ๊ฐ€ ๋ฐ”๋€Œ์–ด ํŒŒ์ผ๋ณ„๋กœ๋Š” ๊ฒฌ์ค„ ์ˆ˜ ์—†๊ณ , ์ฆ๊ฐ€๊ฐ€ ํ•œ ๊ณณ์ด ์•„๋‹ˆ๋ผ ๊ณต์œ  ์ฝ”๋“œ ์ „๋ฐ˜์— ํผ์ ธ ์žˆ๋‹ค. ์‹ค์ธก(gzip -9):

    • ํ—ค๋”๋งŒ 147.4 โ†’ 147.7 KB(์˜ˆ์‚ฐ 150) ยท Home 237.1 โ†’ 237.9 KB(์˜ˆ์‚ฐ 240) โ€” ์˜ˆ์‚ฐ ์•ˆ
    • ํŽ˜์ด์ง€ ์„ฌ ํŽ˜์ด์ง€(๋ฌธ์˜ ํผ) 191.8 โ†’ 192.6 KB(์˜ˆ์‚ฐ 192) โ€” 645 B ์ดˆ๊ณผ. ์›๋ž˜ ์—ฌ์œ ๋Š” 0.2 KB ์˜€๋‹ค

    ์˜ˆ์‚ฐ ๋ณ€๊ฒฝ์€ ๋ฆฌ๋“œ ์Šน์ธ ์‚ฌํ•ญ์ด๋‹ค(ํ™ˆํŽ˜์ด์ง€ README ยท verify_build.sh).

  • Options:

    1. ํŽ˜์ด์ง€ ์„ฌ ์˜ˆ์‚ฐ 192 โ†’ 194 KB (์—ฌ์œ  1.4 KB)
    2. ์˜ˆ์‚ฐ์€ ๊ทธ๋Œ€๋กœ ๋‘๊ณ  ํ•€์„ ์˜ฌ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค
    3. ์ฝ”๋“œ์—์„œ 645 B ์ด์ƒ ์ค„์ธ๋‹ค (๋ฒ”์œ„๊ฐ€ ์ปค์ง€๊ณ , ์ฆ๊ฐ€๊ฐ€ ๋ฒˆ๋“ค ์ „์ฒด์— ํผ์ ธ ์žˆ์–ด ์„ฑ๊ณต ๊ฐ€๋Šฅ์„ฑ์ด ๋‚ฎ๋‹ค)
  • Decision: ์˜ต์…˜ 1(์˜ค๋„ˆ ์Šน์ธ 2026-10-08). BUDGET_PAGE_ISLAND ๋งŒ 194 KB ๋กœ ์˜ฌ๋ฆฐ๋‹ค. main 68 ยท ์„ฌ ํŒŒํŠธ 46 ยท ํ—ค๋” 150 ยท Home 240 ยท ์ž‘์„ฑ์ž 220 ์€ ๊ทธ๋Œ€๋กœ๋‹ค.

  • Rationale: ์ฆ๊ฐ€๋Š” CoUI ๊ฐฑ์‹ ์ด ๊ณต์œ  ์ฝ”๋“œ์— ๋”ํ•œ ๊ฒƒ์ด๋ผ ์‚ฌ์ดํŠธ ์ฝ”๋“œ๋กœ ํ”ผํ•  ์ˆ˜ ์—†๊ณ (-O4 ๋กœ ์ค„์ด์ง€ ์•Š๋Š”๋‹ค๋Š” ๊ธฐ์กด ๊ฒฐ์ •๋„ ๊ทธ๋Œ€๋กœ), 0.69 % ์ฆ๊ฐ€๊ฐ€ ๋ฐฉ๋ฌธ์ž ์ฒด๊ฐ ์„ฑ๋Šฅ์„ ๋ฐ”๊พธ์ง€ ์•Š๋Š”๋‹ค. ํ•œ ๋‹จ๊ณ„ ์˜ฌ๋ฆผ(194)์ด ๋‹ค์Œ ๊ฐฑ์‹ ๊นŒ์ง€ 1.4 KB ์—ฌ์œ ๋ฅผ ๋‚จ๊ธด๋‹ค.

  • Impact: site/homepage/scripts/verify_build.sh ์˜ BUDGET_PAGE_ISLAND ์™€ ๊ทธ ๊ทผ๊ฑฐ ์ฃผ์„(4์ฐจ), README ยท ์•„ํ‚คํ…์ฒ˜ ๋ฌธ์„œ(ยง9.4)์˜ ํ˜„์žฌ ๊ฐ’์„ 194 ๋กœ ๊ณ ์ณค๋‹ค. ๋‹ค๋ฅธ ์˜ˆ์‚ฐ ํด๋ž˜์Šค๋Š” ๋ฐ”๊พธ์ง€ ์•Š๋Š”๋‹ค.

  • Source: #935 ยท D-096 ยท site/homepage/README.md

D-100: DCM ์‚ฌ์šฉ์„ ํ๊ธฐํ•˜๊ณ  Dart SDK ๋ถ„์„ยทํฌ๋งท์œผ๋กœ ํ†ต์ผํ•œ๋‹ค

  • Date: 2026-10-12
  • Decision: DCM CLI, ๊ทœ์น™ยทํ”„๋ฆฌ์…‹, ์ „์šฉ Melos ๋ช…๋ น, CI ๋ถ„์„ยท๋Œ€์‹œ๋ณด๋“œ ์—…๋กœ๋“œยท์•ผ๊ฐ„ ์‹คํ–‰์„ ์ œ๊ฑฐํ•œ๋‹ค. ํฌ๋งท์€ dart format, ๋ถ„์„์€ dart analyze๋ฅผ ์‚ฌ์šฉํ•œ๋‹ค.
  • Rationale: ์˜ค๋„ˆ๊ฐ€ DCM์„ ๋” ์ด์ƒ ์‚ฌ์šฉํ•˜์ง€ ์•Š๊ธฐ๋กœ ํ–ˆ๋‹ค. ๊ฐœ๋ฐœยทCIยท์ฝ”๋“œ ์ƒ์„ฑ ๊ฒฝ๋กœ์— ๊ฐ™์€ ๋„๊ตฌ๋ฅผ ์ ์šฉํ•ด ๋ผ์ด์„ ์Šค์™€ ๋ฐฐํฌ ์ฑ„๋„์— ๋”ฐ๋ฅธ ํฌ๋งท ์ฐจ์ด๋ฅผ ์—†์•ค๋‹ค.
  • Impact: ์ฝ”๋“œ ์ƒ์„ฑ ํ›„์ฒ˜๋ฆฌ์™€ ๋ณ€๊ฒฝ ํŒŒ์ผ ํฌ๋งท ๊ฒŒ์ดํŠธ๋ฅผ Dart๋กœ ์ „ํ™˜ํ•œ๋‹ค. ์ƒ์„ฑ๋ฌผยทํ”Œ๋žซํผ ์ œ์™ธ ๊ฒฝ๊ณ„์™€ Analyzer ๊ธฐ๋ฐ˜์˜ ๋ถ„์„ ๋Œ€์ƒ ์„ ์ •์€ ์œ ์ง€ํ•œ๋‹ค. ํฌ๋งท ์žก์€ .fvmrc์— ๊ณ ์ •๋œ Flutter SDK๋ฅผ ์„ค์น˜ํ•˜๋ฉฐ ํฌ๋งคํ„ฐ์˜ ์‹คํŒจ ์ข…๋ฃŒ ์ฝ”๋“œ๋ฅผ ๊ทธ๋Œ€๋กœ ์ „๋‹ฌํ•œ๋‹ค.
  • Scope: ์ด์ „ ๊ฒฐ์ •๊ณผ ๊ฒ€์ฆ ๋ณด๊ณ ์„œ์˜ DCM ๊ธฐ๋ก์€ ๋‹น์‹œ ์ฆ๊ฑฐ๋‹ค. ํ˜„์žฌ ์‹คํ–‰ ์ง€์นจ์€ ์ด ๊ฒฐ์ •๊ณผ CLAUDE.md๋ฅผ ๋”ฐ๋ฅธ๋‹ค. ํ๊ธฐ๋œ ๋„๊ตฌ์˜ ์ž”์—ฌ ์บ์‹œ ์ œ์™ธยท์ •๋ฆฌ๋งŒ ์œ ์ง€ํ•œ๋‹ค.
  • Source: ์˜ค๋„ˆ ์ง€์‹œ, 2026-10-12

D-101: serverpod ์„ 4.1.0-beta.3 ๋กœ ์˜ฌ๋ฆฐ๋‹ค โ€” ํŒจํ‚ค์ง€ 18์ข… ยท CLI ํ•€ 6๊ณณ ยท ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ 1๊ฑด

  • Date: 2026-10-20
  • Context: ์˜ค๋„ˆ ์š”์ฒญ ใ€Œserverpod 4.1.0-beta.3 ๋กœ ์—…๋ฐ์ดํŠธใ€. ์ด ๋จธ์‹ ์˜ ์ „์—ญ serverpod_cli ๋Š” ์ด๋ฏธ beta.3 ์ด๋ผ, beta.1 ์„ ํ•€ํ•œ ์›Œํฌ์ŠคํŽ˜์ด์Šค์—์„œ serverpod generate ๊ฐ€ ๋งŒ๋“  ์ฝ”๋“œ๊ฐ€ ์ปดํŒŒ์ผ๋˜์ง€ ์•Š์•˜๋‹ค(UndefinedSentinel ๋“ฑ beta.3 ๋Ÿฐํƒ€์ž„์—๋งŒ ์žˆ๋Š” ํƒ€์ž…). 4.1.0-beta.1 โ†’ beta.3 ๋ณ€๊ฒฝ ๊ธฐ๋ก(beta.2 ๋Š” ํŒจํ‚ค์ง• ๋ฌธ์ œ๋กœ ๊ฑด๋„ˆ๋œ€)์— ๊นจ์ง€๋Š” ๋ณ€๊ฒฝ์€ ์—†๋‹ค: copyWith ํƒ€์ž… ์„ผํ‹ฐ๋„, ๊ณต์œ ยท๋ชจ๋“ˆ ๋ชจ๋ธ ์—ญ์ง๋ ฌํ™” ์•ฝ 3๋ฐฐ, ์ŠคํŠธ๋ฆผ ์—…๋กœ๋”, 4.0.3 ยท 4.0.4 ์ˆ˜์ • ํฌํ•จ.
  • Decision: serverpod ํŒจํ‚ค์ง€ 18์ข…(์„œ๋ฒ„ ยท ํด๋ผ์ด์–ธํŠธ ยท Flutter ยท ํ…Œ์ŠคํŠธ)๊ณผ CLI ํ•€(ci.yml ยท build.yaml ยท patrol-test.yml ยท activate_serverpod_cli.sh ยท deployment-aws-docker.yml ยท ๋ฌธ์„œ)์„ 4.1.0-beta.3 ๋กœ ์˜ฌ๋ฆฐ๋‹ค. coco-de ํฌํฌ(serverpod-auth-kr ^4.0.0-beta.2 ยท serverpod-clickhouse >=3.2.0 <5.0.0)๋Š” ๊ทธ๋Œ€๋กœ ํ•ด์„๋ผ override ๋ฅผ ์Œ“์ง€ ์•Š์•˜๋‹ค.
  • Rationale: ๊ฐ™์€ CLIยทํŒจํ‚ค์ง€ ๋ฒ„์ „์ด์–ด์•ผ ์ƒ์„ฑ๋ฌผ์ด ์ปดํŒŒ์ผ๋œ๋‹ค(check_serverpod_cli_version.py). ๋ณ€๊ฒฝ์ด ์ถ”๊ฐ€ํ˜•์ด๊ณ  ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜์ด FK ํ•œ ๊ฑด์ด๋ผ ์œ„ํ—˜์ด ๋‚ฎ๋‹ค.
  • Impact: โ‘  create-migration ์ด ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ 1๊ฑด(20261020054155055-serverpod-4-1-0-beta-3)์„ ๋งŒ๋“ ๋‹ค โ€” serverpod_auth_core ยท serverpod_auth_idp ๋ชจ๋“ˆ ๋ฒ„์ „์ด ๋ฐ”๋€Œ๊ณ  serverpod_auth_core_profile_fk_1 ์ด DEFERRABLE INITIALLY DEFERRED ๋กœ ์žฌ์ •์˜๋œ๋‹ค(์šด์˜ ๋ฐ˜์˜ ์‹œ DROP/ADD CONSTRAINT ํ•œ ์Œ, ํ”„๋กœํ•„ ํ…Œ์ด๋ธ”์— ์งง์€ ์ž ๊ธˆ). โ‘ก ์ƒˆ ์ „์ด ์˜์กด์„ฑ serverpod_argon2 0.1.0(Zig ๊ธฐ๋ฐ˜, ๋นŒ๋“œ ํ›…์ด ์‚ฌ์ „ ๋นŒ๋“œ ๋„ค์ดํ‹ฐ๋ธŒ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ๋™๋ด‰) โ€” Dockerfile ์ด ์ด๋ฏธ dart build cli ๋ฅผ ์จ์„œ ๋ฒˆ๋“ค์— ์‹ค๋ฆฌ๋ฉฐ ๋ณ„๋„ ํˆด์ฒด์ธ์ด ํ•„์š” ์—†๋‹ค. โ‘ข check_serverpod_cli_version.py ๊ฐ€ ๋ณด์ง€ ์•Š๋Š” deployment-aws-docker.yml ํ•€๋„ ํ•จ๊ป˜ ์˜ฌ๋ ธ๋‹ค. โ‘ฃ pubspec.lock ยท ๊ณ ์ง€(THIRD_PARTY_NOTICES.md ยท copyleft_report.json)๋ฅผ ์žฌ์ƒ์„ฑํ–ˆ๋‹ค. โ‘ค ๋ฐฑ์—”๋“œ ๋‹จ์œ„(ํ˜ธ์ŠคํŠธ 1127 ยท identity ยท blog) ยท customer ํ†ตํ•ฉ ยท customer_app 73 ํ†ต๊ณผ. ์šด์˜(Lightsail)์€ ์ด ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜๊ณผ ํ•จ๊ป˜ ๋ฐฐํฌํ•ด์•ผ ํ•œ๋‹ค โ€” ๋ฐฐํฌ ์ „๊นŒ์ง€ docs/runbook-production-lightsail.md ์˜ ์šด์˜ ๋ฒ„์ „ ๊ธฐ๋ก์€ beta.1 ๊ทธ๋Œ€๋กœ๋‹ค.
  • Source: D-095 ยท check_serverpod_cli_version.py

D-102: ์ƒ์„ฑ ์•ฑ์€ ์ตœ์‹  CoUI ํ‚ท๊ณผ ํ”Œ๋žœ ๋‹จ๊ณ„ ๋ธŒ๋žœ๋“œ๋กœ ๋งŒ๋“ ๋‹ค โ€” ์ฒซ ํ™”๋ฉด ์‡ผ์ผ€์ด์Šค๋Š” ๋ฐ๋ชจ ํ•œ์ • ์˜ˆ์™ธ

  • Date: 2026-10-20
  • Context: ์˜ค๋„ˆ ์š”์ฒญ ใ€Œ์•ฑ ์ƒ์„ฑ๋  ๋•Œ CoUI ์ตœ์‹  ๋ฒ„์ „์œผ๋กœ ๋นŒ๋“œ๋˜๋„๋ก, ์ตœ์‹  coco-de/skills ๋กœ ๋””์ž์ธ ๋ธŒ๋žœ๋”ฉ์ด ๋ฐ˜์˜๋˜๋„๋ก โ€ฆ ๋ฐ๋ชจ ์•ฑ์ด์ง€๋งŒ WoW ํฌ์ธํŠธ๋ฅผ ์ฃผ๋Š” ๋น„์ฃผ์–ผ ๊ฐ•ํ™”ใ€. ๊ทธ๋•Œ๊นŒ์ง€ ์ƒ์„ฑ ์•ฑ์€ ๋ชจ๋ธ์ด ์†์œผ๋กœ ์“ด CSS ์˜€๊ณ  CoUI ์™€ ๋ฌด๊ด€ํ–ˆ๋‹ค. ๋ฏธ๋ฆฌ๋ณด๊ธฐ CSP ๊ฐ€ ๊ฐ™์€ ์ถœ์ฒ˜์˜ ์Šคํฌ๋ฆฝํŠธ ยท ์Šคํƒ€์ผ๋งŒ ํ—ˆ์šฉํ•˜๊ณ  ์„œ๋ฒ„๋Š” ์ƒ์„ฑ ์ฝ”๋“œ๋ฅผ ์‹คํ–‰ํ•˜์ง€ ์•Š๋Š”๋‹ค(๋นŒ๋“œ ๋‹จ๊ณ„ ์ปดํŒŒ์ผ ๋ถˆ๊ฐ€).
  • Decision: โ‘  tools/coui_kit/build.sh ๊ฐ€ ์ตœ์‹  coui_web-v* ๋ฆด๋ฆฌ์Šค(ํ˜„์žฌ v0.160.0, 80521926)์˜ ThemeConfig ํ† ํฐ ยท Tailwind ์„ค์ • ยท ๋ธŒ๋žœ๋“œ ํŒ”๋ ˆํŠธ 73๋ฒŒ๊ณผ Tailwind Play CDN 3.4.17 ยท Lucide 1.52.0 ์„ coui_kit_assets.g.dart ๋กœ ๊ตฝ๊ณ , ์„œ๋ฒ„๊ฐ€ ์•ฑ ์‚ฐ์ถœ๋ฌผ์˜ coui/ ์— ์‹ฃ๋Š”๋‹ค(์•ฑ์€ ๋งŒ๋“ค์–ด์ง„ ๋•Œ์˜ ํŒ์„ ์œ ์ง€). โ‘ก ํ”Œ๋žœ ๋‹จ๊ณ„์—์„œ ๋ชจ๋ธ์ด demo-brand-theme ์ถ•(hue 15ยฐ ๊ฒฉ์ž ยท ํ†ค ยท ๋ชจ์–‘ ยท ๊นŠ์ด ยท ์›€์ง์ž„ ยท ๋ฌด๋“œ ๋‚ฑ๋ง)์„ ๊ณ ๋ฅด๊ณ  ๊ณ„ํš ํ™”๋ฉด์ด ๋ณด์—ฌ ์ค€๋‹ค. ์ƒ‰ ๊ฐ’์€ ๋ชจ๋ธ์ด ์•„๋‹ˆ๋ผ CoUI ํŒ”๋ ˆํŠธ๊ฐ€ ์ •ํ•œ๋‹ค. โ‘ข ๋นŒ๋“œ ํ”„๋กฌํ”„ํŠธ๋Š” CoUI ์ด๋ฆ„๋งŒ ์ œ์‹œํ•œ๋‹ค(Tailwind ๊ธฐ๋ณธ ํŒ”๋ ˆํŠธ ์ œ๊ฑฐ ยท co-* ยท data-* ยท window.CoUI). โ‘ฃ coui-product-style ์˜ ใ€Œ์žฅ์‹ ์—†์Œใ€์€ ๋ฐ๋ชจ ์•ฑ ์ฒซ ํ™”๋ฉด(๋ธŒ๋žœ๋“œ ํžˆ์–ด๋กœ ยท ์ผ๋Ÿฌ์ŠคํŠธ ยท KPI ๋  ยท ๋“ฑ์žฅ ๋ชจ์…˜)์— ํ•œํ•ด ์˜ค๋„ˆ ์ง€์‹œ๋กœ ๋ฎ์–ด์“ด๋‹ค โ€” ๋‚˜๋จธ์ง€ ํ™”๋ฉด์€ ํ•˜์šฐ์Šค ์Šคํƒ€์ผ ๊ทธ๋Œ€๋กœ๋‹ค. โ‘ค ์„œ๋ฒ„๋Š” app.js ยท ์ธ๋ผ์ธ ์Šคํฌ๋ฆฝํŠธ๋ฅผ ์‹คํ–‰ ์—†์ด ์–ดํœ˜ ์ ๊ฒ€ํ•˜๊ณ , ๊ฑธ๋ฆฌ๋ฉด ํ•œ ๋ฒˆ ๋‹ค์‹œ ๋ฐ›๊ณ , ๋งˆ์ง€๋ง‰ ๋‹ต์€ ๊ทธ๋Œ€๋กœ ์‹ฃ๊ณ  ๋กœ๊ทธ์— ๋‚จ๊ธด๋‹ค.
  • Rationale: ๋ชจ๋ธ์ด CSS ๋ฅผ ์ง์ ‘ ์“ฐ๋ฉด ์•ฑ๋งˆ๋‹ค ํ’ˆ์งˆ ํŽธ์ฐจ๊ฐ€ ํฌ๊ณ  ๋‹คํฌ ๋ชจ๋“œ๊ฐ€ ๊นจ์ง„๋‹ค โ€” ํ† ํฐ ์ด๋ฆ„๋งŒ ์“ฐ๊ฒŒ ํ•˜๋ฉด ๋ธŒ๋žœ๋“œ ยท ๋‹คํฌ ยท ๊ณ ๋Œ€๋น„๊ฐ€ CoUI ์—์„œ ์˜จ๋‹ค. Play CDN ์€ CoUI ๋ฌธ์„œ ์‚ฌ์ดํŠธ(coui.cocode.im)์™€ ๊ฐ™์€ ํŒ์ด๊ณ , ์„œ๋ฒ„์— Node ๋ฅผ ๋‘์ง€ ์•Š๊ณ ๋„ ๋Ÿฐํƒ€์ž„์— ํด๋ž˜์Šค๋ฅผ ํ•ด์„ํ•œ๋‹ค. ์‹œ๋“œ ๋ช…๋„๋ฅผ ํฐ ๊ธ€์”จ ๋Œ€๋น„(primary 4.6:1 ยท ๋ณด์กฐ 3.2:1)๊นŒ์ง€ ๋‚ฎ์ถฐ 73๋ฒŒ ๋ชจ๋‘ WCAG ๋ฅผ ๋„˜๋Š”๋‹ค. ์‹ค์ธก(gpt-4.1 ยท gpt-5.5, ์—…์ข… 8์ข… 17ํšŒ): ๋นŒ๋“œ 27~52์ดˆ(gpt-4.1) ยท 120~159์ดˆ(gpt-5.5) โ€” ์ด์ „ ํ”„๋กฌํ”„ํŠธ์˜ 104~155์ดˆ(gpt-4.1)๋ณด๋‹ค ์งง๋‹ค(์ถœ๋ ฅ์ด Tailwind ยท ํ‚ท ์ด๋ฆ„์ด๋ผ ์งง๋‹ค). ์ ๊ฒ€ํ•œ 14๊ฐœ ์•ฑ ์ค‘ 2๊ฐœ(์ตœ์ข… ํ”„๋กฌํ”„ํŠธ ์ด์ „)์— ์Šคํฌ๋ฆฝํŠธ ๋ฌธ๋ฒ• ์˜ค๋ฅ˜๊ฐ€ ์žˆ์—ˆ๊ณ  ์ ๊ฒ€๊ธฐ ํŒ์ •์ด node ์™€ ๋ชจ๋‘ ์ผ์น˜ํ–ˆ๋‹ค โ€” ์‹ค์ œ JS 49๊ฐœ(Tailwind ๋ฒˆ๋“ค ํฌํ•จ)์—์„œ ์˜คํƒ 0. ํ™”๋ฉด ์ „ํ™˜์„ ํ‚ท์ด ๋งก๊ณ  ๋ชจ๋“  ํ™”๋ฉด์„ ์ •์  HTML ๋กœ ์“ฐ๊ฒŒ ํ•˜์ž ๋Ÿฐํƒ€์ž„ ์˜ค๋ฅ˜๋กœ ๋นˆ ํ™”๋ฉด์ด ๋˜๋˜ ์‚ฌ๋ก€๊ฐ€ ์‚ฌ๋ผ์กŒ๋‹ค.
  • Impact: โ‘  ์•ฑ ์‚ฐ์ถœ๋ฌผ์ด ๋ฆฌ๋น„์ „๋งˆ๋‹ค ํ‚ท ํฌ๊ธฐ(์••์ถ• ์•ฝ 190KB)๋งŒํผ ์ปค์ง„๋‹ค โ€” ์†Œ์Šค ZIP(7~13KB)์€ ๊ทธ๋Œ€๋กœ. โ‘ก ์ƒ์„ฑ ์•ฑ์— CoUI ยท Lucide(ISC) ยท Tailwind(MIT) ๊ณ ์ง€(coui/LICENSES.txt)๊ฐ€ ํ•จ๊ป˜ ๋‚˜๊ฐ„๋‹ค. โ‘ข CoUI ํŒ ์˜ฌ๋ฆฌ๊ธฐ๋Š” build.sh ์žฌ์‹คํ–‰ + ์ƒ์„ฑ๋ฌผ ์ปค๋ฐ‹ โ€” CoUI ์ถœ๋ ฅ ํ˜•์‹์ด ๋ฐ”๋€Œ๋ฉด ์ƒ์„ฑ๊ธฐ๊ฐ€ ๋‹จ์–ธ์œผ๋กœ ๋ฉˆ์ถ˜๋‹ค. CoUI 0.154 ์—์„œ deprecated ๋œ monochrome ๋งคํ•‘์€ ์“ฐ์ง€ ์•Š๋Š”๋‹ค(๋ชจ๋…ธ ํ†ค์€ ํ‘œ์ค€ ๋งคํ•‘ + ๊ฑฐ์˜ ๊ฒ€์€ primary). โ‘ฃ CustomerBuildPlanView.brand(nullable, ๋ทฐ ๋ชจ๋ธ โ€” ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ์—†์Œ), ๊ณ„ํš ํ™”๋ฉด ๋ธŒ๋žœ๋“œ ํŒจ๋„ ยท Widgetbook ใ€Œ๊ณ„ํš ยท ๋ธŒ๋žœ๋“œใ€.
  • Source: ์˜ค๋„ˆ ์ง€์‹œ, 2026-10-20 ยท cc-flutter:demo-brand-theme ยท cc-designer:coui-product-style(skills v5.25.0) ยท tools/coui_kit/README.md

D-103: ์Šคํ† ์–ด ์Šคํฌ๋ฆฐ์ƒท์€ IDE ๊ฐ€ ํŒ€ ํ”Œ๋Ÿฌ๊ทธ์ธ์„ ๋ชฐ์•„ ๋งŒ๋“ ๋‹ค โ€” ์„ค์น˜ ยท ๋กœ๊ทธ์ธ ยท ์บก์ฒ˜๋Š” ์‚ฌ๋žŒ์˜ ์‹คํ–‰, ์ƒ์„ฑ ์„ธ์…˜์€ ์—์ด์ „ํŠธ ์ง‘ํ–‰

  • Date: 2026-10-22
  • Context: ์˜ค๋„ˆ ์š”์ฒญ ใ€Œ์•ฑ ์ถœ์‹œ ๋•Œ๋งˆ๋‹ค ๋งŒ๋“ค๋˜ ์Šคํ† ์–ด ์Šคํฌ๋ฆฐ์ƒท์„ Claude ๋กœ ์ž๋™ ์ƒ์„ฑํ•˜๋Š” ๋„๊ตฌ๋ฅผ Cocode IDE ์—์„œ ์ง„ํ–‰ ๊ฐ€๋Šฅํ•˜๊ฒŒใ€(#1371). ๋„๊ตฌ๋Š” ํŒ€ Claude Code ํ”Œ๋Ÿฌ๊ทธ์ธ store-screenshots@cocode(๋น„๊ณต๊ฐœ coco-de/cocode-claude-plugins) + figma@claude-plugins-official ์ด๊ณ , ์ง€๊ธˆ์€ ํ„ฐ๋ฏธ๋„์— ์„ค์น˜ ๋ช…๋ น 3๊ฐœ๋ฅผ ๋ถ™์—ฌ๋„ฃ๊ณ  Claude Code /plugin ์—์„œ Figma ์— ๋กœ๊ทธ์ธํ•œ ๋’ค ์ž์—ฐ์–ด๋กœ ์š”์ฒญํ•œ๋‹ค. IDE(๋ฆฌ๋‰ด์–ผ ์…ธ)๋Š” Admin ๋กœ๊ทธ์ธ ๋•Œ๋งŒ ์—ด๋ฆฌ๋ฏ€๋กœ(CustomerAuthGate) ์“ฐ๋Š” ์‚ฌ๋žŒ์€ ๋น„๊ณต๊ฐœ ์ €์žฅ์†Œ์— ์ ‘๊ทผํ•  ์ˆ˜ ์žˆ๋Š” ํŒ€์›์ด๋‹ค.
  • Decision: โ‘  ๋ฆฌ๋‰ด์–ผ ์…ธ ใ€Œ๋ฐฐํฌใ€ ๋ชฉ์ ์ง€์— feature/store_screenshots/app ํŽ˜์ด์ง€๋ฅผ ๋„ฃ๋Š”๋‹ค(ํ˜ธ์ŠคํŠธ๊ฐ€ deployBuilder ๋กœ ์ฃผ์ž…, ์—†์œผ๋ฉด ์ง€๊ธˆ ์•ˆ๋‚ด๋ฌธ). โ‘ก ์ค€๋น„ ์ ๊ฒ€ ยท ์„ค์น˜ ยท Figma ๋กœ๊ทธ์ธ(claude mcp login, ๋‚ด์žฅ ํ„ฐ๋ฏธ๋„) ยท ์‹œ๋ฎฌ๋ ˆ์ดํ„ฐ ์บก์ฒ˜(simctl io โ€ฆ screenshot - ยท adb exec-out screencap -p)๋Š” ์‚ฌ๋žŒ์ด ๋ˆ„๋ฅธ ๋ฒ„ํŠผ์ด๋ผ SandboxProfile.humanTerminal ์ด๋‹ค(git clone ์„ ๋ก€). ์บก์ฒ˜ ํŒŒ์ผ์€ HumanEditWriter ๋กœ store-assets/screens/NN_<์ข…๋ฅ˜>_store.png ์— ์“ด๋‹ค(๋ฎ์–ด์“ฐ์ง€ ์•Š์Œ). โ‘ข ์ƒ์„ฑ ์„ธ์…˜(claude ๋Œ€ํ™”ํ˜•)์€ ์—์ด์ „ํŠธ๋ผ DD-16 ๋Œ€๋กœ SandboxProfile.agent + ์ „์šฉ ์ •์ฑ… ํ”„๋ก์‹œ(Anthropic 3 ยท Figma 4 ยท ๊ธฐ๋ณธ 3 ํ˜ธ์ŠคํŠธ)๋‹ค. ํ”„๋ก์‹œ๊ฐ€ ๋ง‰์€ ํ˜ธ์ŠคํŠธ๋Š” ํ™”๋ฉด์— ๋ณด์ด๊ณ (DD-17a), ๊ณ ๋ฅด๋ฉด ํ”„๋ก์‹œ๋ฅผ ์ƒˆ๋กœ ๋„์›Œ ๊ฐ™์€ ๋Œ€ํ™”๋ฅผ --resume <session-id> ๋กœ ์ž‡๋Š”๋‹ค(ํ—ˆ์šฉ์€ ์•ฑ ์„ธ์…˜ ๋™์•ˆ๋งŒ, Figma ๋„๋ฉ”์ธ๋งŒ ๋ฏธ๋ฆฌ ์„ ํƒ). โ‘ฃ ์š”์ฒญ ๋ฌธ๊ตฌ๋Š” ํ”Œ๋Ÿฌ๊ทธ์ธ ์•ˆ๋‚ด๋ฌธ ํ‘œํ˜„ ๊ทธ๋Œ€๋กœ(ใ€Œโ—‹โ—‹ ์Šคํ† ์–ด ์Šคํฌ๋ฆฐ์ƒท ๋งŒ๋“ค์–ด์ค˜. ํ™”๋ฉด์€ ./โ€ฆ ํด๋” PNG์•ผ.ใ€)์ด๊ณ , ์ •ํ•˜์ง€ ์•Š์€ ๋ธŒ๋žœ๋“œ ์ƒ‰ ยท ๋Œ€์ƒ ์Šคํ† ์–ด ยท ๋ฌธ๊ตฌ๋Š” ํ™”๋ฉด์„ ๋ณด๊ณ  ์ •ํ•œ ๋’ค ์•Œ๋ฆฌ๋ผ๊ณ  ๋ง๋ถ™์ธ๋‹ค. โ‘ค ๋„ค์ดํ‹ฐ๋ธŒ ๋ฉ”๋‰ด ๋ช…๋ น ํ–‰ ยท AI ๋…ธ์ถœ ์„ ์–ธ์€ AI ๋ช…๋ น ํ‘œ(Epic #1184)๊ฐ€ development ์— ๋“ค์–ด์˜จ ๋’ค #1192 ์—์„œ ๋”ํ•œ๋‹ค โ€” ์ง€๊ธˆ์€ ์‚ฌ์ด๋“œ๋ฐ”์™€ โŒ˜K ใ€Œ๊ฒ€์ƒ‰ ยท ๋ช…๋ นใ€.
  • Rationale: ์ƒ์„ฑ ๋กœ์ง์€ ํ”Œ๋Ÿฌ๊ทธ์ธ ํ•œ ๊ณณ์— ๋‘๊ณ  IDE ๋Š” ์ค€๋น„ ยท ์ž…๋ ฅ ยท ๊ธฐ๋™ ยท ๊ฒฐ๊ณผ๋งŒ ๋งก๋Š”๋‹ค โ€” ํ”Œ๋Ÿฌ๊ทธ์ธ์€ push ๋กœ ๋ฐฐํฌ๋˜๋ฏ€๋กœ IDE ๊ฐ€ ์‚ฌ๋ณธ์„ ๋“ค๋ฉด ๋‘˜์ด ๊ฐˆ๋ผ์ง„๋‹ค. ์‹œ๋ฎฌ๋ ˆ์ดํ„ฐ๋Š” ์žฅ๋งˆ๋‹ค ๋Œ€ํ™” ยท ๊ถŒํ•œ ์Šน์ธ์„ ๊ธฐ๋‹ค๋ฆฌ์ง€ ์•Š๋„๋ก IDE ๊ฐ€ ์ง์ ‘ ์ฐ๋Š”๋‹ค(์‚ฌ์šฉ์ž ๊ฒฐ์ •).
  • Impact: โ‘  Figma ์—…๋กœ๋“œ URL ํ˜ธ์ŠคํŠธ๋Š” ์‹ค์ธก ์ „์ด๋ผ ๊ธฐ๋ณธ ๋ชฉ๋ก์— ์—†๋‹ค โ€” ์ฒซ ์‹ค์‚ฌ์šฉ์—์„œ ๋ง‰ํžŒ ๋ชฉ๋ก์œผ๋กœ ํ™•์ธํ•ด kStoreScreenshotsFigmaHosts ์— ๋”ํ•œ๋‹ค. โ‘ก ํ”Œ๋Ÿฌ๊ทธ์ธ ์ž์ฒด์˜ ๊ด€์ฐฐ(๊ณ ์น˜์ง€ ์•Š์Œ): Microsoft Store ๋Š” ์Šคํฌ๋ฆฐ์ƒท์— ๋งˆ์ผ€ํŒ… ๋ฌธ๊ตฌ ยท ๋กœ๊ณ ๋ฅผ ๋„ฃ์ง€ ๋ง๋ผ๊ณ  ์•ˆ๋‚ดํ•˜๋Š”๋ฐ ํ‚คํŠธ ํ…œํ”Œ๋ฆฟ์€ ๋„ฃ๋Š”๋‹ค ยท ๋งค๋‰ด์–ผ iPhone ๊ทœ๊ฒฉ(1179ร—2556 ยท 1206ร—2622)๊ณผ ํ‚คํŠธ(6.9" 1320ร—2868)๊ฐ€ ๋‹ค๋ฅด๋‹ค.
  • Source: ์˜ค๋„ˆ ์ง€์‹œ, 2026-10-22 ยท #1371 ยท DD-16 ยท DD-17a ยท feature/store_screenshots/app

D-104: serverpod ์„ 4.1.0-rc.1 ๋กœ ์˜ฌ๋ฆฐ๋‹ค โ€” ํŒจํ‚ค์ง€ 18์ข… ยท CLI ํ•€ 6๊ณณ ยท ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ 1๊ฑด ยท ์ง„์ž…์  ๊ฒฐํ•จ 1๊ฑด

  • Date: 2026-10-26
  • Context: ์˜ค๋„ˆ ์š”์ฒญ ใ€Œserverpod: ^4.1.0-rc.1 ์—…๋ฐ์ดํŠธ ํ•ด์ค˜ใ€(#1417). 4.1.0-rc.1(pub.dev 2026-10-23)์€ 4.1 ๋ผ์ธ์˜ ์ฒซ ๋ฆด๋ฆฌ์Šค ํ›„๋ณด๋‹ค. 4.1.0-beta.3 โ†’ rc.1 ๋ณ€๊ฒฝ ๊ธฐ๋ก์— ๊นจ์ง€๋Š” ๋ณ€๊ฒฝ์€ ์—†๋‹ค: ์ด๋ฉ”์ผ IdP passwordless OTP ๋กœ๊ทธ์ธ, ์ž„๋ฒ ๋””๋“œ PostgreSQL TCP+Unix ์†Œ์ผ“, CLI ์˜ FVM ์ง€์› ยท serverpod doctor, ๋ชจ๋“ˆ future call ์ดˆ๊ธฐํ™” ยท ๋™์‹œ future call ํด๋ ˆ์ž„ FK ์œ„๋ฐ˜ ๋ฌด์‹œ, ํ…Œ์ŠคํŠธ ํ”„๋ ˆ์ž„์›Œํฌ record/map ์‘๋‹ต ์ง๋ ฌํ™”, ์ƒ์„ฑ ์‹คํŒจ ์‹œ ๋ฌด๊ด€ํ•œ ๋ชจ๋ธ ์‚ญ์ œ ๋ฐฉ์ง€, analyzer ์ƒํ•œ ์ƒํ–ฅ, JSON utf8 ์ง์ ‘ ์ธ์ฝ”๋”ฉ ยท serverpod generate ์„ฑ๋Šฅ ๊ฐœ์„ .
  • Decision: serverpod ํŒจํ‚ค์ง€ 18์ข…(๋ฝ ๊ธฐ์ค€: ์„œ๋ฒ„ ยท ํด๋ผ์ด์–ธํŠธ ยท Flutter ยท ํ…Œ์ŠคํŠธ)๊ณผ CLI ํ•€(ci.yml ยท build.yaml ยท patrol-test.yml ยท activate_serverpod_cli.sh ยท deployment-aws-docker.yml ยท dev_fullstack.sh ์ฃผ์„ ยท ๋ฌธ์„œ)์„ 4.1.0-rc.1 ๋กœ ์˜ฌ๋ฆฐ๋‹ค. ์š”์ฒญ ๋ฌธ๊ตฌ์˜ ์บ๋Ÿฟ(^4.1.0-rc.1)์ด ์•„๋‹ˆ๋ผ ์ •ํ™• ํ•€์„ ์“ด๋‹ค โ€” ์บ๋Ÿฟ์€ 4.1.0 ์ •์‹์ด๋‚˜ ์ดํ›„ 4.x ๊ฐ€ ๋‚˜์˜ค๋ฉด pub upgrade ๊ฐ€ ํŒจํ‚ค์ง€๋งŒ ์˜ฌ๋ฆฌ๊ณ  CI ์˜ CLI ํ•€์€ ๊ทธ๋Œ€๋กœ ๋‚จ๊ฒจ, ์„œ๋กœ ๋‹ค๋ฅธ ๋ฒ„์ „์ด ๋งŒ๋“  ์ƒ์„ฑ๋ฌผ์ด ์–ด๊ธ‹๋‚œ๋‹ค(D-101 ์—์„œ ๊ฒช์€ UndefinedSentinel ์ปดํŒŒ์ผ ์‹คํŒจ์™€ ๊ฐ™์€ ์œ ํ˜•์ด๋ฉฐ check_serverpod_cli_version.py ๋„ ์ •ํ™• ํ•€์„ ์ „์ œํ•œ๋‹ค). coco-de ํฌํฌ(serverpod-auth-kr ยท serverpod-clickhouse)๋Š” ๊ทธ๋Œ€๋กœ ํ•ด์„๋ผ override ๋ฅผ ์Œ“์ง€ ์•Š์•˜๋‹ค. ํ•จ๊ป˜ product_analytics_client ์ง„์ž…์ ์ด client.dart ยท protocol.dart ๋ฅผ ๋‚ด๋ณด๋‚ด๋„๋ก ๊ณ ์นœ๋‹ค(โ‘ข).
  • Rationale: D-101 ๊ณผ ๊ฐ™๋‹ค โ€” ๊ฐ™์€ CLIยทํŒจํ‚ค์ง€ ๋ฒ„์ „์ด์–ด์•ผ ์ƒ์„ฑ๋ฌผ์ด ์ปดํŒŒ์ผ๋œ๋‹ค. ๋ฝ์—์„œ ๋ฐ”๋€ ๊ฒƒ์ด serverpod_* 18์ข…๋ฟ์ด๊ณ  API ๋ณ€๊ฒฝ์€ ์ถ”๊ฐ€ํ˜•์ด๋ฉฐ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜์€ ์ƒˆ ํ…Œ์ด๋ธ” 1๊ฐœ๋ผ ์œ„ํ—˜์ด ๋‚ฎ๋‹ค.
  • Impact: โ‘  create-migration ์ด ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ 1๊ฑด(20261026064610737-serverpod-4-1-0-rc-1)์„ ๋งŒ๋“ ๋‹ค โ€” serverpod_auth_idp ๋ชจ๋“ˆ ๋ฒ„์ „์ด 20260924105404509 โ†’ 20261015164015382 ๋กœ ๋ฐ”๋€Œ๊ณ  passwordless OTP ์šฉ ์ƒˆ ํ…Œ์ด๋ธ” serverpod_auth_idp_email_account_otp_login_request(email ์œ ๋‹ˆํฌ, serverpod_auth_idp_secret_challenge FK 2๊ฐœ ON DELETE CASCADE)๊ฐ€ ์ƒ๊ธด๋‹ค. ๊ธฐ์กด ํ…Œ์ด๋ธ” ๋ณ€๊ฒฝ์€ ์—†๋‹ค. ์ง์ „ ์Šคํ‚ค๋งˆ์— migration.sql ์„ ์ ์šฉํ•œ ๊ฒฐ๊ณผ๊ฐ€ ์‹ ๊ทœ ์„ค์น˜(definition.sql)์™€ ์Šคํ‚ค๋งˆ ยท ๋ชจ๋“ˆ ๋ฒ„์ „ ๊ธฐ๋ก(12๊ฐœ ๋ชจ๋“ˆ)๊นŒ์ง€ ๊ฐ™์Œ์„ ๋กœ์ปฌ Postgres ๋กœ ํ™•์ธํ–ˆ๋‹ค. โ‘ก OTP ๋Š” ๋ณ„๋„ ์ถ”์ƒ ๋ฒ ์ด์Šค(EmailOtpIdpBaseEndpoint)์— ์žˆ์–ด ํ˜ธ์ŠคํŠธ๊ฐ€ ์ƒ์†ํ•˜์ง€ ์•Š๋Š” ํ•œ ๊ณต๊ฐœ API ๊ฐ€ ์•„๋‹ˆ๋‹ค โ€” ํ˜ธ์ŠคํŠธ ์ƒ์„ฑ ์„œ๋ฒ„ ยท ํด๋ผ์ด์–ธํŠธ์— ์ด๋ฉ”์ผ OTP ์—”๋“œํฌ์ธํŠธ๋Š” ์—†๋‹ค(๊ธฐ์กด PhoneOtpEndpoint ๋Š” ๋ณ„๊ฐœ). EmailIdp ยท EmailIdpConfig ๋ณ€๊ฒฝ์€ ์ถ”๊ฐ€ํ˜•์ด๊ณ  ๊ธฐ์กด ์ค„ ์‚ญ์ œ ยท ๋ณ€๊ฒฝ์ด 0์ด๋ฉฐ ๊ธฐ๋ณธ ๋™์ž‘๋„ ๊ฐ™๋‹ค(๊ธฐ๋ณธ ์ธ์ฆ์ฝ”๋“œ ์ƒ์„ฑ๊ธฐ 8์ž ์œ ์ง€). ๊ธฐ์กด ์ค„์ด ๋ฐ”๋€ ๊ฒƒ์€ ํ˜ธ์ŠคํŠธ๊ฐ€ ํ˜ธ์ถœํ•˜์ง€ ์•Š๋Š” EmailIdpAdmin.deletePasswordResetRequestAttempts ์˜ ์ด๋ฉ”์ผ ์ •๊ทœํ™” ํ•˜๋‚˜๋‹ค. OTP ๋กœ๊ทธ์ธ์„ ์ผœ๋ ค๋ฉด ์ƒ์† + sendOtpLoginVerificationCode ์„ค์ • + ์†๋„ ์ œํ•œ์„ ๋ณ„๋„ ๊ฒฐ์ •์œผ๋กœ ํ•œ๋‹ค. โ‘ข product_analytics_client ์ง„์ž…์ ์ด ๋ชจ๋ธ ํ•˜๋‚˜๋งŒ ๋‚ด๋ณด๋‚ด ํ˜ธ์ŠคํŠธ ์ƒ์„ฑ ํด๋ผ์ด์–ธํŠธ๊ฐ€ ์ปดํŒŒ์ผ๋˜์ง€ ์•Š๋˜ development ์˜ ๊ธฐ์กด ๊ฒฐํ•จ(#1402 ๋„์ž…)์„ ๊ณ ์ณค๋‹ค. ๋ณ€๊ฒฝ ์—†๋Š” origin/development(7556652c)๋ฅผ beta.3 CLI ๋กœ ์ƒ์„ฑํ•ด๋„ ๊ฐ™์€ ๋‹จ์œ„ ํ…Œ์ŠคํŠธ 5๊ฑด(seed_e2e_accounts_guard_test)์ด ์‹คํŒจํ•จ์„ ํ™•์ธํ–ˆ๋‹ค โ€” rc.1 ๊ณผ ๋ฌด๊ด€ํ•˜๋‹ค. ํ†ตํ•ฉ blog_legacy_http_test ๋กœ๋“œ ์‹คํŒจ 1๊ฑด๋„ ๊ฐ™์€ ์›์ธ์ด์—ˆ๋‹ค. โ‘ฃ ์šด์˜(Lightsail)์€ ์ด ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜๊ณผ ํ•จ๊ป˜ ๋ฐฐํฌํ•ด์•ผ ํ•œ๋‹ค โ€” ๋ฐฐํฌ ์ „๊นŒ์ง€ docs/runbook-production-lightsail.md ยท deployed-provenance.json ์˜ ์šด์˜ ๋ฒ„์ „ ๊ธฐ๋ก์€ beta.3 ๊ทธ๋Œ€๋กœ๋‹ค. โ‘ค ์ด ๋จธ์‹ ์˜ ์ „์—ญ serverpod_cli ๋Š” 4.1.0-beta.1 ์ด๋ผ ๊ฐฑ์‹  ์ „์— serverpod generate ๋ฅผ ์“ฐ๋ฉด ์ƒ์„ฑ๋ฌผ์ด ์–ด๊ธ‹๋‚œ๋‹ค: dart pub global activate serverpod_cli 4.1.0-rc.1. โ‘ฅ pubspec.lock ยท ๊ณ ์ง€(THIRD_PARTY_NOTICES.md ยท copyleft_report.json ยท oss-notices-cocode.md)๋ฅผ ์žฌ์ƒ์„ฑํ–ˆ๋‹ค. โ‘ฆ ๊ฒ€์ฆ: ๋ฐฑ์—”๋“œ ํ˜ธ์ŠคํŠธ ๋‹จ์œ„ 1131 ยท ํ†ตํ•ฉ 992(์Šคํ‚ต 3 ยท 2) ยท ๋ชจ๋“ˆ ๋‹จ์œ„(identity 54 ยท blog 262) ํ†ต๊ณผ, check_serverpod_cli_version.py ยท check_migration_order.py ยท actionlint ยท feature_modules.py check ํ†ต๊ณผ.
  • Source: D-101 ยท check_serverpod_cli_version.py ยท #1417 ยท #1402

D-105: serverpod ์„ 4.1.0 ์ •์‹์œผ๋กœ ์˜ฌ๋ฆฐ๋‹ค โ€” ํŒจํ‚ค์ง€ 18์ข… ยท CLI ํ•€ 6๊ณณ ยท ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ 0๊ฑด

  • Date: 2026-11-01
  • Context: ์˜ค๋„ˆ ์š”์ฒญ ใ€Œserverpod: ^4.1.0 ์—…๋ฐ์ดํŠธ ๋ฐ˜์˜ ํ•ดใ€(#1446). 4.1.0 ์ •์‹์€ 4.1 ๋ผ์ธ์˜ ์ฒซ ์ •์‹ ๋ฆด๋ฆฌ์Šค๋‹ค(๋ฝ์˜ serverpod_* 18์ข…๊ณผ serverpod_cli ๋ชจ๋‘ pub.dev ๊ฒŒ์‹œ). ๋ณ€๊ฒฝ ๊ธฐ๋ก(CHANGELOG)์ด 4.1 ๋ผ์ธ ํ†ตํ•ฉ๋ณธ์ด๋ผ rc.1 โ†” 4.1.0 ์„ ๊ฐ€๋ฅด์ง€ ๋ชปํ•ด, ํŒจํ‚ค์ง€ 18์ข…๊ณผ CLI ์˜ ์†Œ์Šค๋ฅผ ์ง์ ‘ ๋Œ€์กฐํ–ˆ๋‹ค. ํŒจํ‚ค์ง€ ์ƒํ˜ธ ํ•€ ยท serverpodVersion ์ƒ์ˆ˜ ์™ธ์˜ ๋ณ€ํ™”๋Š” โ‘  ์—”๋“œํฌ์ธํŠธ ์ธ์ž ์—ญ์ง๋ ฌํ™” ์‹คํŒจ๊ฐ€ InvalidParametersException(400)์ด ๋œ๋‹ค(๊ฐ’์€ ์‘๋‹ต์— ์‹ฃ์ง€ ์•Š๋Š”๋‹ค) โ‘ก updateById ยท updateWhere ๊ฐ€ RETURNING * ๋Œ€์‹  buildReturningClause ๋ฅผ ์“ด๋‹ค(๋ช…์‹œ ์ปฌ๋Ÿผ๋ช… ๋ชจ๋ธ์˜ ํ•„๋“œ๋ช… ๋ฐ˜ํ™˜ ์ˆ˜์ •) โ‘ข ๋‹ซํžŒ WebSocket ์œผ๋กœ์˜ ์†ก์‹ ์€ ์˜ค๋ฅ˜๊ฐ€ ์•„๋‹ˆ๋ผ ๋กœ๊ทธ๋กœ ๋ฒ„๋ฆฐ๋‹ค โ‘ฃ ์ž„๋ฒ ๋””๋“œ PostgreSQL ์ด TCP ๋ฅผ ๊ธฐ๋ณธ์œผ๋กœ ์ผœ์ง€ ์•Š๋Š”๋‹ค(์šฐ๋ฆฌ๋Š” ์ž„๋ฒ ๋””๋“œ๋ฅผ ์“ฐ์ง€ ์•Š๋Š”๋‹ค) โ‘ค ์—ญ์ง๋ ฌํ™” ๋ผ์šฐํŒ…์ด classNames ยท classNamePrefix ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ๋ฅผ ์“ฐ๊ณ  ์ƒ์„ฑ๊ธฐ๊ฐ€ ์ด๋ฅผ protocol.dart ์— ๋‚ด๋ณด๋‚ธ๋‹ค โ€” ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ๊ฐ€ ์—†๋Š” ๊ตฌํ˜• ํ”„๋กœํ† ์ฝœ(coco-de ํฌํฌ)์€ ๊ธฐ์กด ํด๋ฐฑ์„ ๊ทธ๋Œ€๋กœ ์“ฐ๋Š” ํ˜ผํ•ฉ ์„ธ๋Œ€ ํ˜ธํ™˜ ์„ค๊ณ„๋‹ค. serverpod_database ๊ฐ€ sqlparser ๋ฅผ ^0.44.3 โ†’ ^0.45.1 ๋กœ ์˜ฌ๋ ธ๋‹ค. ์–ด๋А ํŒจํ‚ค์ง€์—์„œ๋„ migrations/ ๋Š” ๋ฐ”๋€Œ์ง€ ์•Š์•˜๋‹ค.
  • Decision: serverpod ํŒจํ‚ค์ง€ 18์ข…(๋ฝ ๊ธฐ์ค€: ์„œ๋ฒ„ ยท ํด๋ผ์ด์–ธํŠธ ยท Flutter ยท ํ…Œ์ŠคํŠธ)๊ณผ CLI ํ•€(ci.yml ยท build.yaml ยท patrol-test.yml ยท activate_serverpod_cli.sh ยท deployment-aws-docker.yml ยท dev_fullstack.sh ์ฃผ์„ ยท ๋ฌธ์„œ)์„ 4.1.0 ์œผ๋กœ ์˜ฌ๋ฆฐ๋‹ค. ์š”์ฒญ ๋ฌธ๊ตฌ์˜ ์บ๋Ÿฟ(^4.1.0)์ด ์•„๋‹ˆ๋ผ ์ •ํ™• ํ•€์„ ์“ด๋‹ค โ€” D-104 ์™€ ๊ฐ™์€ ์ด์œ (์บ๋Ÿฟ์ด๋ฉด ์ดํ›„ 4.x ์—์„œ pub upgrade ๊ฐ€ ํŒจํ‚ค์ง€๋งŒ ์˜ฌ๋ฆฌ๊ณ  CI ์˜ CLI ํ•€์€ ๊ทธ๋Œ€๋กœ ๋‚จ๊ฒจ ์„œ๋กœ ๋‹ค๋ฅธ ๋ฒ„์ „์ด ๋งŒ๋“  ์ƒ์„ฑ๋ฌผ์ด ์–ด๊ธ‹๋‚œ๋‹ค)์— ๋”ํ•ด, check_serverpod_cli_version.py ๊ฐ€ backend/cocode_server/pubspec.yaml ์˜ ๊ฐ’์„ ๋ฌธ์ž์—ด ๊ทธ๋Œ€๋กœ CI ํ•€๊ณผ ๋น„๊ตํ•˜๋ฏ€๋กœ ^4.1.0 ์ด๋ฉด ๊ฐ€๋“œ๊ฐ€ ์‹คํŒจํ•œ๋‹ค. coco-de ํฌํฌ(serverpod-auth-kr ยท serverpod-clickhouse)๋Š” ๊ทธ๋Œ€๋กœ ํ•ด์„๋ผ override ๋ฅผ ์Œ“์ง€ ์•Š์•˜๋‹ค.
  • Rationale: D-101 ยท D-104 ์™€ ๊ฐ™๋‹ค โ€” ๊ฐ™์€ CLIยทํŒจํ‚ค์ง€ ๋ฒ„์ „์ด์–ด์•ผ ์ƒ์„ฑ๋ฌผ์ด ์ปดํŒŒ์ผ๋œ๋‹ค. ๋ฝ์—์„œ ๋ฐ”๋€ ๊ฒƒ์ด serverpod_* 18์ข…๊ณผ sqlparser ๋ฟ์ด๊ณ (์›Œํฌ์ŠคํŽ˜์ด์Šค์— drift ์—†์Œ) ์Šคํ‚ค๋งˆ ๋ณ€ํ™”๊ฐ€ ์—†๋‹ค.
  • Impact: โ‘  4.1.0 CLI ๋กœ ์žฌ์ƒ์„ฑํ•œ ๋’ค ํ˜ธ์ŠคํŠธ create-migration ์€ ใ€ŒNo changes detectedใ€ โ€” ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜์ด ์—†๋‹ค. ๊ฐ feature ์„œ๋ฒ„์—์„œ ๋Œ๋ฆฐ create-migration ์€ identity ยท blog ๋ชจ๋“ˆ์—์„œ๋งŒ ์ƒˆ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜์„ ๋งŒ๋“ค๋ ค ํ–ˆ๋Š”๋ฐ, 4.1.0 ๊ณผ ๋ฌด๊ด€ํ•œ ๊ธฐ์กด ๋“œ๋ฆฌํ”„ํŠธ(๋ชจ๋“ˆ ์Šค๋ƒ…์ƒท์˜ ๋งˆ์ง€๋ง‰ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜์ด 10-03 ์ด๋ผ rc.1 ์˜ serverpod_auth_idp ์Šคํ‚ค๋งˆ๋ฅผ ๋‹ด์ง€ ์•Š๋Š”๋‹ค โ€” ๋Ÿฐํƒ€์ž„์€ ํ˜ธ์ŠคํŠธ migrations/ ๋งŒ ์ฝ๋Š”๋‹ค)๋ผ ์ด๋ฒˆ ๋ฒ”์œ„์—์„œ ๋˜๋Œ๋ฆฌ๊ณ  #1449 ๋กœ ๋‚จ๊ฒผ๋‹ค. โ‘ก pubspec.lock ์€ serverpod_* 18์ข… + sqlparser 0.44.5 โ†’ 0.45.1 ๋งŒ ๋ฐ”๋€๋‹ค. โ‘ข ์šด์˜(Lightsail)์€ ์•„์ง rc.1 ์ด๋ฏธ์ง€๋‹ค โ€” ์ด ๋ณ€๊ฒฝ์—๋Š” DB ๋ณ€๊ฒฝ์ด ์—†์–ด ๋ฐฐํฌ๊ฐ€ ๊ฐ€์ ธ์˜ค๋Š” ๊ฒƒ์€ ์œ„ ๋Ÿฐํƒ€์ž„ ๋ณ€ํ™”๋ฟ์ด๋‹ค. ๋ฐฐํฌ ์ „๊นŒ์ง€ docs/runbook-production-lightsail.md ยท deployed-provenance.json ์˜ ์šด์˜ ๋ฒ„์ „ ๊ธฐ๋ก์€ rc.1 ๊ทธ๋Œ€๋กœ๋‹ค. โ‘ฃ ์ด ๋จธ์‹ ์˜ ์ „์—ญ serverpod_cli ๋Š” 4.0.0 ์ด๋ผ ๊ฐฑ์‹  ์ „์— serverpod generate ๋ฅผ ์“ฐ๋ฉด ์ƒ์„ฑ๋ฌผ์ด ์–ด๊ธ‹๋‚œ๋‹ค: dart pub global activate serverpod_cli 4.1.0. โ‘ค ๊ณ ์ง€(THIRD_PARTY_NOTICES.md ยท copyleft_report.json ยท oss-notices-cocode.md)๋ฅผ ์žฌ์ƒ์„ฑํ–ˆ๋‹ค. โ‘ฅ ๊ฒ€์ฆ: ๋ฐฑ์—”๋“œ ํ˜ธ์ŠคํŠธ ๋‹จ์œ„ 1131(์Šคํ‚ต 3) ยท ํ†ตํ•ฉ 1017(์Šคํ‚ต 2) ยท ๋ชจ๋“ˆ ์ „์ฒด(identity 54 ยท blog 262 ยท business_card 21 ยท customer 84 ยท customer/app 167 ยท renewal/app 3) ํ†ต๊ณผ, 12๊ฐœ ํŒจํ‚ค์ง€ dart analyze error ยท warning 0, check_serverpod_cli_version.py ยท check_migration_order.py ยท actionlint ยท feature_modules.py check ํ†ต๊ณผ.
  • Source: D-104 ยท D-101 ยท check_serverpod_cli_version.py ยท #1446 ยท #1449

D-106: ํ™ˆํŽ˜์ด์ง€ ๋ฐฉ๋ฌธ ์ˆ˜์ง‘์„ ์ŠคํŠœ๋””์˜ค์™€ ๋ถ„๋ฆฌํ•˜๊ณ  ใ€Œ๋ถ„์„์„ ๊ณ ์ง€ํ•œ ๋ฐฉ์นจ์ด ์‹œํ–‰ ์ค‘์ผ ๋•Œ๋งŒใ€ ์ผ ๋‹ค โ€” ์‹œํ–‰์ผ ์ž๋™ ๊ฐœ์‹œ

  • Date: 2026-11-09
  • Context: ์˜ค๋„ˆ ์š”์ฒญ ใ€Œcocode.im/admin/ ํ™ˆํŽ˜์ด์ง€ ์ ‘์† ์ •๋ณด ๋ถ„์„์ด ์ œ๋Œ€๋กœ ์ˆ˜์ง‘๋˜์ง€ ๋ชปํ•˜๊ณ  ์žˆ๋Š”๋ฐ ๊ฐœ์„  ๋ฐ˜์˜ํ•˜๊ณ  ๋ฐฐํฌ ํ•ด์ค˜ใ€(#1506). ์‹ค์ธกํ•˜๋‹ˆ ๋ผ์ด๋ธŒ ํ™ˆํŽ˜์ด์ง€ 6๊ณณ ๋ชจ๋‘ ์ˆ˜์ง‘ ์Šคํฌ๋ฆฝํŠธ์™€ ๋™์˜ ๋ฐฐ๋„ˆ๊ฐ€ ์—†์—ˆ๋‹ค. #1402 ๊ฐ€ ๋‘˜์˜ ์กฐ๊ฑด์„ ๋ธ”๋กœ๊ทธ ์ŠคํŠœ๋””์˜ค์˜ API ์ฃผ์†Œ(kCocodeApiBase)์— ๋ฌถ์—ˆ๊ณ , ๊ทธ ์ฃผ์†Œ๋Š” ์ŠคํŠœ๋””์˜ค ๋ชจ๋“œ์—์„œ๋งŒ ๋นŒ๋“œ์— ๋„˜์–ด๊ฐ€๋Š”๋ฐ ์šด์˜์€ ์ŠคํŠœ๋””์˜ค๊ฐ€ ๊บผ์ ธ ์žˆ์–ด ์ˆ˜์ง‘์ด ํ•œ ๋ฒˆ๋„ ์ผœ์ง„ ์ ์ด ์—†๋‹ค. ๋ฐฑ์—”๋“œ(์ˆ˜์ง‘ API ยท CORS ยท ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜)๋Š” ์ •์ƒ์ด๋‹ค. ๋‹ค๋งŒ ์ฝ”๋“œ๋Š” ใ€Œ๋ฐฉ์นจ์— ๋ถ„์„ ์ ˆ์„ ์‹ฃ๊ณ  7์ผ ๊ณต์ง€ํ•œ ๋’ค ์ผ ๋‹คใ€(FLAG F-23)๋Š” ์กฐ๊ฑด์œผ๋กœ ์ผ๋ถ€๋Ÿฌ ๋ง‰์•„ ๋‘์—ˆ๊ณ , ํ˜„ํ–‰ ๋ฐฉ์นจ(2026-10-03 ์‹œํ–‰)์—๋Š” ์ฟ ํ‚ค ยท ๋ถ„์„ ์ ˆ์ด ์—†๋‹ค. ๋ณด์กด ๊ธฐ๊ฐ„์„ ์ •ํ•ด ์ง€์šฐ๋Š” ์ž‘์—…๋„ ์—†๋‹ค.
  • Decision: โ‘  ์ˆ˜์ง‘์„ ์ŠคํŠœ๋””์˜ค์™€ ์™„์ „ํžˆ ๋ถ„๋ฆฌํ•œ๋‹ค โ€” ๋นŒ๋“œ ์ธ์ž --analytics-api-base(ANALYTICS_API_BASE, ํด๋ฐฑ ์—†์Œ), pages.yaml ์ด ๊ธ€ ๋ชจ๋“œ์™€ ๋ฌด๊ด€ํ•˜๊ฒŒ ๋„˜๊ธฐ๊ณ  ์ €์žฅ์†Œ ๋ณ€์ˆ˜ ANALYTICS_ENABLED=false ๋กœ ๋ˆ๋‹ค. โ‘ก ์ฃผ์†Œ๋งŒ์œผ๋กœ๋Š” ์ผœ์ง€์ง€ ์•Š๋Š”๋‹ค โ€” ๋นŒ๋“œ ๋‚ ์งœ์— ์‹œํ–‰ ์ค‘์ธ ๋ฐฉ์นจ ํŒ์ด ๋ถ„์„์„ ๊ณ ์ง€ํ•  ๋•Œ(PrivacyVersion.coversAnalytics, ํ•„์ˆ˜ ์ธ์ž)๋งŒ ์Šคํฌ๋ฆฝํŠธ์™€ ๋ฐฐ๋„ˆ๊ฐ€ ์‹ค๋ฆฐ๋‹ค(fail-closed). โ‘ข ์‹œํ–‰์ผ์ด ์ง€๋‚˜๋ฉด ์˜ˆ์•ฝ ์‹คํ–‰์ด ์•Œ์•„์„œ ์žฌ๋ฐฐํฌํ•œ๋‹ค โ€” ๋ฐฐํฌ ์ƒํƒœ์— -analytics-<์‹œํ–‰์ผ> ์ถ•(๋ถ„์„ ๊ณ ์ง€ ํŒ์ด ์‹œํ–‰ ์ค‘์ผ ๋•Œ๋งŒ ๋ถ™๋Š”๋‹ค), ํ™ˆํŽ˜์ด์ง€ ์บ์‹œ ํ‚ค์—๋„ ๊ฐ™์€ ์ถ•. โ‘ฃ ์‚ฐ์ถœ๋ฌผ ๊ฒ€์ฆ V-26(์Šคํฌ๋ฆฝํŠธ โ†” ๋ฐฐ๋„ˆ ์ง). โ‘ค ์ˆ˜์ง‘๊ธฐ ๋ณด๊ฐ•(์„ธ ๋ฒˆ ๊ฑฐ์ ˆ๋œ ์ด๋ฒคํŠธ ํ๊ธฐ ยท bfcache ๋ณต๊ท€๋ฅผ ํŽ˜์ด์ง€ ์กฐํšŒ๋กœ) ๊ณผ ์–ด๋“œ๋ฏผ์˜ ์ˆ˜์ง‘๊ธฐ ์ž๊ฐ€ ์ ๊ฒ€. โ‘ฅ ๋ฐฉ์นจ ์ƒˆ ํŒ์€ ์ด PR ์— ๋„ฃ์ง€ ์•Š๊ณ  ๋ณ„๋„ ์ดˆ์•ˆ PR ๋กœ ์˜ค๋„ˆ๊ฐ€ ๊ฒ€ํ† ํ•œ๋‹ค.
  • Rationale: ์˜ค๋„ˆ ์„ ํƒ(2026-11-09) ใ€Œ๋ฐฉ์นจ ๊ฐœ์ • ํ›„ ์ž๋™ ๊ฐœ์‹œใ€. ๋ฐฉ์นจ์— ์—†๋Š” ์ˆ˜์ง‘์„ ์‹œ์ž‘ํ•˜์ง€ ์•Š๋Š”๋‹ค๋Š” ์•ฝ์†์„ ๋ฌธ์„œ๊ฐ€ ์•„๋‹ˆ๋ผ ์ฝ”๋“œ๊ฐ€ ์ง€ํ‚ค๊ฒŒ ํ•œ๋‹ค(๊ฒŒ์ดํŠธ D ์™€ ๊ฐ™์€ ๋ฐœ์ƒ). ์ŠคํŠœ๋””์˜ค ํด๋ฐฑ์„ ๋‘์ง€ ์•Š์€ ์ด์œ : ๋„๋Š” ์Šค์œ„์น˜๊ฐ€ ์ŠคํŠœ๋””์˜ค ๋ชจ๋“œ์—์„œ ๋“ฃ์ง€ ์•Š๊ณ , ๊ฐœ๋ฐœ์ž๊ฐ€ --api-base ๋งŒ ์ค˜๋„ ์‹ค์ œ API ๋กœ ์ˆ˜์ง‘์ด ์ผœ์ง€๊ธฐ ๋•Œ๋ฌธ์ด๋‹ค. ์ƒํƒœ ์ถ•์„ ใ€Œ๊ณ ์ง€ ํŒ์ด ์‹œํ–‰ ์ค‘์ผ ๋•Œ๋งŒใ€ ๋ถ™์ธ ์ด์œ : ๊ธฐ๋ณธ ์ƒํƒœ ๋ฌธ์ž์—ด์ด ์ด ๊ธฐ๋Šฅ ์ „๊ณผ ๊ฐ™์•„์•ผ ๋ผ์ด๋ธŒ ํ‘œ์ง€์™€ ๋งž๋Š”๋‹ค(์“ธ๋ฐ์—†๋Š” ์žฌ๋ฐฐํฌ๊ฐ€ ์—†๋‹ค).
  • Impact: โ‘  ์ด PR ์˜ ๋ฐฐํฌ ์‹œ์ ์—๋Š” ๋ถ„์„์„ ๊ณ ์ง€ํ•œ ๋ฐฉ์นจ์ด ์—†์œผ๋ฏ€๋กœ ๋ผ์ด๋ธŒ๋Š” ๋ฐ”๋€Œ์ง€ ์•Š๋Š”๋‹ค(์ˆ˜์ง‘ ยท ๋ฐฐ๋„ˆ ์—†์Œ, ์–ด๋“œ๋ฏผ์ด ใ€Œ์ˆ˜์ง‘๊ธฐ ๊บผ์งใ€๊ณผ ์ด์œ ๋ฅผ ๋ณด์—ฌ ์ค€๋‹ค). โ‘ก ๋ฐฉ์นจ ์ƒˆ ํŒ์ด ๋จธ์ง€๋ผ ์‹œํ–‰์ผ์ด ๋˜๋ฉด ๋‹ค์Œ ์˜ˆ์•ฝ ์‹คํ–‰(15๋ถ„ ์ฃผ๊ธฐ)์ด ์žฌ๋นŒ๋“œํ•˜๊ณ  ์ˆ˜์ง‘์ด ์‹œ์ž‘๋œ๋‹ค โ€” ๊ทธ ์ „๊นŒ์ง€ ํ™ˆํŽ˜์ด์ง€ ์ˆ˜์น˜๋Š” 0 ์ด๋‹ค. โ‘ข ์ƒˆ ํŒ์€ coversAnalytics ๋ฅผ ๋ฐ˜๋“œ์‹œ ๋ช…์‹œํ•œ๋‹ค โ€” ๋ถ„์„ ์ ˆ์ด ์žˆ๋Š”์ง€ ์ œ๋ชฉ์œผ๋กœ ๋Œ€์กฐํ•˜๋Š” ํ…Œ์ŠคํŠธ๊ฐ€ ๊ฐ’๊ณผ ๊ธ€์ด ์–ด๊ธ‹๋‚˜๋ฉด ๋ง‰๋Š”๋‹ค. โ‘ฃ ๋ธ”๋กœ๊ทธ ์ŠคํŠœ๋””์˜ค ๋นŒ๋“œ๋Š” ๋”๋Š” ์ˆ˜์ง‘์„ ๋ค์œผ๋กœ ์–ป์ง€ ์•Š๋Š”๋‹ค. โ‘ค ๋ณด์กด ๊ธฐ๊ฐ„ ์ •๊ธฐ ์‚ญ์ œ๋Š” ๋ฐฉ์นจ ์‹œํ–‰ ์ „์— ํ•„์š”ํ•˜๋‹ค(ํ›„์†). โ‘ฅ ์•Œ๋ ค์ง„ ํ•œ๊ณ„: ์‹œํ–‰์ผ 0์‹œ(KST) ๊ฒฝ๊ณ„์—์„œ ์ƒํƒœ ๊ณ„์‚ฐ๊ณผ ๋นŒ๋“œ๊ฐ€ ์„œ๋กœ ๋‹ค๋ฅธ ๋‚ ์งœ๋ฅผ ๋ณด๋ฉด ํ•œ ๋ฒˆ ๋” ๋นŒ๋“œํ•˜๊ณ  ์ˆ˜๋ ดํ•œ๋‹ค(์ž๊ธฐ ์น˜์œ ).
  • Source: ์˜ค๋„ˆ ์ง€์‹œ, 2026-11-09 ยท #1506 ยท #1402 ยท admin-product-analytics.md ยท FLAG F-23 ยท F-12

D-107: Cocode IDE ์š”๊ธˆ์ œ๋ฅผ ๊ฐœ์ธ ยท Pro ยท ํŒ€ ยท ์ปค์Šคํ…€ 4๋‹จ๊ณผ AI ํฌ๋ ˆ๋”ง ๊ธฐ์ค€์œผ๋กœ ๊ณต๊ฐœํ•œ๋‹ค โ€” ์ƒˆ ๊ฐ€๊ฒฉ์€ ์ถœ์‹œ ๋•Œ ์ ์šฉ, ์ง€๊ธˆ์€ ํ˜„์žฌ Pro ์ด์šฉ๊ถŒ๋งŒ ํŒ๋งค

  • Date: 2026-11-10
  • Context: ์˜ค๋„ˆ ์š”์ฒญ ใ€Œํฌ์Šคํ‹ฐ๋”” ๊ฐ€๊ฒฉ ํŽ˜์ด์ง€๋ฅผ ๋ถ„์„ํ•ด Cocode IDE ๊ฐ€๊ฒฉ ์ •์ฑ…์„ ์—…๋ฐ์ดํŠธํ•˜๊ณ  ํ™ˆํŽ˜์ด์ง€์— ๋ฐ˜์˜ใ€ + ใ€ŒAI ํฌ๋ ˆ๋”ง์— ๋Œ€ํ•œ ๋ช…ํ™•ํ•œ ๊ฐ€์ด๋“œ๊ฐ€ ์—†์œผ๋‹ˆ ์ œ๋Œ€๋กœ ๋ฐ˜์˜. ๊ฐœ์ธ ยท ํ”„๋กœ ยท ํŒ€ ยท ์ปค์Šคํ…€๊นŒ์ง€ ์—ฐ๊ฐ„ ๊ฒฐ์ œ ํ• ์ธ์„ ์ ์šฉใ€(#1529), ์ด์–ด ใ€Œ๊ฒฐ๊ณผ ๋‚˜์˜ค๋ฉด ์•Œ์•„์„œ ๊ฒฐ์ •ํ•ด์„œ ๋ฐฐํฌ๊นŒ์ง€ใ€์™€ ใ€Œ๊ฐ€๊ฒฉ์„ 2๋ฐฐ๋กœ โ€” ๊ฐœ์ธ 29,000์› ยท Pro 58,000์› ๊ธ‰์œผ๋กœใ€. ๊ธฐ์กด /pricing/ ์€ ๋ฌด๋ฃŒ ์ฒดํ—˜ + Pro(29,000์›) ๋‘ ์žฅ์ด์—ˆ๊ณ , ํฌ๋ ˆ๋”ง์€ ใ€Œ์ถฉ์ „ ๊ธˆ์•ก๊ณผ ์ฐจ๊ฐ๋Ÿ‰์€ ์ƒํ’ˆ ๊ณต๊ฐœ ์‹œ ์•ˆ๋‚ดใ€๋ฟ์ด์—ˆ๋‹ค(#1484 โ€” ์„œ๋ฒ„์˜ ์ถ”๊ฐ€ ํฌ๋ ˆ๋”ง ์ƒํ’ˆ ์„ค์ •์€ ๋น„์–ด ์žˆ๋‹ค). ์„œ๋ฒ„๊ฐ€ ํŒŒ๋Š” ์ƒํ’ˆ์€ Pro ์ด์šฉ๊ถŒ(30์ผ ยท ์›” ๊ตฌ๋…, 29,000์› โ€” ์„œ๋ฒ„ ์†Œ์œ  ๊ฐ€๊ฒฉ) ํ•˜๋‚˜์ด๊ณ  ์œ ๋ฃŒ ๊ณ„์ •์˜ AI ์ˆ˜์ •์€ ๊ณ„๋Ÿ‰ํ•˜์ง€ ์•Š๋Š”๋‹ค. ๊ธฐ์กด Pro ์นด๋“œ์˜ ใ€Œํ”„๋กœ์ ํŠธ์™€ ์†Œ์Šค ๋‚ด๋ณด๋‚ด๊ธฐใ€๋Š” ๊ณ ๊ฐ์šฉ์œผ๋กœ ๊ตฌํ˜„๋ผ ์žˆ์ง€ ์•Š์•˜๋‹ค(๊ณ„์ • ์ •๋ณด ๋‚ด๋ณด๋‚ด๊ธฐ๋งŒ ์žˆ๋‹ค).
  • Decision: โ‘  ์š”๊ธˆ์ œ 4๋‹จ(์ •๊ฐ€) โ€” ๊ฐœ์ธ 29,000์› ยท Pro 58,000์› ยท ํŒ€ 198,000์›(3๋ช… ํฌํ•จ, 1๋ช… ์ถ”๊ฐ€ 50,000์›) ยท ์ปค์Šคํ…€ ๊ฒฌ์ , ๋ชจ๋‘ ์›” ยท VAT ํฌํ•จ. ์ฒซ ์ œ์•ˆ(15,000 ยท 29,000 ยท 99,000์›)์˜ ๋‘ ๋ฐฐ๋กœ ์˜ค๋„ˆ๊ฐ€ ์กฐ์ •ํ–ˆ๋‹ค. โ‘ก ์—ฐ๊ฐ„ ๊ฒฐ์ œ 20% ํ• ์ธ โ€” ์›” ์š”๊ธˆ ร— 12 ร— 0.8 ์„ ํ•œ ๋ฒˆ์— ๊ฒฐ์ œ(๊ฐœ์ธ 278,400 ยท Pro 556,800 ยท ํŒ€ 1,900,800์›), ํฌ๋ ˆ๋”ง์€ ๋งค๋‹ฌ ๋‚˜๋ˆ  ์ง€๊ธ‰ํ•œ๋‹ค. โ‘ข AI ํฌ๋ ˆ๋”ง โ€” 1ํฌ๋ ˆ๋”ง = 100์›(์ถฉ์ „ ๊ธฐ์ค€๊ฐ€, ์„œ๋ฒ„ ๋‹จ์œ„์™€ ๊ฐ™๋‹ค), AI ์‹คํ–‰ 1ํšŒ(์ƒˆ ์•ฑ ๋งŒ๋“ค๊ธฐ ยท AI ์ˆ˜์ • 1ํšŒ) = 5ํฌ๋ ˆ๋”ง. AI ๊ธฐํš์•ˆ ยท ๊ธฐ๋ณธ ์•ฑ๊ณผ ์ฒซ ๋งž์ถค ยท ๋ฏธ๋ฆฌ๋ณด๊ธฐ ยท ๊ณต์œ  ๋งํฌ ยท ๋˜๋Œ๋ฆฌ๊ธฐ ยท ์‹คํŒจํ•˜๊ฑฐ๋‚˜ ์ทจ์†Œํ•œ ์‹คํ–‰์€ 0. ์š”๊ธˆ์ œ ํฌ๋ ˆ๋”ง์€ ๋งค์›” 400 ยท 1,000 ยท 4,000(ํŒ€ ๊ณต์œ ) ยท ํ˜‘์˜์ด๊ณ  ๋‹ค์Œ ๊ฒฐ์ œ์ผ์— ์†Œ๋ฉธํ•œ๋‹ค(์ด์›” ์—†์Œ). ์ถฉ์ „์€ 100ํฌ๋ ˆ๋”ง = 10,000์›, ์ถฉ์ „ํ•œ ๋‹ฌ ๋ง์ผ ์†Œ๋ฉธ, ๋งŒ๋ฃŒ๊ฐ€ ๋น ๋ฅธ ํฌ๋ ˆ๋”ง๋ถ€ํ„ฐ ์“ด๋‹ค. โ‘ฃ ํŒ๋งค โ€” ์ƒˆ ์š”๊ธˆ์ œ ยท ์—ฐ๊ฐ„ ๊ฒฐ์ œ ยท ์š”๊ธˆ์ œ ํฌ๋ ˆ๋”ง ยท ์†Œ์Šค ๋‚ด๋ณด๋‚ด๊ธฐ๋Š” ๋ชจ๋‘ ใ€Œ์ถœ์‹œ ์ค€๋น„ ์ค‘ใ€์œผ๋กœ ์‹ฃ๊ณ  ์ฃผ๋ฌธ ๋งํฌ๋ฅผ ๋‹ฌ์ง€ ์•Š๋Š”๋‹ค. ์ง€๊ธˆ ์ฃผ๋ฌธํ•  ์ˆ˜ ์žˆ๋Š” ๊ฒƒ์€ ํ˜„์žฌ Pro ์ด์šฉ๊ถŒ(29,000์›, ํฌ๋ ˆ๋”ง ์ฐจ๊ฐ ์—†์Œ) ํ•˜๋‚˜๋กœ, ์นด๋“œ ์•„๋ž˜ ๋ณ„๋„ ๋ ์—์„œ๋งŒ ์ฃผ๋ฌธ์„œ๋กœ ์ž‡๋Š”๋‹ค. ์ƒˆ ๊ฐ€๊ฒฉ์€ ์„œ๋ฒ„์˜ ์š”๊ธˆ์ œ ยท ํฌ๋ ˆ๋”ง๊ณผ ํ•จ๊ป˜ ์ถœ์‹œํ•  ๋•Œ ์ ์šฉํ•˜๊ณ , ์ถœ์‹œ ์ „์— ๊ฒฐ์ œํ•œ ๊ธฐ๊ฐ„์—๋Š” ๊ฒฐ์ œ ๋‹น์‹œ ์กฐ๊ฑด์ด ์ ์šฉ๋œ๋‹ค. โ‘ค ์ˆซ์ž๋Š” IdePricing ํ•œ ๊ณณ โ€” ์นด๋“œ ยท ๋น„๊ตํ‘œ ยท FAQ(FAQPage ๊ตฌ์กฐํ™” ๋ฐ์ดํ„ฐ) ยท ํ…Œ์ŠคํŠธ๊ฐ€ ๊ฐ™์ด ์ฝ๋Š”๋‹ค.
  • Rationale: ํฌ์Šคํ‹ฐ๋””์—์„œ ๋Œ€์ƒ ํ•œ ์ค„ ยท ์›”/์—ฐ๊ฐ„ ํ† ๊ธ€ ยท ํฌ๋ ˆ๋”ง์˜ ใ€Œ์•ฝ NํšŒใ€ ํ™˜์‚ฐ ยท ์ž‘์—…๋ณ„ ์†Œ๋ชจ๋Ÿ‰ ํ‘œ ยท ๊ทธ๋ฃน ๋น„๊ตํ‘œ ยท ํฌ๋ ˆ๋”ง ์ด์›”/ํ•ด์ง€ FAQ ๋ฅผ ๊ฐ€์ ธ์˜ค๊ณ , ๊ฐ€๊ฒฉ ์ธ์ƒ ๊ธด๋ฐ•๊ฐ ๋ฐฐ๋„ˆ ยท ๊ทผ๊ฑฐ ์—†๋Š” ใ€Œ๊ฐ€์žฅ ์ธ๊ธฐใ€(โ†’ ใ€Œ์ถ”์ฒœใ€) ยท VAT ๋ฏธํ‘œ๊ธฐ ยท ์š”๊ธˆ์ œ๋งˆ๋‹ค ๋‹ค๋ฅธ ์ถฉ์ „ ๋‹จ๊ฐ€๋Š” ๊ฐ€์ ธ์˜ค์ง€ ์•Š์•˜๋‹ค. 20% ๋Š” ์—ฐ๊ฐ„ ์„ ๋‚ฉ ๊ด€ํ–‰๊ณผ AI ๋ณ€๋™ ์›๊ฐ€ ์‚ฌ์ด์˜ ์ ˆ์ถฉ์ด๋‹ค. ๊ฐ€๊ฒฉ์„ ๋‘ ๋ฐฐ๋กœ ์˜ฌ๋ฆฌ๋ฉด์„œ ํฌ๋ ˆ๋”ง๋„ 1.6๋ฐฐ ๋Š˜๋ฆฐ ๊ฒƒ์€ ์š”๊ธˆ์ œ ํฌ๋ ˆ๋”ง์ด ์ถฉ์ „๊ฐ€(100์›)๋ณด๋‹ค ์‹ธ๊ณ  ํฐ ์š”๊ธˆ์ œ์ผ์ˆ˜๋ก ์‹ธ์•ผ ํ•˜๊ธฐ ๋•Œ๋ฌธ์ด๋‹ค โ€” ๊ฐ€๊ฒฉ๋งŒ ์˜ฌ๋ฆฌ๋ฉด ๊ฐœ์ธ์˜ ํฌ๋ ˆ๋”ง ๋‹จ๊ฐ€(116์›)๊ฐ€ ์ถฉ์ „๊ฐ€๋ฅผ ๋„˜๋Š”๋‹ค. ํฌ๋ ˆ๋”ง๋‹น ์‹คํšจ ๋‹จ๊ฐ€๋Š” ์›”๊ฐ„ 72.5 ยท 58 ยท 49.5์›(์—ฐ๊ฐ„ 58 ยท 46.4 ยท 39.6์›)์œผ๋กœ ๋‚ด๋ ค๊ฐ„๋‹ค. ํ˜„์žฌ ์ด์šฉ๊ถŒ์˜ ํŒ๋งค๊ฐ€๋ฅผ ์ง€๊ธˆ 58,000์›์œผ๋กœ ๋ฐ”๊พธ์ง€ ์•Š์€ ๊ฒƒ์€, ๊ทธ ๊ฐ’์ด ์„œ๋ฒ„ ์†Œ์œ  ๊ฐ€๊ฒฉ ยท ์•ฝ๊ด€๊ณผ ๋ฌถ์—ฌ ์žˆ์–ด ์šด์˜ ๋ฐฑ์—”๋“œ ๋ฐฐํฌ์™€ ์•ฝ๊ด€ ๊ฐœ์ •์ด ํ•จ๊ป˜ ํ•„์š”ํ•˜๊ณ , ๊ทธ ์‚ฌ์ด ์ฃผ๋ฌธ์„œ๊ฐ€ ๊ฐ€๊ฒฉ ๋ถˆ์ผ์น˜๋กœ ๋ง‰ํžˆ๊ธฐ ๋•Œ๋ฌธ์ด๋‹ค(๊ฐ€๋งน ์‹ฌ์‚ฌ ์ค‘). ํ˜„์žฌ ์ด์šฉ๊ถŒ์„ ์ƒˆ ๊ฐ€๊ฒฉ์˜ ใ€Œํ• ์ธ๊ฐ€ใ€๋กœ ํ‘œ์‹œํ•˜์ง€ ์•Š๋Š”๋‹ค โ€” ํŒ๋งค๋œ ์  ์—†๋Š” ๊ฐ€๊ฒฉ์„ ์ •๊ฐ€์ฒ˜๋Ÿผ ์“ฐ์ง€ ์•Š๋Š”๋‹ค.
  • Impact: โ‘  ์ฃผ๋ฌธ์„œ ยท ์ฒดํฌ์•„์›ƒ ยท ์ด์šฉ์•ฝ๊ด€ ยท ์„œ๋ฒ„๋Š” ๋ฐ”๋€Œ์ง€ ์•Š๋Š”๋‹ค(์•ฝ๊ด€์˜ Pro 29,000์› ยท ใ€Œ์—ฐ๊ฐ„ ๊ฒฐ์ œ๋Š” ํŒ๋งคํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹คใ€ ๊ทธ๋Œ€๋กœ ์ฐธ). โ‘ก ์„œ๋ฒ„ ํ›„์†: ์š”๊ธˆ์ œ ์นดํƒˆ๋กœ๊ทธ์™€ ๊ถŒํ•œ(๊ฐœ์ธ ยท ํŒ€ ์ขŒ์„), ์ƒˆ ๊ฐ€๊ฒฉ์˜ ์„œ๋ฒ„ ์†Œ์œ  ์ƒํ’ˆ(ํ˜„์žฌ ์ด์šฉ๊ถŒ ๋Œ€์ฒด ยท ๊ธฐ์กด ๊ตฌ๋… ์ „ํ™˜ ๊ณ ์ง€), 365์ผ ์ด์šฉ๊ถŒ, ์š”๊ธˆ์ œ ํฌ๋ ˆ๋”ง ์›” ์ง€๊ธ‰, ์ƒ์„ฑ ยท ์ˆ˜์ • ์‹คํ–‰ ์ฐจ๊ฐ, ์†Œ์Šค ๋‚ด๋ณด๋‚ด๊ธฐ, ์ถ”๊ฐ€ ํฌ๋ ˆ๋”ง ์ƒํ’ˆ ์„ค์ •(10,000์› ยท 100ํฌ๋ ˆ๋”ง ยท ์‹คํ–‰ 5ํฌ๋ ˆ๋”ง โ€” ์›๊ฐ€ ๊ฒ€ํ†  ํ›„). โ‘ข ์ถœ์‹œํ•  ๋•Œ ์•ฝ๊ด€ ยท ํ™˜๋ถˆ์ •์ฑ…์„ ๊ฐœ์ •ํ•˜๊ณ  ์‚ฌ์ „ ๊ณต์ง€ํ•œ๋‹ค. โ‘ฃ ๊ฐ€๊ฒฉ์„ ๋ฐ”๊พธ๋ ค๋ฉด IdePricing ๋งŒ ๊ณ ์น˜๋ฉด ํŽ˜์ด์ง€์™€ ํ…Œ์ŠคํŠธ๊ฐ€ ๋”ฐ๋ผ๊ฐ„๋‹ค. โ‘ค PRD Q-03 ยท #1236 Q1 ยท Q3 ๋ถ€๋ถ„ ํ•ด์†Œ(๊ณ ๊ฐ์šฉ ์š”๊ธˆ์ œ์˜ ๋“ฑ๊ธ‰๊ณผ ๊ณผ๊ธˆ ๋ฐฉ์‹ โ€” ๊ฐœ๋ฐœ ์ž‘์—… ๊ณต๊ฐ„์˜ ๋“ฑ๊ธ‰์€ ๋ฏธ๊ฒฐ).
  • Source: ์˜ค๋„ˆ ์ง€์‹œ, 2026-11-10 ยท #1529 ยท #1484 ยท #1236 ยท site/homepage/docs/pg-review/README.md

D-108: development ยท main ์— repo ruleset ์„ ๋„์ž…ํ•œ๋‹ค โ€” PR ํ•„์ˆ˜ ยท ํ•„์ˆ˜ ์ฒดํฌ ๐Ÿ“Š CI ์š”์•ฝ ยท force-push/์‚ญ์ œ ๊ธˆ์ง€ (#1536)

  • Date: 2026-11-10
  • Context: ๋ณ€๊ฒฝ๊ด€๋ฆฌ๋ฅผ ๋ฌธ์„œ๊ฐ€ ์•„๋‹ˆ๋ผ ์„ค์ •์ด ์ง€ํ‚ค๊ฒŒ ํ•˜๋ ค๋Š” ์ ๊ฒ€(Epic #1530)์—์„œ development ยท main ์— ๋ธŒ๋žœ์น˜ ๋ณดํ˜ธ ยท ruleset ์ด ์—†๋‹ค๋Š” ์ ์ด ํ™•์ธ๋๋‹ค. D-078 ์˜ ใ€Œ๋ธŒ๋žœ์น˜ ๋ณดํ˜ธ ยท ruleset ์ด ์—†๋‹คใ€๋Š” ์ „์ œ๋Š” ์ด ๊ฒฐ์ •์œผ๋กœ ๋ฐ”๋€๋‹ค.
  • Decision: ์ €์žฅ์†Œ ruleset ์„ active ๋กœ ๋‘”๋‹ค โ€” ์‚ญ์ œ ๊ธˆ์ง€ ยท force-push ๊ธˆ์ง€ ยท PR ํ•„์ˆ˜ ยท ํ•„์ˆ˜ ์ฒดํฌ ๐Ÿ“Š CI ์š”์•ฝ. ์ €์žฅ์†Œ admin ์€ PR ๋ณ‘ํ•ฉ ์‹œ์—๋งŒ ์šฐํšŒํ•  ์ˆ˜ ์žˆ๋‹ค. ใ€Œup-to-date ๊ฐ•์ œใ€(strict)๋Š” ์ผœ์ง€ ์•Š๋Š”๋‹ค โ€” ๋ณ‘๋ ฌ ๋จธ์ง€ ์ „๋žต(parallel-work-and-ci-ops.md P-1)์„ ์œ ์ง€ํ•˜๊ธฐ ์œ„ํ•ด์„œ๋‹ค. ์Šน์ธ์ž ์š”๊ตฌ๋Š” #1536 ์—์„œ ์ด์–ด๊ฐ„๋‹ค.
  • Rationale: ์˜ค๋„ˆ ์Šน์ธ(2026-11-10). ํ•„์ˆ˜ ์ฒดํฌ์™€ ์ง์ ‘ push ๊ธˆ์ง€๋Š” ์Šน์ธ์ž ์—†์ด๋„ ๊ฐ•์ œํ•  ์ˆ˜ ์žˆ๋Š” ํ†ต์ œ๋‹ค. ์šฐํšŒ๋ฅผ admin ยท PR ๋ณ‘ํ•ฉ์œผ๋กœ ํ•œ์ •ํ•œ ์ด์œ  โ€” ๊ธ‰ํ•œ ๋ณ‘ํ•ฉ์ด ๋ง‰ํžˆ๋Š” ์ผ์ด ์žˆ์–ด๋„ ์˜ˆ์™ธ๊ฐ€ PR ์— ๊ธฐ๋ก์œผ๋กœ ๋‚จ๊ฒŒ ํ•˜๊ธฐ ์œ„ํ•ด์„œ๋‹ค.
  • Impact: ๋ชจ๋“  ์„ธ์…˜์€ ๐Ÿ“Š CI ์š”์•ฝ ์„ฑ๊ณต ํ›„์—๋งŒ ๋ณ‘ํ•ฉํ•œ๋‹ค. ์‹คํŒจ ์ƒํƒœ ๋ณ‘ํ•ฉ์€ admin ์šฐํšŒ๋ฟ์ด๋ฉฐ ์‚ฌ์œ ๋ฅผ PR ์— ๋‚จ๊ธด๋‹ค. development ยท main ์œผ๋กœ ์ง์ ‘ push ํ•˜๋Š” ์›Œํฌํ”Œ๋กœ๋Š” ์‹คํŒจํ•œ๋‹ค.
  • Source: ์˜ค๋„ˆ ์Šน์ธ, 2026-11-10 ยท #1530 ยท #1536 ยท D-078

D-109: ์ƒˆ ํ”„๋กœ์ ํŠธ ํ…œํ”Œ๋ฆฟ์˜ ๊ธฐ๋ณธ์„ Serverpod 4.1.2 ยท ์˜คํ”„๋ผ์ธ ๋™๊ธฐํ™” ํ”„๋กœํ•„๋กœ ๋ฐ”๊พผ๋‹ค โ€” AD-9(D-097) ๊ฐœ์ • (#1612)

  • Date: 2026-11-16
  • Context: D-097 ยท ADR v2 AD-9 ๋Š” ใ€Œ์‹ ๊ทœ ์ปค๋„ ๊ธฐ๋ณธ์€ ์ •์‹ Serverpod 4.0.3, 4.1 databaseSync ๋Š” opt-inใ€์ด์—ˆ๋‹ค. ๊ทธ ๋’ค ํ…œํ”Œ๋ฆฟ์€ 4.1.0 ์ •ํ™• ๊ณ ์ •์œผ๋กœ ์˜ฌ๋ผ๊ฐ”์ง€๋งŒ(kernel#56 ยท bricks#540) ๋ฌธ์„œ๋Š” ๊ทธ๋Œ€๋กœ์˜€๊ณ , ์˜คํ”„๋ผ์ธ ๋™๊ธฐํ™”๋Š” ์กฐ์ง ํฌํฌ(coco-de/co-serverpod)๋ฅผ ์“ฐ๋Š” ์„ ํƒ ํ”„๋กœํ•„์ด์—ˆ๋‹ค. ์›๊ฒฉ ์ž‘์—…๊ณต๊ฐ„(#1610)์„ ์ค€๋น„ํ•˜๋ฉด์„œ ์˜ค๋„ˆ๊ฐ€ Serverpod 4.1.2 ์ƒํ–ฅ๊ณผ ์˜คํ”„๋ผ์ธ ๋™๊ธฐํ™”๋ฅผ cocode ์ €์žฅ์†Œ ยท ์ƒˆ ํ”„๋กœ์ ํŠธ ํ…œํ”Œ๋ฆฟ ยท ํ”„๋ฆฌ๋ทฐ ์‹œํ—˜ ํ”„๋กœ์ ํŠธ ๋ชจ๋‘์— ์ ์šฉํ•˜๊ธฐ๋กœ ํ–ˆ๋‹ค.
  • Decision: ์ƒˆ ํ”„๋กœ์ ํŠธ ํ…œํ”Œ๋ฆฟ(kernel ยท bricks ยท cob)์˜ ๊ธฐ๋ณธ์€ โ‘  Serverpod 4.1.2 ์ •ํ™• ๊ณ ์ • โ‘ก ์˜คํ”„๋ผ์ธ ๋™๊ธฐํ™” ํ”„๋กœํ•„(pub.dev serverpod_offline_sync 0.0.12 ยท databaseSync: true, ์กฐ์ง ํฌํฌ ์žฌ์ •์˜ ์—†์Œ)์ด๋‹ค. ๋„๋ ค๋ฉด cob โ€ฆ --no-offline-sync(stable ํ”„๋กœํ•„). --serverpod <๋ฒ„์ „> ์€ ์ปค๋„์ด ์„ ํƒํ•œ ํ”„๋กœํ•„์— ๋ฒ„์ „์„ ์ ์šฉํ•œ๋‹ค. ใ€Œdonor ๋ฒ„์ „์ด ๋ธŒ๋ฆญ ์ตœ์†Œ ๋ฒ„์ „์„ ์ž๋™์œผ๋กœ ์˜ฌ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค ยท apply ๊ฐ€ ์ˆ˜์šฉ ํ˜ธ์ŠคํŠธ์— ๋งž์ถ˜๋‹คใ€๋Š” AD-9 ์˜ ๋‚˜๋จธ์ง€๋Š” ๊ทธ๋Œ€๋กœ๋‹ค.
  • Rationale: ์˜ค๋„ˆ ๊ฒฐ์ •(2026-11-16). ์ƒ์„ฑ๋ฌผ๊ณผ serverpod_cli ๋Š” ๊ฐ™์€ ๋ฒ„์ „์ด์–ด์•ผ ํ•˜๊ณ  CLI 4.1.2 ๋Š” ๋ฒ”์œ„ ์„ ์–ธ์— ๊ฒฝ๊ณ ํ•˜๋ฏ€๋กœ ์ •ํ™• ๊ณ ์ •์„ ์œ ์ง€ํ•œ๋‹ค. ์˜คํ”„๋ผ์ธ ๋™๊ธฐํ™”๋Š” pub.dev ํŒ์œผ๋กœ ์˜ฎ๊ฒจ ๋น„๊ณต๊ฐœ ํฌํฌ ์—†์ด ํ’€๋ฆฐ๋‹ค.
  • Impact: โ‘  AD-5 ์˜ ใ€Œํด๋ผ์ด์–ธํŠธ SQLite ์กฐ๊ฑด๋ถ€ ์˜ˆ์™ธใ€์™€ 3์ข… ๊ฒŒ์ดํŠธ(์‹ ๊ทœ ์„ค์น˜ ยท ์ง์ „ ์Šคํ‚ค๋งˆ ์—…๊ทธ๋ ˆ์ด๋“œ DROP 0 ยท ๊ณต์‹ ์žฌ์‹คํ–‰ no-op + sync ์ง‘ํ•ฉ ์ œ์™ธ)๊ฐ€ opt-in ํ”„๋กœํ•„์ด ์•„๋‹ˆ๋ผ ๊ธฐ๋ณธ ์ƒ์„ฑ๋ฌผ์— ์ ์šฉ๋œ๋‹ค. Serverpod 4.1.2 ์—์„œ ๊ทธ ์ƒ์„ฑ๊ธฐ ํ•œ๊ณ„๊ฐ€ ๋‚จ์•„ ์žˆ๋Š”์ง€๋Š” ํ™•์ธ๋˜์ง€ ์•Š์•˜๋‹ค. โ‘ก ํฌํฌ์—๋งŒ ์žˆ๋˜ ๊ธฐ๋Šฅ(๋ฐฐ์น˜ ์˜ˆ์‚ฐ ยท ์„ค์ • ๊ฐ์ฒด ยท ์ƒํƒœ ์ถ”์  ยท ์‹คํŒจ ๋ถ„๋ฅ˜ ยท ์‹œ๊ณ„ ์˜ค์ฐจ ํ•œ๋„)์€ pub.dev 0.0.12 ์— ์—†๋‹ค โ€” ์ƒˆ ํ”„๋กœ์ ํŠธ์—๋Š” ์˜ํ–ฅ์ด ์—†๊ณ , ํฌํฌ API ๋ฅผ ์“ฐ๋Š” ๊ธฐ์กด ์ œํ’ˆ์€ ๊ทธ๋Œ€๋กœ ์˜ฎ๊ธธ ์ˆ˜ ์—†๋‹ค. โ‘ข cocode ํ˜ธ์ŠคํŠธ์˜ 4.1.2 ์ƒํ–ฅ์€ #1606 ์ด ๋”ฐ๋กœ ํ•œ๋‹ค. โ‘ฃ ๊ณผ๊ฑฐ ์ธก์ • ยท ๊ธฐ์ค€์„  ๊ธฐ๋ก(docs/projects/637/** ๋“ฑ)์˜ 4.0.3 ์€ ๊ทธ๋•Œ์˜ ์‚ฌ์‹ค์ด๋ผ ๊ณ ์น˜์ง€ ์•Š๋Š”๋‹ค.
  • Source: ์˜ค๋„ˆ ๊ฒฐ์ •, 2026-11-16 ยท #1610 ยท #1612 ยท coco-de/kernel#77 ยท coco-de/co-bricks#948 ยท coco-de/bricks#564 ยท coco-de/co-bricks#949 ยท D-097

D-110: ์š”๊ธˆ์ œ ์ •๊ฐ€๋ฅผ ์‹ค์ œ ์•ฑ์„ ๋งŒ๋“œ๋Š” ๋„๊ตฌ์˜ ์„ ์œผ๋กœ ์˜ฌ๋ฆฐ๋‹ค โ€” ๊ฐœ์ธ 59,000 ยท Pro 119,000 ยท ํŒ€ 379,000์›, ํฌ๋ ˆ๋”ง 1,000 ยท 2,100 ยท 7,000 (D-107 ๊ฐœ์ •, #1645)

  • Date: 2026-11-17
  • Context: ์›๊ฒฉ ์ž‘์—…๊ณต๊ฐ„(#1610 โ€” ๊ณ ๊ฐ์˜ ํ’€์Šคํƒ ์•ฑ์„ ํ˜ธ์ŠคํŠธ์—์„œ ๋งŒ๋“ค๊ณ  ๊ณ ์นœ๋‹ค)์˜ ์ˆ˜์ต์„ฑ์„ ๊ณ„์‚ฐํ•˜๋ฉฐ ์š”๊ธˆ์„ ๋‹ค์‹œ ๋ดค๋‹ค. ์›๊ฐ€(Bedrock)๋Š” ๋‹ฌ๋Ÿฌ์ด๊ณ , ์‹ค์ธกํ•œ ์š”์ฒญ๋‹น ์›๊ฐ€๋Š” ํ™”๋ฉด ์ˆ˜์ • ์•ฝ $0.15 ยท ํ’€์Šคํƒ ์ˆ˜์ • ์•ฝ $0.50(Sonnet 5.5, ์ง€์‹œ๋งˆ๋‹ค ํ•œ ๋ฒˆ์”ฉ ์žฐ ๊ฐ’)์ด๋‹ค. ์˜ค๋„ˆ: ใ€Œ๊ธˆ์•ก์€ ํ•œํ™” ๋ง๊ณ  ๋‹ฌ๋Ÿฌ๋กœ ์‚ฐ์ถœ โ€ฆ ๋‹ค์‹œ ํ•œํ™”๋กœ ๋ณ€ํ™˜ใ€, ใ€Œ๋Ÿฌ๋ฒ„๋ธ” ยท ๋ฒ ์ด์Šค44 ์™€ ๊ฐ™์€ ๋ฐ”์ด๋ธŒ ์ฝ”๋”ฉ ๋„๊ตฌ์˜ ๊ฐ€๊ฒฉ๋„ ์ฐธ๊ณ ใ€, ์ด์–ด ใ€Œ์šฐ๋ฆฌ๋Š” lovable, base44 ๋ณด๋‹ค ๋†’๊ฒŒ ๋ฐ›์•„์•ผ โ€ฆ ์›น ๊ธฐ๋ฐ˜์ด ์•„๋‹ˆ๋ผ ์ •๋ง ์ œ๋Œ€๋กœ ์›Œํ‚นํ•˜๋Š” ์†Œํ”„ํŠธ์›จ์–ด ์ œํ’ˆใ€. ์‹œ์žฅ(2026-11, ์ œ3์ž ๊ธ€ ๊ธฐ์ค€ ยท ๋‹ฌ๋Ÿฌ ยท ์„ธ๊ธˆ ์ œ์™ธ ยท ์›” ๊ฒฐ์ œ): ์›น ๊ธฐ๋ฐ˜ ๋„๊ตฌ Lovable $25/$50 ยท Base44 $20/$50/$100(ํฌ๋ ˆ๋”ง๋‹น $0.20~0.25, ์—ฐ๊ฐ„ 17~20% ํ• ์ธ), ์‹ค์ œ ์•ฑ์„ ๋งŒ๋“œ๋Š” ๋„๊ตฌ FlutterFlow $39/$80/$150(์ถ”๊ฐ€ ์ขŒ์„ $85, ์—ฐ๊ฐ„ 25%) ยท Bubble ์›น+๋ชจ๋ฐ”์ผ ์•ฝ $59/$209/$549. D-107 ์˜ ์ •๊ฐ€(29,000 ยท 58,000 ยท 198,000์›)๋Š” ๋‹ฌ๋Ÿฌ๋กœ $19 ยท $38 ยท $129 ๋ผ ์›น ๊ธฐ๋ฐ˜ ๋„๊ตฌ์˜ ์„ ์ด์—ˆ๋‹ค.
  • Decision: โ‘  ์ •๊ฐ€(์›” ยท VAT ํฌํ•จ) โ€” ๊ฐœ์ธ 59,000์›($39) ยท Pro 119,000์›($79) ยท ํŒ€ 379,000์›(3๋ช…, $249) ยท ์ปค์Šคํ…€ ๊ฒฌ์ . ๋‹ฌ๋Ÿฌ(์„ธ๊ธˆ ์ œ์™ธ)๋กœ ์ •ํ•˜๊ณ  ํ™˜์œจ 1,400์› ยท ๋ถ€๊ฐ€์„ธ 10% ๋กœ ๋ฐ”๊ฟ” ๋์ž๋ฆฌ๋ฅผ ์ •๋ฆฌํ–ˆ๋‹ค. ํŒ€์˜ 1๋ช… ์ถ”๊ฐ€๋Š” ๊ฐ™์€ ๋น„์œจ๋กœ 95,000์›์ด๋‹ค(2026-11-18 ์˜ค๋„ˆ ์Šน์ธ). โ‘ก ์—ฐ๊ฐ„ ๊ฒฐ์ œ 20% ํ• ์ธ์€ ๊ทธ๋Œ€๋กœ๋‹ค(566,400 ยท 1,142,400 ยท 3,638,400์›). โ‘ข ์š”๊ธˆ์ œ ํฌ๋ ˆ๋”ง์€ ๋งค์›” 1,000 ยท 2,100 ยท 7,000(ํŒ€ ๊ณต์œ ). 1ํฌ๋ ˆ๋”ง = 100์›(์ถฉ์ „๊ฐ€) ยท AI ์‹คํ–‰ 1ํšŒ = 5ํฌ๋ ˆ๋”ง ยท ์ถฉ์ „ 100ํฌ๋ ˆ๋”ง = 10,000์›์€ ๊ทธ๋Œ€๋กœ๋‹ค. โ‘ฃ ํฌ๋ ˆ๋”ง ์ˆ˜์˜ ๊ธฐ์ค€ โ€” ํฌ๋ ˆ๋”ง 1๊ฐœ์— ์‹ค์„ ์ˆ˜ ์žˆ๋Š” AI ์›๊ฐ€๋Š” ์•ฝ 1์„ผํŠธ. ์š”๊ธˆ์ œ ํฌ๋ ˆ๋”ง์€ ์‹คํšจ ๋‹จ๊ฐ€๊ฐ€ ์ถฉ์ „๊ฐ€๋ณด๋‹ค ์‹ธ์„œ(์›” 59 ยท 57 ยท 54์›, ์—ฐ 47 ยท 45 ยท 43์›), ์—ฐ๊ฐ„ ๊ฒฐ์ œ์ž๊ฐ€ ๋‹ค ์“ฐ๋Š” ์ตœ์•…์—๋„ ๊ธฐ์—ฌ์ด์ต 50%(D-107 ๊ณผ ๊ฐ™์€ ๋ชฉํ‘œ ยท ์‹คํŒจ ์˜ˆ๋น„ 20%)๊ฐ€ ๋‚จ๋Š” ์„ ์ด๋‹ค. โ‘ค ์›๊ฒฉ ์ž‘์—…๊ณต๊ฐ„์˜ ์†Œ๋ชจ๋Ÿ‰์€ ํ™”๋ฉด ์ˆ˜์ • 15 ยท ํ’€์Šคํƒ ์ˆ˜์ • 50ํฌ๋ ˆ๋”ง(์ •์‚ฐ์€ ์‹ค์ œ ์›๊ฐ€ 1์„ผํŠธ๋‹น 1ํฌ๋ ˆ๋”ง). ๊ทธ ๊ธฐ๋Šฅ์„ ๊ณต๊ฐœํ•  ๋•Œ ์š”๊ธˆ ํŽ˜์ด์ง€์— ์‹ฃ๋Š”๋‹ค. โ‘ฅ ํŒ๋งค ๊ทœ์น™์€ D-107 ๊ทธ๋Œ€๋กœ๋‹ค โ€” ์ƒˆ ์š”๊ธˆ์ œ๋Š” ใ€Œ์ถœ์‹œ ์ค€๋น„ ์ค‘ใ€, ์ง€๊ธˆ ์ฃผ๋ฌธํ•  ์ˆ˜ ์žˆ๋Š” ๊ฒƒ์€ ํ˜„์žฌ Pro ์ด์šฉ๊ถŒ(29,000์›) ํ•˜๋‚˜.
  • Rationale: ๋น„๊ต ๋Œ€์ƒ์ด ์›น ํ™”๋ฉด์„ ๋งŒ๋“ค์–ด ์ฃผ๋Š” ๋„๊ตฌ๊ฐ€ ์•„๋‹ˆ๋ผ ์•ฑ ยท ์„œ๋ฒ„ ยท DB ๋ฅผ ๊ฐ–์ถ˜ ์ œํ’ˆ์„ ๋งŒ๋“œ๋Š” ๋„๊ตฌ์ด๋ฏ€๋กœ ๊ทธ ์ธต(FlutterFlow)์— ๋งž์ท„๋‹ค. ๊ฐ€๊ฒฉ์„ ์˜ฌ๋ฆฐ ๋งŒํผ ํฌ๋ ˆ๋”ง๋„ ๋Š˜๋ ค(2.5 ยท 2.1 ยท 1.75๋ฐฐ) ์š”๊ธˆ์ œ๋งˆ๋‹ค ํ’€์Šคํƒ ์ˆ˜์ • 20 ยท 42 ยท 140ํšŒ๊ฐ€ ๋“ค์–ด๊ฐ„๋‹ค. ๋‹ค ์“ธ ๋•Œ ๊ธฐ์—ฌ์ด์ต๋ฅ ์€ ์›” 60 ยท 61 ยท 60%, ์—ฐ 51 ยท 53 ยท 51%(๊ณ„์ •๋‹น ์ธํ”„๋ผ $1.5 ๊ฐ€์ • ํฌํ•จ), ์ ˆ๋ฐ˜๋งŒ ์“ฐ๋ฉด 75~80% ๋‹ค. ARR 30์–ต ์›์— ํ•„์š”ํ•œ ์œ ๋ฃŒ ๊ณ„์ •์€ ๊ฐœ์ธ๋งŒ ์•ฝ 5,200 ยท ๊ฐœ์ธ 70% + Pro 30% ์•ฝ 4,000 ยท Pro ๋งŒ ์•ฝ 2,600(์›” ยท ์—ฐ ๋ฐ˜๋ฐ˜ ๊ฐ€์ •)์ด๋‹ค.
  • Impact: โ‘  ํ™ˆํŽ˜์ด์ง€ /pricing/ ์˜ ์นด๋“œ ยท ๋น„๊ตํ‘œ ยท FAQ ๊ฐ€ ์ƒˆ ์ˆซ์ž๋กœ ๋ฐ”๋€๋‹ค(IdePricing โ€” ๊ณต๊ฐœ ํŽ˜์ด์ง€, ๊ฐ€๋งน ์‹ฌ์‚ฌ์ž๊ฐ€ ๋ณด๋Š” ๊ณณ์ด๋‹ค). ์ฃผ๋ฌธ์„œ ยท ์ฒดํฌ์•„์›ƒ ยท ์•ฝ๊ด€ ยท ์„œ๋ฒ„(CUSTOMER_PRO_AMOUNT_KRW)๋Š” ๋ฐ”๋€Œ์ง€ ์•Š๋Š”๋‹ค. โ‘ก ์š”์ฒญ๋‹น ๊ฐ€๊ฒฉ์€ ์‹œ์žฅ๋ณด๋‹ค ๋†’๋‹ค โ€” ํ™”๋ฉด ์ˆ˜์ • ์•ฝ $0.55 ยท ํ’€์Šคํƒ ์ˆ˜์ • ์•ฝ $1.85 ๋กœ, ์›น ๊ธฐ๋ฐ˜ ๋„๊ตฌ์˜ ๋ฉ”์‹œ์ง€๋‹น $0.20~0.25 ์™€ ์ง์ ‘ ๋น„๊ต๋˜๋ฉด ๋น„์‹ธ ๋ณด์ธ๋‹ค. ์š”์ฒญ๋‹น ์›๊ฐ€๋ฅผ ๋‚ฎ์ถ”๋Š” ์ผ(๋‹จ์ˆœํ•œ ์ˆ˜์ •์— ๋” ์‹ผ ๋ชจ๋ธ ยท ์š”์ฒญ๋งˆ๋‹ค ์ฝ๋Š” ๋ถ„๋Ÿ‰ ์ค„์ด๊ธฐ)์ด ๊ฐ€๊ฒฉ๊ณผ ๋ณ„๊ฐœ๋กœ ํ•„์š”ํ•˜๋‹ค. โ‘ข ๊ฐ€์ • โ€” ํ™˜์œจ 1,400์› ยท ๊ฒฐ์ œ ์ˆ˜์ˆ˜๋ฃŒ 3.3% ยท ๊ณ„์ •๋‹น ์ธํ”„๋ผ $1.5 ยท ํ•œ ๋ฒˆ์”ฉ ์žฐ ์›๊ฐ€. ๊ฐ€๊ฒฉ ์ €ํ•ญ(์ „ํ™˜์œจ)์€ ๊ณ„์‚ฐ์— ์—†๋‹ค. ๊ณต๊ฐœ ๋’ค 2์ฃผ์˜ ์‹ค์ œ ์‚ฌ์šฉ๋ฅ  ยท ์›๊ฐ€๋กœ ๋‹ค์‹œ ๋ณธ๋‹ค. โ‘ฃ ใ€ŒAI ์‹คํ–‰ 1ํšŒ = 5ํฌ๋ ˆ๋”งใ€์ด ๊ฐ™์€ ๊ธฐ์ค€์— ๋งž์œผ๋ ค๋ฉด ์›น ์•ฑ ์‹คํ–‰์˜ ์›๊ฐ€๊ฐ€ 5์„ผํŠธ ์ดํ•˜์—ฌ์•ผ ํ•œ๋‹ค โ€” ํ™•์ธํ•˜์ง€ ์•Š์•˜๋‹ค. โ‘ค ์ถœ์‹œ ์ „์˜ ํ˜„์žฌ ์ด์šฉ๊ถŒ(29,000์›)์—์„œ ์›๊ฒฉ ์ž‘์—…๊ณต๊ฐ„์˜ ๋‹ฌ ์˜ˆ์‚ฐ์€ ๊ณ„์ • 12,000์› ยท ํšŒ์‚ฌ 1,000,000์›์ด๋‹ค(2026-11-18 ์˜ค๋„ˆ ์Šน์ธ โ€” ํ’€์Šคํƒ ์•ฝ 6ํšŒ, ๋‹ค ์จ๋„ ๊ธฐ์—ฌ์ด์ต 52%).
  • Source: ์˜ค๋„ˆ ํ™•์ •(ใ€Œ์ด์ˆซ์ž๋กœ ํ™•์ • ํ•ฉ๋‹ˆ๋‹คใ€), 2026-11-17 ยท #1645 ยท #1610 ยท D-107 ยท site/homepage/docs/pg-review/README.md ยท docs/cocode-ide-renewal/bedrock-commercial-policy.md

D-111: IDE ์˜ AI ๋Š” ์„œ๋ฒ„๋กœ๋งŒ ๋ˆ๋‹ค โ€” ๋กœ์ปฌ API ํ‚ค ยท ๋ชจ๋ธ ์„ ํƒ ยท ์™ธ๋ถ€ ์—์ด์ „ํŠธ ยท ๋กœ์ปฌ ๋ชจ๋ธ์„ ์ œ๊ฑฐํ•œ๋‹ค (D-034 ๋Œ€์ฒด, #1656)

  • Date: 2026-11-18
  • Context: ์˜ค๋„ˆ๊ฐ€ ๋ฐ์Šคํฌํ†ฑ 0.1.23 ์„ ์ง์ ‘ ์จ ๋ณด๊ณ  ๋ฌผ์—ˆ๋‹ค โ€” ใ€Œ๋Œ€ํ™”์—์„œ ์™œ ์„œ๋ฒ„ API๋ฅผ ์‚ฌ์šฉํ•˜์ง€ ์•Š๋Š”๊ฑฐ์•ผ? ๋กœ์ปฌ API ํ‚ค ์„ค์ •ํ•ด์„œ ๋ชจ๋ธ์„ ํƒํ•˜๋Š” ๋ถ€๋ถ„์€ ๋ชจ๋‘ ์ œ๊ฑฐํ•ด์ค˜. ์•ž์œผ๋กœ๋Š” ์„œ๋ฒ„ ํฌ๋ ˆ๋”ง์„ ์‚ฌ์šฉํ•˜๋Š” ๋ฐฉ์‹์„ ์‚ฌ์šฉํ•˜๋„๋กใ€. ๊ด€๋ฆฌ์ž IDE ์˜ ๋Œ€ํ™”๋Š” ๋„ท ๋ชจ๋‘ ๋ฐ์Šคํฌํ†ฑ์—์„œ ๋ชจ๋ธ์„ ์ง์ ‘ ๋ถˆ๋ €๋‹ค: ๋งŒ๋“ค๊ธฐ ๋Œ€ํ™”์™€ ํ˜„์žฌ ์•ฑ ์ˆ˜์ •(GenkitNarrator โ€” ์ž๊ธฐ ํ‚ค ยท ์˜จ๋””๋ฐ”์ด์Šค), ์—์ด์ „ํŠธ ์„ธ์…˜(CocodeAgentRuntime โ€” ์ž๊ธฐ ํ‚ค), ์™ธ๋ถ€ ์—์ด์ „ํŠธ(ACP โ€” Claude Code ยท Codex ยท Gemini CLI ์˜ ์ž์ฒด ๋กœ๊ทธ์ธ). D-034(2026-09-10)๊ฐ€ ใ€Œ์—์ด์ „ํŠธ์˜ ๋ชจ๋ธ ๋น„์šฉ์€ BYOKใ€๋กœ ์ •ํ•œ ๊ตฌ์กฐ๋‹ค. ์„œ๋ฒ„์—๋Š” ์ž์œ  ๋Œ€ํ™” ยท ๋„๊ตฌ ํ˜ธ์ถœ์„ ๋ฐ›๋Š” API ๊ฐ€ ์—†์—ˆ๋‹ค โ€” ๊ณ ๊ฐ ํ™”๋ฉด์˜ ์ •ํ•ด์ง„ ๋นŒ๋“œ ์ž‘์—…๊ณผ ์›๊ฒฉ ์ž‘์—…๊ณต๊ฐ„์˜ ์ฐจ๋ก€๋ฟ์ด์—ˆ๋‹ค.
  • Decision: โ‘  IDE ์˜ AI ๋Š” ์„œ๋ฒ„ ํ•˜๋‚˜๋กœ๋งŒ ๋ˆ๋‹ค. ใ€Œ๋ชจ๋ธ ์ง์ ‘ ์—ฐ๊ฒฐใ€(API ํ‚ค ๊ณต๊ธ‰์ž ์—ฌ๋Ÿ) ยท ์„ค์ •์˜ ใ€ŒAI ๊ณต๊ธ‰์žใ€ ยท ใ€Œ๋กœ์ปฌ ๋ชจ๋ธใ€ ยท ์˜จ๋””๋ฐ”์ด์Šค ยท Ollama ยท ๋Œ€ํ™”์˜ ์™ธ๋ถ€ ์—์ด์ „ํŠธ(ACP)๋ฅผ ์ „๋ถ€ ์ œ๊ฑฐํ•œ๋‹ค(์˜ค๋„ˆ ์„ ํƒ โ€” ใ€Œ์ „๋ถ€ ์ œ๊ฑฐใ€). โ‘ก ์„œ๋ฒ„์— ๋Œ€ํ™”์šฉ API customerIdeAi.turn ์„ ๋‘”๋‹ค โ€” ํ•œ ๋ฒˆ์˜ ๋ชจ๋ธ ํ˜ธ์ถœ์ด ์—ฌ๋Ÿฌ ํ„ด์˜ ๋Œ€ํ™”์™€ ๋„๊ตฌ ์ •์˜๋ฅผ ์‹ฃ๊ณ , ๋„๊ตฌ๋Š” ๋ฐ์Šคํฌํ†ฑ์—์„œ ๋ˆ๋‹ค. ๋ชจ๋ธ ยท ๊ฐ€๊ฒฉ ยท ์˜ˆ์‚ฐ์€ ์„œ๋ฒ„ ์ •์ฑ…์ด ์ •ํ•œ๋‹ค(ํด๋ผ์ด์–ธํŠธ๊ฐ€ ๊ณ ๋ฅด์ง€ ์•Š๋Š”๋‹ค). โ‘ข ๊ณผ๊ธˆ์€ ์„œ๋ฒ„์˜ ๊ธฐ์กด ์ˆœ์„œ ๊ทธ๋Œ€๋กœ๋‹ค(์˜ค๋„ˆ ์„ ํƒ) โ€” ์ฒดํ—˜ โ†’ ๊ด€๋ฆฌ์ž ์›” ์˜ˆ์‚ฐ โ†’ ์œ ๋ฃŒ ํฌํ•จ ์˜ˆ์‚ฐ โ†’ ์ถฉ์ „ ํฌ๋ ˆ๋”ง(CustomerAiMeter). ์š”๊ธˆ์ œ ํฌ๋ ˆ๋”ง์˜ ์›” ์ง€๊ธ‰(D-110)์ด ๊ตฌํ˜„๋˜๋ฉด ๊ทธ์ชฝ์œผ๋กœ ์˜ฎ๊ธด๋‹ค. โ‘ฃ D-034 ๋ฅผ ๋Œ€์ฒดํ•œ๋‹ค.
  • Rationale: ๊ณ ๊ฐ์€ ํ‚ค์™€ ๋ชจ๋ธ์„ ๊ณ ๋ฅผ ์ˆ˜ ์—†๊ณ  ๊ณจ๋ผ์„œ๋„ ์•ˆ ๋œ๋‹ค โ€” ๊ณผ๊ธˆ๊ณผ ํ’ˆ์งˆ์˜ ์ฑ…์ž„์ด ํ•œ ๊ณณ์— ์žˆ์–ด์•ผ ํ•œ๋‹ค. ์›๊ฒฉ ์ž‘์—…๊ณต๊ฐ„(#1610)์ด ์ด๋ฏธ ๊ฐ™์€ ์›์น™(๋ชจ๋ธ ํ‚ค๋Š” ์šฐ๋ฆฌ ์ชฝ์—๋งŒ)์œผ๋กœ ์ง€์–ด์กŒ๊ณ , ์š”๊ธˆ(D-110)์€ ์„œ๋ฒ„๊ฐ€ ์“ด ๋งŒํผ์„ ํฌ๋ ˆ๋”ง์œผ๋กœ ์„ธ๋Š” ๊ฒƒ์„ ์ „์ œํ•œ๋‹ค. ์ž๊ธฐ ํ‚ค๋กœ ๋„๋Š” ๊ธธ์ด ๋‚จ์•„ ์žˆ์œผ๋ฉด ๊ทธ ์‚ฌ์šฉ๋Ÿ‰์€ ์žฅ๋ถ€์— ์žกํžˆ์ง€ ์•Š๋Š”๋‹ค.
  • Impact: โ‘  ์ฒซ ํŒ์€ ์‘๋‹ต์ด ํ˜๋Ÿฌ๋‚˜์˜ค์ง€ ์•Š๊ณ  ํ•œ ๋ฒˆ์— ๋‚˜์˜จ๋‹ค(์„œ๋ฒ„ API ๊ฐ€ ํ˜๋ ค๋ณด๋‚ด๊ธฐ๋ฅผ ํ•˜์ง€ ์•Š๋Š”๋‹ค โ€” ๋‹ค์Œ ๋‹จ๊ณ„). โ‘ก ์˜คํ”„๋ผ์ธ์—์„œ๋Š” ๋Œ€ํ™”๊ฐ€ ๋˜์ง€ ์•Š๋Š”๋‹ค(์ง€๊ธˆ์€ ๊ธฐ๊ธฐ ์•ˆ ๋ชจ๋ธ๋กœ ๋œ๋‹ค). โ‘ข ์‚ฌ์šฉ์ž๊ฐ€ ๋ชจ๋ธ์„ ๊ณ ๋ฅด์ง€ ๋ชปํ•œ๋‹ค. โ‘ฃ ์šด์˜ ์„œ๋ฒ„์— ๋ชจ๋ธ ์ •์ฑ…(CUSTOMER_BEDROCK_POLICY_JSON)๊ณผ ์„œ๋ฒ„์šฉ ๋ชจ๋ธ ํ‚ค๊ฐ€ ํ•„์š”ํ•˜๋‹ค โ€” ์ง€๊ธˆ ์šด์˜์—๋Š” ์—†์–ด์„œ ๊ณ ๊ฐ ํ™”๋ฉด์˜ ์›น ์•ฑ ์ƒ์„ฑ๋„ ๊บผ์ ธ ์žˆ๋‹ค. ์ •์ฑ…์„ ๋„ฃ์œผ๋ฉด ๊ทธ๊ฒƒ๋„ ํ•จ๊ป˜ ์ผœ์ง„๋‹ค. โ‘ค ๋ฒ”์œ„ ๋ฐ–: ์—์ด์ „ํŠธ ํŒ€ ยท ์Šคํ† ์–ด ์Šคํฌ๋ฆฐ์ƒท์ด ๋„์šฐ๋Š” ์™ธ๋ถ€ CLI(AgentLaunchProfile โ€” ์„ค์ •์˜ ใ€Œ์ฝ”๋”ฉ ์—์ด์ „ํŠธใ€)๋Š” ๋Œ€ํ™”์˜ ์„ ํƒ ์ƒ์ž๊ฐ€ ์•„๋‹ˆ๋ผ ๋‹ค๋ฅธ ๊ธฐ๋Šฅ์ด๋ผ ์ด๋ฒˆ์— ๊ฑด๋“œ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค. ๊ฐ™์€ ์›์น™์„ ์ ์šฉํ• ์ง€๋Š” ๋”ฐ๋กœ ์ •ํ•œ๋‹ค. โ‘ฅ docs/cocode-ide-renewal/agent-session-contract.md ์˜ ใ€Œ๊ธฐ์กด ๊ณ ๊ฐ Bedrock API ๋Š” ๋ฒ”์šฉ ๋กœ์ปฌ ๋„๊ตฌ ์„ธ์…˜์ด ์•„๋‹ˆ๋‹คใ€์™€ bedrock-commercial-policy.md ์˜ ์‚ฌ์šฉ๋Ÿ‰ ๋ฒ”์œ„ ์„ค๋ช…์€ ์ด ๊ฒฐ์ •์— ๋งž์ถฐ ๊ณ ์นœ๋‹ค(๊ตฌํ˜„ PR ์—์„œ).
  • Source: ์˜ค๋„ˆ ์ง€์‹œ์™€ ์„ ํƒ, 2026-11-18 ยท #1656 ยท #1657(์„œ๋ฒ„) ยท #1658(๋ฐ์Šคํฌํ†ฑ) ยท D-034 ยท D-110

D-112: ๊ด€๋ฆฌ์ž IDE ์˜ ์ƒˆ ์•ฑ ๋งŒ๋“ค๊ธฐ๋ฅผ ์„œ๋ฒ„ ์ชฝ ํ˜ธ์ŠคํŠธ๋กœ ์˜ฎ๊ธฐ๊ณ  ๊ธฐ๊ธฐ์—์„œ cob ์„ ์‹คํ–‰ํ•˜๋Š” ๊ธธ์„ ์—†์•ค๋‹ค (#1661)

  • Date: 2026-11-18
  • Context: ์˜ค๋„ˆ๊ฐ€ ๋ฐ์Šคํฌํ†ฑ 0.1.23 ์„ ์ง์ ‘ ์จ ๋ณด๋‹ˆ IDE ๊ฐ€ cob ์„ ํ„ฐ๋ฏธ๋„์—์„œ ์„ค์น˜ํ•˜๋ผ๊ณ  ์š”๊ตฌํ–ˆ๋‹ค(์„ค์ • โ€บ ๋นŒ๋” ยท ๋Œ€ํ™”์˜ ์„ค์น˜ ์นด๋“œ). ๊ด€๋ฆฌ์ž IDE ์˜ ๋งŒ๋“ค๊ธฐ๋Š” ์‚ฌ์šฉ์ž ๊ธฐ๊ธฐ์—์„œ cob ์„ ์‹คํ–‰ํ•ด ์•ฑ์„ ์กฐ๋ฆฝํ–ˆ์œผ๋ฏ€๋กœ(D-091 ยท D-092), ์ด ๊ธธ์„ ๋‘๋ ค๋ฉด cob ๊ณผ bricks ๋ฅผ ์‚ฌ์šฉ์ž ๊ธฐ๊ธฐ์— ๋‚ด๋ณด๋‚ด์•ผ ํ•˜๊ณ  ๊ทธ๋Ÿฌ๋ฉด ๋‘˜์ด ๊ณต๊ฐœ๋œ๋‹ค. ์˜ค๋„ˆ: ใ€Œ๊ด€๋ฆฌ์ž IDE์˜ ๋งŒ๋“ค๊ธฐ๋„ ์„œ๋ฒ„์ชฝ์œผ๋กœ ๋Œ๋ฆฌ์ž โ€” cob๋„ ๊ณต๊ฐœํ•ด์•ผ ํ•˜๋Š” ๋ฌธ์ œ๊ฐ€ ๋ฐœ์ƒํ•˜๋‹ˆ๊นŒใ€. ๊ฐ™์€ ๋‚  D-111(#1656)์ด IDE ์˜ AI ๋ฅผ ์„œ๋ฒ„๋กœ๋งŒ ๋Œ๋ ธ๊ณ , ๊ณ ๊ฐ ํ™”๋ฉด์€ ์ด๋ฏธ ์›๊ฒฉ ์ž‘์—…๊ณต๊ฐ„(#1610)์—์„œ ํ’€์Šคํƒ ์•ฑ์„ ๋งŒ๋“ ๋‹ค.
  • Decision: โ‘  ๊ด€๋ฆฌ์ž IDE ์˜ ์ƒˆ ์•ฑ ๋งŒ๋“ค๊ธฐ๋Š” ์„œ๋ฒ„ ์ชฝ ์ž‘์—… ๊ณต๊ฐ„ ํ˜ธ์ŠคํŠธ์—์„œ ํ•œ๋‹ค โ€” ๊ณ ๊ฐ ํ™”๋ฉด์ด ์“ฐ๋Š” ๊ฒƒ๊ณผ ๊ฐ™์€ ์›๊ฒฉ ์ž‘์—…๊ณต๊ฐ„ ์—”์ง„์ด๋‹ค(#1610). ์„œ๋ฒ„ ์—”๋“œํฌ์ธํŠธ๋Š” customerRemote, ํ™”๋ฉด์€ ๋ฐ์Šคํฌํ†ฑ ๊ณต์šฉ ์œ„์ ฏ CustomerRemoteWorkspace(feature/customer/app)์ด๊ณ  DesktopRemoteApps(app/cocode/lib/desktop_remote_apps.dart)๊ฐ€ IDE ์˜ ใ€Œ์ƒˆ ์•ฑใ€ ๋ชฉ์ ์ง€์— ์˜ฌ๋ฆฐ๋‹ค. ๊ด€๋ฆฌ์ž๋„ ๊ณ ๊ฐ์ฒ˜๋Ÿผ ๋Œ€ํ™”์™€ ํ”„๋ฆฌ๋ทฐ๋งŒ ๋ฐ›๊ณ  ์†Œ์Šค๋Š” ๋ฐ›์ง€ ์•Š๋Š”๋‹ค(์˜ค๋„ˆ ์„ ํƒ). ํ”„๋กœ์ ํŠธ ์ถ”๊ฐ€ โ€บ ยซ์ฑ„ํŒ…์œผ๋กœ ๋งŒ๋“ค๊ธฐยป๋Š” ํด๋”๋ฅผ ๋งŒ๋“ค์ง€ ์•Š๊ณ  ใ€Œ์ƒˆ ์•ฑใ€ ํŽ˜์ด์ง€๋ฅผ ์—ฐ๋‹ค. โ‘ก ์‚ฌ์šฉ์ž ๊ธฐ๊ธฐ์—์„œ cob ์„ ์‹คํ–‰ํ•˜๋Š” ๊ธธ์„ ์ „๋ถ€ ์ œ๊ฑฐํ•œ๋‹ค โ€” ProcessCobClient(cob catalog/plan/doctor/fullstack/verify/publish) ยท CobStatusProbe(cob plan --help ยท cob --version ยท ~/.cob/bricks ํ™•์ธ) ยท Cob* ํด๋ผ์ด์–ธํŠธ ํƒ€์ž…๊ณผ ์ค€๋น„ ์ƒํƒœ ์ด์Šˆ ยท ProjectBuilderFlow ์™€ ๊ณ„ํš ยท ์‹คํ–‰ ยท ์ด์–ด ๋Œ๋ฆฌ๊ธฐ ยท ๊ฒŒ์‹œ, ์กฐ๋ฆฝ UI(๊ณ„ํš ยท ์‹คํ–‰ ยท ์‹คํŒจ ์นด๋“œ, ์‹คํ–‰ ๋‹จ๊ณ„, ์ฑ„ํŒ… ๋ชจ๋“œ์˜ ์กฐ๋ฆฝ ใ€Œ์ž‘์—… ํ˜„ํ™ฉใ€ ์˜† ํŒจ๋„, ํ•˜๋‹จ ใ€Œ๋””๋ฒ„๊ทธ ๋กœ๊ทธใ€ ํƒญ, ์›Œํฌ์ŠคํŽ˜์ด์Šค ์ฑ„ํŒ…์˜ ใ€Œ์กฐ๋ฆฝใ€/ใ€Œ์ƒˆ ์•ฑ ๋งŒ๋“ค๊ธฐใ€ ์ „ํ™˜, ์นดํƒˆ๋กœ๊ทธ ๊ธฐ๋ฐ˜ ์‹œ์ž‘ ์ œ์•ˆ, ์ปจํ…์ŠคํŠธ ํŒจ๋„๊ณผ ๊ทธ ์ผœ๊ธฐ ยท ๋„๊ธฐ ์„ค์ •, Pages ์ €์žฅ์†Œ ํ™•์ธ PagesRepositoryProbe ยท cob publish), ์„ค์ • โ€บ ๋นŒ๋”, ๊ทธ๋ฆฌ๊ณ  package/runner ์˜ ์ฃฝ์€ ์ฝ”๋“œ RunnerSession ยท RunnerLaunchSpec ยท runner_event. ์šฐ๋ฆฌ ํ˜ธ์ŠคํŠธ ์•ˆ์—์„œ ์“ฐ๋Š” cob(ํ…œํ”Œ๋ฆฟ ์ƒ์„ฑ cob fullstack ยท ์„ธ์…˜ ๊ฐ€์ƒ๋จธ์‹ ์˜ ๋Ÿฌ๋„ˆ cob dev)์€ ์ด ๊ฒฐ์ •์˜ ๋Œ€์ƒ์ด ์•„๋‹ˆ๋‹ค. โ‘ข ๋‚จ๊ธฐ๋Š” ๊ฒƒ โ€” ๊ธฐ๊ธฐ์— ์ด๋ฏธ ์žˆ๋Š” ์ €์žฅ์†Œ์˜ ํŽธ์ง‘๊ธฐ ยท ํ„ฐ๋ฏธ๋„ ยท git ยท ๋กœ์ปฌ ํ”„๋ฆฌ๋ทฐ. ๋กœ์ปฌ ํ”„๋ฆฌ๋ทฐ๋Š” ํ„ฐ๋ฏธ๋„ ํƒญ์—์„œ flutter run -d web-server ยท serverpod start ยท jaspr serve ๋ฅผ ๋„์šฐ๋ฉฐ(์—๋””ํ„ฐ D-077) cob ์„ ์“ด ์ ์ด ์—†๋‹ค. ใ€ŒIDE ์˜ ํ’€์Šคํƒ ํ”„๋ฆฌ๋ทฐ๊ฐ€ cob dev ์— ์˜์กดํ•œ๋‹คใ€๋Š” ์•ž์„  ๋ฉ”๋ชจ(#1661 ๋‘˜์งธ ๋Œ“๊ธ€)๋Š” ํ‹€๋ ธ๋‹ค โ€” cob dev ๋ฅผ ๋ถ€๋ฅด๋Š” ์œ ์ผํ•œ ์ฝ”๋“œ RunnerSession(package/runner)์€ ์–ด๋А lib/ ์—์„œ๋„ ํ˜ธ์ถœ๋˜์ง€ ์•Š์€ ์ฃฝ์€ ์ฝ”๋“œ์˜€๋‹ค. package/runner ์˜ ์ถœ๋ ฅ ํŒŒ์„œ๋Š” feature/run/app ยท feature/terminal/app ์ด ์“ฐ๋ฏ€๋กœ ๋‚จ๋Š”๋‹ค. ์—ด๋ฆฐ ๋กœ์ปฌ ํ”„๋กœ์ ํŠธ์˜ ์ฑ„ํŒ…๋„ ๋‚จ๋Š”๋‹ค โ€” ํ˜„์žฌ ์•ฑ ์ˆ˜์ • ๋Œ€ํ™”(WorkspaceChatView / WorkspaceEditor.propose, ์„œ๋ฒ„ ์šฉ๋„ workspace_edit)์™€ ๊ด€๋ฆฌํ˜• ์—์ด์ „ํŠธ ์„ธ์…˜. โ‘ฃ BuilderSandbox(์ •์ฑ… ํ”„๋ก์‹œ ๋Ÿฐ์ฒ˜)๋Š” ์Šคํ† ์–ด ์Šคํฌ๋ฆฐ์ƒท์ด ์“ฐ๋ฏ€๋กœ ๋‚จ๊ธฐ๊ณ , package/bricks(์•ฑ ์•ˆ Mason ์—”์ง„ โ€” ๋“ฑ๋ก๋งŒ ๋˜๊ณ  ์ฝํžˆ์ง€ ์•Š๋Š”๋‹ค)๋Š” cob ์ด ์•„๋‹ˆ๋ผ ๊ฑด๋“œ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค.
  • Rationale: cob ๊ณผ bricks ๋ฅผ ์‚ฌ์šฉ์ž ๊ธฐ๊ธฐ์— ๋‘์ง€ ์•Š์œผ๋ฉด ๊ณต๊ฐœํ•  ์ผ์ด ์—†๋‹ค. ๋งŒ๋“œ๋Š” ์—”์ง„์ด ๊ณ ๊ฐ ํ™”๋ฉด๊ณผ ํ•˜๋‚˜๊ฐ€ ๋œ๋‹ค(#1610). D-111 ๊ณผ ๊ฐ™์€ ๋ฐฉํ–ฅ์ด๋‹ค โ€” IDE ์˜ AI ์— ์ด์–ด ๋งŒ๋“ค๊ธฐ๋„ ์„œ๋ฒ„์—์„œ ๋ˆ๋‹ค.
  • Impact: โ‘  ๊ด€๋ฆฌ์ž IDE ์—์„œ ๋งŒ๋“  ์ƒˆ ์•ฑ์€ ๊ด€๋ฆฌ์ž์˜ ๋””์Šคํฌ์— ์—†๊ณ  ๋กœ์ปฌ ํ”„๋กœ์ ํŠธ ๋ชฉ๋ก์—๋„ ์—†๋‹ค โ€” ใ€Œ์ƒˆ ์•ฑใ€ ํŽ˜์ด์ง€๊ฐ€ ์„œ๋ฒ„์—์„œ ๋ฐ›์•„ ๋‚˜์—ดํ•œ๋‹ค. โ‘ก ์›๊ฒฉ ์ž‘์—…๊ณต๊ฐ„์˜ ํ•œ๋„์™€ ์šด์˜ ์ •์ฑ…์ด ๊ด€๋ฆฌ์ž์—๊ฒŒ๋„ ์ ์šฉ๋œ๋‹ค โ€” ๊ด€๋ฆฌ์ž๋Š” Pro ๋กœ ๊ณ„์‚ฐ๋˜๊ณ , ์šด์˜ ์ •์ฑ…์€ ํ—ˆ์šฉ ๋ชฉ๋ก์ด๋ฉฐ, ํ•œ๋„๋Š” ๊ณ„์ •๋ณ„์ด๋‹ค(์ด์Šˆ ์‹œ์ : ํ”„๋กœ์ ํŠธ 3๊ฐœ ยท ํ•˜๋ฃจ 30์ฐจ๋ก€ ยท ๊ณ„์ • ์›” 12,000์›). ์›๊ฒฉ ๊ณ„๋Ÿ‰์— ๊ด€๋ฆฌ์ž ์ „์šฉ ์˜ˆ์‚ฐ์€ ์—†๋‹ค. ์šด์˜ ์ •์ฑ…์ด ํ—ˆ์šฉ ๋ชฉ๋ก์ธ ๋™์•ˆ, ๋ชฉ๋ก์— ์—†๋Š” ๊ด€๋ฆฌ์ž๋Š” ์•ฑ์„ ์•„์˜ˆ ๋งŒ๋“ค ์ˆ˜ ์—†๋‹ค โ€” ใ€Œ์ƒˆ ์•ฑใ€์€ ใ€Œ์ง€๊ธˆ์€ ์“ธ ์ˆ˜ ์—†๋‹ค, ์ž ์‹œ ํ›„ ๋‹ค์‹œ ํ™•์ธํ•ด ๋‹ฌ๋ผใ€๋Š” ์•ˆ๋‚ด๋งŒ ๋ณด์ธ๋‹ค(๊ธฐ๋‹ค๋ ค๋„ ํ’€๋ฆฌ์ง€ ์•Š๋Š”๋‹ค). ์•ฑ์„ ๋งŒ๋“ค์–ด์•ผ ํ•˜๋Š” ๊ด€๋ฆฌ์ž ๊ณ„์ •์€ ๋ชจ๋‘ ๊ทธ ๋ชฉ๋ก์— ์žˆ์–ด์•ผ ํ•œ๋‹ค. โ‘ข ์˜คํ”„๋ผ์ธ์—์„œ๋Š” ์•ฑ์„ ๋งŒ๋“ค ์ˆ˜ ์—†๋‹ค. โ‘ฃ ์˜› ใ€Œ์ƒˆ ์•ฑใ€ ํŽ˜์ด์ง€์˜ ํ”„๋กฌํ”„ํŠธ ์ž…๋ ฅ๋ž€๊ณผ ํ…œํ”Œ๋ฆฟ ๊ฐค๋Ÿฌ๋ฆฌ๊ฐ€ ์—†์–ด์ง„๋‹ค โ€” ์›๊ฒฉ ๋งŒ๋“ค๊ธฐ๋Š” ์•ฑ ์ด๋ฆ„๋งŒ ๋ฐ›๋Š”๋‹ค. โ‘ค ์˜› ์ €์žฅ ์ƒํƒœ๋Š” ์ง€์šฐ์ง€ ์•Š๊ณ  ๊ณ„์† ์ฝํžŒ๋‹ค โ€” ์„ธ์…˜ SQLite ์˜ ๋นŒ๋” ์„ธ์…˜ ํ–‰(์˜› ์กฐ๋ฆฝ ๋Œ€ํ™”๋Š” ํ–‰์— ๋‚จ์ง€๋งŒ ํ™”๋ฉด์— ๋ณด์ด์ง€ ์•Š๋Š”๋‹ค), ์ „์— ์ƒ์„ฑํ•œ ํ”„๋กœ์ ํŠธ์˜ ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ ํ•ญ๋ชฉ(์ผ๋ฐ˜ ๋กœ์ปฌ ํ”„๋กœ์ ํŠธ๋กœ ๋‚จ๋Š”๋‹ค), ์‹ ๋ขฐ ๊ธฐ๋ก, ~/.cob/bricks. โ‘ฅ ๋Œ€์ฒด ๋ฒ”์œ„ โ€” D-091 ยท D-092(๋นŒ๋” ์‹คํ–‰ ์‹คํŒจ ์‚ฌ์œ  ยท ์ด์–ด ๋Œ๋ฆฌ๊ธฐ ยท Pages ๊ฒŒ์‹œ)๋Š” ๊ทธ ๋Œ€์ƒ์ด ์—†์–ด์ ธ ์ „๋ถ€ ๋Œ€์ฒด๋œ๋‹ค. D-023 ์€ ํŒ€์ด ๊ฐœ๋ฐœ ๋„๊ตฌ๋กœ cob ์„ ์“ฐ๋Š” ๊ฒฐ์ •์ด๋ผ ๊ทธ๋Œ€๋กœ๋‹ค. ์—๋””ํ„ฐ D-077(๋กœ์ปฌ ์‹คํ–‰ ยท ํ”„๋ฆฌ๋ทฐ์˜ ๋Ÿฌ๋„ˆ ๋ช…๋ น)๋„ ๊ทธ๋Œ€๋กœ๋‹ค โ€” ์ด ์ผ์ง€์˜ D-077(๋ชจ๋ฐ”์ผ E2E ยท ๋ชจ๋ฐ”์ผ ๋ฐฐํฌ๋Š” ๋ฒ”์œ„ ๋ฐ–)์€ ์ด ๊ฒฐ์ •๊ณผ ๋ฌด๊ด€ํ•˜๋‹ค. โ‘ฆ ํ•จ๊ป˜ ๋‹ฌ๋ผ์ง„ ํ™”๋ฉด โ€” ์—ด๋ฆฐ ํ”„๋กœ์ ํŠธ์˜ ๋Œ€ํ™”๋Š” ใ€Œํ˜„์žฌ ์•ฑ ์ˆ˜์ •ใ€ ํ•˜๋‚˜์ด๊ณ (ใ€Œ์กฐ๋ฆฝใ€์œผ๋กœ ๋ฐ”๊พธ๋Š” ๋ฉ”๋‰ด ์—†์Œ), ์ฑ„ํŒ… ๋ชจ๋“œ์—๋Š” ใ€Œ์ž‘์—… ํ˜„ํ™ฉใ€ ๋‹จ์ถ”๊ฐ€ ์—†์œผ๋ฉฐ(์—ด ํŒจ๋„์ด ์—†๋‹ค โ€” ์ฝ”๋“œ ๋ชจ๋“œ์—๋Š” ๊ทธ๋Œ€๋กœ ์žˆ๋‹ค), ํ•˜๋‹จ ใ€Œ๋””๋ฒ„๊ทธ ๋กœ๊ทธใ€ ํƒญ๊ณผ ์„ค์ • โ€บ ๋นŒ๋”๊ฐ€ ์—†๋‹ค. ์•ฑ ์ถ”๊ฐ€ โ€บ ยซ์ฑ„ํŒ…์œผ๋กœ ๋งŒ๋“ค๊ธฐยป๋Š” ์ ์–ด ๋‘” ์ด๋ฆ„์„ ๋“ค๊ณ  ใ€Œ์ƒˆ ์•ฑใ€์˜ ๋งŒ๋“ค๊ธฐ ํ™”๋ฉด์œผ๋กœ ๊ฐ„๋‹ค(์œ„์น˜๋Š” ๋„˜๊ธฐ์ง€ ์•Š๋Š”๋‹ค). ์˜ˆ์ „ ํŒ์˜ ์กฐ๋ฆฝ ๋Œ€ํ™”๋งŒ ๋“  ์„ธ์…˜์€ ์„ธ์…˜ ๋ชฉ๋ก์— ๋‚˜์˜ค์ง€ ์•Š๋Š”๋‹ค(๊ธฐ๋ก์€ ๋‚จ๋Š”๋‹ค). ์„ค์ • โ€บ ์•Œ๋ฆผ์˜ ใ€Œ์Šน์ธ์ด ํ•„์š”ํ•  ๋•Œใ€ ยท ใ€Œ์ž‘์—…์ด ์‹คํŒจํ–ˆ์„ ๋•Œใ€๋Š” ์กฐ๋ฆฝ ๋Œ€ํ™”๋งŒ ๋ณด๋‚ด๋˜ ์•Œ๋ฆผ์ด์—ˆ๋‹ค โ€” ์ด์ œ ์—์ด์ „ํŠธ ์„ธ์…˜์ด ๋ณด๋‚ธ๋‹ค(ํŒŒ์ผ ๋ณ€๊ฒฝ ํ™•์ธ์„ ๊ธฐ๋‹ค๋ฆด ๋•Œ ยท ์„ธ์…˜์ด ์‹คํŒจํ•ด ๋ฉˆ์ท„์„ ๋•Œ). โ‘ง ๋‚จ์€ ์ผ โ€” ๊ณต๊ฐœ ๋งค๋‰ด์–ผ(site/manual/content/ko โ€” start/requirements.md ยท guide/chat-builder/** ยท guide/settings/builder.md ๋“ฑ)์€ ์•„์ง ์˜› ๋นŒ๋”๋ฅผ ์„ค๋ช…ํ•˜๊ณ  cob ยท bricks ๋ฅผ ์ด๋ฆ„์œผ๋กœ ์‹ฃ๋Š”๋‹ค. ์ด ๊ฒฐ์ •์˜ ์ฝ”๋“œ ๋ณ€๊ฒฝ์—๋Š” ๋“ค์–ด ์žˆ์ง€ ์•Š๋‹ค โ€” #1666 ์—์„œ ๊ณ ์นœ๋‹ค.
  • Source: ์˜ค๋„ˆ ๊ฒฐ์ •, 2026-11-18 ยท #1661 ยท PR #1662 ยท #1656 ยท #1610 ยท D-111 ยท D-023 ยท D-091 ยท D-092 ยท ์—๋””ํ„ฐ D-077(decision-log-fullstack-code-editor.md)