hanlint 0.0.1__tar.gz

hanlint-0.0.1/.claude/settings.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit|NotebookEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python -X utf8 \"${CLAUDE_PROJECT_DIR:-.}/hooks/writeGate.py\" pre"
+          }
+        ]
+      }
+    ]
+  }
+}

hanlint-0.0.1/.gitattributes

@@ -0,0 +1,4 @@
+# 줄 끝은 LF 하나다. 윈도우 체크아웃에서도 바꾸지 않는다.
+* text=auto eol=lf
+*.png binary
+*.jpg binary

hanlint-0.0.1/.githooks/commit-msg

@@ -0,0 +1,22 @@
+#!/bin/sh
+# 커밋 메시지 규칙 집행. 판정 정본은 scripts/commitMessage.py, 규칙 문장은 skills/specs/operation/sourceControl.md.
+# 이 훅은 얇게 유지한다. 판정을 sh 와 파이썬에 이중화하면 두 판정이 표류한다.
+message_file="$1"
+
+if [ -z "$message_file" ] || [ ! -f "$message_file" ]; then
+  echo "blocked: 커밋 메시지 파일이 없다" >&2
+  exit 1
+fi
+
+repo_root="$(git rev-parse --show-toplevel)"
+python_bin="$repo_root/.venv/Scripts/python.exe"
+if [ ! -x "$python_bin" ]; then
+  python_bin="$(command -v python || command -v python3)"
+fi
+# 실패는 닫는 방향으로 한다. 파이썬 없이 통과시키면 검사 없는 커밋이 조용히 들어온다.
+if [ -z "$python_bin" ]; then
+  echo "blocked: 커밋 메시지 규칙을 판정할 python 이 없다" >&2
+  exit 1
+fi
+
+exec "$python_bin" -X utf8 "$repo_root/scripts/commitMessage.py" "$message_file"

hanlint-0.0.1/.githooks/pre-commit

@@ -0,0 +1,47 @@
+#!/bin/sh
+# staged 파일에서 em 대시, en 대시, 제어 문자, snake_case 파일 이름을 막는다.
+# 규칙 정본은 skills/specs/operation/codeStyle.md 와 sourceControl.md. 검사 범위는 tests/gates/testDash.py 와 같다.
+# printf 로 실제 문자를 만든다. 정규식 안에 리터럴로 쓰면 이 파일이 자기 게이트에 걸린다.
+
+em_dash="$(printf '\342\200\224')"
+en_dash="$(printf '\342\200\223')"
+control="$(printf '[\001-\010\013\014\016-\037\177]')"
+blocked=0
+
+for file in $(git diff --cached --name-only --diff-filter=ACM); do
+  case "$file" in
+    *.py|*.js|*.md|*.toml|*.json|*.txt|*.sh|*.yml|*.yaml) ;;
+    .githooks/*) ;;
+    *) continue ;;
+  esac
+  if git show ":$file" | grep -q "$em_dash"; then
+    echo "blocked: em 대시 (U+2014) 가 있다: $file" >&2
+    blocked=1
+  fi
+  if git show ":$file" | grep -q "$en_dash"; then
+    echo "blocked: en 대시 (U+2013) 가 있다: $file" >&2
+    blocked=1
+  fi
+  if git show ":$file" | LC_ALL=C grep -q "$control"; then
+    echo "blocked: 제어 문자가 있다 (이스케이프를 날것으로 적었을 때 생긴다): $file" >&2
+    blocked=1
+  fi
+  # 코드 폴더의 파일 이름은 camelCase 다. 던더 파일과 conftest.py 만 파이썬이 정한 이름이라 예외. npm 의 js 도 같다.
+  case "$file" in
+    src/*.py|tests/*.py|hooks/*.py|scripts/*.py|npm/*.js)
+      base="$(basename "$file")"
+      case "$base" in
+        __init__.py|__main__.py|conftest.py) ;;
+        *_*)
+          echo "blocked: snake_case 파일 이름이다. camelCase 로 바꾼다: $file" >&2
+          blocked=1
+          ;;
+      esac
+      ;;
+  esac
+done
+
+if [ "$blocked" -ne 0 ]; then
+  echo "blocked: 부연은 마침표로 끊고 범위는 물결표로 쓴다. 이름은 camelCase 다 (operation.codeStyle)" >&2
+  exit 1
+fi

hanlint-0.0.1/.githooks/pre-push

@@ -0,0 +1,34 @@
+#!/bin/sh
+# main 이 아닌 ref 의 push 를 막고, main 을 올리기 전에 게이트를 다시 돈다.
+# 커밋 메시지의 검증 줄은 주장이고 이 훅이 확인이다. 규칙 정본은 skills/specs/operation/sourceControl.md.
+
+while read -r local_ref local_sha remote_ref remote_sha; do
+  case "$remote_ref" in
+    refs/heads/main) ;;
+    "") ;;
+    *)
+      echo "blocked: main 만 push 한다: $remote_ref" >&2
+      exit 1
+      ;;
+  esac
+done
+
+repo_root="$(git rev-parse --show-toplevel)"
+if [ ! -d "$repo_root/tests" ]; then
+  exit 0
+fi
+
+python_bin="$repo_root/.venv/Scripts/python.exe"
+if [ ! -x "$python_bin" ]; then
+  python_bin="$(command -v python || command -v python3)"
+fi
+if [ -z "$python_bin" ]; then
+  echo "blocked: 게이트를 돌릴 python 이 없다" >&2
+  exit 1
+fi
+
+if ! "$python_bin" -X utf8 -B -m pytest -q "$repo_root/tests" >/dev/null 2>&1; then
+  echo "blocked: pytest 가 red 다. 고치고 다시 push 한다" >&2
+  "$python_bin" -X utf8 -B -m pytest -q "$repo_root/tests" 2>&1 | tail -20 >&2
+  exit 1
+fi

hanlint-0.0.1/.github/workflows/ci.yml

@@ -0,0 +1,60 @@
+# 게이트 전부. push 와 PR 에서 돌고 publish.yml 이 같은 것을 재사용한다 (복사하면 조용히 뒤처진다).
+# 정본 절차는 skills/specs/operation/verify.md (여기는 집행만).
+name: ci
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_call:
+
+permissions:
+  contents: read
+
+defaults:
+  run:
+    shell: bash
+
+jobs:
+  gates:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            python: "3.11"
+          - os: ubuntu-latest
+            python: "3.13"
+          - os: windows-latest
+            python: "3.12"
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python }}
+      # npm 동등성 게이트 (testNpmParity) 와 npm 자체 테스트에 node 가 필요하다.
+      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7
+        with:
+          node-version: 22
+      - run: python -X utf8 -B -m pip install --quiet ".[dev]"
+      - run: python -X utf8 -B scripts/exportData.py --check
+      - run: python -X utf8 -B -m ruff check src tests hooks scripts
+      - run: python -X utf8 -B -m ruff format --check src tests hooks scripts
+      - run: python -X utf8 -B -m pytest -q
+      - run: node --test "npm/test/*.test.js"
+      - run: python -X utf8 -B hooks/tests/checkWriteGate.py
+
+  # 루트 action.yml 을 자기 문서에 실제로 써서 액션 표면이 살아 있는지 본다.
+  action:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7
+        with:
+          node-version: 22
+      - uses: ./
+        with:
+          files: README.md npm/README.md
+          errors-only: "true"
+          command: node npm/bin/hanlint.js

hanlint-0.0.1/.github/workflows/publish.yml

@@ -0,0 +1,151 @@
+# 배포: 버전 태그 (v0.0.x) 푸시가 트리거. PyPI 와 npm 에 같은 버전을 같은 날 올린다.
+# 정본 절차는 skills/specs/operation/release.md (여기는 집행만).
+#
+# 인증은 둘 다 Trusted Publishing (OIDC) 이다. 장수 토큰 시크릿을 두지 않는다. 러너가 GitHub OIDC 로
+# 자기 신원을 증명하고 레지스트리가 단기 자격을 발급한다. 사전 1회 설정:
+#   PyPI: pypi.org > Account > Publishing > Add pending publisher
+#         (project hanlint, owner eddmpython, repository hanlint, workflow publish.yml, environment pypi)
+#   GitHub: Settings > Environments > pypi
+#   npm: 첫 게시 (0.0.1) 는 운영자 기계에서 npm publish 로 한다. 패키지가 생긴 뒤
+#        npmjs.com > hanlint > Settings > Trusted Publisher > GitHub Actions
+#        (repository eddmpython/hanlint, workflow publish.yml) 을 등록하면 다음 태그부터 여기서 올라간다.
+name: publish
+
+on:
+  push:
+    tags: ["v*"]
+  # 수동 실행. 태그가 워크플로보다 먼저 나갔거나 게시가 실패해 재시도할 때. 버전은 체크아웃한 ref 의 것이다.
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+defaults:
+  run:
+    shell: bash
+
+jobs:
+  # 게시는 되돌릴 수 없다 (버전 번호 재사용 불가). ci 의 게이트 전부를 통과해야 한다.
+  gates:
+    permissions:
+      contents: read
+    uses: ./.github/workflows/ci.yml
+
+  build:
+    needs: gates
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7
+        with:
+          node-version: 22
+
+      # 릴리즈 정책: pyproject.toml, npm/package.json, 태그는 항상 같은 값이다. 어긋나면 여기서 멈춘다.
+      - name: 세 버전 일치 검증
+        run: |
+          set -eu
+          pyVersion="$(python -c 'import tomllib; print(tomllib.load(open("pyproject.toml", "rb"))["project"]["version"])')"
+          npmVersion="$(node -p "require('./npm/package.json').version")"
+          echo "pyproject=$pyVersion package.json=$npmVersion"
+          test "$pyVersion" = "$npmVersion"
+          case "$GITHUB_REF" in
+            refs/tags/*)
+              echo "tag=${GITHUB_REF_NAME#v}"
+              test "${GITHUB_REF_NAME#v}" = "$pyVersion"
+              ;;
+            *)
+              echo "dispatch: HEAD 태그 목록:"
+              git tag --points-at HEAD
+              git tag --points-at HEAD | grep -Fxq "v$pyVersion"
+              ;;
+          esac
+
+      - run: python -X utf8 -B -m pip install --quiet build
+      - run: python -X utf8 -B -m build
+
+      # PyPI 에 올라갈 바로 그 wheel 을 격리 venv 에 설치해 본다. 의존성 0, 데이터 동봉, 자기 문서 통과.
+      - name: wheel 격리 설치 검증
+        run: |
+          set -eu
+          python -m venv "$RUNNER_TEMP/smoke"
+          "$RUNNER_TEMP/smoke/bin/pip" install --quiet dist/*.whl
+          "$RUNNER_TEMP/smoke/bin/pip" show hanlint | grep -E '^Requires: ?$'
+          "$RUNNER_TEMP/smoke/bin/hanlint" --version
+          "$RUNNER_TEMP/smoke/bin/hanlint" README.md
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: dist
+          path: dist
+
+  publish-pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write # PyPI Trusted Publishing OIDC 는 게시 job 에만 연다.
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist
+      # 재실행 (workflow_dispatch) 때 이미 올라간 버전이면 실패하지 않고 지나간다.
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true
+
+  publish-npm:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write # npm Trusted Publishing OIDC 는 게시 job 에만 연다.
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7
+        with:
+          node-version: 22.19.0
+          registry-url: https://registry.npmjs.org
+      # trusted publishing 은 npm >= 11.5.1 에서만 동작한다 (node 22 번들은 10.x).
+      - run: npm install -g npm@11.19.0
+      # npm/data 는 파이썬 정본의 투영이다. 낡은 투영을 올리지 않는다.
+      - run: python -X utf8 -B scripts/exportData.py --check
+      - run: node --test "npm/test/*.test.js"
+      # 첫 판 (0.0.1) 은 운영자 기계에서 올라간다 (Trusted Publisher 등록에 패키지가 먼저 있어야 한다).
+      # 그 뒤 같은 태그를 밀어도 이미 있는 버전은 건너뛴다. PyPI 의 skip-existing 과 같은 뜻이다.
+      - name: npm 게시 (이미 있는 버전은 건너뛴다)
+        working-directory: npm
+        run: |
+          set -eu
+          version="$(node -p "require('./package.json').version")"
+          if npm view "hanlint@$version" version >/dev/null 2>&1; then
+            echo "hanlint@$version 은 이미 npm 에 있다. 건너뛴다"
+          else
+            npm publish
+          fi
+
+  release:
+    needs: [publish-pypi, publish-npm]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist
+      - uses: softprops/action-gh-release@v3
+        with:
+          generate_release_notes: true
+          files: |
+            dist/*.whl
+            dist/*.tar.gz

hanlint-0.0.1/.gitignore

@@ -0,0 +1,44 @@
+# 로컬 하네스. 공개 저장소에 올리지 않는다. 경로를 루트에 고정한다.
+/CLAUDE.md
+/AGENTS.md
+# .claude/settings.json 만 예외다. 훅 등록은 로컬 상태가 아니라 이 저장소의 강행 계약이라 클론에도 따라간다.
+.claude/*
+!.claude/settings.json
+.codex/
+.cursor/
+.idea/
+.vscode/
+*.local.json
+
+# 끝나지 않은 이니셔티브. 폴더 하나가 기획 하나다. 로컬 전용
+mainPlan/
+
+# 세션 간 메모리. 로컬 전용
+/memory/
+
+# 비밀
+.env
+.env.*
+!.env.example
+*.pem
+*.key
+
+# 파이썬
+.venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+dist/
+build/
+
+# npm. 의존성 0 이라 node_modules 는 원래 없다. pack 산출물도 저장소 밖으로
+node_modules/
+*.tgz
+
+# 운영체제
+.DS_Store
+Thumbs.db
+Desktop.ini

hanlint-0.0.1/.pre-commit-hooks.yaml

@@ -0,0 +1,13 @@
+# pre-commit 표면. 소비 저장소의 .pre-commit-config.yaml 에서 이 저장소를 repo 로 가리키면 커밋마다 마크다운을 검사한다.
+#
+#   - repo: https://github.com/eddmpython/hanlint
+#     rev: v0.0.1
+#     hooks:
+#       - id: hanlint
+- id: hanlint
+  name: hanlint
+  description: 한국어 마크다운에서 반복되는 결함을 결정적으로 잡는다
+  entry: hanlint
+  language: python
+  types: [markdown]
+  args: [--errors-only, --quiet]

hanlint-0.0.1/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+hanlint 의 눈에 띄는 변경을 이 파일에 적는다. 형식은 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) 를
+따르고 버전은 [Semantic Versioning](https://semver.org/spec/v2.0.0.html) 이다. 변경은 [Unreleased] 에 쌓고
+릴리즈 커밋에서 버전 절로 내린다.
+
+## [Unreleased]
+
+## [0.0.1] - 2026-08-27
+
+첫 공개판이다. 한국어 마크다운에서 반복되는 결함을 결정적으로 잡는 린터이자 글쓴이의 글짓기 도구다.
+의존성 0 의 파이썬이 정본이고 npm 판은 같은 규칙, 같은 fixture 로 글자 단위로 같은 출력을 낸다
+(testNpmParity 게이트). 점수와 등급은 내지 않는다. 세어서 확정할 수 있는 결함만 자리와 이유와 함께 짚는다.
+
+### Added
+
+- 규칙 42개. sentence (상투어, 번역투, 겹말, 일본어투, 지시어, 이중 피동, 관형격 연쇄, 명사 쌓기, 종결어미
+  반복, 긴 문장, 어려운 말 등), paragraph (조각난 문단, 사실 나열, 화제 끊김), structure (제목 어미 통일,
+  헤딩 건너뜀, 설명글 없는 절, 확인할 결과 없는 절), document (수 약속 불일치, 미회수 예고, 독자 부재),
+  orthography (맞춤법 27, 띄어쓰기 12, 헷갈리는 말 12항목. 국립국어원 조항 근거), code (읽는 파일의 출처,
+  설치 줄과 import 대조, 중복 블록, 첫 실행까지 거리, 플랫폼 전용 API)
+- `hanlint fix`: 고친 표기가 확정된 지적을 원문에 적용하고 줄마다 보여 준다. `--dry-run` 은 보여 주기만 한다
+- `hanlint audit` 와 `hanlint map --format html`: 지문 지도 (색이 구멍 종류) 와 문장 길이, 종결어미, 어휘,
+  접속사 분포
+- `hanlint print --layer`: 문장, 문단, 절, 글 지문을 JSON 으로
+- `hanlint profile`: 승인된 글들의 문체 분포를 만들고 새 글의 편차 구간을 짚는다
+- `hanlint coverage`: 사람 평가자 지적과 hanlint 지적의 자리 겹침 비율과 못 집은 유형 목록
+- `hanlint diff`: 두 초안의 짜임, 리듬, 규칙별 지적 수의 변화
+- 입출력: stdin (`-`, `--path`), `--format compact|json|github`, `--errors-only`, `--severity`, 설정 파일
+  `hanlint.toml` 과 인라인 제어 주석. 따옴표와 백틱 안은 인용으로 보고 사전 규칙이 건너뛴다
+- 표면: GitHub Action (`action.yml`), pre-commit 훅 (`.pre-commit-hooks.yaml`), VS Code 확장 (`vscode/`,
+  저장 시 진단과 quick fix), AI 스킬 (`skills/use-hanlint/SKILL.md`)
+- 형태소 정밀 모드 (`pip install hanlint[kiwi]`) 는 선택이고 기본은 표층 근사다
+
+[Unreleased]: https://github.com/eddmpython/hanlint/compare/v0.0.1...HEAD
+[0.0.1]: https://github.com/eddmpython/hanlint/releases/tag/v0.0.1

hanlint-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 eddmpython
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hanlint-0.0.1/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.5
+Name: hanlint
+Version: 0.0.1
+Summary: 한국어 글에서 AI 와 사람이 반복해서 어기는 결함을 결정적으로 잡는 린터
+Project-URL: Homepage, https://github.com/eddmpython/hanlint
+Project-URL: Issues, https://github.com/eddmpython/hanlint/issues
+License-Expression: MIT
+License-File: LICENSE
+Keywords: fingerprint,korean,lint,readability,writing
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Natural Language :: Korean
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Text Processing :: Linguistic
+Requires-Python: >=3.11
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Provides-Extra: kiwi
+Requires-Dist: kiwipiepy>=0.20; extra == 'kiwi'
+Description-Content-Type: text/markdown
+
+# hanlint
+
+한국어 글에서 반복되는 결함을 결정적으로 잡는 린터이자 글쓴이의 글짓기 도구다. 의존성이 없다.
+
+번역투와 상투어, 자주 틀리는 맞춤법과 띄어쓰기 (`됬`, `않 해`, `할수 있다`), 로서/로써 같은 헷갈리는 말,
+지시어와 명사 쌓기, 조각난 문단, 도입과 결말의 개수 불일치, 그리고 코드 튜토리얼이라면 만들지 않은
+파일을 읽는 자리와 설치 줄에 없는 import 까지 집는다. 항목마다 국립국어원 조항이나 실측 근거가 붙어
+있고 고친 표기가 확정된 자리는 `hanlint fix` 가 바로 바꾼다.
+
+글의 좋고 나쁨은 판정하지 않는다. 세어서 확정할 수 있는 결함만 집어서 자리와 이유를 돌려준다.
+좋은 글인지는 사람과 LLM 평가자가 그 위에서 판단한다. hanlint 는 그 판단이 셈에 시간을 쓰지
+않게 바닥을 깔아 주는 도구다.
+
+## 설치
+
+pip 하나면 된다. 형태소 분석기로 더 정밀하게 보려면 `hanlint[kiwi]` 를 따로 받는다. Node 쪽은 npm 에
+같은 이름으로 있고 설치 없이 `npx hanlint 글.md` 로 바로 돈다.
+
+```powershell
+pip install hanlint
+pip install hanlint[kiwi]
+npx hanlint 글.md
+```
+
+두 구현은 같은 규칙, 같은 fixture, 같은 출력이다. 지문 지도와 프로파일과 kiwi 정밀 모드는 파이썬 쪽에만 있다.
+
+## 사용
+
+마크다운 파일 하나를 주면 된다.
+
+```powershell
+hanlint 글.md
+```
+
+지적마다 규칙 이름, 줄 번호, 인용 문장, 왜 문제인지가 붙는다. 기계가 고칠 수 있는 것은 고친
+문장이 같이 온다. 첫 줄은 어느 설정을 읽었는지다. 종료 코드는 지적이 없으면 0, error 가 있으면 1 이라
+발행 게이트에 그대로 물린다.
+
+```text
+설정: hanlint.toml
+
+글.md:12  [doublePassive]  결과가 저장되어집니다.
+    되어지 는 이중 피동이다. 피동 하나로 줄인다
+    고친 뒤: 결과가 저장됩니다.
+```
+
+기계가 확실히 고칠 수 있는 자리는 `hanlint fix 글.md` 가 원문에 적용하고 무엇을 바꿨는지 줄마다 보여 준다.
+`--dry-run` 은 보여 주기만 한다. 다른 명령은 표에 있다.
+
+| 명령 | 무엇 |
+|---|---|
+| `hanlint 글.md --format compact --errors-only` | 한 줄에 지적 하나, error 만. AI 와 스크립트가 쓴다 |
+| `hanlint - --path 초안.md` | stdin 으로 넣은 글을 그 이름으로 검사한다 |
+| `hanlint 글.md --format json` | 기계가 읽는 꼴. `github` 은 GitHub Actions 주석 |
+| `hanlint fix 글.md` | 번역투, 명령형 뒤 마침표, 이중 부정처럼 확실한 자리를 고친다 |
+| `hanlint audit 글.md` | 지문 지도와 분포. 색이 있는 자리가 구멍이다 |
+| `hanlint map 글.md --format html` | 지도를 단일 HTML 로 |
+| `hanlint print 글.md --layer sentences` | 문장, 문단, 절, 글의 지문을 JSON 으로. 층 하나만 고를 수 있다 |
+| `hanlint rules` | 규칙 목록 |
+| `hanlint explain <규칙>` | 규칙의 기술서. 왜, 어디서, 고치기, 안 잡는 것 |
+| `hanlint init` | 주석 달린 `hanlint.toml` |
+| `hanlint profile build 글들/` | 승인된 글의 문체 분포. `--profile` 로 새 글을 견준다 |
+| `hanlint diff 전.md 후.md` | 두 초안의 짜임, 리듬, 지적 수의 변화 |
+| `hanlint coverage review.json 글.md` | 사람 평가자의 지적 가운데 hanlint 가 같은 자리를 집은 비율 |
+
+백틱과 따옴표 안은 인용이라 사전 규칙과 지시어 규칙이 건너뛴다. 상투어를 인용하며 설명하는 글이 잡히지 않는다.
+
+## 규칙을 끄기
+
+글 전체에서 끄려면 `hanlint init` 이 만드는 `hanlint.toml` 의 `disable` 에 이름을 넣는다. 한 자리에서만
+끄려면 마크다운 주석을 쓴다. 상투어를 인용하는 문단처럼 규칙이 맞지만 그 자리만 예외일 때다.
+
+```markdown
+<!-- hanlint-disable cliche -->
+
+AI 가 자주 쓰는 표현은 `핵심은`, `결국 중요한 것은` 처럼 눈에 띄는 것부터 지웁니다.
+
+<!-- hanlint-enable cliche -->
+```
+
+`hanlint-disable-next` 는 다음 블록 하나만 끈다. 규칙 이름을 안 적으면 전부 끈다.
+
+## 파이썬에서
+
+같은 일을 함수로 한다.
+
+```python
+from hanlint import lintText
+
+for finding in lintText(text):
+    print(finding.line, finding.rule, finding.why)
+```
+
+`lintFile`, `auditText`, `fingerprint` 도 같은 자리에 있다.
+
+## 커밋과 PR 에서
+
+pre-commit 훅과 GitHub Action 이 저장소 루트에 있다. 훅은 `.pre-commit-config.yaml` 에서 이 저장소를
+가리키면 되고, 액션은 지적을 PR 의 줄 주석으로 단다. VS Code 확장 (`vscode/`) 은 저장할 때 검사해
+밑줄로 보여 주고 확정된 자리는 quick fix 로 고친다.
+
+```yaml
+- uses: eddmpython/hanlint@main
+  with:
+    files: docs/글.md
+    errors-only: "true"
+```
+
+## AI 에게 시키기
+
+`skills/use-hanlint/SKILL.md` 를 에이전트의 스킬 폴더에 두면 AI 가 글을 쓴 직후 스스로 검사하고
+지적이 0 이 될 때까지 고친다.
+
+## 무엇을 잡나
+
+잡는 것과 잡지 않는 것은 [skills/specs/start/product.md](skills/specs/start/product.md) 에 있다.
+규칙 하나는 파일 하나이고 자기 기술서를 docstring 으로 든다.
+
+## 라이선스
+
+MIT 다.