ํ๋ก์ ํธ ์งํ ์ค ์์ฑ๋ ์ฝ๋๋ฅผ PR ์ด์ ์ ํ์ง ๊ด์ ์์ ๋ฆฌ๋ทฐํ๋ค. ๋ณ๊ฒฝ๋ถ(git diff)์ ๋์์ผ๋ก pilot-code-review ์์ด์ ํธ๋ฅผ ํธ์ถํ๋ฉฐ, ๊ฒฐํจ๋ง๋ค severity ์ ์ฌ์ง์ ๋ผ์ฐํ (feature/planner/generator)์ ์ ์ํ๋ค. evaluator ์ ์๊ตฌ์ฌํญยท๊ฒ์ดํธ ํ์ ๊ณผ๋ ๋ณ๊ฐ ์ถ์ด๋ค.
์ฌ์ฉ์๊ฐ "PR ์ฌ๋ ค์ค", "ํ ๋ฆฌํ์คํธ ์์ฑ" ๋ฑ ํ์ฌ ๋ธ๋์น๋ฅผ GitHub Pull Request ๋ก ์ฌ๋ฆฌ๊ธธ ์์ฒญํ ๋ ์ฌ์ฉํ๋ค. base branch ๋ stateยทconfigยท ๊ณตํต config ์์ผ๋ก ์๋ ๊ฒฐ์ ํ๋ฉฐ ์ฌ์ฉ์ ๋ช ์ ์ ๋ ฅ ์ state ์ ์ ์ฅํ๋ค. ์ ๋ชฉยท๋ณธ๋ฌธ ์ปจ๋ฒค์ ์ `skills/context/shared/pr.md` ๋ฅผ ๋ฐ๋ฅธ๋ค.
์ด๋ฏธ ์ ์ฅ๋ docs/ ๊ธฐํ์๋ฅผ features/ ๊ธฐ๋ฅ ๋ช ์ธ๋ก ๋ถํ ยท๊ตฌ์กฐํํ ๋ ์ฌ์ฉํ๋ค. PM ์์ฑ ํ ์ค์ฌ ๊ธฐํ์๋ฅผ ๊ธฐ๋ฅ ๋จ์ ๋ฌธ์๋ก ๋ณํํ๊ณ project.md ์ ๋ชฉํ ์น์ ๊ณผ prompts/ ํ์ผ(plannerยทgeneratorยทevaluator)์ ์๋ ๊ฐฑ์ ํ๋ค. ๊ธฐํ์ fetch ๋ `/pilot:confl`, ํ๋กฌํํธ ๊ธฐ๋ฐ ๋จ์ผ ๊ธฐ๋ฅ ์ถ๊ฐ๋ `/pilot:create-feature` ๋ฅผ ์ฌ์ฉํ๋ค.
์ฌ์ฉ์๊ฐ "์ปค๋ฐํด์ค", "๋ณ๊ฒฝ ๋ฌถ์ด์ ์ปค๋ฐ" ๋ฑ git ์ปค๋ฐ ์์ฑ์ ์์ฒญํ ๋ ์ฌ์ฉํ๋ค. ๋ณ๊ฒฝ ํ์ผ์ ํ์ธํ๊ณ `skills/context/shared/commit.md` ๊ท์น(scope ํ๊ธฐ, ํ๊ตญ์ด ๋ณธ๋ฌธ, 50์ ์ด๋ด ์์ฝ)์ ๋ง์ถฐ ๋ฉ์์ง๋ฅผ ์์ฑํด ์ปค๋ฐํ๋ค. unstaged ํ์ผ์ด ์์ผ๋ฉด ํฌํจ ์ฌ๋ถ๋ฅผ ์ฌ์ฉ์์๊ฒ ํ์ธํ๋ค.
Confluence ๊ธฐํ์๋ฅผ ํ๋ก์ ํธ docs/ ํด๋์ fetch ํ๊ฑฐ๋ ์ ์ฅ๋ docs/ ๋ฅผ searchยทallยทsearch+action ๋ชจ๋๋ก ์กฐํํ ๋ ์ฌ์ฉํ๋ค. ์ ์ฅ๋ docs/ ๋ฅผ features/ ๋ก ๊ฐ๊ณตํ๋ ์์ ์ `/pilot:analyze` ๊ฐ ๋ด๋นํ๋ค.
ํ์ฑ ํ๋ก์ ํธ์ ์ฌ์ฉ์ ํ๋กฌํํธ ํ ์ค๋ก ๋จ์ผ feature ๋ช ์ธ๋ฅผ ์ถ๊ฐํ ๋ ์ฌ์ฉํ๋ค. features/NN-{slug}.md ๋ฅผ prompt-origin ํ ํ๋ฆฟ์ผ๋ก ์์ฑํ๊ณ `/pilot:analyze` ์ ๋์ผํ๊ฒ project.md (๋ชฉํยท๊ด๋ จ ํ์ผ) ์ prompts/* (plannerยทgeneratorยทevaluator) ๋ฅผ ํจ๊ป ๋๊ธฐํํ๋ค. ๊ธฐํ์(docs/) ๊ธฐ๋ฐ ๋ค๊ฑด ๋ถํ ์ `/pilot:analyze` ๋ฅผ ์ฌ์ฉํ๋ค. ์คํ์ @pilot-planner ํธ์ถ๋ก ์์ โ ์๋ ํ์ดํ๋ผ์ธ ์๋.
pilot ์ํฌ์คํ์ด์คยทํ๋ก์ ํธ์ ์ ํฉ์ฑ์ ๊ฒ์ฌํ๋ค. ์ํ ์ด์ยท๋๋ฆฌํํธยท ๋ถ๋ถ ์ค์ ์ด ์์ฌ๋ ๋, ๋๋ ์ ๊ธฐ ์ ๊ฒยท์ง๋จ์ ์ํ ๋ ์ฌ์ฉํ๋ค. STATE.mdยทMANIFEST.mdยทconfig.md ์กด์ฌ ์ฌ๋ถ, `.agent-state.yml` ์คํค๋ง, `analyzed`ยท`tdd` ํ๋๊ทธ๊ฐ ์ค์ ํ์ผ ์ํ์ ์ผ์นํ๋์ง ๊ฒ์ฌํด STATE corrupt ๊ฐ์ ์กฐ์ฉํ ๋ฌธ์ ๋ฅผ ์กฐ๊ธฐ ๊ฐ์งํ๋ค.
์ ์ํฌ์คํ์ด์ค ์ ์ โ `workspace/` ๊ตฌ์กฐ๋ฅผ ์ด๊ธฐํํ๋ค. `workspace/STATE.md` ์ `workspace/context/` ํ์์ `MANIFEST.md`ยท`config.md` ์ค์ผ๋ ํค์ ์ผ๊ด ์์ฑํ๋ค. ์ฒ์ pilot ์ ๋์ ยท์ ์ ํ ๋ ์ฌ์ฉํ๋ค.