가이드 · Claude Code workflow

Claude Code HTML Plan: 시각적 명세가 주목받은 이유

2026년 Anthropic의 Claude Code 엔지니어 Thariq Shihipar는 Markdown을 넘어 비교, mockup, 작은 interaction을 담은 HTML spec을 보여 줬습니다. Agent를 더 똑똑하게 만드는 게 아니라 사람이 계획을 더 잘 읽게 하는 접근입니다.

업데이트 2026년 8월 3일실전 가이드

HTML plan의 출발점

How I AI 인터뷰와 Code with Claude 행사에서 rich HTML specs와 micro UI가 소개되며 Claude Code HTML plan이라는 검색 의도가 선명해졌습니다.

HTML이 더하는 것

  1. 대안 나란히 비교
  2. component hierarchy와 states
  3. flow·chart·responsive intent
  4. 비개발 리뷰어 참여

HTML만으로 해결되지 않는 것

facts, permissions, formal revisions, blocking decision은 자동으로 생기지 않습니다. script와 remote resources에는 보안 비용도 있습니다.

게시 경로를 의도적으로 선택

원본 HTML을 보존하려면 artifact host, 장기 유지·인용·review에는 typed document를 씁니다. 변환물을 original fidelity라고 부르지 않습니다.

OpenWiki의 governed alternative

scope, evidence, risk, approval request를 .mdw로 만들고 check·build·digest·--review를 실행합니다. HTML prototype과 연결하더라도 두 artifact임을 밝힙니다.

# Ask the Agent to author the supported typed plan, then:
ow a2ui draft check ./plan
ow a2ui draft build ./plan
ow a2ui digest ./plan/document.mdw
ow publish ./plan/document.mdw --review --no-open --timeout 900

FAQ

자주 묻는 질문

HTML plan을 널리 알린 사람은 누구인가요?

Anthropic Claude Code 팀의 Thariq Shihipar가 2026년 How I AI 인터뷰에서 소개했습니다.

OpenWiki에 HTML plan을 바로 게시할 수 있나요?

아니요. Hosted는 .mdw만 받습니다.

HTML이 항상 Markdown보다 낫나요?

아닙니다. visual structure가 리뷰를 개선할 때만 유리하고 짧은 diff-friendly 문서는 text가 더 적합합니다.

출처 및 추가 자료

실제 워크플로 사용

에이전트가 만든 작품을 발표하세요.

리포트, 문서, 계획마다 독자를 위한 페이지를 만들고 코멘트, 검토 결정, 공식 개정을 에이전트에게 돌려보내세요.