document-haness/.agents/skills/writing-korean-technical-blogs/references/rule-catalog.md

규칙 카탈로그

이 문서는 스킬의 판단 규칙과 테스트 ID를 연결한다. 규칙 충돌 시 references/decision-policy.md의 우선순위를 따른다.

INV-01 — 수치·날짜·버전·단위 보존

원문에서 숫자와 대응 대상을 추출하고 출력에서 같은 관계를 유지한다. 값, 방향, 단위, 기간을 임의로 바꾸지 않는다.

INV-02 — 보호 구간 잠금

코드 블록, 인라인 코드, 명령어, URL, 직접 인용, 법무·보안 문구, 사용자가 잠근 문자열은 정확히 보존한다.

INV-03 — 공식 용어 표기표

제품명, 기술명, 팀명, 약어와 식별자의 기준 표기를 먼저 정하고 글 전체에서 일관되게 사용한다.

SRC-01 — 원문 밖 사실 생성 금지

자료에 없는 성과, 원인, 사용자 반응, 업계 추세, 감정과 경험을 만들지 않는다.

SRC-02 — 미지정 정보의 명시

필수 정보가 없으면 [확인 필요: ...], 미지정, 미측정 또는 질문으로 남긴다. 선택 섹션은 생략한다.

AUD-01 — 목적·독자·독자 결과 확인

글을 쓰기 전에 왜 쓰는지, 누가 읽는지, 읽고 무엇을 이해하거나 결정해야 하는지 고정한다.

STR-01 — 기술 사례 기본 골격

자료가 뒷받침하는 범위에서 문제·맥락 → 제약·대안 → 선택 → 구현·실험 → 결과 → 한계·후속 조치로 구성한다.

STR-02 — 핵심 결과의 조기 제시

결과 수치가 글의 핵심이면 첫 15% 안의 요약이나 도입에 배치하고 측정 환경과 함께 제시한다.

STR-03 — 대상과 행동이 드러나는 제목

소개, 살펴보기, 여정만으로 제목을 만들지 않는다. 대상, 문제, 선택 또는 결과를 제목에 드러낸다.

KOR-01 — 한국어 규범 최종 검수

초안과 문체 편집이 끝난 뒤 editing-korean-grammar-and-expression으로 맞춤법·띄어쓰기·문장 부호를 검수한다.

KOR-02 — 문장 호응과 수식 범위

주어·목적어·서술어의 호응을 확인하고 독립 주장·조건·결론이 한 문장에 과도하게 중첩되면 의미를 보존해 분리한다.

KOR-03 — 식별자와 일반 개념 구분

코드 식별자와 공식 제품명은 원문을 보존한다. 일반 기술 개념은 필요할 때 첫 등장에 한국어 설명을 붙인다.

CLR-01 — 주체와 동작 우선

추상 명사와 막연한 평가보다 누가 무엇을 했고 어떤 영향이 있었는지 쓴다. 근거가 없으면 구체화를 보류한다.

CLR-02 — 복합 문장 분리

독립 주장·조건·결론이 셋 이상이거나 검증 관계가 흐려지면 문장을 나누거나 표·목록으로 옮긴다.

CLR-03 — 모호한 지시어 복원

이를, 이러한, 해당, 이것의 선행 대상이 불명확하면 자료에 있는 구체 명사를 복원한다.

AI-01 — 실제 문제로 시작

시대 일반론, 의례적 인사, 글쓰기 행위 설명보다 시스템의 문제, 관찰값, 목표 또는 독자가 얻을 정보를 먼저 제시한다.

AI-02 — 평가어를 근거로 대체

중요하다, 효율적이다, 혁신적이다, 빠르다는 지표·작동 방식·영향·비교 기준이 있을 때만 사용한다.

AI-03 — 구조와 문장 틀 반복 완화

접속어와 종결형을 무작위로 바꾸지 않는다. 실제 인과·시간·비교 관계에 맞춰 반복을 줄인다.

AI-04 — 결과·한계 중심 결론

결론은 본문 재요약이나 의례적 기대보다 결정, 검증 결과, 적용 조건, 남은 문제와 다음 검증을 제시한다.

AI-05 — 인간 흉내 금지

자연스럽게 보이게 하려고 오탈자, 비문, 감정, 실패담, 사적 일화나 확신을 만들지 않는다.

BRD-01 — 프로젝트·기업 프로필 우선

명시된 브랜드 가이드가 있으면 우선한다. 없으면 다른 기업을 모방하지 않고 정확·명료·절제된 기본 프로필을 사용한다.

REV-01 — 변경 근거 기록

수정 모드에서는 주요 변경마다 문제, 수정 결과, 규칙 ID, 보존 확인과 필요한 경고를 기록한다.

TST-01 — 하드 게이트와 회귀 검증

사실 변경, 보호 구간 변경, 허위 근거, 보안 노출은 점수와 무관하게 실패다. 일반·어려운·회귀 사례를 모두 검증한다.