html-brieflisted

# html-brief 조사·검토 결과를 **사람이 빠르게 읽고 AI가 근거를 다시 확인할 수 있는 단일 HTML 문서**로 만든다. 이 스킬은 예쁜 웹페이지를 만드는 스킬이 아니다. 독자가 문서를 처음 열었을 때 아래 세 가지가 분명해야 한다. 1. 결론 또는 결정할 내용이 무엇인가. 2. 그 판단을 바꾸는 핵심 근거와 제약은 무엇인가. 3. 원문을 어디서 다시 확인할 수 있는가. ## 적용 범위 - **의사결정 모드**: 수신자가 선택·승인·제외 범위를 결정해야 할 때. - **보고 모드**: 조사, 기술 검토, 작업 결과를 본인이나 내부 수신자가 이해하고 재사용해야 할 때. 다음에는 적용하지 않는다. - 마케팅 랜딩 페이지, 제품 화면, 대시보드, 웹앱 - 사용자가 HTML을 요구하지 않은 일반 대화 답변 - 내용 구조는 그대로 두고 파일 형식만 바꾸는 단순 변환 ## 모드 선택 독자가 문서를 읽고 **무엇인가를 골라야 하면 의사결정 모드**, 결론과 근거를 **이해하거나 후속 작업에 사용하면 보고 모드**다. 모호하면 독자에게 요구되는 행동을 기준으로 판단하고, 결과물에 선택한 모드를 표시한다. 두 모드의 필수 구조와 `brief-data` JSON 형식은 [references/modes.md](references/modes.md)를 읽고 따른다. ## 작성 원칙 ### 결론부터 쓴다 첫 화면에 제목, 한 문장 결론, 수신자, 기준일을 둔다. 조사 과정이나 배경 설명으로 시작하지 않는다. 문서 전체의 중심 문장은 하나만 정하고 나머지는 그 문장을 입증하거나 실행하는 정보로 제한한다. ### 사실·해석·권고를 구분한다 - **사실**: 원문으로 확인 가능한 내용. 가까운 위치에 출처 ID를 붙인다. - **해석**: 여러 사실에서 도출한 판단. “이 문서의 해석”임을 드러낸다. - **권고**: 비용·위험·효과를 비교해 제안한 행동. 판단 기준을 함께 쓴다. 시점에 따라 달라질 수 있는 사실은 현재 제공된 웹 검색·페이지 읽기 도구로 다시 확인한다. 공식 문서·법령·제품 원문 같은 1차 자료를 우선하고, 실제로 연 URL과 확인일을 남긴다. 근거가 부족하면 단정하지 않고 한계를 적는다. ### 기존 자료를 보존한다 기존 신청서·보고서·계획서를 입력으로 받았을 때는 사용자가 명시적으로 덮어쓰라고 하지 않는 한 수정하지 않는다. 날짜나 버전을 포함한 새 HTML 파일을 만들고, 결과물에 “기존 문서 보존 / 신규 문서” 여부를 표시한다. ### 읽을 가치가 있는 정보만 남긴다 수신자가 결정하거나 다음 행동을 하는 데 필요 없는 조사 로그, 장황한 배경, 비슷한 표현의 반복은 제외한다. 전문용어는 독자 수준에 맞게 처음 한 번만 풀어 쓰되, 해당 분야 독자에게 익숙한 용어를 억지로 바꾸지 않는다. ## 작업 흐름 ### 1. 입력과 기존 자산 확인 현재 하네스가 읽는 프로젝트 지침 파일(`AGENTS.md`, `CLAUDE.md` 등) 중 현재 경로에 가장 가까운 적용 범위를 따른다. 기존 문서·