๐ฌ ํ๊ณ ์ฃผ์
ํ ๋ฌ ์ , ๋ฌด์ ์ฌ์ AI Native Engineering ๊ณต๊ณ ๋ฅผ ๋ณด๊ณ ์ง์ํ๊ฒ ๋์๋ค.



2์ฐจ ํ ์คํธ๊น์ง ๋ณผ ์ ์๋ ๊ธฐํ๋ฅผ ์ป์์ง๋ง, ๊ฒฐ๊ณผ์ ์ผ๋ก๋ ๋ถํฉ๊ฒฉํ๋ค. ์ด์ ํ์ฌ์์ ๊ฒฝ์๋์ผ๋ก ๊ถ๊ณ ์ฌ์ง์ ๋ฐ์ ๋ค, ์๋กญ๊ฒ ์ด์ง์ ์ค๋นํ๋ฉด์ 'AI๊ฐ ์ฝ๋๋ฅผ ์ง๋ ์๋์ ๋ฐฑ์๋ ์์ง๋์ด๋ก์ ์ด๋ค ๊ฒฝ์๋ ฅ์ ๊ฐ์ ธ์ผ ํ ๊น?'๋ผ๋ ๊ณ ๋ฏผ์ด ๊ณ์ ๋จธ๋ฆฟ์์ ๋งด๋์, ์ด๋ ฅ์๋ฅผ ์๋ ์์ด ์์ ํ๋ค. ๊ทธ๋ฐ ์๊ธฐ์ ์ค๋๋ง์ ์๋ฅ๋ถํฐ ์ฝ๋ฉ ํ ์คํธ๊น์ง ๋ฐ์๋ณผ ์ ์์๊ธฐ์, ๊ฒฐ๊ณผ์ ๋ฌด๊ดํ๊ฒ ๋์๊ฒ๋ ๊ฐ์ง ๊ฒฝํ์ด์๋ค.
์ฌ์ค, ํ๊ณ ๋ฅผ ํด์ผ๊ฒ ๋ค๋ ์๊ฐ ์์ฒด๋ฅผ ์๊ณ ์์๋๋ฐ, ์ต๊ทผ์ EO Korea ์ฑ๋์ ์ฌ๋ผ์จ ์คํ ํฌ๋์์ ๋น ํ ํฌ๋ก ์กฐ์ฉํ ํผ์ง๋ ๊ฐ๋ฐ์ ์์กด๋ฒ ์์์ ๋ณด๊ณ 2์ฐจ ํ ์คํธ์์ ๋ด๊ฐ ๋์ณค๋ ๊ฒ๋ค๊ณผ ๊ฒน์ณ ๋ณด์ด๋ฉด์ ์๊ฐ์ด ๋ฌ๋ค.
์ด ๊ธ์ ์ฑ์ฉ ํ๊ธฐ๊ฐ ์๋ ํ๊ณ ์ด๋ค. ๋ฌด์ ์ฌ์ AI Native Engineer 2์ฐจ ํ ์คํธ ๊ฒฝํ์ ํตํด, ์ฃผ๋์ด ๊ฐ๋ฐ์๋ก์ ๋ด๊ฐ AI ์๋์ ์ด๋ป๊ฒ ๋์๊ฐ์ผ ํ ์ง ํบ์๋ณด๋๋ก ํ์.
๐ฌ ์์ ์์ฝ
EO Korea - ์คํ ํฌ๋์์ ๋น ํ ํฌ๋ก ์กฐ์ฉํ ํผ์ง๋ ๊ฐ๋ฐ์ ์์กด๋ฒ
AI ์๋์ ์ฃผ๋ชฉ๋ฐ๋ ์์ง๋์ด์์ด ๋ฐ๋๊ณ ์๋ค. ๋จ์ํ ์ฝ๋๋ฅผ ์ ์ง๋ ๊ฒ์ ๋์ด, ๋ค์์ AI Agent๋ฅผ ๋ฅ์ํ๊ฒ ์ค์ผ์คํธ๋ ์ด์ ํ๋ ์ญ๋์ด ์๋ก์ด ์ฑ์ฉ ๊ธฐ์ค์ด ๋๊ณ ์๋ค๋ ๊ฒ์ด๋ค.
์ด๋ฅผ ์ ํ๋ ค๋ฉด ๋ ๊ฐ์ง๊ฐ ํ์ํ๋ค.
- Agent๋ค์ ์์
ํ๋ฆ์ ์ค๊ณํ๋ ์ ์ด ์ ๋ต(Multi-Agent Workflow)
- ์ ์ง์ ์ธ ์์ด์ ํธ ๋์
- ์ปจํ ์คํธ ์ค์์นญ ์ ๋ต
- ํ๋ฅญํ ๊ด๋ฆฌ์์ ์์ง
- Agent๊ฐ ํผ๋ ์์ด ์ฝ๋๋ฅผ ์ฝ๊ณ ๊ธฐ์ฌํ ์ ์๋ ์ฝ๋๋ฒ ์ด์ค(Agent-Friendly Codebase)
- ๋ช ํํ ์ปจํธ๋ํธ(ํ ์คํธ) ์ ๊ณต
- ๋ฌธ์์ ์ฝ๋์ ์ผ๊ด์ฑ
- ์ผ๊ด๋ ๋์์ธ ํจํด
ํฅ๋ฏธ๋ก์ด ๊ฑด ์ด ๋ณํ๊ฐ ์ฃผ๋์ด์๊ฒ ์ ๋ฆฌํ๋ค๋ ๊ฒ์ด๋ค. ๊ธฐ์กด ๋ฐฉ์์ ๊ณ ์ฐฉ๋์ง ์์ ์ฃผ๋์ด๋ AI ์ํฌํ๋ก์ฐ๋ฅผ ๋น ๋ฅด๊ฒ ์คํํ๊ณ , ์์ฉํ ์ ์์ด ์คํํธ์ ์ํ๊ณ์์ ์คํ๋ ค ๊ฐ์ ์ด ๋๋ค๊ณ ํ๋ค.
๐ต ๋์ ๋ฌธ์ ์ ๋ถ์ ๋ฐ ํ๊ณ
2์ฐจ ํ ์คํธ๋ ๋จ์ผ AI Agent(Gemini CLI)๋ฅผ ํ์ฉํด ์งํํ๋ค. ๋น๋ก ๋ค์ค Agent๋ฅผ ๋์์ ๋ค๋ฃจ์ง๋ ์์์ง๋ง, ์์์์ ๊ฐ์กฐ๋ AI ๋ค์ดํฐ๋ธ ์์ง๋์ด์ ํต์ฌ ์ญ๋์ธ '์ํฌํ๋ก์ฐ ์ค๊ณ' ์ 'Agent-Friendly ์ฝ๋๋ฒ ์ด์ค ๊ตฌ์ถ' ๊ด์ ์์, ๋๋ ์ด ๋ ๊ฐ์ง ์ญ๋ ๋ชจ๋ ๋ถ์กฑํ๋ค. ํ๋์ฉ ํบ์๋ณด๋๋ก ํ์.
1. ์์คํ ์ค๊ณ ์์๊ณผ ์ปจํ ์คํธ ๊ณผ๋ถํ
๐ ๋ถ์
ํ๋ฉด์ ์ธ ๋ฌธ์
GEMINI.md ์์ฑ์ ๋ง์ ์๊ฐ์ ํฌ์ํ์ง๋ง, ๊ฐ๋ฐ๋ฌผ์ ํ์ง๊ณผ ๊ฐ๋ฐ ํจ์จ์ด ๋ฎ์๋ค.
- ์? → ์๊ตฌ์ฌํญ(
PROBLEM.md) ๋ฌธ์ ๋ถ์์ ๋ด๊ฐ ํ์ง ์๊ณ , AI์๊ฒ ์ ์ ์ผ๋ก ์์ํ๋ค. - ์? → ์ ํ๋ ์๊ฐ ๋ด์ ๋น ๋ฅด๊ฒ ๊ตฌํ ๋จ๊ณ๋ก ๋์ด๊ฐ์ผ ํ๋ค๋ ์๋ฐ๊ฐ๊ณผ ์กฐ๊ธํจ์ด ์์๋ค.
๊ทผ๋ณธ ์์ธ
์์คํ ์ค๊ณ์ ์ปจํ ์คํธ ์์ถ์ AI๊ฐ ์๋ ๊ฐ๋ฐ์์ ์์ญ์ด๋ค. ์์์์ ์ง์ ํ ๊ฒ์ฒ๋ผ, Agent๋ ๋ฌธ์์ ์ฝ๋๊ฐ ๋ถ์ผ์นํ๊ฑฐ๋ ๋ชจํธํ ๋, ์ฌ์ํ ์คํด๋ฅผ ๋ฐํ์ผ๋ก ๋น ๋ฅด๊ฒ ์ค๋ฅ๋ฅผ ์ฆํญ์ํจ๋ค. ์ฆ, ์์ ์ ์ง์ํ๊ธฐ ์ , ๋ช ํํ ๋๋ฉ์ธ๊ณผ ์ ์ฝ์ ์ ์ํ๋ ์์คํ ์ค๊ณ์ ์ญํ ์ ์ํํ์ง ๋ชปํ๋ค.
โฉ๏ธ Before
์ ๋ง์ ํ๋ฆฐ๊ฒ ์๋ค. "๋ฐ์ ์๋ก ๋์๊ฐ๋ผ"๋ผ๋ ๋ง์ ๊ฐ๊ณผํ๋ค. ์ด๊ธฐ ๋ถ์ ์์ด ์กฐ๊ธํ๊ฒ AI๊ฐ ๋์ถํ ์ ์ฝ ์ฌํญ์ ๊ทธ๋๋ก GEMINI.md์ ์ถ๊ฐํ๋ค. ๊ฒฐ๊ณผ์ ์ผ๋ก ๋ฌธ์์ ์ปจํ
์คํธ๋ ๋น๋ํด์ก๊ณ , ๋ถํ์ํ๊ฒ ๋ฌด๊ฑฐ์์ง ์ ์ฝ์ฌํญ๊ณผ ํต์ฌ ๋น์ฆ๋์ค ๋ก์ง ์ฌ์ด์์ Agent๋ ๋งฅ๋ฝ์ ์๊ธฐ ์์ํ๋ค. ์ด๋ ํ
์คํธ ํ๋ค์ค ์ค๋ฅ์ ์๋ชป๋ ์ฝ๋ ์์ฑ์ผ๋ก ์ด์ด์ก๋ค.
โช๏ธ After
GEMINI.md์ ์ญํ ์ ์ฌ์ ์ํด์ผ ํ๋ค. ๋ง์ ์ ๋ณด๋ฅผ ์ฃผ์
ํ๋ ๊ฒ๋ณด๋ค, ์คํด ์์ด ์คํํ ์ ์๋ ์ต์ํ์ ๊ณ์ฝ์๊ฐ ๋์ด์ผ ํ๋ค.
- ์๊ตฌ ์ฌํญ์ ๋ด๊ฐ ๋จผ์ ์๋ ํ๊ณ ํต์ฌ ์๊ตฌ์ฌํญ์ ์ง์ ์ ๋ฆฌํ๋ค.
- ๊ทธ ์ค Agent๊ฐ ๋ฐ๋์ ์์์ผ ํ ์ต์ํ์ ๋ด์ฉ๋ง
GEMINI.md์ ๋ฃ๋๋ค. - ๋ง์์๋ก ์ข์ ๊ฒ ์๋๋ผ, ์ ํํ ์๋ก ์ข๋ค.
2. ๊ฒ์ฆ ๋ถ๊ฐ๋ฅํ ๋ชจํธํ ์ํฌํ๋ก์ฐ ๋ถ๋ฆฌ
๐ ๋ถ์
ํ๋ฉด์ ์ธ ๋ฌธ์
ํ์ดํ๋ผ์ธ์ Step 1 ~ 4๋ก ๋๋์์ง๋ง, ๊ฐ ๋จ๊ณ์ ์ฑ ์๊ณผ ๊ฒ์ฆ ๊ธฐ์ค์ด ํฌ๊ณ ๋ชจํธํ๋ค.
- ์? → ๋จ๊ณ๋ฅผ ๋๋๋ ๊ฒ ์์ฒด๊ฐ ๋ชฉ์ ์ด ๋์ด, ๊ฐ์ฅ ์ค์ํ ์๋ฃ ๊ธฐ์ค์ ์ ์ํ์ง ์์๋ค.
- ์? → ๋จ๊ณ๋ฅผ ์ ๋๋๊ธฐ๋ง ํ๋ฉด, Agent๊ฐ ์ค์ค๋ก ์ ์ํํ ๊ฒ์ด๋ผ๊ณ ๊ณผ์ ํ๋ค.
๊ทผ๋ณธ ์์ธ
์์์์ ์ง์ ํ ์ ์ง์ ์ค์ผ์คํธ๋ ์ด์ ์์น์ ์๋ฐฐํ๋ค. ๋จ์ผ ์์ ์ ์์ ํ ์ํ๊ณผ ๊ฒ์ฆ ์์ด ๋ค์ ๋จ๊ณ๋ก ๋์ด๊ฐ๊ธฐ ๋๋ฌธ์, ์ด๋์๋ถํฐ ๋ ผ๋ฆฌ๊ฐ ์ด๊ธ๋ฌ๋์ง ์ถ์ ์์ฒด๊ฐ ์ด๋ ค์์ก๋ค.
โฉ๏ธ Before
## Step 1: Prompt Log Generation (`prompts/`)
## Step 2: API Documentation Generation (`docs/`)
## Step 3: Code Implementation (`src/main/`)
## Step 4: Test Implementation (`src/test/`)
๊ฒ๋ณด๊ธฐ์๋ ์ฒด๊ณ์ ์ผ๋ก ๋ณด์ด์ง๋ง, ๊ฐ ๋จ๊ณ์ ์๋ฃ ๊ธฐ์ค์ด ์๋ ๊ตฌ์กฐ์๋ค. ํ์ผ ์์ฑ์ด๋ ๋จ์ ์ปดํ์ผ ์ฑ๊ณต๋ง์ผ๋ก๋ ๋น์ฆ๋์ค ์๊ตฌ์ฌํญ ์ถฉ์กฑ์ ๋ณด์ฅํ ์ ์๋ค. ํนํ ์ฝ๋๋ฅผ ๋จผ์ ์์ฑํ๊ณ ํ ์คํธ๋ฅผ ๋์ค์ ๊ตฌํํ๋ ๋ฐฉ์์, ์์์์ ๋งํ 'ํ ์คํธ๋ฅผ ํตํ ๋ช ํํ ์ปจํธ๋ํธ ์ ๊ณต'์ ์ด๊ธ๋๋ฉฐ Agent์ ๋ ผ๋ฆฌ์ ์ค๋ฅ๋ฅผ ์ฌ์ ์ ์ฐจ๋จํ์ง ๋ชปํ๋ค.
โช๏ธ After
๊ฐ ๋จ๊ณ์ ๋ช ํํ ๊ฒ์ฆ ์ฌ์ดํด์ ํตํฉํด์ผ ํ๋ค.
- ๊ฐ ๋จ๊ณ์์ ์์ํด์ผ ํ ๋จ์ผ ๊ธฐ๋ฅ๊ณผ ๋ฒ์ ๋ช ์
- ํ ์คํธ ํต๊ณผ, ์๋ํฌ์ธํธ ์๋ต ํ์ธ ๋ฑ ๊ฒ์ฆ ๊ฐ๋ฅํ ๊ธฐ์ค ์ค์
- ๋ค์ ๋จ๊ณ๋ก ์ปจํ ์คํธ๋ฅผ ์ ํํ๊ธฐ ์ , ๊ฐ๋ฐ์๊ฐ ์ง์ ์ฝ๋์ ๋ ผ๋ฆฌ๋ฅผ ๋ฆฌ๋ทฐํ๋ ์ฒดํฌํฌ์ธํธ ํ๋ณด
Agent๊ฐ ๋จ์ผ ์์ ์ ์๋ฒฝํ ์ํํ๋์ง ๊ฒ์ฆํ ๋ค ๋ค์์ผ๋ก ๋์ด๊ฐ๋ ๊ฒ. ๊ทธ๊ฒ์ด ์ ์ง์ ์์์ด๋ค.
๐ช๐ป ๋ง๋ฌด๋ฆฌ
2์ฐจ ํ ์คํธ(2์ 8์ผ)์ดํ ์ฝ ํ ๋ฌ์ ์๊ฐ์ด ํ๋ ๋ค.
ํ ์คํธ ์งํ, ๋ฌด์์ด ๋ถ์กฑํ๋์ง ๋ฐ๋ก ํ๊ณ ๋ฅผ ํ๋ค. ๋ถํฉ๊ฒฉ ๊ฒฐ๊ณผ๋ฅผ ๋ฐ๊ณ ์ด ์์ ์์ ๋ค์ ์ฝ์ด๋ณด๋, ํ ๋ฌ ์ฌ์ด์ AI์ ๋ํ์ฌ ๊ธฐ์ ์ ์ผ๋ก๋ ๋ฐฉ๋ฒ๋ก ์ ์ผ๋ก ์ ์๋ฏธํ ๋ณํ๊ฐ ์์์์ ํ์ธํ ์ ์์๋ค.
๊ฐ์ฅ ํฐ ๋ณํ๋ ๋ง์ฐํ๋ AI ํ์ฉ์ ๊ตฌ์กฐํํ๋ค๋ ์ ์ด๋ค. oh-my-opencode๋ฅผ ํตํด Multi-Agent Orchestration ํ๊ฒฝ์ ์ง์ ๊ฒฝํํ๊ณ , ์ด ๊ณผ์ ์์ Single-Agent ํ๊ฒฝ์์๋ ์ ์ฉํ ์ ์๋ ๋๋ง์ ํ๋ก์ธ์ค๋ฅผ ์๋ฆฝํ๋ค. ์ด ๊ณผ์ ์ ํตํด Single-Agent ํ๊ฒฝ์์๋ ๊ตฌ์กฐ์ ์ผ๋ก ์ฌ์ฉํ ์ ์๋ /init, /plan, /work ํ๋ก์ธ์ค๋ฅผ ์๋ฆฝํ์ฌ ๊ฒ์ฆ ๊ฐ๋ฅํ๊ณ , ํต์ ๊ฐ๋ฅํ ์ํฌํ๋ก์ฐ๋ก ๋ฐ์ ์ํฌ ์ ์์๋ค.
์์์์ ๋งํ ๊ฒ์ฒ๋ผ, ์ ๋ต์ด ์๋ AI ์ํ๊ณ์์๋ ์ง์ ๋ถ๋ชํ๋ฉฐ ์์ ๋ง์ ์ํฌํ๋ก์ฐ๋ฅผ ๊ตฌ์ถํ๋ ์คํ ์ ์ ์ด ํต์ฌ์ด๋ค. ๋๋ ๋ถํฉ๊ฒฉ ์ดํ ํ ๋ฌ ๋์ ๊ทธ๊ฑธ ํ๋ค.
๋ถํฉ๊ฒฉ์ด๋ผ๋ ๊ฒฐ๊ณผ๋ ๋ฐ๊ฟ ์ ์๋ค. ํ์ง๋ง ์ด ๊ฒฐ๊ณผ๊ฐ ์ง๋ ํ ๋ฌ๊ฐ ๋ด๊ฐ ๊ฒฝํํ ๊ฒ๋ค์ ์ถ๋ฐ์ ์ด ๋๋ค๋ ๊ฑด ๋ถ๋ช ํ๋ค.
์ฃผ๋์ด์ ๊ฐ์ ์ ๊ธฐ์กด ๋ฐฉ์์ ๊ณ ์ฐฉ๋์ง ์๋๋ค๋ ๊ฒ์ด๋ค. ์คํจํ ๋ฐฉ๋ฒ๋ก ์ ๋น ๋ฅด๊ฒ ๋ฒ๋ฆฌ๊ณ , ๋ ๋์ ๊ธฐ์ ๊ณผ ํ๋ก์ธ์ค๋ฅผ ์คํ์ง์ฒ๋ผ ํก์ํ๋ ๊ฒ. ์ง๊ธ ๋ด๊ฐ AI ๋ค์ดํฐ๋ธ ์์ง๋์ด๋ก ๋์๊ฐ๋ ๋ฐ ์์ด ๊ฐ์ฅ ๊ฐ๋ ฅํ ๋ฌด๊ธฐ๋ ๋ฐ๋ก ๊ทธ ์ ์ฐํจ์ด๋ผ๊ณ ์๊ฐํ๋ค.