What is HwpForge CLAUDE.md?

Project instructions for HwpForge, a Rust library and command-line tool for working with Korean HWP and HWPX document formats. They describe its architecture, development commands, and current implementation status.

Use them when developing, testing, or extending HwpForge, including its document codec, Markdown conversion, HWP5 conversion, command-line interface, and MCP bindings.

They give an agent the project context needed to make changes consistently and understand which document features are already supported.

HwpForge CLAUDE.md — Instructions file for coding agents by ai-screams: Project instructions for HwpForge, a Rust library and command-line…

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add instructions/ai-screams/hwpforge/claude-md

Clone the repo

git clone --depth 1 https://github.com/ai-screams/HwpForge

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/ai-screams/hwpforge/claude-md.svg)](https://agentmods.dev/instructions/ai-screams/hwpforge/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/ai-screams/hwpforge/claude-md"><img src="https://agentmods.dev/badge/instructions/ai-screams/hwpforge/claude-md.svg" alt="Measured on agentmods" height="20"></a>

Per session 9,318 This file is loaded in full into every session.

When invoked 9,318 The same file — it is already loaded in full.

Security scan A 0 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5	$0.09318	$0.09318
Opus 5	$0.04659	$0.04659
Sonnet 5	$0.01864	$0.01864
Haiku 4.5	$0.00932	$0.00932

Measured 4d ago against content hash b582c41b12bb, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

HwpForge CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 458 lines

How it starts

The opening of the file, as written. The whole thing — 458 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

HwpForge is a Rust library for programmatic control of Korean HWP/HWPX document formats, designed with LLM-first principles. The goal is to enable AI agents (like Claude Code) to generate Korean government proposal documents using natural language + Markdown + YAML style templates.

Current Status (snapshot — 2026-08-25):

HWPX codec: read/write shipped · Markdown bridge: read/write shipped
HWP5 → HWPX converter path: active, style/layout fidelity line in progress
CLI bindings: shipped · MCP bindings: shipped · Python bindings: stub
Shared tab / ordered·bullet·outline / checkable-bullet semantics wired through core → blueprint → smithy. HWP5 checkable carries all three gotcha-#8 truth locations (bullet.checkedChar, bullet.paraHead.checkable, paraPr.checked).
Phase 12 HWP5→HWPX carry series (GSO shapes/equation/memo/dutmal/compose/indexmark/click-here·auto fields/cross-ref instId/document metadata/outline 1–10) main 머지 완료.
E6 IR 와이어-누출 상환 완료 (0.9.0): Summery rename(A) · BookmarkName collapse(B) · raw wire 필드 제거(C) · inst_id/SystemId→공유 ObjectId(M2). H1(display_text)=Won't-do (ADR-009 §CLOSURE, memory e6-wire-leak-status-h1-wontdo.md).
0.10.0 릴리스 (2026-07-02): colLine(다단 구분선) HWPX+HWP5 carry(breaking) + rmcp 2.0 보안(GHSA-89vp-x53w-74fx)·quick-xml 0.41 + 문서 정합.
AI 편집(에이전트 편집) 전 에픽 배포 완료 (2026-07-12~24, 0.11.0→0.11.6): E1 누름틀 채우기(0.11.0, feat!: display_text 의미 변경) · E2 fill 델타 API·fields(0.11.1) · E6 템플릿 스탬핑 W1(0.11.2) · E3 표 격자 주소+set-cell(0.11.3) · E6 W2 클래스-B 셀 스탬핑+layout_carry linesegarray 보존(0.11.4) · E5 outline/read/diff 읽기 3표면(0.11.5) · E4 문단 구조 편집 insert-para/delete-para(0.11.6, preserve-first 바이트 스플라이스 + reverse-delta self-verify). 설계/로드맵 = .docs/planning/2026-07-10-agent-editing-architecture.md (남은 후속: E4b 표 행 편집 · <hp:t> 줄 경계 분할 보존 등 backlog).
PDF Export 에픽 배포 (2026-07-26~08-12, 0.12.0→0.13.1): smithy-pdf 신설 — 조판 캐시 재생(계산 금지) 렌더: 표·머리말/꼬리말·쪽번호·폰트 파이프라인(face 축·fsType)·CLI to-pdf(스니핑·3채널 경고 DTO). 에픽 canonical = .docs/planning/2026-07-26-pdf-export-epic.md.
이미지/글상자 렌더 에픽 W1b~W5 배포 (2026-08-14~25, 0.14.0→0.16.0): W1b 좌표 ledger(가시 textpos 통일, 0.15.0) · W2 인라인 이미지(0.15.1) · W3 표 셀 이미지+축약점 earliest-preimage(0.15.2) · W4 글상자 렌더+ObjectPlacement 공용화(breaking — 도형 11종 hp:pos 캐리) · W5 글상자 내부 인라인+body 앵커 렌더+HWP5 앵커 비트 byte-ground → 0.16.0 (트리거 3막 사고 — Releasing 절 필수 조건 2건 참조). 에픽 canonical = .docs/planning/2026-08-13-image-textbox-epic.md (잔여: sub-line-height 인라인 이미지 · W6 마감 · CI 다이어트 제안 .docs/planning/2026-08-25-ci-diet-proposal.md).

Read the full file on GitHub · 458 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

4d ago First seen · 458 lines · 9,318 tokens per session scan A b582c41b12bb

Subscribe to this mod's changes

HwpForge CLAUDE.md is an instructions file published in the GitHub repository ai-screams/HwpForge (18 stars, last pushed 3d ago), licensed Apache-2.0. It adds 9,318 tokens to every session, about $0.0466 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Planning Rust Testing cli document hancom hwp markdown

HwpForge CLAUDE.md

Getting it into your agent

Wrote this? Show the measurements

What it costs to keep this loaded

Grade A, and why

Nothing flagged

How it starts

CLAUDE.md

Project Overview

What this file has done since we first saw it

Other instructions, from other repositories

kordoc CLAUDE.md

mq copilot-instructions.md

mq commit.instructions.md

mq general.instructions.md

mq rust-crate.instructions.md

mq testing.instructions.md