DongHyeonka
1dda18da30
fix(docs): 참조 기능 경로를 다시 백틱으로 적어 문서 검사가 본다
...
문제
1103/14-04 조치는 참조 기능을 지운 사본에서 문서 검사가 통과하도록 참조
기능·참조 context 경로와 그 전용 파일·script를 백틱 없이 다시 적었다.
검사기는 백틱 안·명령 안·링크의 경로만 보므로(verify-documentation-
readiness.ts) 그 26줄은 참조 기능이 설치된 템플릿에서도 검사 밖이다. 참조
기능 파일 이름이 바뀌면 매뉴얼이 없는 경로를 가리켜도 어느 게이트도
실패하지 않는다. docs/manual/README.md의 "이 폴더 문서의 경로는 검사된다"가
예제 경로에서 거짓이다.
고른 방법
- 앞 커밋(1105/14-01)으로 검사기가 지운 템플릿 기능의 경로를 받으므로,
README, starter-experience, static-delivery, compatibility,
backend-api-and-server-state-contract, manual-checklist,
adapter-remediation-ledger, performance-evidence, 매뉴얼 01·02·patterns의
참조 기능 경로와 test:reference-feature를 다시 백틱(또는 명령 한 줄)으로
적는다. 두 줄로 끊겨 검사되지 않던 measure 명령도 한 줄로 적었다.
1105/15-02·16-01 조치가 starter-experience.md 표와 매뉴얼 03(A 표, "기능을
지울 때")에 백틱 없이 더한 config/scale/feature-shape-ceilings.json과
measure 명령 세 줄도 같은 규칙으로 고쳤다.
- patterns.md 첫머리 규칙("백틱 없이 적는다")과 README의 SAMPLE_EXTRAS
안내를 새 규칙(설치된 동안 검사, 지운 사본에서는 받음)과 목록 모듈
위치로 고쳤다.
- 테스트: template-feature-removal-documents.test.ts에 "names their paths
and scripts only where verify:documentation checks them"을 더했다. 검사기가
읽은 1절 문서 목록(documentation-review.json)을 받아, 지울 수 있는 템플릿
기능의 경로·script가 백틱 span·링크 대상·셸 블록 밖에 나오면 실패한다.
같은 우회가 다시 들어오는 것을 막는다. 지운 사본에서 통과하는 성질은 앞
커밋의 "passes in a copy without reference-feature"가 본다.
- 버린 대안: 경로 존재만 보는 단위 테스트를 따로 두기(리뷰의 차선책).
검사기와 같은 규칙을 두 곳에 두게 된다.
위험·한계
- 다음에 참조 기능 경로를 백틱 없이 적는 문서 변경은 새 테스트가 막는다.
백틱으로 적으면 참조 기능을 지운 사본에서도 통과한다.
- 언어 없는 펜스 블록은 검사기처럼 셸 블록으로 보고 넘긴다. 그 안의 명령이
아닌 줄(트리 그림 등)에 적은 경로는 검사기도 새 테스트도 보지 않는다.
검증
- desktop batch에서 확인: node scripts/run-vitest.ts run
tests/unit/template-feature-removal-documents.test.ts
tests/unit/documentation-readiness.test.ts, corepack pnpm
verify:documentation, corepack pnpm test:sample-removal
Refs: 1105/14-03
2026-11-06 02:59:02 +09:00
..
2026-11-05 22:12:30 +09:00
2026-11-06 01:05:22 +09:00
2026-11-05 22:05:31 +09:00
2026-11-04 22:59:03 +09:00
2026-11-06 01:05:22 +09:00
2026-09-24 15:33:13 +09:00
2026-11-04 22:56:52 +09:00
2026-11-01 23:44:29 +09:00
2026-11-04 21:10:19 +09:00
2026-09-25 22:37:21 +09:00
2026-09-25 22:49:32 +09:00
2026-09-25 22:58:37 +09:00
2026-09-24 16:25:22 +09:00
2026-11-06 01:23:48 +09:00
2026-11-06 02:59:02 +09:00
2026-11-06 02:33:16 +09:00
2026-11-03 21:12:34 +09:00
2026-09-24 00:42:21 +09:00
2026-11-04 20:59:25 +09:00
2026-11-04 20:59:25 +09:00
2026-09-26 00:29:34 +09:00
2026-11-04 21:18:51 +09:00
2026-11-01 23:14:47 +09:00
2026-11-01 22:25:41 +09:00
2026-09-24 00:42:21 +09:00
2026-11-04 20:25:48 +09:00
2026-09-24 00:42:21 +09:00
2026-11-04 20:22:27 +09:00
2026-09-25 22:54:40 +09:00
2026-11-01 22:49:13 +09:00
2026-11-04 20:22:27 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 13:58:35 +09:00
2026-09-24 00:42:21 +09:00
2026-11-05 23:23:28 +09:00
2026-09-24 00:42:21 +09:00
2026-11-05 22:26:27 +09:00
2026-09-26 00:04:25 +09:00
2026-09-24 13:41:45 +09:00
2026-09-24 13:45:37 +09:00
2026-11-03 00:55:33 +09:00
2026-11-03 21:37:48 +09:00
2026-09-24 13:45:37 +09:00
2026-11-03 00:55:33 +09:00
2026-11-04 20:22:13 +09:00
2026-11-06 02:33:16 +09:00
2026-11-06 02:07:47 +09:00
2026-09-24 13:41:45 +09:00
2026-11-03 07:17:49 +09:00
2026-11-04 22:50:22 +09:00
2026-11-03 06:52:43 +09:00
2026-09-24 00:42:21 +09:00
2026-11-03 01:24:31 +09:00
2026-11-03 01:24:31 +09:00
2026-11-05 03:30:56 +09:00
2026-09-24 00:42:21 +09:00
2026-09-25 22:52:33 +09:00
2026-11-05 22:29:19 +09:00
2026-11-04 20:28:49 +09:00
2026-09-26 00:16:55 +09:00
2026-11-06 02:59:02 +09:00
2026-11-04 20:30:47 +09:00
2026-09-25 23:10:19 +09:00
2026-11-06 01:23:48 +09:00
2026-11-04 21:31:16 +09:00
2026-11-06 01:23:48 +09:00
2026-11-06 02:12:06 +09:00
2026-09-24 00:42:21 +09:00
2026-09-27 13:20:12 +09:00
2026-11-06 02:59:02 +09:00
2026-09-24 12:25:01 +09:00
2026-11-06 01:05:22 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-25 23:58:52 +09:00
2026-09-24 13:32:37 +09:00
2026-09-24 00:42:21 +09:00
2026-11-01 23:14:47 +09:00
2026-09-24 00:42:21 +09:00
2026-09-25 22:57:51 +09:00
2026-09-25 22:33:44 +09:00
2026-11-04 20:38:17 +09:00
2026-09-25 22:52:29 +09:00
2026-09-24 13:30:26 +09:00
2026-09-25 21:18:39 +09:00
2026-09-24 00:42:21 +09:00
2026-11-06 01:23:48 +09:00
2026-11-03 02:00:45 +09:00
2026-11-05 04:26:44 +09:00
2026-09-25 23:00:43 +09:00
2026-09-24 00:42:21 +09:00
2026-09-25 22:07:53 +09:00
2026-09-25 22:18:00 +09:00
2026-11-05 22:07:09 +09:00
2026-11-01 23:18:45 +09:00
2026-11-04 20:54:24 +09:00
2026-11-01 22:16:26 +09:00
2026-11-04 20:29:34 +09:00
2026-11-05 22:08:19 +09:00
2026-09-24 00:42:21 +09:00
2026-11-01 22:56:29 +09:00
2026-11-06 01:23:48 +09:00
2026-11-06 02:58:00 +09:00
2026-11-04 22:28:30 +09:00
2026-09-27 13:32:33 +09:00
2026-09-27 13:47:35 +09:00
2026-09-25 22:25:44 +09:00
2026-09-27 13:47:35 +09:00
2026-09-27 13:32:33 +09:00
2026-11-05 22:41:50 +09:00
2026-11-03 20:23:14 +09:00
2026-11-05 22:05:52 +09:00
2026-11-05 22:12:33 +09:00
2026-11-06 02:11:17 +09:00
2026-11-03 01:52:18 +09:00
2026-11-01 22:16:26 +09:00
2026-11-04 20:35:11 +09:00
2026-11-04 20:46:40 +09:00
2026-11-01 21:57:53 +09:00
2026-09-24 00:42:21 +09:00
2026-11-01 20:50:00 +09:00
2026-11-04 21:00:22 +09:00
2026-09-24 00:42:21 +09:00
2026-11-06 02:07:47 +09:00
2026-09-26 00:26:17 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-11-05 22:10:05 +09:00
2026-11-05 22:06:33 +09:00
2026-09-25 23:19:41 +09:00
2026-11-04 20:30:47 +09:00
2026-11-04 21:31:16 +09:00
2026-09-27 13:16:31 +09:00
2026-11-04 20:19:33 +09:00
2026-09-26 00:36:49 +09:00
2026-11-04 20:20:51 +09:00
2026-11-01 23:14:47 +09:00
2026-11-01 23:14:48 +09:00
2026-09-25 22:25:44 +09:00
2026-11-04 20:59:31 +09:00
2026-09-24 11:55:57 +09:00
2026-09-27 13:32:33 +09:00
2026-09-24 00:42:21 +09:00
2026-11-03 21:12:34 +09:00
2026-11-01 23:44:29 +09:00
2026-11-06 02:58:00 +09:00
2026-11-06 02:11:17 +09:00
2026-09-24 00:42:21 +09:00
2026-11-04 21:23:52 +09:00
2026-11-04 20:30:47 +09:00
2026-11-04 20:30:47 +09:00
2026-11-05 22:14:54 +09:00
2026-11-05 22:07:09 +09:00
2026-09-24 00:42:21 +09:00
2026-11-04 23:35:33 +09:00
2026-11-04 23:35:33 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-27 13:32:33 +09:00
2026-09-24 00:42:21 +09:00
2026-11-05 22:14:54 +09:00
2026-09-27 12:57:41 +09:00
2026-11-04 20:35:11 +09:00
2026-11-06 01:05:22 +09:00
2026-11-05 22:08:50 +09:00
2026-11-05 22:07:09 +09:00
2026-09-24 00:42:21 +09:00
2026-11-06 02:07:47 +09:00
2026-09-25 22:38:34 +09:00
2026-09-25 21:34:12 +09:00
2026-09-24 00:42:21 +09:00
2026-11-05 22:06:59 +09:00
2026-11-01 22:42:44 +09:00
2026-11-04 20:32:17 +09:00
2026-11-03 07:17:49 +09:00
2026-11-06 02:59:02 +09:00
2026-11-06 01:05:22 +09:00
2026-09-26 01:01:49 +09:00
2026-09-26 00:22:16 +09:00
2026-11-03 21:37:48 +09:00
2026-09-24 00:42:21 +09:00
2026-11-03 01:24:31 +09:00
2026-09-25 22:23:01 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-11-01 23:18:45 +09:00
2026-11-06 01:23:48 +09:00
2026-09-25 23:19:41 +09:00
2026-09-24 13:54:42 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-24 00:42:21 +09:00
2026-09-26 00:32:19 +09:00
2026-11-04 20:24:14 +09:00
2026-11-03 01:58:38 +09:00