원문: 탄글 2026 영어 프롬프트와 개발 과정 설계 — AI조씨(Notion) · 수집일: 2026-10-15
핵심 요지
- “탄글 2026”은 HWP·HWPX·DOC·DOCX를 하나의 편집기에서 읽고, 편집하고, 레이아웃을 유지한 채 저장하려는 개인 독립 프로젝트다. 이 페이지는 그 개발 과정을 코딩 에이전트에게 맡기려고 쓴 영어 프롬프트 6개(전체 방향 1개 + 단계별 5개)에 한국어 해설을 붙인 강의자료다.
- 도구는 셋으로 나눠 쓴다. Agent-Reach로 공개 웹·이미지 자료를 찾고, REA로 분석 근거와 남은 질문을 정리하고, imagegen으로 자체 아이콘을 만든다. 저자는 “REA는 웹·이미지 검색을 대신하는 검색 엔진이 아니다”라고 따로 짚는다.
- 모든 프롬프트에 같은 원칙이 깔려 있다. 관찰(보인 것)·추론(그럴 것 같은 것)·미확인(따로 검증할 것)을 나누고, 검증한 범위만 “지원한다”고 보고하게 한다. 예를 들어 화면에 ‘셀 합치기’ 버튼이 있다는 것은 관찰이고, 저장 뒤에도 병합이 유지되는지는 미확인이다.
- 저자는 이 문서가 과정 설계일 뿐, 도구를 실제로 돌린 이력이나 기능 완성 보고가 아니라고 여러 번 밝힌다. 기존 Windows 개발판에는 23쪽 HWPX 문서의 편집 누락과 조판 차이가 아직 남아 있다.
주요 내용
개발 과정 6단계
- Agent-Reach로 공개 문서·웹·이미지를 찾고, REA로 분석 가능한 자료와 기능의 근거를 정리한다.
- 확인한 기능을 사용자 작업, 입력·저장 조건, 오류 상황, 수용 기준으로 바꾼다.
- 네 형식이 함께 쓰는 문서 모델, 레이아웃 엔진, 독립적인 편집 화면을 설계한다.
- imagegen으로 앱 아이콘과 도구 아이콘을 만들어 탄글 디자인 기준에 맞춘다.
- 원본 문서의 수정 위치와 화면의 글자 위치를 연결해 본문·표 셀·개체를 편집한다.
- 새 복사본으로 저장하고 다시 열어, 형식별 호환성과 수정 전후 레이아웃을 비교한다.

전체 방향 프롬프트 (마스터 프롬프트)
조사부터 저장 검증까지 한 기준으로 묶는 프롬프트다. 다시 쓸 일이 가장 많은 부분이라 원문 그대로 옮긴다.
Design and develop TANGEUL 2026, an independently developed document editor
for private personal and educational use.
Use Agent-Reach and REA as the research and reverse-engineering toolchain.
Use public web searches, image searches, official documentation, screenshots,
file-format specifications, and explicitly authorized artifacts as evidence.
Keep source URLs, artifact hashes, observations, inferences, and unknowns separate.
Check tool availability before describing a research phase as executed.
Build one consistent editing application targeting HWP, HWPX, DOC, and DOCX.
Provide a separate import and export strategy for each format.
DOC is a distinct legacy binary format; DOCX support must not imply DOC support.
Preserve text, fonts, character and paragraph formatting, lists, tables,
merged cells, images, object anchors, margins, sections, and pagination.
Maintain stable layout when entering or leaving an editing operation.
Distinguish legitimate reflow caused by changed content from unintended drift.
Prioritize editing. One click must place the caret at the clicked text position.
Keep paragraphs, table cells, lists, and supported text-bearing objects editable.
Provide continuous vertical page scrolling, rulers, indentation, page margins,
alignment, grids, and platform-appropriate page-break shortcuts.
Keep toolbar values, visible glyphs, caret geometry, and the edited source aligned.
Create original application and toolbar icons with imagegen.
Use an independent TANGEUL design system, with assets readable at real toolbar sizes.
Treat document-format compatibility separately from application branding and UI identity.
Preserve original input files. Save edited documents as new copies.
Use source-owned transactional edits and format-appropriate serialization.
Preserve unmodified resources and unknown data when safe.
Never silently flatten editable text into images or rename an unrelated format.
Saved HWP and HWPX files must satisfy the applicable Hancom 2022 acceptance checks.
Saved DOC and DOCX files must satisfy the applicable Microsoft Word checks.
Record format validation separately from verified consumer acceptance.
Use verified results or authorized external verification evidence for these claims.
Implement Windows first and keep the architecture portable to macOS.
Report actual implementation, tested samples, known limitations, and remaining work.
Do not claim complete layout fidelity, universal compatibility, DOC support,
or macOS validation until the relevant acceptance tests have passed.단계별 프롬프트 5종
각 프롬프트의 전문은 raw 원본에 있다. 여기서는 무엇을 시키는지만 정리한다.
| 단계 | 시키는 일 | 눈여겨볼 제약 |
|---|---|---|
| 공개 웹·이미지 근거 조사 | 열기·저장, 글꼴, 문단, 표 병합, 그림, 단축키 등 기능별로 근거 출처·외형·문서상 동작·추론·미해결 질문을 기록한 evidence ledger와 우선순위 백로그를 만든다 | 스크린샷은 외형만 입증하고 숨은 동작이나 파일 형식 의미는 입증하지 못한다. 계획한 도구 사용을 완료한 작업처럼 쓰지 않는다 |
| 요구사항·독립 UI 설계 | 기능마다 사용자 작업, 기대 동작, 근거, 우선순위, 지원 형식, 수용 기준을 정한 제품 사양을 쓰고, 네 형식이 함께 쓰는 편집 화면을 설계한다 | 한 번 클릭하면 그 자리에 캐럿이 놓이고, 편집해도 레이아웃이 흔들리지 않아야 한다. 구현됨·미지원·미검증을 따로 적는다 |
| 문서 모델·레이아웃 보존 | 화면 좌표와 별개로 원본의 의미적 주소(semantic source address)를 유지하는 문서 모델과 렌더링 파이프라인을 만들고, 형식별 parser·writer를 둔다 | ”가장 가까운 같은 문자열”로 원본을 찾아 묶지 않는다. 23쪽 HWPX 보고서를 수용 기준 문서로 쓰고, 정상 재배치와 의도치 않은 어긋남을 구분한다 |
| imagegen 아이콘·시각 자산 | 앱 아이콘과 툴바 아이콘 묶음을 만든다. 팔레트는 ffffff·#181b20·#5c626c·#dcdfe4·#315bef로 지정한다 | 16·20·24·32px과 밝은/어두운 배경에서 알아볼 수 있는지 확인한다. 한컴·MS 아트워크는 쓰지 않는다. 앱 화면에서 확인한 뒤에만 “통합 완료”로 적는다 |
| 편집·저장 호환성 | 텍스트·표 편집, 서식, 검색·치환, undo/redo, 트랜잭션 저장을 구현하고, 바뀐 위치와 주변 보존, 새 복사본 재열기를 검증한다 | 형식 검사(standards check)와 실제 앱에서의 수용(한글 2022·Word)을 다른 증거로 다룬다. 텍스트 추출, 표지 미리보기, 단순 샘플, 파싱 성공만으로 완료를 선언하지 않는다 |

형식별 확인 기준
| 형식 | 목표 |
|---|---|
| HWP | 실제 HWP 구조로 읽고 편집해 새 복사본으로 저장한다. 지원 범위의 출력이 한글 2022에서 정상적으로 열리는지 확인한다 |
| HWPX | 본문·표·그림·문단·쪽 정보와 수정하지 않은 자원을 보존한다. 23쪽 기준 문서로 편집 연결과 배치 일치를 검증한다 |
| DOC | 레거시 바이너리용 읽기·편집·저장 경로를 DOCX와 따로 만들고, Word에서 읽히는 실제 출력인지 검증한다 |
| DOCX | 원본 OOXML의 관계·스타일·그림과 수정하지 않은 ZIP 항목을 보존하고 Word 호환성을 검증한다 |

그 밖의 메모
- 06절(자료 이용 조건): 상세 본문은 소유자 전용 비공개 페이지로 두고, “명시적 동의 → 소유자 승인 → 개인 계정 한정 열람권” 순서로 열어 준다. 자동 동의 게이트를 만든다면 서버가 본문·검색 결과·미리보기·첨부·API를 내주기 전에 인증, 동의 버전, 승인 상태를 확인해야 한다고 적었다.
- 07절(다음 단계): 자동 글쓰기와 이어서 글쓰기는 편집·레이아웃·저장 호환성을 검증한 다음으로 미뤘다.
- 탄글은 한컴·Microsoft와 제휴나 후원 관계가 없다고 명시하고, 승인된 개인·교육용 비상업 목적으로만 이용하라고 적었다.
해석과 적용 메모
- 프롬프트의 실질은 기능 목록보다 “주장하지 말 것” 목록에 있다. “DOCX 지원이 DOC 지원을 뜻하지 않는다”, “파싱 성공은 완료가 아니다”, “계획을 이력처럼 쓰지 마라” 같은 문장은 에이전트가 과하게 보고하는 버릇을 미리 막는다. 문서 편집기가 아닌 다른 대형 구현을 맡길 때도 그대로 가져다 쓸 수 있는 틀이다.
- 레이아웃 보존 프롬프트의 “가장 가까운 문자열로 원본을 묶지 마라”는 WYSIWYG 편집기에서 실제로 자주 생기는 버그(같은 단어가 여러 번 나오면 엉뚱한 곳이 수정됨)를 짚는다. 화면 좌표와 원본 주소를 분리하라는 요구가 핵심이다.
- REA를 쓴 공개 자료 기반 기능 재구성이라는 점에서 2026-10-09-github-morluto-rea의 “근거와 미지수를 함께 돌려준다”는 설계 철학이 실제 프로젝트 프롬프트에 어떻게 녹아드는지 보여 주는 사례다.
- 한국어 문서 형식을 다루는 다른 접근으로는 HWPX 파서·MCP 쪽(2026-03-31-hwp-mcp-korean-hwpx-parser, 2026-07-25-pytorchkr-topic-11342-kordoc-hwp-pdf-mcp)이 있다. 그쪽은 읽기·추출이 중심이고, 탄글은 편집·저장 왕복(round-trip)을 목표로 한다.
누락·접근 제한
- 수집 범위: 공개 페이지 본문 블록 122개 전체(표 3개, 이미지 3장 포함). Notion 공개 API로 비로그인 상태에서 읽었다.
- 06절이 가리키는 “상세 조건과 접근 관리 프롬프트” 하위 페이지는 소유자 전용 비공개라 수집하지 않았다.
- 탄글 2026의 실제 구현 결과나 코드는 공개되지 않았다. 이 노트의 내용은 모두 과정 설계와 목표이고, 검증된 기능 목록이 아니다.
관련 노트
- 2026-10-09-github-morluto-rea — 이 과정에서 분석 근거 정리를 맡는 REA
- 2026-09-16-github-panniantong-agent-reach — 공개 웹·이미지 조사를 맡는 Agent-Reach
- 2026-03-31-hwp-mcp-korean-hwpx-parser — HWPX 파싱 쪽 접근
- 2026-07-25-pytorchkr-topic-11342-kordoc-hwp-pdf-mcp — HWP·PDF 문서 MCP