@qualisoft/ai-skills 1.1.0 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,175 @@
 # 변경 이력
 
+## 1.4.0 — 2026-09-14
+
+대본을 **고객 송부용**으로 다시 세웠습니다. 세 가지 문제를 고쳤습니다.
+
+### ① 불필요한 정보가 산출물에 섞여 들어갔습니다
+
+산출물은 고객사에 송부되는데, 원본 문서는 우리 작업용이라 고객이 볼 필요가 없는
+것이 섞여 있습니다. `_scope.md` 에서 걸러냅니다.
+
+프론트매터 전체 · **담당자 이메일** · `미결정` 섹션 · `변경 이력` · `[[문서-id]]`
+링크 표기 · 원본 파일명·경로 · 템플릿 작성 지침 · 빈 표와 빈 섹션.
+
+`TODO(...)` 는 **지우지 않습니다.** 본문에서는 `협의 중` 으로 바꾸고, 마지막에
+`고객 확인 필요 항목` 으로 모아 보여줍니다. 없는 척하면 고객이 나중에 발견합니다.
+
+### ② 엑셀을 열면 "파일에 오류가 있습니다 — 복구했습니다"
+
+`openpyxl` 로 엑셀 표 기능을 쓸 때 **머리행 이름이 비거나 중복되면** 엑셀이 파일을
+복구합니다. 마크다운 표를 그대로 옮기면 자주 걸립니다. 재현해서 확인했습니다:
+
+```
+| | |            → tableColumn name=""  ×2   → 복구
+| 구분 | 구분 |   → tableColumn name="구분" ×2 → 복구
+| 항목 | 값 |     (데이터 행 없음)            → 복구
+```
+
+`excel.md` 에 네 가지를 규칙으로 못박았습니다 — 빈 머리행 채우기, 중복 이름 구분,
+데이터 없는 표에는 표 기능 적용 금지, `displayName` 은 공백 없이 유일하게.
+
+### ③ 파일을 봐도 무슨 문서인지 몰랐습니다
+
+서식만 고정하면 **"예쁘지만 목적을 모르는 파일"** 이 나옵니다. 두 겹을 더 넣었습니다.
+
+**`_purpose.md` — 목적 블록을 맨 앞에 강제합니다.**
+답하는 질문 한 줄 → 핵심 수치 3~4개(원본에서 세어서) → 받는 분이 할 일.
+그 뒤 가장 중요한 표 하나, 그 다음 상세. **원본 섹션 순서를 그대로 따르지
+않습니다** — 원본은 우리가 쓰기 좋은 순서이고 산출물은 받는 사람이 읽기 좋은
+순서여야 합니다.
+
+**문서 종류별 구성 지침(`DOC_SHAPE`)** — 같은 서식이어도 뼈대는 문서마다 다릅니다.
+
+| 문서 | 앞에 세우는 것 |
+| --- | --- |
+| 산출물 정의서 | 공정별 납품 목록 · 제외한 산출물 |
+| WBS · 일정 | **마일스톤을 본표와 분리** · 지연 과업 강조 |
+| 요구사항 정의서 | 요구사항 ↔ 과업 ↔ 산출물이 같은 행 · 미수용 사유 |
+| 화면 설계서 | 화면 목록 먼저, 화면마다 한 줄 설명 |
+| 데이터 모델 | 한글 논리명을 물리명보다 앞에 |
+| QA · 테스트 | 고객이 하는 확인(UAT)과 우리가 하는 확인을 구분 |
+| 그 밖 | 결론을 앞으로, 행 수가 가장 많은 표를 본표로 |
+
+새 문서 종류는 `DOC_SHAPE` 에 한 줄 추가하면 됩니다.
+
+### 대본 구조
+
+```
+DOC_SHAPE   이 문서는 무엇을 앞에 세우는가   (build.mjs)
+_purpose    받는 사람이 첫 화면에서 알 것    (templates/script/)
+_scope      무엇을 빼는가
+_style      색 · 글자 · 표 — 값 고정
+```
+
+### 검증
+
+```
+치환 잔여 0건 · 문서별 구성 지침 다르게 주입 확인
+  01-project-brief → "이 문서는 **사업 개요**"
+  07-screen-spec   → "이 문서는 **화면 설계서**"
+정제 규칙 · 목적 블록 · 표 손상 규칙 모두 대본에 포함 확인
+```
+
+
+## 1.3.0 — 2026-09-14
+
+### 파일 스크립트를 **대본**으로 바꿨습니다
+
+1.2.0 은 파이썬 코드를 내줬습니다. 실제로 필요한 건 코드가 아니라 **AI 에게 줄
+지시문**이었습니다. 이제 `파일 스크립트` 버튼을 누르면 복사해서 에이전트에 붙여
+넣을 대본이 나옵니다. 파이썬도, `pip install` 도 필요 없습니다.
+
+형식은 PDF · Excel · PowerPoint · Word · CSV 다섯입니다.
+
+**서식 규격이 대본 안에 박혀 있습니다.** 색 여섯 개, 글자 위계 네 단계, 표 스타일,
+하지 말 것 목록이 고정되어 모든 대본에 들어갑니다. 착수 때 만들든 중간에 만들든,
+누가 어떤 도구로 만들든 **같은 모양이 나옵니다.** 매번 "모던하게 만들어 줘" 라고
+말하면 매번 다른 것이 나오기 때문입니다.
+
+대본은 원본 `.md` 경로만 가리키고 "이 파일을 먼저 읽어라" 라고 지시합니다. 문서를
+고친 뒤 같은 대본을 다시 써도 최신 내용으로 만들어집니다.
+
+서식을 바꾸려면 `skills/project-init/templates/script/*.md` 를 고칩니다.
+
+### 안 쓴 메뉴를 검정 점으로 죽여 둡니다
+
+기획안을 근거로 메뉴는 만들어졌지만 끝까지 손대지 않는 문서가 생깁니다. 그런 문서를
+"작성 중"으로 두면 진행률이 영원히 낮게 깔리고, 무엇이 남은 일이고 무엇이 애초에
+필요 없던 항목인지 구분되지 않습니다.
+
+한 번도 쓰이지 않은 문서는 좌측 메뉴에서 **노란 점이 검정 점으로** 바뀌고 이름이
+흐려집니다. 판정 기준:
+
+| 신호 | 판정 |
+| --- | --- |
+| 템플릿 골격을 뺀 실질 글자 수 ≥ 400 | 쓰임 |
+| `status` 가 `draft` 가 아님 (`log` 템플릿 제외) | 쓰임 |
+| 추적 ID 를 본문에 정의 (코드 블록 예시 제외) | 쓰임 |
+| 위 어느 것도 아님 | **안 쓰임 — 검정 점** |
+
+임계값 400 은 실측으로 잡았습니다 — 갓 만든 문서 37~265, 한 번이라도 채운 문서
+996 이상.
+
+### 사이드바 상단에서 비활성을 직접 관리합니다
+
+**`비활성 관리`** 를 켜면 메뉴마다 체크박스가 생깁니다. 자동 판정을 사람이 덮어쓸
+수 있습니다. 덮어쓴 값은 문서 id 로 `localStorage` 에 남아 **다시 빌드해도
+유지됩니다.** 자동 판정과 같아지면 저장을 지워 쓸데없는 기록을 남기지 않습니다.
+
+### 검증
+
+브라우저에서 확인했습니다.
+
+```
+갓 만든 프로젝트   15개 중 13개 검정 점 · "비활성 13 / 15"
+실제 쓰는 프로젝트  14개 전부 정상 (오탐 0)
+검정 점            rgb(0,0,0) + 테두리 (다크 모드에서도 보임)
+체크 클릭          문서 이동 없음 · 저장 · 새로고침 후 유지
+대본               치환 잔여 0건 · 서식 규격 포함 확인
+```
+
+
+## 1.2.0 — 2026-09-14
+
+문서를 **산출물 파일로 뽑는 스크립트**를 붙였습니다.
+
+빌드한 HTML 의 각 문서 우측 상단에 `파일 스크립트` 버튼이 생깁니다. 누르면 모달이
+열리고, 형식을 고르면 그 형식으로 문서를 만드는 파이썬 스크립트가 나옵니다.
+복사해서 그대로 실행하면 됩니다.
+
+| 형식 | 필요한 것 | 결과 |
+| --- | --- | --- |
+| PDF | `pip install reportlab` | 표지·머리말·쪽번호, 줄무늬 표. 한글은 내장 CID 폰트라 폰트 파일이 필요 없습니다 |
+| Excel (XLSX) | `pip install openpyxl` | 본문 시트 + 표마다 별도 시트 (정렬·필터 켜짐) |
+| PowerPoint (PPTX) | `pip install python-pptx` | 표지 + `##` 하나당 슬라이드 하나 |
+| Word (DOCX) | `pip install python-docx` | 한글 서체·표 음영 적용 |
+| CSV | 없음 — 표준 라이브러리 | 개요 1개 + 표마다 1개 (엑셀용 BOM) |
+
+**스크립트는 내용을 품지 않습니다.** 원본 `.md` 경로만 박혀 있고 실행할 때 그 파일을
+다시 읽습니다. 그래서 문서를 고친 뒤 **같은 스크립트를 다시 돌리면 최신 내용**이
+나옵니다. 계속 최신화되는 문서를 다루는 데 필요한 성질입니다.
+
+HTML 크기도 문서 수와 무관합니다 — 스크립트는 한 벌만 들어가고 파일명은 모달을 열 때
+브라우저에서 치환합니다.
+
+서식을 바꾸려면 `skills/project-init/templates/export/*.py` 를 고칩니다.
+`build.mjs` 는 그 파일을 읽어 나르기만 합니다.
+
+### 검증
+
+5종 모두 실제 문서(`07-screen-spec.md`, 183줄·표 20개)로 생성해 확인했습니다.
+
+```
+CSV    7개 파일        PDF   8쪽 · 한글 정상
+Excel  본문 + 표 20시트  DOCX  42KB
+PPTX   59KB
+```
+
+브라우저에서도 확인했습니다 — 문서 14개 전부에 버튼, 형식 5종, 치환 잔여 0건,
+모달 가운데 정렬, 183줄 스크롤, 다크 모드.
+
+
 ## 1.1.0 — 2026-09-11
 
 설치 위치와 소유 판정을 고쳤습니다. **1.0.0 사용자는 전원 재설치가 필요합니다.**
@@ -10,6 +180,17 @@ npx @qualisoft/ai-skills@latest install --force
 
 > 직접 고친 스킬이 있으면 `--force` 가 그 디렉터리를 지웁니다. 먼저 백업하세요.
 
+> **`npx` 가 옛 버전을 실행하는 경우** — 과거에 `npm i -g @qualisoft/ai-skills` 로
+> 전역 설치를 한 적이 있으면, `npx` 는 레지스트리에서 최신을 받지 않고 **그 전역
+> 설치본을 그대로 실행합니다.** 버전을 확인하고, 낡았으면 전역 설치를 갱신하세요.
+>
+> ```bash
+> npm ls -g --depth=0 | grep qualisoft     # 전역 설치 버전 확인
+> npm i -g @qualisoft/ai-skills@latest     # 갱신
+> ```
+>
+> 전역 설치를 쓰지 않는다면 버전을 명시하면 확실합니다 — `npx @qualisoft/ai-skills@latest install`
+
 ### 고친 것
 
 **① npx 캐시를 직접 가리키던 문제** — 모든 플랫폼 해당

package/README.md

@@ -165,7 +165,30 @@ large  19~21개  다인원, 6개월 이상
 **비유하자면** — 택배 배송 알림과 같습니다.
 ```
 
-### 5. 상용 라이브러리를 쓰지 않는다
+### 5. 산출물은 고객에게 바로 보낼 수 있게 나온다
+
+각 문서 우측 상단 **`파일 스크립트`** 버튼 → 형식(PDF · Excel · PPT · Word · CSV)을 고르면 **AI 에게 줄 대본**이 나옵니다. 복사해서 에이전트에 붙여 넣으면 됩니다. 코드가 아니라 지시문이라 설치할 것이 없습니다.
+
+대본은 네 겹으로 쌓입니다.
+
+| 겹 | 정하는 것 |
+| --- | --- |
+| 구성 | **이 문서는 무엇을 앞에 세우는가** — 일정표는 마일스톤을, 요구사항은 추적 관계를 |
+| 목적 | 답하는 질문 한 줄 · 핵심 수치 · 받는 분이 할 일을 맨 앞에 |
+| 정제 | 담당자 이메일 · 미결정 · 변경 이력 · 내부 표기를 걸러냄 |
+| 서식 | 색 여섯 개 · 글자 위계 네 단계 · 표 스타일. 값이 고정 |
+
+**서식만 고정하면 "예쁘지만 목적을 모르는 파일"이 나옵니다.** 그래서 목적 블록을 강제하고, 문서 종류마다 본표로 세울 것을 따로 정합니다. 착수 때 만들든 중간에 만들든 같은 모양이 나옵니다.
+
+대본은 원본 `.md` 를 가리킬 뿐 내용을 품지 않습니다. 문서를 고친 뒤 같은 대본을 다시 써도 최신 내용으로 만들어집니다.
+
+### 6. 안 쓴 메뉴는 스스로 물러난다
+
+기획안으로 메뉴는 만들어졌지만 끝까지 손대지 않는 문서가 생깁니다. 한 번도 쓰이지 않은 문서는 좌측 메뉴에서 **검정 점**으로 바뀌고 이름이 흐려집니다. 남은 일과 애초에 필요 없던 항목이 섞이지 않습니다.
+
+사이드바 상단 **`비활성 관리`** 로 자동 판정을 직접 덮어쓸 수 있고, 그 값은 다시 빌드해도 유지됩니다.
+
+### 7. 상용 라이브러리를 쓰지 않는다
 
 `npm ls`가 비어 있습니다. `fs` · `path` · `url` · `zlib` 만 씁니다. 설치 시간도, 취약점 알림도, 라이선스 검토도 없습니다.
 
@@ -250,6 +273,17 @@ node skills/project-init/build.mjs selftest
 npx @qualisoft/ai-skills@latest install --force
 ```
 
+> **`npx` 가 옛 버전을 실행하는 경우** — 과거에 `npm i -g @qualisoft/ai-skills` 로
+> 전역 설치를 한 적이 있으면, `npx` 는 레지스트리에서 최신을 받지 않고 **그 전역
+> 설치본을 그대로 실행합니다.** 버전을 확인하고, 낡았으면 전역 설치를 갱신하세요.
+>
+> ```bash
+> npm ls -g --depth=0 | grep qualisoft     # 전역 설치 버전 확인
+> npm i -g @qualisoft/ai-skills@latest     # 갱신
+> ```
+>
+> 전역 설치를 쓰지 않는다면 버전을 명시하면 확실합니다 — `npx @qualisoft/ai-skills@latest install`
+
 ## 저장소 · 문의
 
 - 소스 — <https://github.com/qualisoft-service/project-ai-skills>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qualisoft/ai-skills",
-  "version": "1.1.0",
+  "version": "1.4.0",
   "description": "기획 인터뷰부터 문서 체계·디자인 시안·구현까지 이어지는 AI 에이전트 스킬 5종. Claude Code · Codex · Gemini 등 어느 도구에서나 쓴다. 외부 의존성 없음.",
   "keywords": [
     "ai-skills",

package/skills/project-init/SKILL.md

@@ -45,6 +45,47 @@ node ~/.claude/skills/project-init/build.mjs selftest
 
 빌드한 HTML의 좌측 메뉴는 1~4단계 진행률을 자동 표시한다. 1단계는 인터뷰 기록, 2단계는 문서 상태(`draft` 25 / `review` 65 / `approved` 100 가중 평균), 3단계는 디자인 기록·스타일가이드·시안, 4단계는 `docs.config.json.stageProgress["4"]`를 기준으로 한다. 구현 스킬은 검증된 완료율만 4단계 값에 기록한다. 색은 0% 회색, 1~24% 빨강, 25~49% 노랑, 50~99% 주황, 100% 초록이다. 가이드·추적 메뉴는 회색, 홈처럼 주요 이동 항목만 파랑으로 분리한다.
 
+## 연동 서비스
+
+좌측에는 **`연동 서비스 관리` 한 줄만** 둔다(붙은 개수 배지 포함).
+서비스를 전부 나열하면 사이드바가 문서 메뉴보다 길어져 연동 목록판이 된다.
+목록은 `연동 서비스` 페이지가 맡고, 카드마다 **연동 방법 묻기 복사** 버튼이 있어
+AI에게 그대로 붙여넣을 문구를 클립보드에 담는다.
+
+**목록은 네 갈래에서 모은다. 아래일수록 약하다.**
+
+| 출처 | 어디서 | 딱지 |
+| --- | --- | --- |
+| **설정** | `Docs/docs.config.json` 의 `integrations` — 사람이 적은 것. **언제나 이긴다** | `설정` |
+| **자동 감지** | `git remote origin`(github.com이면 GitHub), 루트·`docs/`·`api/`·`openapi/` 의 `openapi\|swagger.(yaml\|yml\|json)` | `자동 감지` |
+| **기획** | **문서 본문에 서비스 이름이 있으면 연동 예정으로 본다.** 근거 문서를 카드에 적는다 | `기획` |
+| **추천** | 위 셋이 **하나도 없을 때만** 카탈로그 기본값으로 채운다 | `추천` |
+
+**기획에서 잡는 것이 이 체계의 요점이다.** 연동은 설정 파일보다 기획서에 먼저 적힌다 —
+“GCP 에 배포한다”, “카카오 알림톡을 쓴다”. 그걸 사람이 설정에 한 번 더 옮겨 적게 만들지 않는다.
+`기획` 딱지는 자동으로 올라온 것이라 **오탐일 수 있다.** 아니면 설정에서 빼면 된다.
+
+확정된 연동은 설정에 적는다. **설정이 항상 이긴다.**
+
+```json
+{
+  "integrations": {
+    "notion": { "url": "https://notion.so/...", "note": "회의록 DB" },
+    "figma":  { "status": "none" },
+    "sentry": { "name": "Sentry", "slug": "sentry", "color": "362D59", "what": "에러 추적", "url": "https://sentry.io/acme" }
+  }
+}
+```
+
+`status` 를 안 적으면 `url` 유무로 판정한다. 카탈로그에 없는 id도 쓸 수 있고,
+그때는 `name`·`slug`(simple-icons)·`color`(# 없는 HEX)를 같이 적는다.
+로고는 cdn.simpleicons.org 에서 받고, 막힌 환경에서는 브랜드색 이니셜로 떨어진다.
+연동을 새로 붙였으면 `integrations` 를 고치고 `build` 를 다시 돌린다.
+
+카탈로그에는 감지용 표기(`detect`)가 함께 들어 있다 — GitHub·Swagger·Notion·Figma·Slack·Jira(추천 기본값)와
+GCP·AWS·Vercel·Cloudflare·GA4·GTM·Sentry·카카오·네이버·Stripe·토스페이먼츠·Firebase·Supabase·SendGrid·GitHub Actions.
+새 서비스를 카탈로그에 넣을 때는 `detect` 를 같이 적는다. **없으면 기획에서 잡히지 않는다.**
+
 ## 작업 순서
 
 **새 프로젝트를 시작할 때**
@@ -368,6 +409,88 @@ npm view react versions --json  # 선택지가 필요하면
 > 그 도메인의 프로젝트를 실제로 해보기 전에는 채우지 않는다.
 > 겪지 않은 논점을 상상해서 적으면 다음 프로젝트가 틀린 지침을 물려받는다.
 
+## 파일 스크립트 — 산출물 생성 대본
+
+빌드한 HTML 의 각 문서 우측 상단 **`파일 스크립트`** 버튼을 누르면 형식(PDF ·
+Excel · PowerPoint · Word · CSV)을 고를 수 있고, **AI 에게 줄 지시문(대본)** 이
+나온다. 코드가 아니다. 복사해서 에이전트에 붙여 넣으면 그 형식으로 산출물을 만든다.
+
+**전제: 이 산출물은 고객사에 송부된다.** 그래서 대본은 네 겹으로 쌓인다.
+
+| 겹 | 파일 | 정하는 것 |
+| --- | --- | --- |
+| 구성 | `DOC_SHAPE` (build.mjs) | **이 문서는 무엇을 앞에 세우는가** — 문서 종류마다 다르다 |
+| 목적 | `_purpose.md` | 받는 사람이 첫 화면에서 무엇을 알아야 하는가 |
+| 정제 | `_scope.md` | 무엇을 빼는가 — 내부 정보·개인정보·미결정·이력 |
+| 서식 | `_style.md` | 색·글자·표. 값이 고정이라 매번 같은 모양이 나온다 |
+
+### 왜 네 겹인가
+
+**서식만 고정하면 "예쁘지만 무슨 문서인지 모르는 파일"이 나온다.** 원본 순서대로
+옮기면 우리가 쓰기 좋은 순서가 그대로 고객에게 간다. 그래서 목적 블록(답하는 질문 ·
+핵심 수치 · 받는 분이 할 일)을 맨 앞에 강제하고, 문서 종류별 구성 지침으로 무엇을
+본표로 세울지 정한다.
+
+`DOC_SHAPE` 는 문서 `name` 으로 찾는다. 예를 들어 `wbs-schedule` 은 마일스톤을
+본표와 분리해 세우게 하고, `requirements` 는 요구사항 ↔ 과업 ↔ 산출물이 같은 행에
+보이게 한다. 없는 문서는 `DOC_SHAPE_DEFAULT` 를 쓴다 — 결론을 앞으로 올리고,
+행 수가 가장 많은 표를 본표로 삼는다.
+
+**새 문서 종류를 넣으면 `DOC_SHAPE` 에 한 줄 추가한다.** 안 넣어도 동작하지만,
+그 문서는 "원본 순서대로"가 된다.
+
+### 엑셀 표 손상 — 대본이 막는다
+
+`openpyxl` 로 엑셀 표 기능을 쓰면 머리행 이름이 **비거나 중복될 때** 엑셀이
+파일을 열며 *"파일에 오류가 있습니다 — 복구했습니다"* 를 띄운다. 마크다운 표를
+그대로 옮기면 자주 걸린다. 실제로 재현해 확인했다:
+
+```
+| | |            → tableColumn name=""  ×2   → 복구
+| 구분 | 구분 |   → tableColumn name="구분" ×2 → 복구
+| 항목 | 값 |     (데이터 행 없음)            → 복구
+```
+
+그래서 `excel.md` 에 네 가지를 규칙으로 못박았다 — 빈 머리행 채우기, 중복 이름
+구분, 데이터 없는 표에는 표 기능 적용 금지, `displayName` 은 공백 없이 유일하게.
+
+### 대본은 내용을 품지 않는다
+
+원본 `.md` 경로만 가리키고 "이 파일을 먼저 읽어라" 라고 지시한다. 그래서 문서를
+고친 뒤 같은 대본을 다시 써도 최신 내용으로 만들어지고, HTML 크기가 문서 수와
+무관하다. 치환(`__DOC_FILE__` · `__DOC_TITLE__` · `__DOC_STEM__` · `__SHAPE__`)은
+모달을 열 때 브라우저에서 일어난다.
+
+서식이나 구성을 바꾸려면 **`templates/script/` 의 마크다운**과 **`DOC_SHAPE`** 를
+고친다. 다른 곳은 건드리지 않는다.
+
+## 비활성 메뉴 — 안 쓴 메뉴를 죽여 둔다
+
+기획안을 근거로 메뉴는 만들어졌지만 끝까지 손대지 않는 문서가 생긴다. 그런 문서를
+"작성 중"으로 두면 진행률이 영원히 낮게 깔리고, **무엇이 남은 일이고 무엇이 애초에
+필요 없던 항목인지** 구분되지 않는다.
+
+한 번도 쓰이지 않은 문서는 좌측 메뉴에서 **검정 점**으로 바뀌고 이름이 흐려진다.
+판정은 `docUsed()` 가 한다.
+
+| 신호 | 판정 |
+| --- | --- |
+| 템플릿 골격을 뺀 실질 글자 수 ≥ 400 | 쓰임 |
+| `status` 가 `draft` 가 아님 (`log` 템플릿 제외) | 쓰임 |
+| 추적 ID 를 본문에 정의 (코드 블록 예시는 제외) | 쓰임 |
+| 위 어느 것도 아님 | **안 쓰임 — 검정 점** |
+
+임계값 400 은 실측으로 잡았다. 갓 만든 문서는 37~265, 한 번이라도 채운 문서는
+996 이상으로 갈라진다.
+
+> **상태나 링크를 주 신호로 쓰지 않는다.** `log` 템플릿은 `status` 가 `approved` 로
+> 시작하고, 모든 `spec` 템플릿은 리스크 대장으로 가는 링크를 자동으로 건다.
+> 그걸 근거로 삼으면 갓 만든 대장이 늘 '사용됨'이 된다.
+
+**사이드바 상단 `비활성 관리`** 를 켜면 메뉴마다 체크박스가 생긴다. 자동 판정을
+사람이 덮어쓸 수 있다. 덮어쓴 값은 문서 id 로 `localStorage` 에 남으므로 **다시
+빌드해도 유지된다.** 자동 판정과 같아지면 저장을 지워, 쓸데없는 기록을 남기지 않는다.
+
 ## 하지 말 것
 
 - `index.html`을 직접 고치기 — 다음 빌드에 덮어써진다.