refs #732: polish HMM report title and response

docs/design/hmm-html-report-mcp/troubleshooting.md

@@ -35,6 +35,31 @@
 **해결**: DB 템플릿 활성 상태와 custom Agent Tool의 반환 형식을 확인한다. 포털은 유효한 `html`
 또는 `rendered_html`만 sandboxed iframe으로 표시한다.
 
+## 일반 답변에 HTML 표가 반복되거나 글자가 잘 보이지 않음
+
+**원인**: 최종 답변 모델이 사용자의 `HTML로 보여줘`를 artifact 생성이 아니라 답변 본문 형식
+요청으로 해석해 `<table>` 또는 Markdown 표를 다시 작성했다.
+
+**확인**: MCP 마지막 응답에 유효한 `html`이 있으면서 저장된 `answer`에도 HTML 태그나 표 행이
+있는지 확인한다.
+
+**해결**: 최종 답변 지침에 HTML artifact 우선 규칙을 적용하고, 출력 후 검사에서 일반 답변을
+생성 완료·제목·조회 건수 안내로 정규화한다. iframe CSS나 조회 Tool은 변경하지 않는다.
+
+**재발 방지**: renderer가 반환된 시나리오에서 일반 답변에 `<table>`과 Markdown 표가 없는지
+회귀 테스트한다.
+
+## 리포트 제목에 질문 전체 문장이 표시됨
+
+**원인**: `report.title`에 사용자 질문을 그대로 복사했다.
+
+**확인**: renderer 호출의 `reportJson.report.title`과 `question`이 완전히 같은지 확인한다.
+
+**해결**: 제목 생성 지침으로 출력 형식·행동 문구를 제거한 짧은 명사형 제목을 만들고,
+`report.question`에는 원문을 유지한다.
+
+**재발 방지**: 제목과 원문 질문이 역할상 분리되고 제목 길이 제한이 적용되는지 검증한다.
+
 ## 리포트는 생성됐지만 행이 0건임
 
 **원인**: 다음 둘 중 하나다.