๋ฐฑ์๋ ๋ณ๊ฒฝ์ด architecture boundary, dependency direction, policy, TDD ๊ฒฐ์ ์ ๋ง๋์ง ๋ ๋ฆฝ ๊ฒํ ํด์ผ ํ ๋ ์ฌ์ฉํ๋ ๋ฆฌ๋ทฐ ๊ท์น.
๋ฐฑ์๋ ์ฝ๋๋ฅผ ์๊ตฌ์ฌํญ๊ณผ ์ค๊ณ ๊ฒฐ์ ์ ๋ง๊ฒ ์์ ํ๊ณ compile/test/typecheck ๊ฐ์ ๊ตฌํ ๊ฒ์ฆ evidence๋ฅผ ๋จ๊ฒจ์ผ ํ ๋ ์ฌ์ฉํ๋ ๊ตฌํ ๊ท์น.
๋ฐฑ์๋ ๊ตฌํ ์ ์ ์ํคํ ์ฒ ํ๋จ, ๊ณ์ธต ์ฑ ์, ํธ๋์ญ์ , ์ ํฉ์ฑ, ์คํจ ์ฒ๋ฆฌ, ๋์์ฑ, ๊ฒ์ฆ ๊ณํ์ ๊ธฐ์ ์ค๊ณ๋ฌธ์๋ก ์ ๋ฆฌํด์ผ ํ ๋ ์ฌ์ฉํ๋ ์์ฑ ๊ท์น.
ํ๋ก ํธ์๋ ๋ณ๊ฒฝ์ด architecture, conventions, performance, UI/UX ๊ธฐ์ค์ ๋ง๋์ง ๋ ๋ฆฝ ๊ฒํ ํด์ผ ํ ๋ ์ฌ์ฉํ๋ ๋ฆฌ๋ทฐ ๊ท์น.
UI, route/page, component, client state, API client, query/cache ์ฝ๋๋ฅผ ์๊ตฌ์ฌํญ๊ณผ ์ค๊ณ ๊ฒฐ์ ์ ๋ง๊ฒ ์์ ํ๊ณ ๊ตฌํ ๊ฒ์ฆ evidence๋ฅผ ๋จ๊ฒจ์ผ ํ ๋ ์ฌ์ฉํ๋ ๊ตฌํ ๊ท์น.
ํ๋ก ํธ์๋ ๊ตฌํ ์ ์ ์ฌ์ฉ์ ํ๋ฆ, route, component, state, API, cache, error, browser ๊ฒ์ฆ ๊ณํ์ ๊ธฐ์ ์ค๊ณ๋ฌธ์๋ก ์ ๋ฆฌํด์ผ ํ ๋ ์ฌ์ฉํ๋ ์์ฑ ๊ท์น.
feature delivery ์์ฒญ์์ product planning, API contract, backend/frontend delivery engineer subagent๋ฅผ ์ค์ผ์คํธ๋ ์ด์ ํ๊ณ ๊ฒฐ๊ณผ๋ฅผ ํตํฉํ ๋ ์ฌ์ฉํ๋ค. subagent๊ฐ ๋ค๋ฅธ subagent๋ฅผ ํธ์ถํ ์ ์๋ runtime์์ fullstack ๊ธฐ๋ฅ ์ ๋ฌ ์ค์ผ์คํธ๋ ์ด์ ์ด ํ์ํ ๊ฒฝ์ฐ ์ฌ์ฉํ๋ค.
Analyze an existing backend codebase and update `docs/backend` so architecture, policies, strategies, getting-started notes, and design documentation reflect actual code instead of generic playbook assumptions.