Skip to content

docs(guides): 로컬 개발 환경 가이드 신설 (dev) — #200 Layer 3 dev-setup deep-link 타깃#130

Merged
DaveDev42 merged 1 commit into
mainfrom
feat/guide-dev-environment-200
Jun 26, 2026
Merged

docs(guides): 로컬 개발 환경 가이드 신설 (dev) — #200 Layer 3 dev-setup deep-link 타깃#130
DaveDev42 merged 1 commit into
mainfrom
feat/guide-dev-environment-200

Conversation

@DaveDev42

Copy link
Copy Markdown
Contributor

무엇을

station 2(dev)의 로컬 개발 환경 셋업을 다루는 가이드 guides/dev-environment를 ko+en으로 신설합니다.

왜 — agent-plugin #200 Layer 3

agent-plugin §1.3.4("skill 말미 docs 링크는 docs.aitc.dev/<주제>로 deep-link 필수")의 마지막 미준수 3종이 deep-link할 대상 페이지가 없어 DOCS_DEEPLINK_EXEMPT에 임시 등재돼 있습니다:

  • inject-devtools — 브라우저 SDK mock unplugin 주입
  • inject-polyfill — 표준 Web API → SDK 라우팅 shim
  • setup-phone-preview — 실기기 PWA 미리보기 (환경 2)

ship/operate skill의 deep-link 타깃으로 ship-mini-app·operate-mini-app 가이드가 authoring된 것과 동일한 패턴으로, 이 3개 dev-setup skill을 한 가이드로 묶습니다. 이 PR이 머지·배포되면 후속 agent-plugin PR에서 3개 skill에 deep-link를 박고 exempt set에서 제거할 수 있습니다(존재하지 않는 페이지로 deep-link하면 404 — 페이지 authoring이 선행).

내용

  • §1.1 fidelity 사다리 framing — 환경 1(브라우저 mock) → 환경 2(실기기 PWA), 각 셋업이 어느 겹을 채우는지
  • 세 셋업이 실제로 패치하는 파일(SKILL.md 기반 정확 기술), 언제 어느 셋업을 쓰는지 분기
  • 더 위 겹(실 토스 앱 WebView 디버깅)은 debug-relay 가이드로 hand-off
  • quick-tunnel 공개 URL :::caution + relay TOTP 인증 cross-ref

검증

로컬 전수 green: check:og-images(297), verify:crosslinks, build:llms(19→20 guides), coverage:check, typecheck, lint, build(ko+en, broken-link 0).

후속 (별도 PR, 이 repo 아님)

agent-plugin: 3개 skill SKILL.md에 docs.aitc.dev/guides/dev-environment deep-link 추가 + DOCS_DEEPLINK_EXEMPT에서 3종 제거 → validate-plugin green 유지. 그 PR이 #200을 닫습니다.

…preview deep-link 타깃 (#200 Layer 3)

agent-plugin §1.3.4(skill 말미 docs deep-link 필수)의 마지막 미준수 3종
(inject-devtools·inject-polyfill·setup-phone-preview)이 deep-link할 dev-setup
주제 페이지가 없어 DOCS_DEEPLINK_EXEMPT에 임시 등재돼 있었다. ship-mini-app·
operate-mini-app가 ship/operate skill 타깃으로 authoring된 것과 같은 패턴으로,
dev station 셋업 3종을 한 가이드로 묶는다.

- guides/dev-environment.mdx (ko + en mirror, 동등 정본)
- fidelity 사다리(§1.1) 환경 1·2 framing — 브라우저 mock / 표준 Web API / 실기기 PWA
- sidebar Guides 카테고리 알파벳순 삽입 (debug-relay 다음)
- OG PNG 생성 + image: frontmatter 주입, llms.txt 재생성 (19→20 guides)

검증: check:og-images(297), verify:crosslinks, build:llms, coverage:check,
typecheck, lint, build(ko+en, broken-link 0) 전부 green.

후속(별 PR): agent-plugin에서 3개 skill에 이 가이드 deep-link 추가 +
DOCS_DEEPLINK_EXEMPT에서 제거 → validate-plugin green 유지.
@DaveDev42
DaveDev42 merged commit a757674 into main Jun 26, 2026
3 checks passed
@DaveDev42
DaveDev42 deleted the feat/guide-dev-environment-200 branch June 26, 2026 22:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant