git:20260219.5fc9885 to git:20260219.f714f33

32 added, 32 removed. Audit A to A.

---

name: technical-writing

description: Use when reviewing, improving, or writing technical documentation in Korean. Triggers include "문서 리뷰", "테크니컬 라이팅", "기술 문서", "문서 개선", "writing review", "doc review"

---

# Technical Writing Review

- 기술 문서를 리뷰하고 개선을 제안한다. 3단계 순차 리뷰: 유형 분류 → 정보 구조 → 문장 다듬기.

+ Reviews technical documents and suggests improvements. 3-phase sequential review: Type Classification → Information Architecture → Sentence Refinement.

## The Iron Law

- - 3개 Review Area를 순서대로 수행한다. Area를 건너뛰지 않는다.

- - 각 Area 완료 시 리뷰 결과를 사용자에게 제시하고 승인을 받는다.

- - 모든 원칙은 권장 사항이다. 상황에 따라 유연하게 적용한다.

+ - Perform all 3 Review Areas in order. Do not skip any Area.

+ - After completing each Area, present review results to the user and get approval.

+ - All principles are recommendations. Apply flexibly based on context.

## Non-Negotiable Rules

| Rule | Description |

|------|-------------|

- | 순차 수행 | Type → Architecture → Sentence 순서 |

- | Area별 승인 | 각 Area 완료 후 사용자 확인 |

- | Before/After | 모든 개선 제안은 Before/After 형식으로 제시 |

- | 근거 명시 | 각 제안에 해당 원칙 ID(T1~T15, P1~P15) 명시 |

+ | Sequential Execution | Type → Architecture → Sentence order |

+ | Per-Area Approval | User confirmation after each Area |

+ | Before/After | All improvement suggestions in Before/After format |

+ | Cite Principle | Each suggestion must cite its principle ID (T1~T16, P1~PA17) |

## Review Areas

```dot

digraph review_flow {

rankdir=LR;

node [shape=box];

"Input Document" -> "Area 1:\nType Classification";

"Area 1:\nType Classification" -> "Area 2:\nArchitecture Review";

"Area 2:\nArchitecture Review" -> "Area 3:\nSentence Review";

"Area 3:\nSentence Review" -> "Review Complete";

}

```

### Area 1: Type Classification

- - **Reviews**: 문서 유형 분류, 유형별 필수 요소 검증

- - **Enter when**: 리뷰 대상 문서가 존재

- - **Skip when**: 사용자가 유형을 이미 명시하고 유형 검증 불필요 요청

+ - **Reviews**: Document type classification, required elements verification per type

+ - **Enter when**: Review target document exists

+ - **Skip when**: User already specified type and requested no type verification

- **Reference**: `references/type.md`

### Area 2: Architecture Review

- - **Reviews**: 제목, 개요, 페이지 구성, 예측 가능성, 가치 우선, 배경 설명

- - **Enter when**: Area 1 완료

- - **Skip when**: 문장 수준 리뷰만 요청

+ - **Reviews**: Headings, overview, page structure, predictability, value-first, background explanation

+ - **Enter when**: Area 1 completed

+ - **Skip when**: Only sentence-level review requested

- **Reference**: `references/architecture.md`

### Area 3: Sentence Review

- - **Reviews**: 주체, 간결성, 구체성, 일관성, 한국어 자연성

- - **Enter when**: Area 2 완료 (또는 Area 2 스킵 시 Area 1 완료)

- - **Skip when**: 구조 수준 리뷰만 요청

+ - **Reviews**: Subject clarity, conciseness, specificity, consistency, Korean naturalness

+ - **Enter when**: Area 2 completed (or Area 1 if Area 2 skipped)

+ - **Skip when**: Only structure-level review requested

- **Reference**: `references/sentence.md`

## Review Output Format

- 각 Area의 리뷰 결과는 다음 형식으로 제시:

+ Each Area's review results use this format:

```markdown

## Area N: {Area Name} Review

### Summary

- 총 {N}건의 개선 제안

- 심각도: Critical {N} / Suggestion {N}

### Findings

#### Finding 1: {제목}

- **원칙**: {원칙 ID} - {원칙 이름}

- **심각도**: Critical / Suggestion

- **Before**:

> {원본 텍스트}

- **After**:

> {개선된 텍스트}

- **근거**: {왜 이 변경이 필요한지}

```

- **심각도 기준:**

- - **Critical**: 독자가 정보를 잘못 이해하거나 못 찾을 수 있음 (주체 누락, 개요 없음, 유형 불일치)

- - **Suggestion**: 가독성·자연스러움 개선 (메타담화, 번역체, 간결성)

+ **Severity criteria:**

+ - **Critical**: Reader may misunderstand or fail to find information (missing subject, no overview, type mismatch)

+ - **Suggestion**: Readability/naturalness improvement (meta-discourse, translationese, conciseness)

## Area Completion Protocol

- 각 Area 완료 시:

- 1. 리뷰 결과를 Review Output Format으로 제시

- 2. 사용자 확인: "Area N 리뷰 결과를 확인해주세요. 다음 Area로 진행할까요?"

- 3. 사용자 승인 후 다음 Area 진행

+ After completing each Area:

+ 1. Present review results in Review Output Format

+ 2. Ask user: "Area N 리뷰 결과를 확인해주세요. 다음 Area로 진행할까요?"

+ 3. Proceed to next Area after user approval

## Review Completion

- 3개 Area 완료 후:

- 1. 전체 리뷰 요약 제시 (Area별 Finding 수, Critical/Suggestion 비율)

- 2. 우선순위 순 개선 제안 목록 (Critical → Suggestion)

- 3. 사용자 요청 시 개선된 전체 문서 생성

+ After all 3 Areas are complete:

+ 1. Present overall review summary (finding count per Area, Critical/Suggestion ratio)

+ 2. Priority-ordered improvement list (Critical → Suggestion)

+ 3. Generate improved full document upon user request

## Language

- - 리뷰 결과는 한국어로 작성

- - 원칙 ID는 영문 코드 유지 (T1, P1 등)

- - Before/After 예시는 원문 언어 유지

+ - Review results are written in Korean

+ - Principle IDs remain in English codes (T1, P1, etc.)

+ - Before/After examples maintain the original language