HTML 문서
HTML은 브라우저에서 표현할 수 있는 결과를 자유롭게 만드는 범용 문서 유형입니다. 정해진 양식이나 용도에 한정되지 않으며, 프로젝트의 목적에 맞게 정보의 구성, 디자인과 표현 방식을 결정할 수 있습니다.
HTML로 만들 수 있는 것
예를 들면 다음과 같은 결과를 만들 수 있습니다.
- 보기 좋게 구성한 문서와 보고서
- 제품·서비스 소개 페이지
- 화면 시안과 프로토타입
- 대시보드와 현황판
- 가이드와 설명 자료
- 데이터와 조사 결과를 보여주는 페이지
- 발표나 데모에 사용할 결과물
- 프로젝트에 필요한 그 밖의 웹 기반 콘텐츠
이 목록은 HTML의 용도를 제한하지 않습니다. 브라우저에서 표현하는 편이 적합한 결과라면 목적에 맞게 구성할 수 있습니다.
만들기 전에
먼저 무엇을 전달하거나 확인하기 위한 HTML인지 정합니다.
- 대상 독자는 누구인가
- 전달할 핵심 내용은 무엇인가
- 어떤 자료와 결정을 기준으로 하는가
- 읽기 중심인지, 시각적 설명이나 상호작용이 필요한지
- 완성된 결과를 어디에서 어떻게 사용할 것인가
목적과 관련 없는 구성이나 효과를 관성적으로 추가하지 않습니다.
Agent로 만들기
[프로젝트 이름]의 기준 문서와 관련 자료를 읽고, [목적]에 사용할 HTML 문서를 만들어줘.
원하는 분위기, 구성, 포함할 내용과 사용 목적이 있다면 함께 설명합니다.
[대상 사용자]에게 [핵심 내용]을 전달할 수 있도록 구성하고, [원하는 표현 방식]으로 만들어줘.
Agent는 완전한 HTML 문서를 생성하고 기존 HTML 문서를 갱신할 수 있습니다. 같은 목적의 문서가 이미 있다면 새로 만들지 않고 현재 문서를 확인합니다.
프로젝트 자료 사용하기
HTML은 같은 프로젝트의 Markdown, File, Diagram, OpenAPI와 ERD 내용을 바탕으로 만들 수 있습니다. 원본 자료를 그대로 나열하기보다 사용 목적에 맞게 구조화하고 표현합니다.
HTML에 표현된 내용이 프로젝트의 새로운 기준이 되는 것은 아닙니다. 새 결정이나 변경된 사실은 Markdown 기준 문서에도 반영합니다.
검토하기
HTML의 목적에 맞춰 다음을 확인합니다.
- 전달하려는 내용이 정확한가
- 프로젝트의 현재 기준과 일치하는가
- 정보 구조와 표현 방식이 대상 독자에게 적합한가
- 연결된 자료와 근거가 최신인가
- 포함하지 않아야 할 정보나 비밀값이 없는가
- 실제 브라우저에서 의도한 결과로 보이는가
화면 프로토타입이라면 사용자 흐름과 동작을, 보고서라면 내용과 가독성을, 소개 자료라면 메시지와 시각적 전달력을 중심으로 검토합니다.
갱신과 공유
내용이나 목적이 이어지는 경우에는 기존 HTML을 갱신합니다. 다른 결과를 별도로 보존해야 할 때만 새 문서를 만듭니다.
공유하기 전에는 문서에 포함된 정보, 외부 자원과 공개 범위를 확인합니다. 검토에서 발견한 결정과 후속 작업은 Markdown과 Kanban에 다시 연결합니다.
다음 단계
흐름과 관계를 별도의 구조로 설명해야 한다면 Diagram을 확인하세요.