Project Day
Markdown ๊ธฐํ์ ๊ธฐ๋ฐ ์น์ฌ์ดํธ ๊ตฌ์ถ
Codex AI ๋ํ ์ค์ต
gstack ์คํฌ ํ์ฉ
์ฝ๋ฑ์ค(Codex) ๋ํ ๊ธฐ๋ฐ ์น์ฌ์ดํธ ์ ์ ํ๋ก์ ํธ
์ด ์์
์ ์ฝ๋ฑ์ค์ ๊ณง๋ฐ๋ก โ์น์ฌ์ดํธ ๋ง๋ค์ด ์คโ๋ผ๊ณ ์์ฒญํ๋ ๋์ ,
์์ด๋์ด ๋ํ๋ถํฐ Markdown ๊ธฐํ์ ์์ฑ, ์ฝ๋ ์์ฑ, ํ
์คํธ ๋ฐ ์ด๋ ฅ ๊ด๋ฆฌ๊น์ง์ 6๋จ๊ณ ์ ์ ํ๋ก์ ํธ ํ๋ก์ธ์ค๋ฅผ ์์ํ๋ ์ค์ต ๊ณผ์ ์
๋๋ค.
ํ์ ํ๋ก์ ํธ ์งํ ๋ฐฉ๋ฒ
- ํ ํ์ด์ฆ์ฉ ์๋ฃํ์ธ์. ์ ๋จ๊ณ์ ์ฐ์ถ๋ฌผ์ด ๋ค์ ๋จ๊ณ์ ์
๋ ฅ ์๋ฃ๊ฐ ๋ฉ๋๋ค.
- Codex์ ๊ฒฐ๊ณผ๋ฅผ ๊ทธ๋๋ก ์ฑํํ์ง ๋ง์ธ์. ์ฌ์ค, ๊ฐ์ , ๊ฒฐ์ , ๋ฏธ๊ฒฐ ์ง๋ฌธ์ ๊ตฌ๋ถํ๊ณ ํ์ด ํ๋จํ ๊ทผ๊ฑฐ๋ฅผ ๋จ๊น๋๋ค.
- ๊ฐ ์นด๋์ ์์ธ ๊ฐ์ด๋๋ฅผ ํ์ธํ์ธ์. ํ์ด์ฆ ๋ชฉ์ , ์ํ ์์, ํ์ ๊ฒฐ๊ณผ๋ฌผ, ์ค๋ฌด ๊ณ ๋ ค์ฌํญ๊ณผ ์๋ฃ ์ฒดํฌ๋ฆฌ์คํธ๊ฐ ์ ๊ณต๋ฉ๋๋ค.
- ์์ฑ๋ณด๋ค ๊ฒ์ฆ ๊ฐ๋ฅํ ๊ณผ์ ์ด ์ค์ํฉ๋๋ค. ์ ๊ทธ๋ ๊ฒ ์ค๊ณํ๋์ง ๋ฌธ์์ ํ
์คํธ ์ฆ๊ฑฐ๋ก ์ค๋ช
ํ ์ ์์ด์ผ ํฉ๋๋ค.
๐งฐ gstack์ผ๋ก ๊ฐ ํ์ด์ฆ ์งํํ๊ธฐ
gstack์ Garry Tan์ด ๊ณต๊ฐํ ์คํ์์ค AI ์ฝ๋ฉ ์คํฌ ๋ชจ์์
๋๋ค. ์์ด๋์ด ๊ฒํ , ์ค๊ณ ๋ฆฌ๋ทฐ, ์ฝ๋ ๋ฆฌ๋ทฐ, QA, ํ๊ณ ๊ฐ์ ์ญํ ์ ์ฌ๋์ ๋ช
๋ น์ผ๋ก ๋ถ๋ฌ ์ธ ์ ์๊ณ , Codex CLI์์๋ ๋์ํฉ๋๋ค. ์๋ ๊ฐ ํ์ด์ฆ ์นด๋์ ๋ณด๋ผ์ ๋ฐ์ค์ ํด๋น ๋จ๊ณ์์ ์ธ gstack ์คํฌ์ด ์ ๋ฆฌ๋์ด ์์ต๋๋ค.
Think โ Plan โ Build โ Review โ Test โ Ship โ Reflect
# ํ๋ก์ ํธ ํด๋ ์์ ์ค์น (Codex์ฉ)
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git .agents/skills/gstack
cd .agents/skills/gstack && ./setup --host codex
- ์ค์น์๋ Git๊ณผ Bun(v1.0 ์ด์)์ด ํ์ํฉ๋๋ค. Windows๋ Node.js๋ ํ์ํฉ๋๋ค.
- gstack ์คํฌ์ ๊ฒฐ๊ณผ๋ Codex ๊ฒฐ๊ณผ์ ๋๊ฐ์ด ๋ค๋ฃน๋๋ค. ๊ทธ๋๋ก ์ฑํํ์ง ๋ง๊ณ ํ์ด ํ๋จํ ๊ทผ๊ฑฐ๋ฅผ Markdown ๋ฌธ์์ CONVERSATION.md์ ๋จ๊น๋๋ค.
- ์ฌ์ฉํ gstack ๋ช
๋ น๊ณผ ๊ฒฐ๊ณผ ์์ฝ์ ๋งค๋ฒ CONVERSATION.md์ ๊ธฐ๋กํฉ๋๋ค.
๐ Project Day 6๋ ํต์ฌ ํ์ด์ฆ (Tasks)
Phase 1
์์ด๋์ด ๊ตฌ์ฒดํ (Idea Definition)
์ฌ์ดํธ ๋ชฉ์ , ์ฌ์ฉ์ ์ญํ (ํ์/์ ์๋), ํต์ฌ ํ๋์ 3๋ฌธ์ฅ ์ด๋ด๋ก ๋ช
ํํ ์ ๋ฆฌํฉ๋๋ค.
ํต์ฌ ๊ฒฐ๊ณผ๋ฌผ๋ฌธ์ ยท์ฌ์ฉ์ยทํต์ฌ ํ๋์ด ๋๋ฌ๋๋ ํ๋ก์ ํธ ์ ์๋ฌธ
์ค์ ๊ธฐ์คํ์ ๋ชจ๋๊ฐ ๊ฐ์ ์ ํ์ ์์ํ ์ ์๋๊ฐ?
๐งฐ gstack ํ์ฉ ยท Think
- /office-hours 6๊ฐ์ง ํต์ฌ ์ง๋ฌธ์ผ๋ก ์์ด๋์ด์ ์ ์ ๋ฅผ ์ ๊ฒํ๊ณ , ๋๊ตฌ์ ์ด๋ค ๋ฌธ์ ๋ฅผ ํธ๋์ง ๋ค์ ์ ๋ฆฌํด ๋์์ธ ๋ฌธ์๋ฅผ ๋ง๋ญ๋๋ค.
๐ก ๊ฒฐ๊ณผ ๋์์ธ ๋ฌธ์๋ฅผ ๊ทธ๋๋ก ์ฐ์ง ๋ง๊ณ โ๋ฌธ์ ยท์ฌ์ฉ์ยทํต์ฌ ํ๋โ 3๋ฌธ์ฅ ์ ์๋ฌธ์ผ๋ก ์์ถํฉ๋๋ค. ์ด ๋ฌธ์๊ฐ Phase 2์ ์
๋ ฅ์ด ๋ฉ๋๋ค.
์์ธ ์ค์ต๊ณผ์ ๊ฐ์ด๋ ํ์ธ
Phase 2
๊ธฐํ ๋ฌธ์ํ (Markdown Specs)
SITE_SPEC, USER_FLOWS, DATA_MODEL, IMPLEMENTATION_PLAN, CONVERSATION ๋ฌธ์ ํฉ์ ์์ฑํฉ๋๋ค.
ํต์ฌ ๊ฒฐ๊ณผ๋ฌผ์๋ก ๋ชจ์ ์์ด ์ฐ๊ฒฐ๋๋ 5๊ฐ Markdown ๊ธฐํ ๋ฌธ์
์ค์ ๊ธฐ์ค๊ฐ๋ฐ์๊ฐ ์ถ๊ฐ ์ง๋ฌธ ์์ด ์ฒซ ๊ตฌํ์ ์์ํ ์ ์๋๊ฐ?
๐งฐ gstack ํ์ฉ ยท Plan
- /plan-ceo-review ๋ฒ์๋ฅผ ์ ๊ฒํฉ๋๋ค. ํ๋ฃจ ์์ ๋๋ด์ผ ํ๋ฏ๋ก Hold Scope ๋๋ Reduction ๋ชจ๋๋ก ๊ผญ ํ์ํ ๊ธฐ๋ฅ๋ง ๋จ๊น๋๋ค.
- /plan-eng-review ๋ฐ์ดํฐ ํ๋ฆ, ์์ธ ์ํฉ, ํ
์คํธ ๊ณํ์ ํ์ ํด DATA_MODELยทIMPLEMENTATION_PLAN์ ๋ฐ์ํฉ๋๋ค.
- /autoplan (์ ํ) CEOยท๋์์ธยท์์ง๋์ด๋ง ๋ฆฌ๋ทฐ๋ฅผ ํ ๋ฒ์ ๋๋ฆฌ๊ณ ์ฌ๋์ด ๊ฒฐ์ ํ ํญ๋ชฉ๋ง ๋ฐ์ต๋๋ค.
๐ก ๋ฆฌ๋ทฐ์์ ๋์จ ๊ฒฐ์ ๊ณผ ๋ณด๋ฅ ํญ๋ชฉ์ 5๊ฐ ๋ฌธ์ ์ค ์ด๋์ ๋ฐ์ํ๋์ง CONVERSATION.md์ ๋จ๊น๋๋ค.
๊ธฐํ์ ์์ฝ์ ์์ฑ ๊ฐ์ด๋
Phase 3
์ฝ๋ฑ์ค ๊ธฐ๋ฐ ์น์ฌ์ดํธ ๊ตฌํ
์ฝ๋ฑ์ค์ ๋ฌธ์๋ฅผ ๋จผ์ ์ฝ๊ฒ ํ ๋ค website/ ํด๋ ์๋ ๋ฐ์ํ ์น์ฌ์ดํธ ์ฝ๋ ์์ฑ์ ์์ฒญํฉ๋๋ค.
ํต์ฌ ๊ฒฐ๊ณผ๋ฌผ์คํ ๊ฐ๋ฅํ ์น์ฌ์ดํธ์ ๊ตฌํยท๊ฒ์ฆ ๊ธฐ๋ก
์ค์ ๊ธฐ์ค๋ฌธ์์ ์๋ฃ ๊ธฐ์ค์ด ์ฝ๋์ ์ค์ ๋ฐ์๋๋๊ฐ?
๐งฐ gstack ํ์ฉ ยท Build ยท Review
- /freeze ์์ ๋ฒ์๋ฅผ
website/ ํด๋๋ก ๋ฌถ์ด ๊ธฐํ ๋ฌธ์๊ฐ ์ค์๋ก ๋ฐ๋์ง ์๊ฒ ํฉ๋๋ค.
- /design-consultation (์ ํ) ์์ยทํ์ดํฌ๊ทธ๋ํผ ๋ฑ ๊ฐ๋จํ ๋์์ธ ๊ธฐ์ค์ ๋จผ์ ์ ํฉ๋๋ค.
- /review ๊ตฌํ ํ ์ฝ๋๋ฅผ ๋ฆฌ๋ทฐํด ์ค์ ์ฌ์ฉ ์ ํฐ์ง ์ ์๋ ๋ฒ๊ทธ๋ฅผ ์ฐพ์ต๋๋ค.
๐ก ๊ตฌํ ์์ฒญ์ ๊ธฐ์กด์ฒ๋ผ โ๋ฌธ์ ๋จผ์ ์ฝ๊ธฐ โ ์ฝ๋ ์์ฑโ ์์๋ฅผ ์งํต๋๋ค. gstack์ ๊ทธ ์๋ค์ ๋ฒ์ ์ ํ๊ณผ ๊ฒํ ์ ์๋๋ค.
๊ตฌํ ์์ฒญ ํ๋กฌํํธ ์์
Phase 4
๊ธฐ๋ฅ ๋ฐ ์๋๋ฆฌ์ค ํ
์คํธ
ํ์ QR ์์ฑ/์ค์บ ์ถ์๊ณผ ์ ์๋ ๋์๋ณด๋ ์ค์๊ฐ ํํฉ ๋ฐ ์์ธ ๋ฐฉ์ด ์ฒ๋ฆฌ๋ฅผ ํ
์คํธํฉ๋๋ค.
ํต์ฌ ๊ฒฐ๊ณผ๋ฌผ์ ์ยท์์ธ ์๋๋ฆฌ์ค ํ
์คํธ ๊ฒฐ๊ณผ์ ๊ฒฐํจ ๋ชฉ๋ก
์ค์ ๊ธฐ์ค์ฑ๊ณต ํ๋ฉด๋ฟ ์๋๋ผ ์คํจ ์ํฉ๋ ์์ ํ๊ฒ ์ฒ๋ฆฌํ๋๊ฐ?
๐งฐ gstack ํ์ฉ ยท Test
- /qa-only ์ค์ ๋ธ๋ผ์ฐ์ ๋ก QR ์ถ์ยท๋์๋ณด๋ ์๋๋ฆฌ์ค๋ฅผ ํ
์คํธํ๊ณ ์ฝ๋๋ ๊ณ ์น์ง ์์ ์ฑ ๊ฒฐํจ ๋ชฉ๋ก๋ง ๋ฐ์ต๋๋ค.
- /investigate ์์ธ์ด ๋ถ๋ถ๋ช
ํ ๊ฒฐํจ์ ์์ ์ ์ ๊ทผ๋ณธ ์์ธ๋ถํฐ ์กฐ์ฌํฉ๋๋ค.
- /qa ๊ฒฐํจ ๋ชฉ๋ก์ ํ์ธํ ๋ค ์์ ยท์ฌ๊ฒ์ฆ๊ณผ ํ๊ท ํ
์คํธ ์์ฑ์ ๋งก๊น๋๋ค.
๐ก Phase 2์์ /plan-eng-review๋ก ๋ง๋ ํ
์คํธ ๊ณํ์ QA๊ฐ ์ด์ด๋ฐ์ต๋๋ค. ์ ์ยท์์ธ ๊ฒฐ๊ณผ๋ฅผ ํ๋ก ์ ๋ฆฌํ์ธ์.
ํ
์คํธ ์๋๋ฆฌ์ค ํ์ธ
Phase 5
์ฌ์ดํธยท๋ฌธ์ ์ฐ์ ๊ฐ์
๋ณ๊ฒฝ ์์ฒญ์ ๊ธฐํ ๋ฌธ์์ ๋จผ์ ๋ฐ์(Spec-First)ํ ๋ค ์ฝ๋ฑ์ค๋ฅผ ํตํด ์ฌ์ดํธ๋ฅผ ๊ฐ์ ํฉ๋๋ค.
ํต์ฌ ๊ฒฐ๊ณผ๋ฌผ๋ณ๊ฒฝ ๋ช
์ธ, ์ํฅ ๋ถ์, ์์ ์ฝ๋์ ํ๊ท ํ
์คํธ
์ค์ ๊ธฐ์ค๋ณ๊ฒฝ์ผ๋ก ๊ธฐ์กด ๊ธฐ๋ฅ์ด ๊นจ์ง์ง ์์์์ ์ฆ๋ช
ํ๋๊ฐ?
๐งฐ gstack ํ์ฉ ยท Plan ยท Review ยท Test
- /plan-eng-review ๋ณ๊ฒฝ ์์ฒญ์ ๋ฐ์ํ ๊ธฐํ ๋ฌธ์๋ฅผ ๋ค์ ๋ฆฌ๋ทฐํด ์ํฅ ๋ฒ์๋ฅผ ๋ถ์ํฉ๋๋ค (Spec-First).
- /review ์์ ๋ ์ฝ๋๋ฅผ ๋ฆฌ๋ทฐํด ๊ธฐ์กด ๊ธฐ๋ฅ์ ๋ฏธ์น๋ ์ํฅ์ ํ์ธํฉ๋๋ค.
- /qa ํ๊ท ํ
์คํธ๋ฅผ ๋ค์ ๋๋ ค ๊ธฐ์กด ๊ธฐ๋ฅ์ด ๊นจ์ง์ง ์์์์ ์ฆ๋ช
ํฉ๋๋ค.
๐ก ์์๋ฅผ ์งํค์ธ์: ๋ฌธ์ ์์ โ ๋ฆฌ๋ทฐ โ ์ฝ๋ ์์ โ ํ๊ท ํ
์คํธ. ์ฝ๋๋ถํฐ ๊ณ ์น๋ฉด Spec-First๊ฐ ์๋๋๋ค.
๊ฐ์ ๊ฐ์ด๋ ํ์ธ
Phase 6
์์
์ด๋ ฅ ๊ธฐ๋ก ๋ฐ ํ๊ณ ๋ฐํ
CONVERSATION.md์ ํ๋กฌํํธ ๋ฐ ๊ฒฐ์ ์ด๋ ฅ์ ๊ธฐ๋กํ๊ณ 5๋ถ ์ต์ข
๋ฐํ๋ฅผ ์งํํฉ๋๋ค.
ํต์ฌ ๊ฒฐ๊ณผ๋ฌผ์ฌํ ๊ฐ๋ฅํ ์์
๊ธฐ๋ก๊ณผ 5๋ถ ํ๋ก์ ํธ ๋ฐํ
์ค์ ๊ธฐ์ค๋ฌด์์ ๋ง๋ค์๋์ง๋ณด๋ค ์ ๊ทธ๋ ๊ฒ ํ๋จํ๋์ง ์ค๋ช
ํ๋๊ฐ?
๐งฐ gstack ํ์ฉ ยท Reflect
- /document-release ์ต์ข
์ฝ๋์ ๋ง์ถฐ ๊ธฐํ ๋ฌธ์์ README๋ฅผ ์
๋ฐ์ดํธํด ๋ฌธ์์ ์ฌ์ดํธ๋ฅผ ์ผ์น์ํต๋๋ค.
- /retro ์์
์ด๋ ฅ์ ๋ฐํ์ผ๋ก ์๋ ์ ยท์์ฌ์ด ์ ยท๋ค์ ๊ฐ์ ์ ์ ์ ๋ฆฌํด ๋ฐํ ์๋ฃ๋ก ์๋๋ค.
๐ก ๋ฐํ์์๋ ๊ฐ ํ์ด์ฆ์์ ์ด๋ค gstack ์คํฌ์ ์ผ๊ณ , ๊ทธ ๊ฒฐ๊ณผ ์ค ๋ฌด์์ ์ฑํยท๊ฑฐ์ ํ๋์ง์ ๊ทธ ์ด์ ๋ฅผ ์ค๋ช
ํฉ๋๋ค.
ํ๊ณ ๋ฐ ๋ฐํ ๊ฐ์ด๋