템플릿 XML 문서란?
템플릿 XML 문서는 PRD, 업무 보고서, 회의록, 제안서처럼 정해진 양식을 가진 문서입니다.
Markdown 문서와 다르게 원문은 XML 구조를 따르고, 미리보기는 템플릿 렌더러가 XML 값을 읽어 생성합니다.
안전한 수정 기준
- 태그 이름과 계층은 임의로 바꾸지 않습니다.
- 문장, 수치, 일정, 담당자처럼 실제 값 중심으로 수정합니다.
- 긴 문단을 넣을 때는 미리보기에서 줄바꿈과 페이지 나눔을 확인합니다.
- XML 오류가 생기면 최근 수정한 태그부터 확인합니다.
XML 원문 구조를 읽는 방법
템플릿 XML은 태그가 문서 섹션의 의미를 나타냅니다. 태그 이름은 템플릿 렌더러가 값을 찾는 기준이므로 임의 변경을 피해야 합니다.
문장만 수정할 때는 태그 안의 텍스트만 바꾸고, 섹션을 삭제하거나 추가할 때는 같은 계층의 여는 태그와 닫는 태그를 함께 관리합니다.
<document>
<title>문서 제목</title>
<summary>문서 요약</summary>
<section>
<heading>섹션 제목</heading>
<body>섹션 본문</body>
</section>
</document>XML 검증 상태 이해
| 상태 | 의미 | 해야 할 일 |
|---|---|---|
| 유효 | 템플릿이 XML을 읽을 수 있음 | 미리보기와 내보내기 결과 확인 |
| 구문 오류 | 닫히지 않은 태그 또는 잘못된 문자 | 오류 위치 근처의 태그 수정 |
| 구조 불일치 | 템플릿이 기대하는 섹션이 없음 | 원본 템플릿 XML과 비교 |
| 내용 누락 | 필수 값이 비어 있음 | 미리보기에서 빈 영역 확인 |
서식 정리와 원문 복사
- 서식 정리는 들여쓰기와 줄바꿈을 정리해 XML 구조를 읽기 쉽게 만드는 작업입니다.
- 서식 정리 후에도 미리보기와 검증 상태가 유지되는지 확인합니다.
- 원문 복사는 외부 검토, 백업, AI 도구 사용 전에 활용합니다.
- 복사한 XML을 메신저나 문서 도구에 붙여 넣을 때 민감정보가 포함되어 있지 않은지 확인합니다.
템플릿별 작성 포인트
| 템플릿 | 핵심 작성 기준 | 검토 포인트 |
|---|---|---|
| PRD | 문제 정의, 목표, 요구사항, 성공 지표를 분리 | 요구사항과 해결책이 섞이지 않았는지 확인 |
| 업무 보고서 | 성과, 이슈, 다음 액션을 짧게 정리 | 수치와 담당자, 기한이 빠지지 않았는지 확인 |
| 회의록 | 논의 내용보다 결정 사항과 액션 아이템 중심 | 담당자와 due date가 명확한지 확인 |
| 제안서 | 고객 문제, 제안 범위, 기대 효과를 연결 | 과장 표현과 근거 없는 수치를 제거 |
| 기술 문서 | 환경, 절차, 제한사항, 예외 처리를 분리 | 재현 가능한 단계인지 확인 |
| 릴리즈 노트 | 변경 사항, 영향 범위, 주의사항을 구분 | 사용자에게 필요한 조치가 명확한지 확인 |
내보낸 XML 다시 사용
- 문서 편집 화면에서 XML 원문을 내보냅니다.
- 다음 수정 시 동일한 템플릿을 선택합니다.
- 기존 XML 원문을 편집기에 붙여 넣습니다.
- XML 검증 상태와 미리보기를 확인합니다.
- 수정 후 HTML, PDF, XML을 다시 내보냅니다.
AI와 함께 수정할 때
AI assistant는 XML 수정안을 만들 수 있지만, 문서 목적과 사실관계를 대신 보장하지 않습니다.
AI가 반환한 XML은 반드시 검증 상태와 미리보기를 확인한 뒤 적용해야 합니다.
- 요청에는 수정 범위와 유지해야 할 구조를 함께 적습니다.
- AI 응답의 변경 요약과 주의사항을 먼저 읽습니다.
- XML 검증 실패 상태에서는 적용하지 않습니다.
- 고객 정보, API key, 내부 secret이 포함된 문서는 AI 요청 전에 제외합니다.
