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๊ธ์ผ๋ก ์ ๊ณต โ ์์ฅ ์ปค๋ฒ๋ฆฌ์ง๋ ๋์ง๋ง UX ์ค๊ณ ํ๋ฉด์ด ๋ ๋ฐฐ๋ก ๋์ด๋ MVP ์ง์ฐ ์ํ
- ๊ฐ๋ฐ์ ์ธํฐํ์ด์ค๋ฅผ ๋จผ์ ์ถ์ํ๊ณ ๋๋ฆฌ๋จธ ๋ชจ๋๋ ํ์ ์ ๋ฐ์ดํธ๋ก ์์ฐ โ ์ ์ค๊ณ ๋ ธํธ์ ์๋ํฐ ์ฝ์ด ์ค์ฌ ๋ก๋๋งต๊ณผ ์ ํฉ์
- 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:
- Orca์ ๋์ผํ ์ถ(์ธ์ด ๋ฌด๊ด ๋ฉํฐ ์์ด์ ํธ ์ค์ผ์คํธ๋ ์ด์ )์์ ์ ๋ฉด ๊ฒฝ์
- 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:
- MVP๋ ์ต์ ๊ธฐ๋ฅ์ผ๋ก ์ถ์ํ๊ณ ์์ ๋ง(๋กค๋ฐฑ/diff)์ ์ดํ ์ถ๊ฐ
- ๋กค๋ฐฑ + 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:
- "Dart๋ก ๋ชป ๋ง๋๋ ๊ฒ ์๋ค"๋ฅผ cocode ADE ์์ฒด ๊ตฌํ ๋ฒ์์๋ ๊ทธ๋๋ก ์ ์ฉํด, ๋ฆฌ์คํฌ ์คํ์ดํฌ๋ฅผ ํ์ ์ ์ฐจ๋ก ์ทจ๊ธ
- ์ด ๋ฏฟ์์ "์ฌ์ฉ์๊ฐ ๋ง๋๋ ๊ฒฐ๊ณผ๋ฌผ"์ ์ญ๋ ๋ฒ์์ ๋ํ ๊ฒ์ผ๋ก ํ์ ํ๊ณ , 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:
- ์ฝ์ฝ๋ ๋ด๋ถ ๋๊ทธํธ๋ฉ ์ฐ์ โ MVP ๋ฒ์๊ฐ ์ข์์ง๊ณ ๋ฆฌ์คํฌ๊ฐ ์ค์ง๋ง ์ถ์๊ฐ ๋ฆ์ด์ง
- ์ฒ์๋ถํฐ ์ธ๋ถ ๊ฐ๋ฐ์ ์์ฅ ๋์ โ ๋์ ์์ฅ์ ๊ฒจ๋ฅํ๋ ๊ฒ์ฆ๋์ง ์์ ์ธ๋ถ ์์์ ๋ ธ์ถ
- ๊ตฌ๋ถํ์ง ์์ โ 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:
- acp๋ง์ผ๋ก ๋จผ์ ์ถ์ โ Discovery ๋ก๋๋งต๊ณผ ์ผ์น, ๋ชจ๋ธ ๊ณ์ฝ ์์ด ๋น ๋ฅธ ์ถ์, ๋ค๋ง "๋ฉํฐ LLM ์ ํ"์ด๋ผ๋ ํต์ฌ ๊ฐ์น์ ์์ด MVP์ ๋ถ์ฌ
- ๋ ๋ค 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:
- ์๊ฐ ๊ฒ์ฆ๋ง์ผ๋ก ์๋ฃ ๊ฐ๋ฅ โ C-04์ "์๋ฆฌ๋ฅผ ๋น์ธ ์ ์๋ค"์ ์ ํฉ, diff๋ ์ฌํ ์์ ๋ง
- ์ฌ๋์ 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:
- ์ต๋ 3ํ ์ฌ์๋ ํ "์คํจ" ์ ์ด + ์์ค์ปฌ๋ ์ด์
- ์๊ฐ ๊ธฐ์ค ์ ํ(์: 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์ ์ฐธ์กฐ ๋ฌธ์์ ์ ์๋์ด ์๋ค. ์ ๋ก ์์ฒด๋ ์ค์ฌํ๋ฏ๋ก ๊ทผ๊ฑฐ๋ ์ ์งํ๋ ์ถ์ฒ๋ฅผ ์ ์ ํ๋ค
- ์ ์ (2026-08-26): ์ต์ด ๊ธฐ์ฌ๋ ์ด ์ ๋ก๋ฅผ "cc-spec ์์ฒด์ ์ ์ฑ
(
- 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:
- C-04๋ฅผ ๊ทธ๋๋ก ๋๊ณ ๋ฆฌ์คํฌ๋ฅผ ์ธ์
- ์ ์ฝ๊ณผ ๋ฏฟ์์ ๋ ์ธต์๋ก ๋ถ๋ฆฌ โ ์ ์ฝ์ ๊ฒ์ฆ ๊ฐ๋ฅํ ํ์๋ง ๊ท์ ํ๊ณ , ๊ฒ์ฆ๋์ง ์์ ๋ฏฟ์์ ๊ฐ์ ์ผ๋ก ๊ฒฉํํด ์ค์ธก ๊ณํ์ ๋ถ์
- 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:
- Resolved ์ฃผ์ฅ์ ์ ์ง โ ๊ฐ์ฌ ํ์ ์ ๋ฌด์ํ๊ฒ ๋๋ฉฐ, ๊ทผ๊ฑฐ ์๋ ํด์ ์ฃผ์ฅ์ด ๊ฒ์ดํธ ์ฐ์ถ๋ฌผ์ ๋จ์
- Accepted(์ํ ์ธ์)๋ก ์ฌ๋ถ๋ฅํ๊ณ , ๋ฏธ๊ฒ์ฆ ์ฌ์ค์ C-03 ๋ณธ๋ฌธ๊ณผ ๊ฐ์ ๋ชฉ๋ก์ ๋ช ์
- 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:
- ๋๋น์ฑ ์์ด ๊ฐ์ โ ์๊ฐ ๊ฒ์ฆ์ด ๋๋ค๋ ์ชฝ์ ๊ฑธ๊ณ , ์คํจ ์ ๋ถ๋ณ ์ ์ฝ์ ์๋ฐํ๋ฉฐ ์คํ์ ๊ณ ์นจ
- C-04์ ์ ํ ์กฐํญ์ ๋ฏธ๋ฆฌ ์จ๋ฃ์ โ ์คํ์ดํฌ ๋ฏธ๋ฌ ์ "์ฌ๋ diff ์น์ธ ํ ์๋ฃ" ๋ชจ๋๋ก ์๋ ์ ํํ๋ค๊ณ ์ ๊ธ ์ ์ ๊ท์
- ์์ ์ ํ๋ณ ์ฐจ๋ฑ โ ํ ์คํธ ์ปค๋ฒ๋ฆฌ์ง๊ฐ ์๋ ์์ ๋ง ์๊ฐ ๊ฒ์ฆ์ผ๋ก ์๋ฃ
- 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:
- ๊ฐ์ ์ผ๋ก ๊ฐ๋ฑ ํ ์คํ์ดํฌ๋ก ํ์ โ NFR-01์ "A-06 ์คํ์ดํฌ์์ ํ์ ํ ๋ชฉํ์น๋ฅผ ์ถฉ์กฑํ๋ค"๋ก ๋ฐ๊พธ๊ณ , ์ค์ธก ํ ์์น๋ฅผ ์ฑ์
- ์ ์๋ ์์น ์ ์ง โ 150MB/2์ด/400MB๋ฅผ ๊ฒฝ์ ์ฝ์์ผ๋ก ๋ฐ์๋ค์
- ์ค๋๊ฐ ์ง์ ์์น ์ง์
- 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:
- ๊ธฐ์กด ํ ์คํธ ์์ ๊ธ์ง โ ์์ด์ ํธ๋ ํ ์คํธ๋ฅผ ์ถ๊ฐํ ์ ์์ผ๋ ์ฝํยท๋นํ์ฑํยท์ญ์ ํ ์ ์๊ณ , ๊ธฐ์กด ํ ์คํธ ๋ณ๊ฒฝ์ ์ฌ๋ ์น์ธ ํ์
- ํ ์คํธ ๋ณ๊ฒฝ์ diff์์ ๊ฐ์กฐ ํ์๋ง โ ์ ํํ์ง ์๊ณ ์ฌํ ๋ฆฌ๋ทฐ ์ ๋์ ๋๊ฒ ํจ
- 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.md64ํ. ์ต์ด ๊ธฐ์ฌ์ 36.5๋ ์ค๊ธฐ์ด๋ฉฐ 4์ฐจ ๊ฐ์ฌ ์ง์ ์ผ๋ก ์ ์ ) 3์ฐจ ์ ๋์ ๊ฐ์ฌ๊ฐ ์์ธ์ ์ ํํ ์ง๋ชฉํ๋ค: "v1.2.0์ NFR-01์์ ๊ทผ๊ฑฐ ์๋ ์ซ์ 3๊ฐ๋ฅผ ์ ๊ฑฐํ๋ฉด์ ๊ฐ์ ๊ฐ์ ์์ ์ ์ซ์ 6๊ฐ๋ฅผ ๋์ ํ๋ค. D-013 ์์ ์ด '๊ฒ์ฆ๋์ง ์์ ์ซ์๋ฅผ ์ ๊ทธ๋ ๊ฒ์ ์ด ์คํ์ด ์ผ๊ด๋๊ฒ ๊ฑฐ๋ถํด ์จ ํจํด'์ด๋ผ๊ณ ์ผ๋๋ฐ, ๋ฐ๋ก ๊ทธ ๋ฌธ์ฅ์ ์ด ๊ฐ์ ์ด ์ ๋ฏธ๊ฒ์ฆ ์ซ์๋ฅผ ๋์ ํ๋ค." ๋ํ cc-spec ํ๋กํ ์ฝ์ ์์ ยท์ฌํ๊ฐ ๋ฃจํ ์ํ(bound: 2)์ ์ด๋ฏธ ์์งํ ์ํ์๊ณ , ํ๋กํ ์ฝ์ ์ด ๊ฒฝ์ฐ "๋ฌธ๊ตฌ๊ฐ ์๋๋ผ ๋ฌธ์ ์ ์๋ฅผ ๋ค์ ์ก์ ์ ํธ"๋ก ๋ณด๊ณ ์์ค์ปฌ๋ ์ด์ ํ๋ผ๊ณ ๊ท์ ํ๋ค - Options:
- ์ต์ ํต์ฌ์ผ๋ก ์ญ๊ฐ ์ฌ์์ฑ โ ์ ๋ง ์ ๋ฐ๋๋ ๊ฒ๋ง ๋จ๊ธฐ๊ณ ๊ตฌํ ์ธ๋ถ๋ฅผ Planning์ผ๋ก ์ด๊ด
- v1.3.0์ผ๋ก ๊ณ์ ํจ์น โ ์ง์ ํญ๋ชฉ์ ํ๋์ฉ ์์
- ํ์ฌ ์ํ๋ก ์ ๊ธ ํ ์งํ โ ๋ฏธํด์ ํญ๋ชฉ์ ๊ณต๊ฐ ๋ฏธ๊ฒฐ ๊ณผ์ ๋ก ๊ธฐ๋ก
- 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-reevaluateexhaust ์กฐํญ + ํ๋ก์ ํธ ์ค๋ ํ๋ต
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:
- ๋ฐฐํฌ 3์ข ์ ์ง + ๊ฒ์ดํ ์คํ์ดํฌ๋ macOS ๋จผ์ , ๋๋จธ์ง ์์ฐจ
- ์ธ ํ๋ซํผ ๋์ ๊ฒ์ฆ โ ๋ฆฌ์คํฌ๋ฅผ ์๋น๊ธฐ์ง๋ง 1๋จ๊ณ ์คํ์ดํฌ ๊ธฐ๊ฐ์ด ํฌ๊ฒ ๋์ด๋จ
- 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:
- Anthropic + OpenAI ํธํ ๊ฒ์ดํธ์จ์ด โ SDK ํ๋ + ํธํ ๊ณ์ธต ํ๋
- Anthropic ๋จ๋ ์ผ๋ก ๊ฐ๊ณ AC-06์ "1๊ฐ ์ด์"์ผ๋ก ๋ฎ์ถค (๋ฉํฐ LLM์ acp๊ฐ ๋ด๋นํ๋ ๊ฒ์ผ๋ก ์ฌ์ ์)
- 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 ๋ฆฌ๋ค์ด๋ ํธ โขGradlegoogle()์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)
- ์ ์ (2026-09-13): ์ด ํญ๋ชฉ์ ๊ฐ์ "11์ข
"์ ์ ๋ณธ์ด ์๋๋ค(D-051 โ ์ค๋ ๊ฒฐ์ #109). #38 ์ 3-OS ์ค์ธก์ด ยง2.1 ํ์ ์๋
- ํ๊ณ: ํ๋ก์ ํธ๋ณ
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 ๋ถ์์ ์ ์ ์ธํ๋ค
- unibook์ org ๋ด ์ ์ผํ๊ฒ ๊ท๋ชจยทํํ๋ฅผ ๋์์ ๋ง์กฑํ๋ค โ Dart ํ์ผ 9,931๊ฐ(~55.8MB), ์์ฑ ํ์ผ 712๊ฐ git ์ถ์ ,
- 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:
- ยง4๋ฅผ ๋ฒ์ ๊ฒฝ๊ณ๋ก ํ์ํ๊ณ ์ธก์ ์๋ฃ๋ฅผ Planning ์ ๋ ฅ ๋ฌธ์๋ก ๋ถ๋ฆฌ
- v2.2.0์ผ๋ก ๊ณ์ ํจ์น โ ์ง๋ ๋ค ๋ผ์ด๋๊ฐ ์คํจ๋ฅผ ์ฆ๋ช ํ ๋ฐฉ์
- ํ๋ก์ ํธ ์ค๋๊ฐ ์ง์ ๊ฒํ ยท์ ๋ฆฌ
- ํ ์ํ๋ก 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>๋ก ๋ค์ดํฐ๋ธ ํธ๋ค(LinuxGtkWindow, macOSNSWindow, Win32HWND)์ ์ง์ ์ ๊ทผํ ์ ์๋ค(_window_linux.dart:208,_window_macos.dart:200).WindowControllerLinux/WindowControllerMacOS์ธํฐํ์ด์ค๋ก ์ ๊ณต๋๋ฉฐ, Windows ๋ค์ดํฐ๋ธ ๋ํน ๊ฐ์ ๊ณ ๊ธ ํตํฉ์ด ๊ฐ๋ฅํด์ง๋ค. - Options:
- ์ถ์ํ ๋ค์ ๋๊ณ
window_manager๋ก ๊ตฌํ โ stable ์ ์ง, ๋ค์ดํฐ๋ธ ์๋์์ด stable ์ ์ค๋ฉด ๊ตฌํ์ฒด ๊ต์ฒด - master ์ฑ๋๋ก ๊ฐ๊ณ ๋ค์ดํฐ๋ธ API ์ฌ์ฉ
- ๊ตฌํ์ฒด 2๊ฐ๋ฅผ ํ๋๊ทธ๋ก ๋ณํ
- MVP ์์ ์ฐฝ ๋ถ๋ฆฌ ์ ์ธ
- ์ถ์ํ ๋ค์ ๋๊ณ
- Decision: ์ต์ 2 โ master ์ฑ๋ + ๋ค์ดํฐ๋ธ ์๋์ API. ํ๋ก์ ํธ ์ค๋ ํ๋ต(2026-08-26, ๋ ์ฐจ๋ก ํ์ธ ํ)
- Rationale:
windowHandle๋ก ์ด๋ฆฌ๋ ๋ค์ดํฐ๋ธ ๋ํน์window_manager๋ก ๋์ฒดํ ์ ์๋ ๋ฅ๋ ฅ์ด๋ฉฐ, C-03 ์ด ์ ๊ทผ "Dart/Flutter ์ ์ฉ ์์ง ๊น์ด" ํฌ์ง์ ๋์ ์ง์ ๊ธฐ์ฌํ๋ค. Orca(์ํ์ ์ค์ผ์คํธ๋ ์ดํฐ)๊ฐ ๊ฐ์ง ๋ชปํ๋ ์ข ๋ฅ์ ์ฐจ๋ณํ๋ค. - ์ธ์ํ ์ํ (๋ช
์):
- master ์ฑ๋์ ์๋์๋ง์ด ์๋๋ผ ์ ํ ๋น๋ ๊ธฐ๋ฐ ์ ์ฒด์ ์ ์ฉ๋๋ค. stable ์ด ์๋ ํธ๋ฆฌ ์์์ ์ ํ์ ๋น๋ํ๊ฒ ๋๋ค
- Flutter ๊ฐ ์ด API ์ ํจ์น ๋ฒ์ ์์๋ breaking change ๋ฅผ ์๊ณ ํ๋ค โ ์ ์คํธ๋ฆผ ๋ณ๊ฒฝ์ด ๊ณง๋ฐ๋ก ๋น๋๋ฅผ ๊นจ๋จ๋ฆด ์ ์๋ค
@internalAPI ์ด๋ฏ๋ก ๊ณต๊ฐ 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) โdevelopment10,214 ํ์ผ. - ๋ถ์ ํจ๊ณผ: squash ๋ก
b8289d0(58MBmain.dillblob)ยท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 ์ผ๋ก ์ฌ๋ ธ๋ค(ํ๋ก์ ํธ ์ค๋ ์ง์ โ ์ฒ์์ CIflutter-setup๊ธฐ๋ณธ๊ฐ(#478)์ธ 3.47.5 ๋ก ๋ง์ถ๋ ค ํ์ผ๋, 2026-10-01 ์ ๋์จ ์ต์ stable 3.47.6 ์ผ๋ก ์ ํ๋ค). CIflutter-setup๊ธฐ๋ณธ๊ฐ๋ ๊ฐ์ 3.47.6 ์ผ๋ก ์ฌ๋ ค ๋ก์ปฌ(fvm ยท lefthookwith-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 ์ ์ผ๋ถ). CIflutter-setup๊ธฐ๋ณธ๊ฐ๋ ๊ฐ์ 3.47.8 ๋ก ์ฌ๋ ค ๋ก์ปฌ(fvm ยท lefthookwith-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-dart3.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 ์์ ์๊ณ@internalAPI ๊ฐ ํจ์น ๋ฒ์ ์์๋ 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. - ์คํ ์์ โฃ โ โก โ โ โ โข, ์กฐ๊ธฐ ์ข
๋ฃ๋
์คํจํ์ธ ํ์๋ง. ์ดํ์ "ํต๊ณผ๊ฐ ๋์ค๋ฉด ๋๋จธ์ง ๋ฏธ์คํ" ๊ท์น์ ์ฒ ํํ๋ค.
- DD-21 โ โ ~โฃ๋ "์ ์ฉ ๋ถ๊ฐ"๋ฅผ ํ์ ํ์ง ์๊ณ ์คํํ๋ค.
- 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.dill55.64 MiB(์ปค๋ฐb8289d0), GitHub ๋ 50 MiB ๊ฒฝ๊ณ ยท 100 MiB ์ฐจ๋จ. - Options:
- 50 MiB โ GitHub ๊ฒฝ๊ณ ์ ๊ทธ๋๋ก. main.dill ๊ธ์ ์ก๊ณ ํํ ์ถ์ ํ์ผ ์ต๋๊ฐ ํจ์ฌ ์์ ์คํ ์์
- 10 MiB โ ์์ ์ฐ์ถ๋ฌผ๋ ์กฐ๊ธฐ ์ฐจ๋จํ๋ ์ ๋นํ ๋์ฉ๋ ์์ฐ์ด ์๊ธฐ๋ฉด ํ์ฉ๋ชฉ๋ก ๊ด๋ฆฌ ํ์
- 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.ymlchanges์ก ๋ฐฐ์ . #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:
product-artifact-200c74e2์๊ฒฉ ๋ธ๋์น ์ญ์ โ blob ์ด GC ๋์์ด ๋์ด ์ ๊ท clone ์ด ๊ฐ๋ฒผ์์ง. ํ์คํ ๋ฆฌ ์ฌ์์ฑ ๋ถํ์(๋ธ๋์น ์ญ์ ๋ง์ผ๋ก ์ถฉ๋ถํด์ง โ ์ ์ ๋ณ๊ฒฝ์ ์ด๋)- ๋ณด์กด โ ํ์ดํ๋ผ์ธ ์ฐ์ถ ์ด๋ ฅ ๋ณด๊ด. ๊ทธ ๋ธ๋์น๋ฅผ 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.mdFP-103 ์ด ์ด ์๋ฆฌ๋ฅผ ใ์์(๋ฏธ๊ท์ )ใ์ผ๋ก ๊ธฐ๋กํ๊ณ I-5 ๋ก ๋ฑ๊ธํ๋ค. AC-07(์ฌ์๋ 3ํ ์ํ)์ด ์ต๋ 4์ธํธ(์ต์ด 1 + ์ฌ์๋ 3)์ ํธ์ง์ ๋ง๋ค ์ ์๊ฒ ํ๋๋ฐ, ๊ทธ 4์ธํธ๊ฐ ์ฌ๋์๊ฒ ์ด๋ค ์ํ๋ก ๋์ด๊ฐ๋์ง๊ฐ ์ ํด์ง์ง ์์๋ค. - Options:
- ๋์ โ ์ฌ์๋๋ ์ง์ ํธ์ง ์์ ๊ณ์ ์๋๋ค. ์คํจ ํ ์ฌ๋์ด ๋ณด๋ diff ์ ๋ชจ๋ ์๋์ ํ์ ์ด ๋จ๊ณ , ์๋ ๊ตฌ๋ถ์
attempt_no๊ฐ ํ๋ค - ๋๊ฐ๊ธฐ โ ๊ฐ ์ฌ์๋๋ ์ง์ ์๋๋ฅผ ์๋ ๋กค๋ฐฑํ ๊นจ๋ํ ์ํ์์ ์์ํ๋ค. ์ต์ข diff ๋ ๋ง์ง๋ง ์๋๋ง ๋ด์ ๊น๋ํ๋ค
- ๋์ + ํ๋ฉด์์ ์คํจํ ์๋๋ฅผ ๊ธฐ๋ณธ ์ ํ ์ฒ๋ฆฌ (์ ์ฅ์ 1๊ณผ ๋์ผ, UX ์๊ตฌ 1๊ฑด ์ถ๊ฐ)
- ๋์ โ ์ฌ์๋๋ ์ง์ ํธ์ง ์์ ๊ณ์ ์๋๋ค. ์คํจ ํ ์ฌ๋์ด ๋ณด๋ diff ์ ๋ชจ๋ ์๋์ ํ์ ์ด ๋จ๊ณ , ์๋ ๊ตฌ๋ถ์
- Decision: ์ต์ 1 โ ๋์ . ์ฌ์๋๋ ์ง์ ์๋์ ํธ์ง์ ์๋์ผ๋ก ๋๋๋ฆฌ์ง ์๋๋ค.
- Rationale: ํ๋ก์ ํธ ์ค๋ ํ์ (2026-08-29). ๊ทผ๊ฑฐ 3๊ฐ์ง โ โ
flow-permutation-cocode.md:325B-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.mdDD-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:
- ๋ถ์ยท๋น๋ ๋ฒ์์์ ์ ์ธ โ
analysis_options.yaml์ exclude ์melos: ignore:์ ๋๋ ๊ฒฝ๋ก๋ฅผ ๋ฃ๋๋ค. ํ์ผ์ ํ ์ค๋ ์ง์ฐ์ง ์๋๋ค. ์ด๋ฏธ ์ด ๋ฆฌํฌ์ ๊ด์ฉ๊ตฌ(analysis_options.yaml์ดcocode_clientยทdeploy/awsยทpdfrxยทpostal_ko๋ฅผ ํจํค์ง ํต์งธ๋ก ๋ฐฐ์ ์ค) - ๋๋ ์ฝ๋ ์๋ฆฌ โ injectable ์์กด 10ํจํค์ง๋ฅผ GetIt ์๋ ๋ฑ๋ก์ผ๋ก ์ ํ + ๋๋ฝ ๋ฐฑ์๋ ๋ชจ๋ธ 305๊ฐ ๋ณต์ + dio/Failure ์ธ๋์ฐจ ์ ๋ฆฌ. #8 ์ ์๋ ด ์คํ(308โ61โ40)์ด ๋ฉ์ถ์ง ์์๊ณ , ๋๊น์ง ๊ฐ๋ฉด ใServerpod ๋ฐฑ์๋๊ฐ ์๋คใ๊ณ ๋ชป๋ฐ์ ์ ํ์ ์ ์์ฑ ๋ฐฑ์๋๋ฅผ ํต์งธ๋ก ๋ณต์ํ๊ฒ ๋๋ค
- ๋๋ ์์ฐ ์ ๊ฑฐ โ D-026 ๋ฒ๋ณต
- ๋ถ์ยท๋น๋ ๋ฒ์์์ ์ ์ธ โ
- Decision: ์ต์ 1 โ ๋ถ์ยท๋น๋ ๋ฒ์์์ ์ ์ธ. ํ๋ก์ ํธ ์ค๋ ํ์ (2026-08-29).
- Rationale: D-026 ์ ใ์ถํ ๋ฐฑ์๋๊ฐ ํ์ํ ์๋ ์์ด์ใ๋ผ๋ ์๋๋ฅผ ๊ทธ๋๋ก ์งํค๋ฉด์(ํ์ผ 0๊ฑด ์์ ) CI ๋ฅผ ๋์ด๋ฆฌ๋ ์ ์ผํ ๊ฒฝ๋ก๋ค. ์ต์ 2 ๋ ์์ฃผ ์ด์์ด๊ณ cocode ADE ์ ํ ๊ฐ์น์ ๊ธฐ์ฌํ์ง ์์ผ๋ฉฐ, ์ต์ 3 ์ ์ค๋ ๊ฒฐ์ ์ ๋ฒ๋ณตํ๋ค. ์์ ๊ฐ์ญ โ ๋ ๋ธ๋ก์ ์ญ์ ํ๋ฉด ์์ ๋ณต๊ตฌ๋๋ค.
- Impact:
analysis_options.yamlanalyzer.exclude+dart_code_metrics.exclude(๋๋ ํ๋ฉด 11๊ฒฝ๋ก + ๋ฃจํธbuild/**+ ๊ณ ์ ๋ก์ผ์ผ ํ ์คํธ 1๊ฑด) ยทpubspec.yamlmelos: ignore:9ํจํค์ง. ์ค์ธก ๊ฒฐ๊ณผdart analyzeerror 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.dartcoco.<ns>.<key>โcocode.<ns>.<key>ui์์ ฏKey16 ๋ค์์คํ์ด์ค ยท ์ปค๋งจ๋ 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). ๋ค์ด์ด ์ ๋์ฌ์ ๊ฐ๋ ค ๊ฒฝ๊ณ ์ ๊ท์์ ๊ฑธ๋ฆฌ์ง ์๋ ๊ฒ๋ค๋ ์ฐพ์ ์ฎ๊ฒผ๋ค: lowerCamelcoco[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) ๋๋ ํ ๋ฆฌยทpubspecname:ยท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.yamlexclude 3๊ณณ ยทdetect_console_web_impact.shNOT_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: workspace1์ค ์ ๊ฑฐ๊ฐ ์ ๋ถ๋ค โ ํจํค์ง๋ช (cocode_widgetbook)์ ๋ฐ๊พธ๋ฉด ๋ด๋ถ import 15๊ณณ์ ๊ณ ์ณ์ผ ํด์, ๋์ pub workspace(= melos ์ค์ฝํ) ๋ฐ์ผ๋ก ๋นผ ์ด๋ฆ ์ถฉ๋์ ์์ด๋ค.check_workspace_membership.py๋resolution:๋ฏธ์ ์ธ ํจํค์ง๋ฅผ ๊ฒ์ฌ ๋์์์ ์ ์ธํ๋ฏ๋ก(#6 AC 5) ํต๊ณผํ๋ค.๋ฐ๋ผ ์ฎ๊ธด ์ฐธ์กฐ:
analysis_options.yamlexclude 3๊ณณ ยท ๋ฃจํธworkspace:ยท melosignore:(cocode_widgetbookํญ๋ชฉ ์ ๊ฑฐ โ ๊ทธ ์ด๋ฆ์ ์ด์ ๋ถ์ยทํ ์คํธ ๋์์ธ cocode ADE ์์ ฏ๋ถ์ด๋ค) ยทmelos:scripts:analyze์--ignore="*cocode_widgetbook*"์ ๊ฑฐ(์ ์ฑ์ ์ผํจ๋ค) ยทscripts/verify_widgetbook_coverage.sh5๊ณณ ยท 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.ymlmocks ํํ ๊ฒ์ฌ๋๋ฝ 2๊ฑด์ด PodServiceยทEndpointEmailยทEndpointSignupValidation์ฆ ์์ฑ ๋ถ๊ฐ ํ์ ์ mockSCAN_PATHS๋ฅผ composite ๊ณผ ๋์ผํ๊ฒ(feature/์ ์ธ)check_endpoint_auth_gate.py๋ฑ๋ก ๋ชฉ๋ก(SSOT)์ด ์์ฑ๋์ง ์์ ์ ์ ๋์กฐ ๋ถ๊ฐ ์ ์ ๋์กฐ๋ง ๊ฐ๋ฑ. ๊ฒ์ดํธ ์ ์ธ ํ์ ๋ณธ์ฒด๋ ๊ทธ๋๋ก ๋๊ณ ๋ฐ๊ฒฌ๋ถ์ ๋งค ์คํ ์ ๋ ์ถ๋ ฅ check_shared_steps.pyfeature/*/*3์ถ 244๊ฑด ์ ๋์ด ๋๋๋๋ 3์ถ ๋ณด๋ฅ(+ ๋ฐฐ๋ด์ ๊ฐ๋ช ์์ฌ 2๊ฑด์ ์ค์ ๊ฒฐํจ์ด๋ผ ์ญ์ ) detect_backend_impact.shtest/unit81๊ฑด ์ค 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_PKGSmelos 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/config9๊ฑด์ด ๊ฒ์ดํธ ๋ฐ์ผ๋ก ์๋ค),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-shadowingwhere๋๋ค ํ๋ผ๋ฏธํฐ๊ฐ ๋ฐ๊นฅ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-budgetB-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 ๊ณผ ๊ฐ์ ์ฒ๋ถ) breakdown150ยท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:
- ๊ฐ์ ์์ฒญ๋๋ก ยง3 ์ ๋ถ์ฌ๊ฐยท
previous_pathยท๋ถ๋ณ์ 6ยท7 ์ ์ ์คํ๊ณ AC-11 ๋ฌธ๋ฉด์ ๋ช ํํ (v3.4.0) - ๋ ํด์์ ๊ฐ ์งํฉ์ ๋ฐ๊พธ์ง ์๊ณ ์ด๋ฆ๋ณ๊ฒฝ์ ์ญ์ +์์ฑ 2๊ฑด์ผ๋ก ํํํ๋ ๋์ ๋ผ์ด๋ผ ์ ์๊ฒ ๋ฌถ๋ ์์ฑ์ ์ ์ค โ ๊ทธ ์ฌ์ด ๊ฒฝ๊ณ๋ก ๋กค๋ฐฑํ๋ฉด ํ์ผ์ด ๋ ๊ฒฝ๋ก ๋ชจ๋์ ์๋ ์ํ๊ฐ ์๊ธฐ๋ฏ๋ก ๋ฌถ์ ๊ท์น์ด ์ถ๊ฐ๋ก ํ์ํ๋ค
- ์์ฑยท์ญ์ ยท์ด๋ฆ๋ณ๊ฒฝ์ EditSnapshot ๋์์์ ์ ์ธ โ AC-11 ์ด ์์ฑ์ ์ธ์ ํ๊ณ C-02 ๊ฐ "EditSnapshot ์๋ ํธ์ง ๊ฒฝ๋ก๋ ์๋ค"๋ผ ๋ถ๊ฐ
- ๊ฐ์ ์์ฒญ๋๋ก ยง3 ์ ๋ถ์ฌ๊ฐยท
- Decision: ์ต์
1 ์ฑํ โ ํ๋ก์ ํธ ์ค๋ ํ์ (2026-09-10). ๊ฐ์ ์์ฒญ โ ~โฃ ๋ฅผ ๊ทธ๋๋ก
docs/seed-spec-cocode.mdv3.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 ADESnapshotStore๊ฐ ๋จ๊ธด ์ค๋ ์ท)์ #22ยท#23 ์ด ๋ฏธ์ฐฉ์๋ผ ์กด์ฌํ์ง ์๋๋ค. ๋ํ ยง4.4 P1~P7 ์ด๋์๋ ๋ณด์กด ๊ธฐ๊ฐ์ ์๋นํ๋ ๊ท์น์ด ์๋ค(grep -n "๊ธฐ๊ฐ" docs/architecture-cocode.mdํํธ 2๊ฑด ์ ๋ถ "๊ฐ 3๊ฐ" ๋ฌธ์ฅ๋ฟ โ P3 ์ K, P4ยทP4โฒ๋ ์ด๋ ์ํ๋ง ์ฝ๋๋ค). ๊ฐ์ด ์์ด๋ ์๋ฌด ๊ท์น๋ ์ฝ์ง ์๋ ๊ฐ์ ๊ฐ์ด ์๋๋ค. - Options:
- ์ฐ์ ๊ท์น(V-1~V-4)๊ณผ ์ธก์ ๊ท์ฝ์ ํ์ ํ๊ณ , ์ฐธ์กฐ ์ํฌ์คํ์ด์ค git ์ด๋ ฅ์ ํ๋ก์ ํ๋ณธ(R-1 ํ๋ ๋๋ฐ)์ผ๋ก ์ผ์ ๊ท์น์ ์ ์ฉํ ํ๋ณด๊น์ง๋ง ๋ด๋ ๊ฐ ํ์ ์ #29 ์ ๋จ๊ธด๋ค
- ํ๋ก์ ์์ด ์ค๋ฌผ ํ๋ณธ์ด ์๊ธธ ๋๊น์ง ๊ฐ ์นธ์ ๋น์ ๋๋ค
- ์ง๊ธ ๊ฐ์ ํ์ ํ๋ค
- 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๊ณ์ด์ ์ฐ๋ DartFile.rename์ด ๊ทธ ์๋ฏธ๋ฅผ ๋ณด์ฅํ๋์งยทํธ๋ค ์ ์ ์ ๋์์ ํ์ธ ํ์"(ยง9 ๋ฏธ๊ฒฐ 3)๋ก ๋จ๊ฒจ ๋์ด, #25(์ ๋ 2๋จ๊ณ ์ปค๋ฐ)๊ฐ ์นํ ์์ ์ฐ์ฐ์ ์ ํ ์ ์์๋ค. ๊ฐ๋ฐ ๋จธ์ ์ด ์ ๋ถ macOS ๋ผ ๋ก์ปฌ ์ค์ธก์ด ๋ถ๊ฐ๋ฅํ๋ค. - Options: โ Dart
File.rename๊ทธ๋๋ก โกMoveFileExW๋ฅผ FFI ๋ก ์ง์ ํธ์ถ โขReplaceFileWFFI โฃSetFileInformationByHandle(FileRenameInfoEx, REPLACE_IF_EXISTS|POSIX_SEMANTICS)FFI - Decision: ์ต์
โ โ
File.rename๊ทธ๋๋ก, โฃ๋ ์กฐ๊ฑด๋ถ ์ต์ ์ผ๋ก๋ง ๊ธฐ๋ก(docs/windows-atomic-replace-cocode.mdW-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.cc799ยท813ํ)๊ฐFile.rename=MoveFileExW(REPLACE_EXISTING|WRITE_THROUGH)์์ ๋ณด์ด๊ณ , ์ค์ธก 76์ ์์ FFIMoveFileExW์ ๊ฒฐ๊ณผยท์ฝ๋๊ฐ ์ ๋ถ ๊ฐ์๋ค โ โก๋ ์ด๋ 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:
- Design ๋จ๋ ๊ถํ โ DD-23bยท23c ๋ฅผ Design ๊ฒฐ์ ์ผ๋ก ํ์ ํ๊ณ , ๋ฒ๋ณต๋ Design ์ด architecture ๊ฐ์ ์ผ๋ก ํ๋ค
- ์ค๋ ํ๋ต ์ฌํญ โ ์๋ฌธ ์์ ์ฌ๋ถ๋ ๋ณด์ ์ ์ฑ ์ด๋ฏ๋ก ์ค๋๊ฐ ์ผ์ง ํญ๋ชฉ์ผ๋ก ํ์ ํ๊ณ , Design ์ ๊ทธ ์์์ ํํ๋ง ์ ํ๋ค
- ํ์ ์ฃผ์ฒด๋ฅผ ์ ํ์ง ์๊ณ ๋๋ค โ 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:
- seed-spec ๋ฌธ๋ฉด๋๋ก ์ ์ธ โ bdd ์ ์ผ์น. flow-permutationยทux-spec ์์ด์ดํ๋ ์์ ์ ์ ํด์ผ ํ๋ค
- ํฌํจ โ ์์ด์ดํ๋ ์๊ณผ ์ผ์นํ๊ณ ์ฌ์ฉ์๊ฐ ใ์ด ์ค๋ ์ท์ผ๋ก ๋๋๋ฆฐ๋คใ๋ฅผ ์ง๊ด์ ์ผ๋ก ์ฝ๋ ๋ฐฉ์์ผ ์ ์๋ค. seed-spec ๋ถ๋ณ์ 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) ยท
workspaceWriteJournalRecoveryยท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์์์ ํจ๊ป ๊ธฐ๋กํ๊ณ ,
workspaceRetentionSettings.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(ํด์) ยทprdFR-205ยทยง2 ํ๋ฆ 2 3ยท5๋จ๊ณยทยง4 D-14(ํด์) ยท #75EditLockRegistryํ๋ฉด(ํ๋ยทํด์ ๊ฐ ์ง์ง์ด์ง ๊ตฌ๊ฐ 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 ์ด ใ์๊ฐ ๊ฒ์ฆ ์๋๊ฐ ์งํ ์ค์ผ ๋ใ๋ก ํ์ ๋ผ ์ ๊ธ ๋๊ธฐ๋ฅผ ๋ฎ์ง ๋ชปํ๋ค(flowFP-405 ์ux-specUX-D-06 ํ๊ธฐ ์ฃผ์์ด ๊ฐ์ ๋ง๋ก ์ ์ด ๋ ์ฌ์ค). ๊ทธ๋ฆฌ๊ณ ํ์ํ์ง ์๋ค: ๊ต์ฐฉยท๊ธฐ์๋ โ โก๋ก ์ฑ๋ฆฝ ๋ถ๊ฐ, ์น์ธ ๋๊ธฐ๋ ๋ฆฌ์ค ๊ตฌ๊ฐ ๋ฐ์ด๋ผ ๋๊ธฐ์ด์ ์ก์ง ์์ผ๋ฉฐ(D-045 ยง2.1), ๋ณด์ ์ ์ฌ๋ง์ DD-13 ํธ๋ฆฌ๊ฑฐ 3์ข ์ด ๋ฎ๋๋ค. ์ฆ ใ์ํ ์์ใ์ ๊ทผ๊ฑฐ๊ฐ ๋ฌด๋ฐฉ๋น๊ฐ ์๋๋ผ ๊ตฌ์กฐ์ ์ ํ์ฑ์ด๋ค. โฃ ํธ๋ฆฌ๊ฑฐ 3์ด ์ฌ๊ธฐ๋ ์ ๋ฆฌ์ค๋ฅผ ์ ๋ถ ๋ฌดํจํํ๋ฏ๋ก ์ฌ๊ธฐ๋ ํ ๋๊ธฐ์ด์ ์ ์์ ๋น ์งํฉ์ด๋ค โ ์์ํ๋ฉด ๊ทธ ๋ชจ์์ ์ง์ฐ๋ ์ฝ๋๋ฅผ ๋ฐ๋ก ์จ์ผ ํ๋ค. โค S-01b ๋๊ธฐ ์นธ์ ยง2.4 ํ์ ๋์ ์ถ์ฒ ์์ฑ์ด ์๊ณ ์ฌ๋์ด ์ฝ๊ธฐ ์ ์ ์ฌ๋ผ์ง๋ค. ์์ ๋๊ธฐ๋ ๊ณ์ฐํ ์ ๋ ฅ์ด ์๊ณ (UX-D-07 ๊ณผ ๊ฐ์ ๋ฟ๋ฆฌ), ์๋ฒ์ ๊ณ์ฐ ๊ฐ๋ฅํ๋ ํ๋์ ๋ฐ๊พธ์ง ์๋๋ค. - Impact:
flowFP-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:
- ยง3 ์
edit_locks์ ์๋ฅผ ๊ฒฝ๋ก โ ๋ฆฌ์ค ์ฌ์์ผ๋ก ๊ฐ์ (DD-25 โ D-038 ๊ณผ ๊ฐ์ ๊ฒฝ๋ก) - ใ๊ฒฝ๋ก ์งํฉใ ๋ฌธ๋ฉด์ ์ ์งํ๊ณ ๋ฆฌ์ค๋ฅผ ๋ณ๋ ์์ฑ์ผ๋ก ์ถ๊ฐ โ ยง3 ๋จธ๋ฆฌ๋ง์ ใ์ถ๊ฐ๋ง ํ์ฉใ์ ํ์์ ๋ง์ง๋ง, ์งํฉ๊ณผ ์ฌ์์ด ๊ฐ์ ์ฌ์ค์ ๋ ํํ์ด๋ผ ๋์ด ์ด๊ธ๋ ๋ ์ด๋ ์ชฝ์ด ์ ๋ณธ์ธ์ง๊ฐ ๊ท์ ๋์ง ์๋๋ค
- ์งํฉ ์ ์ง + ์์ ์ ์ถ์ ํฌ๊ธฐ โ ๋ถ๊ฐ. ํด์ ํธ๋ฆฌ๊ฑฐ 1(์ธ์ ์ข ๋ฃ)๊ณผ 2(์์ ์ข ๊ฒฐ)๋ ใ๊ทธ ์ธ์ /๊ทธ task_id ๊ฐ ์์ ํ ๋ฆฌ์คใ๋ฅผ ์ฐพ์์ผ ํ๋๋ฐ ์งํฉ์๋ ์์ ์๊ฐ ์๋ค. AC-18 ์ด ์ฑ๋ฆฝํ์ง ์๋๋ค
- ยง3 ์
- 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:
- ์ค์ โ ์ฒซ ๋ ๋. ์ค์ ์๋ฃ ์ ์๋ ์ ๊ธ ์นธ์ ๋ ๋ํ์ง ์๋๋ค
- ์ค์ โ ์ฒซ ๋ ๋์ด๋, ์ค์ ์ ์๋ 0 ์ ๊ทธ๋ฆฐ๋ค
- ์ฒซ ๋ ๋ โ ์ค์. ์ค์์ด ๋๋๋ฉด ๊ฐ์ ๊ฐฑ์ ํ๋ค
- Decision: ์ต์
1. ํ์ ์ ์ด๋
EditLockRegistry.startupSweepCompleted์ด๋ฉฐ,false์ธ ๋์ S-01b ๋ ์ ๊ธ ์นธ์ ๊ทธ๋ฆฌ์ง ์๋๋ค. - Rationale: ์ต์
3 ์ ์ ๋ น ์ ๊ธ์ ํ๋ฉด์ ๋์ด๋ค โ ๋์คํฌ์ ๋จ์ ๋ฆฌ์ค๊ฐ ๊ทธ๋๋ก ใ์ ๊ธด ํ์ผ N๊ฐใ๋ก ํ์๋๊ณ , ๊ทธ๊ฒ์ AC-18 ์ด ์์ ๋ ค๋ ์ํ๊ฐ ์ฌ์ฉ์์๊ฒ ๋๋ฌํ ๊ฒ์ด๋ค. ์ด ํ ๊ฐ์ง๋ก ํ๋ฝํ๋ค. ์ต์
2 ๋ ๋ต์ด ์๋๋ค โ 0 ์ ใ์ ๊ธด ํ์ผ์ด ์๋คใ๋ ์ฌ์ค ์ฃผ์ฅ์ธ๋ฐ ์ค์ ์ ์๋ ๊ทธ ๊ฐ์ด ํ์ ๋์ง ์์๋ค.
ux-specยง3.2 ๊ฐ ์คํจ ์ฌ์ ์ ๋ํด ์ธ์ด ๊ท์น(ใ๋ฌธ์ฅ์ ์ง์ด๋ด์ง ์๋๋ค โ ๋ชจ๋ฅด๋ฉด ์๋ฆฌํ์์ใ)๊ณผ ๊ฐ์ ๋ ผ๋ฆฌ์ด๋ฉฐ, ์ฌ๊ธฐ์ ์๋ฆฌํ์์์ ํด๋นํ๋ ๊ฒ์ด ์นธ์ ๋ถ์ฌ๋ค. ์ต์ 1 ์ ๊ตฌํ ๋น์ฉ๋ ์๋ค: ์ค์์ ์ด๋ฏธ ์์ ํ (WorkspaceRecovery.runOnStartup) 3๋จ๊ณ์ด๊ณ , ์ ธ์ ํ์ํ ๊ฒ์ ํ์ ์ ์ด ํ๋๋ฟ์ด๋ค. - Impact:
coreEditLockRegistry.startupSweepCompleted์ ์ค ยทworkspaceFileEditLockRegistry๊ฐdiscardPersistedLeases์๋ฃ ์ ๊ทธ ๊ฐ์ ์ธ์ด๋ค(๋๋์๊ฐ์ง ์๋๋ค) ยทux-specยง2.4 ์ ๊ธ ์นธ ํ๊ณผ ยง10 S-01b ์ ๋ ๋ ์กฐ๊ฑด ๋ช ์ ยทflowFP-408ยทI-7 ํด์. - โ ๏ธ ์ด ๊ฒฐ์ ์ด ๋ซ์ง ์๋ ๊ฒ: ใ์ฒซ ํ๋ ์ใ์ ๋ ๋ ๊ณ์ธต์ ์ฌ๊ฑด์ด๊ณ ์ด ๋ฆฌํฌ์๋ ์์ง ์
ธ์ด ์๋ค(
coreยทworkspace๋๋ฟ,CocodeStatusBargrep 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:
- ์์ธ ์ด๊ฑฐ๋ก ์ ์ โ ํ๋ณด 4์ข ์ค ์ด๋๊น์ง๊ฐ ์คํจ์ธ์ง ํ์ผํ๋ค. ๋ฌธ์ : ๊ฐ์ ์์ธ์ด ์์ ์ ๋ฐ๋ผ ๋ค๋ฅธ ๊ฒฐ๊ณผ๋ฅผ ๋ณ๋๋ค(๋ณ์ ๊ฒ์ฆ ์คํจ๋ ์์ฑ๊ธฐ ๊ธฐ๋ ์ ์ด๋ฉด ์ง์ธ ๊ฒ์ด ์๊ณ , ํ ์ด ์คํ ์ค ๊ฒ์ฆ์ ์คํจํ๋ฉด ์คํ ์ด์ง์ด ์ด๋ฏธ ์๋ค). ์ด๊ฑฐ๋ ๊ทธ ์ฐจ์ด๋ฅผ ํํํ์ง ๋ชปํ๊ณ , ์ ์์ธ์ด ์๊ธธ ๋๋ง๋ค ์ ์๋ฅผ ๊ณ ์ณ์ผ ํ๋ค.
- ์์น(๊ตฌ๊ฐ)๋ก ์ ์ โ DD-13a ๊ฐ ์ด๋ฏธ ์คํ ์ด์ง โ ํ โ ์ปค๋ฐ์ 3๊ตฌ๊ฐ์ ์ธ์ ์ผ๋ฏ๋ก, ๊ทธ ๊ตฌ๊ฐ ๊ฒฝ๊ณ๋ก ๊ฐ๋ฅธ๋ค. ํ๋ณด 4์ข ์ ์ด๊ฑฐ๊ฐ ์๋๋ผ ๊ตฌ๊ฐ์ ๋งคํ๋๋ค.
- ๊ณ์ ๋ฏธ๊ฒฐ โ 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.mdUX-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 ์ ๊ฒฝ๋ก ํด์๊ณผ ๊ฐ์ด ์ธ์ ๊ฐ์ผ๋ก ๊ณ ์ ํ๋ค.
- ๋งค๋ํ์คํธ ๋ฒ์ = lock ์ฐ์ .
- 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:
- 11 ๋ก ํ์ โ D-018 ์ ์ค์ธก ๊ธฐ๋ก์ ์ ๋ณธ์ผ๋ก ์ผ๋๋ค
- 12 ๋ก ํ์ โ planning-inputs ยง2.1 ํ์ ํ ์๋ฅผ ์ ๋ณธ์ผ๋ก ์ผ๋๋ค
- ๊ฐ์๋ฅผ ์ ๋ณธํํ์ง ์๋๋ค โ ํ์ฉ ํธ์คํธ ๋ชฉ๋ก์ ๋จ์ผ 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:
- ํ๋ซํผ ๋๋ ํฐ๋ฆฌ ์กด์ฌ โ ์ํฌ์คํ์ด์ค ๋ฃจํธ์
android/ยทios/ยทmacos/ยทwindows/ยทlinux/ยทweb/ - ๋น๋ ๋ช
๋ น ์ธ์ โ ์ค์ ๋ก ์คํ๋
flutter build <platform>์ ์ธ์ - ์ฌ์ฉ์ ์ค์ โ S-16 ์ค์ ํ๋ฉด์์ ์ฌ๋์ด ๊ณ ๋ฅธ๋ค
- ์ ์ธ โ ๋งค๋ํ์คํธ(
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.mdD-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:
- ์ ์ค โ
no_target:no_registered_parser๋ฅผ ๋ํด ํ์ ์งํฉ์ 5์ข ์ผ๋ก - ์ฝ๋ ์์ด ์ฐจ๋จ๋ง โ โค ๋์์์์
no_target_code์์ดresult: ๋์์์๋ง ๊ธฐ๋ก - โฃ ์ฝ๋ ์ฌ์ฌ์ฉ โ
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_logJSON ์คํค๋ง ๋ธ๋ก์ ๋ฌธ์ ํธ์ง๊ณผ ์ฝ๋ ๋ฐ์์ #63(์์ ๊ฒฝ๊ณ โ ์ธ spike ๋ ๊ฒฐ์ ๋ง ์ฐ์ถํ๋ค) โ ํ๊ฒฝ ์คํจ ๋ถ๋ฅ(resultenum ํ์ฅ ๋๋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:
- ๋ ๊ฐ์ ๋ชจ๋ ์ง๊ธ ๊ณ ๋ฅธ๋ค(โข ์ ์ ์ ๊ฐ ๋ถ์ฌ)
- โค ๋ชฉ๋ก์ ํ์ ํ๊ณ โข ์ ์ค์ธก ๊ท์ฝ๋ง ํ์ ํ๋ค
- ๋ ๋ค ์ค์ธก๊น์ง ๋ฏธ๋ฃฌ๋ค
- 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ํ์์์ยทํ๋ก์ธ์ค ์ข ๋ฃ ์ ์ ๋ ์ถ์ ๋ฒ์ ๋ฐ).prdD-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-permutationFP-111ยทI-8 ์ด ์ด๋ฅผ ใ์์ธ ๊ตฌ๋ถ์ด ์๋คใ๋ก ์ง๋ชฉํ๊ณ ,allowed_hosts์ฐจ๋จ(AC-14 โ)๊ณผ ๋คํธ์ํฌ ๋จ์ ๋ ๊ตฌ๋ถ๋์ง ์์๋ค. - Options:
resultenum ์ 4๊ฐ์ผ๋ก ํ์ฅํ๋คfailure_class์ ๋ จ ํ๋๋ฅผ ์ ์คํ๋ค(result๋ 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 ๋ ๊ทธ ์ฌํด์์ ํ ๊ฑด๋ ๋ง๋ค์ง ์์ผ๋ฉฐ โresult3๊ฐยท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-permutationFP-111 ํด์ ยท I-8 ์ ์ ๋ฐ ํด์(๋ค ์ ๋ฐ = AC-08 ใ๊ธฐ๋ก vs ์ ์ดใ๋ #67).ux-specยง3.2 โ ์คํจ ์ง์ ๊ฒฝ๋ก 3์ข โ 4์ข (E-4 ํ๊ฒฝ ์คํจ ์ํ ์ด๊ณผ), ์ฌ์ ๋ ํ์ ๋ผ๋ฒจ. UX-D-25 ์ ์ค(์ฝ๋ ์งํฉ์ ๊ฒ์ฆ ๋ฌธ์ ์์ , ์ด ๋ฌธ์๋ ๋ผ๋ฒจ๋ง ์์ ). ใ์ฌ์ ๋ฏธ๊ท์ ใ ์๋ฆฌํ์์๋ ๋น์ ์ ์ข ๋ฃ ์์ ์์ ์ status ํ๋๋ก ์ข์์ง๋ค(ยง9 ๋ฏธ๊ฒฐ 8, ๋ฒ์ ๋ฐ).bddFeature 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-permutationI-8 ๋ค ์ ๋ฐ ยท FP-104). - Options:
- ใ๊ธฐ๋กใ์ด ์ ๋ณธ โ ์๋๋ง ์ค๋จยท๊ธฐ๋กํ๊ณ ์ผ๋ฐ ์คํจ ๊ฒฝ๋ก๋ก ํฉ๋ฅ
- ใ์ ์ดใ๊ฐ ์ ๋ณธ โ ์ฒซ ์ด๊ณผ์์ ์ฆ์
์คํจ์ ์ด
- 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๋ฆฌ์ (flowC-2 / FP-208) โcompletion_modeoverride ๊ฐ๋ถ(prdD-18) โ ์น์ธ ๋๊ธฐ ์ค ์ ๊ธ์ด ํด์ ๋์ด ์๊ธฐ๋ forward apply ์ถฉ๋(flowC-3 / FP-210). - Decision: ์ฐ์ถ๋ฌผ์
docs/approval-rules-cocode.md. ๋ค์ฏ ๊ฒฐ๋ก :- ๊ฑฐ๋ถ โ
๊ฑฐ๋ถ๋จ. ๊ฐ์ D-032(#105, ์ค๋)๊ฐ ์ด๋ฏธ ์ ์คํ์ผ๋ฏ๋ก ์ด Story ๋ ์ ์ด ๊ท์น์ ์ ํ๋ค โ ์ถ๋ฐ์์ฌ๋์น์ธ๋๊ธฐํ๋์ด๊ณkind๋ ์ข ๋ฅ๊ฐ ๊ฐ๋ค. ๊ฑฐ๋ถ๋ ์ ์ฉ์ ๋ง๋ค์ง ์์ผ๋ฉฐ(๋๋๋ฆฌ๋ ๊ฒ์ ๋กค๋ฐฑ), ํธ์ง์ ๋จ๊ณ (AC-23)๊ฑฐ๋ถ๋จ โ ๋กค๋ฐฑ๋จ์ ์๊ตฌ๋๋ค. - ๋ฌด์๋ต์ ์๊ฐ ์ํ์ ๋์ง ์๋๋ค. ์๋ ์ ์ด ์์.
- ์น์ธ 2์ข
์ ์์ฐจ ๋ฐฐ์น โ ํ
์คํธ๋ณ๊ฒฝ์น์ธ์ด ๋จผ์ . ๋ณต๊ท๋ ํ
์คํธ๋ณ๊ฒฝ์น์ธ ยซ์น์ธยป โ ํญ์
์คํ์ค(retry_count๋ถ๋ณ), ์๋ฃ์น์ธ ยซ์น์ธยป โ์๋ฃ, ๊ฑฐ๋ถ โ๊ฑฐ๋ถ๋จ, ๋กค๋ฐฑ โ๋กค๋ฐฑ๋จ. ๋ฆฌ์ ์ ์ํฐํฐ ์์ฑ์๊ฐ ๊ฐ์ ํ๋ค. completion_modeoverride ๋ถ๊ฐ โ โ ๏ธ ์์ ๊ฐ์ค(ํ์ ์ #111).- 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-permutationC-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-permutationI-9(์น์ธยท๋กค๋ฐฑ ์์ฒญ์ ๋ฉฑ๋ฑ์ฑยท์ค๋ณต ์ ๋ ฅ โ ๊ทผ๊ฑฐ ์ด์ด ๋ฌธ์ ๊ทธ๋๋ก ใ๋ฏธ๊ท์ ใ)์ I-10(์น์ธ granularity, ๊ฐ์ ํ ์คํธ ํ์ผ์ ๋ ์์ ์ด ๋๊ธฐ)์ด ์ด๋ ค ์์๊ณ , ๋ ํญ๋ชฉ ๋ชจ๋ ํ์ ์ฃผ์ฒด๊ฐ ์ด๋ ๋ฌธ์์๋ ์์๋ค(ยง6.2 Important ํ์ ์ฃผ์ฒด ์ด ์์ฒด๊ฐ ์๊ณ ยง7.1 ์ Critical ์ ๋๋ง ๋ฎ์ผ๋ฉฐarchitectureยง9 ์๋ ๋ฏธ๋ฑ์ฌ). ๋ux-spec์ ํ ์คํธ๋ณ๊ฒฝ์น์ธ ์นด๋์๋ ๋ช ์์ [์ ์ฉํ์ง ์์]๋ฒํผ์ด ์๋๋ฐflow:128 ์ ๋ฌดํจ ์ด์ ใ๋ฏธ์น์ธ ๋ฐฉ์นใ๋ผ๋ ๋ถ์์๋ง ์ ์ด ๋ฌธ์๊ฐ ์ด๊ธ๋ ์์๋ค. - Decision: ์ฐ์ถ๋ฌผ์
docs/approval-idempotency-cocode.md. ์ฌ์ฏ ๊ฒฐ๋ก :- ํ์ ์ฃผ์ฒด = Design. ์ค๋ ํ์ ๋ถ์.
- ์
๋ ฅ 4์ข
์ ๋ถ โ no-op ํก์ โ ์๋ฃ์น์ธ ยท ํ
์คํธ๋ณ๊ฒฝ์น์ธ ยท
[์ ์ฉํ์ง ์์]ยท ๋กค๋ฐฑ ์ง์ ์ ํ. ๊ฒ์ฌ ์ฃผ์ฒด๋TaskTransition(DD-05). [์ ์ฉํ์ง ์์]= AC-23 ์ ๊ฑฐ๋ถ ์ ๋ ฅ โ๊ฑฐ๋ถ๋จ(์ข ๊ฒฐ). ๊ทธ ๋ณ๊ฒฝ์ ์ ์ฉ๋์ง ์๊ณ ์ด๋ฏธ ์ ์ฉ๋ ํธ์ง์ ๋จ๋๋ค.- ๋ถ๋ถ ์น์ธ ๊ธ์ง โ ์น์ธ์ ๋์ ๋ณ๊ฒฝ ์ ์ฒด์ ๋ํ ๋จ์ผ ํ์ ์ด๊ณ ์ ์ฉ์ ์ ๋์ด๊ฑฐ๋ ์ ๋ฌด๋ค. ํ์ผ๋ณ ์น์ธ ํ๋ณด๋ UX-D-13 ์ด ์ด๋ฏธ ๊ธฐ๊ฐํ๋ค.
- FP-409: ์ ์น์ธ์ด ์ ์ฉ๋๋ฉด ๋ค ์น์ธ์ ์ฌ์ ๊ฒ์ฌ๊ฐ ์ถฉ๋๋ก ๋จ์ด์ง๋ค โ ๊ด์ฐฐ ์กฐ๊ฑด์ ใ์ ์ฉ ์์ ์ ํ์ฌ ํด์ โ ์น์ธ ์์ base ์ด๋ฉด ์ ์ฉ๋์ง ์๋๋คใ.
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) ์ฑ ์ฌ์์์ ๊ฐ๋ก์ง๋ฅด๋ฏ๋ก ์์์ด ํ์ํ๋ค โ ๋ฉ๋ชจ๋ฆฌ์๋ง ๋๋ฉด ์ฌ์์ ํ ์นด๋๋ ๋จ๋๋ฐ ์ ์ฉํ ๊ฒ์ด ์๋ค.
- ์ฃผ์ฒด(0): ์ ํ ๋์์ด ๊ฐ์ด ์๋๋ผ ๊ท์น์ด๊ณ (์ค๋ ํ์ ์ ๋ฐ์ ์จ D-032ยทD-033ยทD-037ยทD-044ยทD-051 ์ ์ ๋ถ ๋ถ๋ณ ์ธต์์ ๊ฐ์ด๊ฑฐ๋ ๋ฒ์ ๊ฒฐ์ ์ด์๋ค), ๋ฉฑ๋ฑ์ฑ์ด ์ฑ๋ฆฝํด์ผ ํ๋ ์๋ฆฌ๋
- 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-permutationI-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-permutationC-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.- FP-105 โ ์๋ ์ํ์ ๋์ง ์๋๋ค. ์กฐ์ฉํ ๋งค๋ฌ๋ฆผ์ DD-22 S2(๋จ๊ณ๋ฅผ ๊ฐ๋ฆฌ์ง ์๋ ์ ํด ์ด๊ณผ)๊ฐ ์ด๋ฏธ ๋ฎ๊ณ , ๋จ๋ ใ์ด๋ฒคํธ๋ฅผ ๋ด๋ฉฐ ์ง์ ์์ใ(๋ผ์ด๋ธ๋ฝ)์ AC-22 ์ค์ง ์ ๋ ฅ์ด ๋ฎ๋๋ค.
- FP-106 โ ์ด๋ ์ํ์ ๋์ง ์๋๋ค.
- FP-107 โ DD-22 ๋ก ์ด๋ฏธ ๋ฎ์ธ๋ค(S1 โช S2). ์์ฌ๋ ๊ฐ(#50)๊ณผ ๋น์ค(#112) ๋๋ฟ์ด๋ฉฐ ๋ฒ์ ๋ฐ.
- FP-405 โ #77 ์ ๊ฒฐ๋ก ์ ์ธ์ฉํ๋ค(๊ตฌ์กฐ์ ์ ํ์ฑ).
CancelReasonํ์ 5์ข โuserStoppedยทuserRolledBackยทapprovalRejectedยทtaskFailedยทworkspaceClosing. ํธ์ถ ์์๋ ์ ์ด๊ฐ ๋จผ์ ,cancel์ด ๋์ค.- ์ ์ดํ 81์นธ ํ์ฅ ์๋ฃ โ ์ ๊ท ์ ์ด 7์ข (โฐโฑโฒโณใใใ), โฌ ์นธ 0๊ฐ.
- 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). ์ด ๋ฌธ์์ ์ด๋ ๊ฒฐ๋ก ๋ ๊ทธ ์์ ์ ๋ฌธ๋ฉด์ ์๊ตฌํ์ง ์๋๋ค.
- FP-105: ใ์์ ๋ฌด๋ฐฉ๋นใ๋ ๊ณผ์ฅ์ด์๋ค โ S2 ๊ฐ ๋จ๊ณ๋ฅผ ๊ฐ๋ฆฌ์ง ์์ผ๋ฏ๋ก ์กฐ์ฉํ ๋งค๋ฌ๋ฆผ์ ๋ฎ์ธ๋ค. ์ค์ ๊ณต๋ฐฑ์ ๋ผ์ด๋ธ๋ฝ ํ๋์ด๊ณ , ์๋ ์ํ์ โ AC ์ ์ค์ ์๊ตฌํ๋๋ฐ
- 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 ์ฌ๊ฐ ๋ฏธ๋ถ์ฌ ๊ทผ๊ฑฐ) ยทflowC-5ยทFP-105ยทFP-106ยทFP-107ยทB-07 ๊ฐฑ์ ยทux-specUX-D-06 ํ๊ธฐ ์ฃผ์์ C-5 ๋ฌธ์ ๊ทธ๋๋ก ์ธ์ฉ ยทbddFeature 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-specAC-20 ์ ใ๊ทธ ์ํ๊ฐ ๊ฐ์ง๋๋ฉดใ์ด๋ผ๊ณ ๋ง ์ฐ๊ณ ๋ฌด์์ ์๋ต ๋ถ๊ฐ๋ก ๋ณผ์ง ๊ท์ ํ์ง ์๋๋ค(PRD D-3, bdd ยง0.5 U-9).architectureยง6.2 ๊ฐ DD-22 ๋ก ํด์์(S1 ์ ์ก ์ข ๋ฃ โช S2 ์ ํด ์ด๊ณผ)์ ๋๊ณ ๊ทธ ๋น์ค์ ์ค๋ ๊ฒฐ์ #112 ๋ก ์ฌ๋ ค ๋์๋ค. ๊ฐ์ง ๊ธฐ์ค์ด ์์ผ๋ฉด AC-20 ์ ๊ธฐ๊ณ์ ํ์ ์ด ๋ถ๊ฐ๋ฅํ๊ณ , #49(๊ฐ์งยท์ ์ด ๊ตฌํ)๋ ์ฐฉ์ํ ์ ๋ ฅ์ด ์๋ค. - Options:
- S1 โช S2 โ ์ด๋ฒคํธ ์คํธ๋ฆผ ํ๋๋ง ๋ณด๋ ๋ ์ ํธ
- S1 โช S2 โช ์ฐ์ ์ค๋ฅ ํ์ โ ์ค๋ฅ๊ฐ Nํ ์ฐ์์ด๋ฉด ์๋ต ๋ถ๊ฐ
- ๋ฐฑ์๋๋ณ ์ ํธ โ 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 ๋ฏธ๊ฒฐ์ด ์ธ์ฉ๋๋ค. ์ค๋๊ฐ ๋ค์ง์ ๋ ์ํฅ ๋ฒ์๋ ๊ฐ์ง๊ธฐ ยท
bddFeature 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:
- ํ๋๋ก ํฉ์น๋ค โ ๋จ์ผ ใ์์ด์ ํธ ํ์์์ใ ์ค์
- ๋ณ๊ฐ 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 =prdD-10 =planning-inputsยง5.3 ์ด ใv2 ๋ผ์ฐํ seam ์ ๊ตฌ์ฒด์ ์ค๊ณ ์ง์ ใ์ Design ์ผ๋ก ๋๊ฒผ๋ค. seam ์ด ์์ผ๋ฉด v2 ๊ฐ ์์ ๋ ๋ถ๊ธฐ๊ฐ ํธ์ถ ์ง์ ๋ง๋ค ํฉ์ด์ง๊ณ , ใv2 ๋ฅผ ์ง์ํ๋๊ฐใ์ ๋ต์ด ์ฝ๋ ํ ๊ณณ์ ์๊ฒ ๋๋ค. - Options:
- ์ ์ก ๊ณ์ธต ์๋(JSON-RPC ์ฝ๋ฑ)์์ ๊ฐ๋ฅธ๋ค
AgentRuntime๊ตฌํ ์ ์ฒด๋ฅผ ๋ฒ์ ๋ณ๋ก ๋๋ค- ํธ์ถ ์ง์ ๋ง๋ค ๋ถ๊ธฐํ๋ค
- ํ์ ์งํ ์์ด์ด ์ด๋ํฐ๋ฅผ ๊ณ ๋ฅธ๋ค โ
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 ์ธ ์ฒ ๋ค๋ฃจ๋ฉด ์ฐ๋ฆฌ๊ฐ ๋ณด๋ด๋ ์์ฒญ๊ณผ ์์ด์ ํธ๊ฐ ์ดํดํ๋ ์์ฒญ์ด ์ด๊ธ๋ ์ฑ ์ธ์ ์ด ์์๋๋ค. ๊ฑฐ๋ถ๋ ๊ด์ฐฐ ๊ฐ๋ฅํ๊ณ ์กฐ์ฉํ ์คํด๋ ๊ทธ๋ ์ง ์๋ค(#34EnvironmentNotAllowed์ ๊ฐ์ ๋ ผ๋ฆฌ). - 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:
flutter_secure_storage^10.0.0 โ ์ด๋ฏธ ์ํฌ์คํ์ด์ค์ ์๊ณ (๋๋package/coreยทapp/cocode, win32 ํธํ override ๊น์ง ์กํ ์๋ค) ์ธ ์ ์ฅ์์ 1:1 ๋์keyring/keyring_native(pub) โ ์์ Dart ์ง์ ์ - ์ธ OS ์ ๊ณต์ ๋๊ตฌยทAPI ์ง์ ํธ์ถ โ macOS
/usr/bin/securityยท Linuxsecret-toolยท Windowsadvapi32.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:
- ๋ค์ฏ์ ํ๊บผ๋ฒ์ ์ง๊ธ ํ์ ํ๋ค
- ๋ค์ฏ์ ์ ๋ถ ์ค์ธก ๋ค๋ก ๋ฏธ๋ฃฌ๋ค
- ์ ์(๋ฌด์์ ์ฌ๋๊ฐ)๋ ์ง๊ธ, ๊ฐ(์ด๋์ ๋๋๊ฐ)์ ์ค์ธก ๋ค๋ก ๋๋๋ค
- 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 ๋ ๊ทผ๊ฑฐ ์๋ฃ๋ก๋ง ๋จ๋๋ค.
- ์ ๊ท ์ฐ์ถ๋ฌผ 3์ข
:
- Source: #91 ์ธ์ ์กฐ๊ฑด 5์ข
. ์ค์ธก์ ์ด ์ํฌํธ๋ฆฌ(2026-09-14, macOS 25.5, Dart 3.13.3 / Flutter 3.47.3) โ
unibookblobless 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:
- ์ ๋ ํ๋ ์ ํ์์ ๋ชป ์ฌ๋ฏ๋ก ํ์ ์ ๋ฏธ๋ฃฌ๋ค(๋ฐ์คํฌํฑ ๋ฌ๋๊ฐ ์๊ธธ ๋๊น์ง)
flutter test๋ก ์ฐ ์๋ฅผ ํ๋ ์ ํ์์ด๋ผ ๋ถ๋ฅด๊ณ ํต๊ณผ๋ก ์ ๋๋ค- ๊ธฐ์ธ๊ธฐ๋ฅผ ์ฌ๊ณ (๋ฌธ์ ํฌ๊ธฐ ๋๋น ํ๋ ์ 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_editor0.10.0 ์moveCursorToPageDown()ยทmoveCursorToPageUp()์ด ๋ณธ๋ฌธ ์์ด// TODO๋ค(_code_line.dart:492). PageUp/PageDown ์ด ๋์ํ์ง ์๋๋ค. AC-15 ์ ์ธ ์กฐ์์ ์์ด ์ด ํ์ ์ ๋ฐ๋์ง ์์ง๋ง ๊ธฐ๋ฅ ๊ฒฐํจ์ด๋ฏ๋ก ํ์ ์ด์๋ก ๋ถ๋ฆฌํ๋ค(์๋ฅ ์์ vsCocodeEditorView์ธต ๋์ฒด ๊ตฌํ์ ๋ณ๊ฐ ์ค๊ณ ๊ฒฐ์ ). - ์ธก์ ํจ์ 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์ผ ์ ๋ฆด๋ฆฌ์ค์ด๋ฉฐ ์ดํ ํ์ด ์๋ค โ ๋ฏธ์์ ์ด๋ค. - โ
์ฐ๋ฆฌ๋ ์ฌ์ฌ์ฉํ์ง ์์๋ค.
terminalpubspec ์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 /Mono1.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:
- 3-OS ์ฌ์ CI ์ ์ด๋ก๋ถ์ AC-16 ์ถฉ์กฑ์ผ๋ก ์ ์ธํ๋ค
- ์ค๊ธฐ๊ธฐ ์ ๋ ฅ๊ธฐ๋ฅผ ๋ชป ์ฌ๋ฏ๋ก ์๋ฌด๊ฒ๋ ํ์ง ์๊ณ 4์กฐํฉ์ ๋ฏธ์ฐฉ์๋ก ๋๋ค
- ์ฌ๋ ์ถ๊ณผ ๋ชป ์ฌ๋ ์ถ์ ๋๋ ์ฌ๋ ์ถ(์ฝ๋ ๊ฒฝ๋ก)์ 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.dart0๊ฑด).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). โยทโ ์ ๊ฒฐํฉ ๊ท์น๋ ํจ๊ป ์ ํด์ผ ํ๋ฉฐ ๊ทธ๊ฒ์ด ๋น ์ง๊ธฐ ์ฌ์ด ์๋ฆฌ์์ ๋ช ์.
- โ ์ค๋ผํด์ ์์ด์ ํธ๊ฐ ๋๋ฆฌ์ง ์์ ๋ณด๋ฅ ๊ฒ์ฌ(์ ๋ ๋ถ์ + ์ ์ฒด ํ ์คํธ + ๋น๋)๋ค.
- ํ๋ณธ ์: ํด๋์ค๋น 96๊ฑด(โ 96 + โ 96). Wilson ์ ๊ท๊ทผ์ฌ ์ญ์ฐ
- Rationale:
- ํ๋ณธ ์๋ ์ง์ด๋ด์ง ์๊ณ ์ญ์ฐํ๋ค. PRD R-4 ๊ฐ ๊ธ์งํ
๊ฒฐํจ 30๊ฑดยท๊ฒ์ถ๋ฅ 80%๋ ์ด ๋ฌธ์ ์ด๋์๋ ๋ชฉํ์น๋ก๋ ์ฐธ์กฐ์ ์ผ๋ก๋ ์ฐ์ง ์๋๋ค.w๋ ์ด ์ค๊ณ๊ฐ ๊ณ ๋ฅธ ๊ฐ์ด์ง๋ง ยซ๊ฒ์ถ๋ฅ ์ ยฑ10%p ์์์ ๋งํ ์ ์์ด์ผ ๊ธฐ์ค ๋น๊ต๊ฐ ์ฑ๋ฆฝํ๋คยป ๋ ์๊ตฌ์์ ๋์๊ณ ๋ํ๋ฉด ๋ฌด์์ ์๋์ง๊ฐ ํจ๊ป ์ ํ ์๋ค โ ๊ฐ์ด ์๋๋ผ ๊ท์น๊ณผ ๊ท๊ฒฐ์ ๊ณ ์ ํ ๊ฒ์ด๋ฉฐ D-033ยทD-044 ๊ฐ ๋ณด์กด ์ ์ฑ ๊ฐ์์ ์ด ๋ฐฉ์๊ณผ ๊ฐ๋ค. - โ ๊ท์์ EditSnapshot ์ ์ฐ๋ ์ด์ : C-02 ๊ฐ "EditSnapshot ์ ๋จ๊ธฐ์ง ์๋ ์์ด์ ํธ ํธ์ง ๊ฒฝ๋ก๋ ์กด์ฌํ์ง ์๋๋ค" ๋ฅผ ๋ณด์ฅํ๋ฏ๋ก ๋ชจ๋ ํธ์ง์ pre ์ํ๊ฐ ์๋ค โ ์ ์ถ์ ์ฅ์น๋ฅผ ๋ง๋ค์ง ์๊ณ ์ด๋ฏธ ๋ถ๋ณ์์ธ ๊ฒ์ ์น๋๋ค.
- ใ๋๋ฌ๋ธ ๊ฒฐํจใ(revealed)์ 0 ์ผ๋ก ์ ์ง ์๋๋ค. ์์ด์ ํธ ํธ์ง์ด ์ ๋ณต ๋ฒ๊ทธ๋ฅผ ๊นจ์ด ๊ฒฝ์ฐ๋ ์ฑ ์ ๊ท์์ด ๋ ผ์์ ์ด๋ผ ๋ณ๋ ์ง๊ณํ๋ค. ํ์ชฝ์ผ๋ก ์ ์ผ๋ฉด ๊ทธ ์ ํ์ด ๊ฒ์ถ๋ฅ ์ ์กฐ์ฉํ ์์ง์ธ๋ค.
- ๊ฒฐํจ ์นดํ๋ก๊ทธ์ ใ์ด๋ ๋ฐฉ๋ฒ๋ ๋ชป ์ก๋ ๊ฒฐํจใ์ ๋ฐ๋์ ๋ฃ๋๋ค. ์์ผ๋ฉด ๊ฒ์ถ๋ฅ ์ด ยซ์ฐ๋ฆฌ ๋ฐฉ๋ฒ์ด ์ก๋๋ก ๋ง๋ ๊ฒฐํจ์ ์ฐ๋ฆฌ ๋ฐฉ๋ฒ์ด ์ก๋๊ฐยป ๋ผ๋ ๋์ด๋ฐ๋ณต์ด ๋๋ค.
- ํ๋ณธ ์๋ ์ง์ด๋ด์ง ์๊ณ ์ญ์ฐํ๋ค. PRD R-4 ๊ฐ ๊ธ์งํ
- 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 @ 9db9015first-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 bare15,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.ymlchanges์ก ๋ฐฐ์ . - 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 ๊ฐ ์ปค๋ฐ๋ณธ๊ณผ ๋์กฐํ๋ค.
- โ: ํฌํจํ์ง ์๋๋ค. ๋ฐ์คํฌํฑ ์ฌ๋ฐฐํฌ ์ํฐํฉํธ์ SSPL-1.0 ์ธ
- 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 ๋ก ์ ์ผ๋ฉด ๊ณ ์ง๊ฐ ๊ทผ๊ฑฐ๊ฐ ์๋๋ผ ์ธ์์ด ๋๋ค.
- ใ๋ฆฌํฌ์ ์์ง๋ง ์ฑ์ด ์ ์ด๋คใ๋ ๋ถํฉ๊ฒฉ์ด๋ค(#99 ์ธ์์กฐ๊ฑด 4). ์ง์ ์์กด ๋ชฉ๋ก์ ํ ๊ฒน๋ง ๋ณด์ฌ ์ฃผ๊ณ ์ ์ด ์์กด์ผ๋ก SSPL ์ด ๋ธ๋ ค ์ฌ ์ ์๋ค. ๊ทธ๋์ ์ ์ด ์์กด ํํฌ๋ก ์ฆ๋ช
ํ๋ค โ
- 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.ymlnightly ๊ฐ ์ฒซ ์คํ(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 ์ด ์๋ค. ๊ทธ๋์ ์น์ธ ๊ถํ์ด ๋ฆฌ๋ทฐ ์๊ฑด์ ์ฐํํ๋ ๊ฒฝ๋ก๊ฐ ๋์ง ์๋๋ค.
- ์ธ ์ํฌํ๋ก๊ฐ ๋ชจ๋ PR ์์ฑ ๋จ๊ณ์์ ใGitHub Actions is not permitted to create or approve pull requestsใ๋ก ์คํจํ๋ค:
- Decision: ํ์ฉํ๋ค(์ต์
โ).
- ์ ์ฅ์ ์์ค ์ค์ ์ ์กฐ์ง ์ ์ฑ ๋๋ฌธ์ 409 ๋ก ๊ฑฐ๋ถ๋๋ค(2026-09-28 ์ค์ธก). ๋ฐ๋ผ์ ์กฐ์ง ์ค์ ใAllow GitHub Actions to create and approve pull requestsใ๋ฅผ ์ผ ๋ค ์ธ ์ ์ฅ์์ ์ ์ฉํ๋ค.
- ์ ์ฉ์๋
admin:org๋ฒ์๊ฐ ํ์ํ๋ค. GITHUB_TOKEN์ด ์ฐ PR ์๋pull_requestCI ๊ฐ ๋์ง ์๋๋ค. ๊ทธ๋์ ๊ฐฑ์ 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 ์ ๋ฐฑ์๋ ์กด์น ์๋๋ ๊ทธ๋๋ก๋ค(์ค๋ ํ์ธ).
- ํ์ ๊ธฐ์ค์ ์์กด ํํฌ๋ค. ์ํฌ์คํ์ด์ค 132๊ฐ์ ํํฌ(dependencies + dev_dependencies)๋ฅผ
- 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).
- D-031 ์ excludeยทignore ๋ ๋์๊ณผ ํจ๊ป ์ฌ๋ผ์ง๊ณ
- 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/{โฆ}. ๋๋ ํฐ๋ฆฌ ยท pubspecname:ยท ๋ฐฐ๋ด ํ์ผ(lib/<์ด๋ฆ>.dart) ยท import URI ยท ์์กด ์ ์ธ ยท ๊ณ์ธต ์ ์ธ ยท CI ์คํฌ๋ฆฝํธ ยท ๋ฌธ์๋ฅผ ํจ๊ป ๋ฐ๊พผ๋ค.cocode_platform์desktop_platform์ด๋ค(์ค๋ ํ์ธ). pub.dev ์platform3.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์ฐจ์ ์ฐ์ธก ์ฑํ ํญ ์์)
- ์ฒซ ํ๋ฉด ยท ํ๋ก์ ํธ ์์ = ์ฑํ ๋น ๋ํ
- AC-03 ํด์: ยซ์คํ ์ ์๋ํฐ ยท ํ์ผํธ๋ฆฌ ยท ํฐ๋ฏธ๋ ์ ๊ณตยป์ ์ฝ๋ ๋ชจ๋๊ฐ ์งํจ๋ค. ์ธ ํ๋ฉด์ ์ฒซ ํ๋ฉด์์๋ ๋ง์ดํธ๋ ์ฑ ์๋จ ์ ํ ํ ๋ฒ ๊ฑฐ๋ฆฌ์ ์๋ค(UX-D-30 ์ ์๋ฆฌ ์ ์ง ์์น์ ๋ชจ๋ ๋จ์๋ก ์ฝ๋๋ค).
- Consequences:
ux-spec-cocodeUX-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/uiCocodeShellScaffold์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-cocodeUX-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 ๋ก ๋ณด๋ด๊ณ , NDJSONerror๋จ๊ณ๋ ์ข ๋ฃ ์ฝ๋๋ง ์ฃ๋๋ค. - 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/<์ด๋ฆ>)์ ๋์์ ํ์ธ ์ ์ ๋ณด์ธ๋ค.
- ์คํ ๋จ๊ณ(์ฌ์ ์ ๊ฒ ยท ์์ฑ ยท ๊ฒ์ฆ ยท ๊ฒ์)๊ฐ ์คํจํ๋ฉด cob ์ถ๋ ฅ์์ ํ ์ค(์ต๋ 240์)์ ๊ณ ๋ฅธ๋ค โ
- 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), ๋น๋ blocresume. ๋ค๋ฅธ ์ฌ๋์ ๋น๊ณต๊ฐ ์ ์ฅ์์ฒ๋ผ ๋ณด์ด์ง ์๋ ์ด๋ฆ์ ยซ์ฌ์ฉ ๊ฐ๋ฅยป์ผ๋ก ๋ณด์ด๊ณ cob ๊ฐ ๊ฒ์ ๋ ๊ฑฐ๋ฅธ๋ค โ ์ด์ ๊ณผ ๊ฐ์ ๊ฒฐ๊ณผ๋ค. - Source: #536 ยท D-091 ยท co-bricks#795 ยท co-bricks#796
โ ๏ธ D-112(2026-11-18)๋ก ๋์ฒด๋๋ค โ ๋ฉ์ถ ์คํ ์ด์ด ๋๋ฆฌ๊ธฐ(
CobClient.execute(plan, from:)ยท ๋น๋ blocresume) ยท ยซ๊ฒ์ฆ ์์ด 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-devpr-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/**ยท melosignore:). #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)์ melosignore: - 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 analyzeerror 0 ยท warning 0(๋ก์ FutureCall@override14๊ฑด ๋ฑ 18๊ฑด ์์ ) ยท info 315(directives_ordering296 ๋ฑ ๋๋ ์คํ์ผ โ ๋น์น๋ช ), 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.yamlSSOT ยทci.ymlยทbuild.yamlยทpatrol-test.ymlยทactivate_serverpod_cli.sh)์ 4.1.0-beta.1 ๋ก ์ฌ๋ฆฐ๋ค. ๋ธ๋ก๊ทธ ๋ฐฑ์๋ Epic(#549) ์์์ ์ฒ๋ฆฌํด ๋จ์ ๋ฐฑ์๋ ์์ ์ด ๊ฐ์ ๋ฒ์ ์์์ ๋๋๊ฒ ํ๊ณ , ์ต์ข Project โdevelopmentPR ์ ์ ์ฒด 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:
- ์์ฑ์ ํ์ด์ง ์์ฐ ์ ์ค โ ์ฌ ํ๋ ๊ตฌ์ฑ
- ์คํ๋์ค ์ฌ ๋ถ๋ฆฌ + ์์ฐ 2๊ณณ ์ํฅ
- ์คํ๋์ค ๋ณด๋ฅ
-
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์ ์๋ค.
- ์์ฑ ๊ฒฝ๋ก(#853): kernel + ๋ฒ๋ค +
- 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#8498a0740b2ยทdocs/fullstack-bundle-poc/adr-v2.mdAD-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:
- ํ์ด์ง ์ฌ ์์ฐ 192 โ 194 KB (์ฌ์ 1.4 KB)
- ์์ฐ์ ๊ทธ๋๋ก ๋๊ณ ํ์ ์ฌ๋ฆฌ์ง ์๋๋ค
- ์ฝ๋์์ 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_challengeFK 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์ข +sqlparser0.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 analyzeerror ยท 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.mdP-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_sync0.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)