fix(test): 템플릿 시험이 사본에 만드는 기능 ID를 예약 접두어로 옮긴다 #26

Closed
donghyeon.kang wants to merge 0 commits from donghyeon.kang/fix/r9-reserved-probe-feature-ids AGit into main
Owner

무엇을, 왜

round9 리뷰의 P1(1112/08-02)을 고친다. 템플릿 시험과 드릴이 저장소 사본에 고정 ID로 기능을 만든다: 매뉴얼 코드 조각 시험은 invoice-feature(FE-GATE-005), 생성 기능 e2e는 order-feature(FE-GATE-008), scaffold 드릴은 scaffold-feature(FE-GATE-020). 사본에는 제품 기능이 그대로 들어 있고 create:feature는 같은 ID를 거부한다. 그래서 매뉴얼 1단계 예시대로 invoice-feature를 만든 제품은 기능 코드와 상관없이 merge 게이트에서 막힌다.

고른 방법과 버린 대안

  • 사본에 만드는 기능 ID를 모두 예약 접두어 typecheck-probe-로 옮기고 scripts/lib/template-probe-features.ts 한 곳에 둔다.
  • 매뉴얼 조각은 invoice-feature 기준 그대로 둔다. 시험이 조각과 검사 파일의 이름 넷(INVOICE_, Invoice, invoice-, invoice)을 예약 기능 이름으로 바꿔 넣는다(renameFeatureText, 이름 규칙은 create-feature.ts의 namesOf를 export해 같은 것을 쓴다).
  • 생성 기능 e2e는 메시지 키와 계약 이름을 ID에서 만든다(generatedMessageKey).
  • 버린 안: 사본에서 제품의 같은 이름 기능을 먼저 지우기(등록·조립 파일까지 지워 사본이 제품과 달라진다), create:feature가 흔한 이름을 거부하기(제품 이름을 막는다).

위험과 영향

  • 이름 바꾸기는 낱말 단위 치환이다. 조각의 영어 문장 속 invoice도 바뀌지만 조각과 검사가 함께 바뀌어 결과는 같다.
  • 제품이 typecheck-probe-로 시작하는 기능을 만들면 다시 부딪친다. 매뉴얼 01·reference/create-feature.md에 쓰지 말라고 적었고 생성 명령이 막지는 않는다.
  • scripts/test-sample-removal.ts는 w2-fe-2 세션 파일이다. 이 PR은 529행 기능 ID 한 줄과 import 한 줄만 바꾼다. 두 PR이 겹치면 이 두 줄만 다시 맞추면 된다.
  • 다운스트림: 이미 복사한 프로젝트는 이 PR을 가져가면 바로 풀린다. 기능 코드는 바꿀 것이 없다(CHANGELOG는 round9 마지막 PR에 모은다).

검증

desktop, CI env, scripts/verify.sh(flock).

  • RED(기준 5250ff95에 새 시험만): tests/unit/template-probe-features.test.ts rc=1. 로그 /tmp/claude-gates/r9f1-red/.
  • P1 재현 X-GD02(기준 커밋, 사본에 invoice-feature 생성): manual-code-blocks.test.ts가 feature id invoice-feature is already a feature or context로 실패(rc=1). 로그 /tmp/claude-gates/r9fe-xgd02/.
  • X-GD02b(기준 커밋, 사본에 order-feature --with-create 생성 뒤 generated-feature.spec.ts): 17 passed. FE-GATE-008 경로는 재현되지 않았다. 이 spec의 ID 변경은 같은 원인을 막는 예방이다.
  • GREEN(이 브랜치): 새 시험·create-feature·manual-code-blocks·template-feature-removal-documents rc=0, 제품 상태(사본에 invoice-feature·order-feature --with-create 생성)에서 같은 unit 둘과 generated-feature.spec.ts rc=0. 로그 /tmp/claude-gates/r9f1-green/.
  • 게이트(트리 3da7d772 = head 트리): FE-GATE-002·003·005·008·020 모두 rc=0. 020의 scaffold 드릴이 예약 ID(typecheck-probe-scaffold-feature 등)로 생성·제거를 끝까지 돌았다. 로그 /tmp/claude-gates/r9f1-gates2/.
  • 노트북 scripts/verify.sh docs: OK.

리뷰어가 볼 곳

  • scripts/lib/template-probe-features.ts의 renameFeatureText와 tests/unit/manual-code-blocks.test.ts의 toProbe.
  • scripts/lib/generated-feature.ts: 계약 이름을 ID에서 만든다.

관련

  • 발견: docs/reviews/2026-11-round9-08-guardrails-docs.md 08-02(PR #23)
  • Refs: 1112/08-02
## 무엇을, 왜 round9 리뷰의 P1(1112/08-02)을 고친다. 템플릿 시험과 드릴이 저장소 사본에 고정 ID로 기능을 만든다: 매뉴얼 코드 조각 시험은 `invoice-feature`(FE-GATE-005), 생성 기능 e2e는 `order-feature`(FE-GATE-008), scaffold 드릴은 `scaffold-feature`(FE-GATE-020). 사본에는 제품 기능이 그대로 들어 있고 `create:feature`는 같은 ID를 거부한다. 그래서 매뉴얼 1단계 예시대로 `invoice-feature`를 만든 제품은 기능 코드와 상관없이 merge 게이트에서 막힌다. ## 고른 방법과 버린 대안 - 사본에 만드는 기능 ID를 모두 예약 접두어 `typecheck-probe-`로 옮기고 `scripts/lib/template-probe-features.ts` 한 곳에 둔다. - 매뉴얼 조각은 `invoice-feature` 기준 그대로 둔다. 시험이 조각과 검사 파일의 이름 넷(`INVOICE_`, `Invoice`, `invoice-`, `invoice`)을 예약 기능 이름으로 바꿔 넣는다(`renameFeatureText`, 이름 규칙은 `create-feature.ts`의 `namesOf`를 export해 같은 것을 쓴다). - 생성 기능 e2e는 메시지 키와 계약 이름을 ID에서 만든다(`generatedMessageKey`). - 버린 안: 사본에서 제품의 같은 이름 기능을 먼저 지우기(등록·조립 파일까지 지워 사본이 제품과 달라진다), `create:feature`가 흔한 이름을 거부하기(제품 이름을 막는다). ## 위험과 영향 - 이름 바꾸기는 낱말 단위 치환이다. 조각의 영어 문장 속 invoice도 바뀌지만 조각과 검사가 함께 바뀌어 결과는 같다. - 제품이 `typecheck-probe-`로 시작하는 기능을 만들면 다시 부딪친다. 매뉴얼 01·`reference/create-feature.md`에 쓰지 말라고 적었고 생성 명령이 막지는 않는다. - `scripts/test-sample-removal.ts`는 w2-fe-2 세션 파일이다. 이 PR은 529행 기능 ID 한 줄과 import 한 줄만 바꾼다. 두 PR이 겹치면 이 두 줄만 다시 맞추면 된다. - 다운스트림: 이미 복사한 프로젝트는 이 PR을 가져가면 바로 풀린다. 기능 코드는 바꿀 것이 없다(CHANGELOG는 round9 마지막 PR에 모은다). ## 검증 desktop, CI env, `scripts/verify.sh`(flock). - RED(기준 `5250ff95`에 새 시험만): `tests/unit/template-probe-features.test.ts` rc=1. 로그 `/tmp/claude-gates/r9f1-red/`. - P1 재현 X-GD02(기준 커밋, 사본에 `invoice-feature` 생성): `manual-code-blocks.test.ts`가 `feature id invoice-feature is already a feature or context`로 실패(rc=1). 로그 `/tmp/claude-gates/r9fe-xgd02/`. - X-GD02b(기준 커밋, 사본에 `order-feature --with-create` 생성 뒤 `generated-feature.spec.ts`): 17 passed. FE-GATE-008 경로는 재현되지 않았다. 이 spec의 ID 변경은 같은 원인을 막는 예방이다. - GREEN(이 브랜치): 새 시험·`create-feature`·`manual-code-blocks`·`template-feature-removal-documents` rc=0, 제품 상태(사본에 `invoice-feature`·`order-feature --with-create` 생성)에서 같은 unit 둘과 `generated-feature.spec.ts` rc=0. 로그 `/tmp/claude-gates/r9f1-green/`. - 게이트(트리 `3da7d772` = head 트리): FE-GATE-002·003·005·008·020 모두 rc=0. 020의 scaffold 드릴이 예약 ID(`typecheck-probe-scaffold-feature` 등)로 생성·제거를 끝까지 돌았다. 로그 `/tmp/claude-gates/r9f1-gates2/`. - 노트북 `scripts/verify.sh docs`: OK. ## 리뷰어가 볼 곳 - `scripts/lib/template-probe-features.ts`의 `renameFeatureText`와 `tests/unit/manual-code-blocks.test.ts`의 `toProbe`. - `scripts/lib/generated-feature.ts`: 계약 이름을 ID에서 만든다. ## 관련 - 발견: `docs/reviews/2026-11-round9-08-guardrails-docs.md` 08-02(PR #23) - Refs: 1112/08-02
donghyeon.kang added 1 commit 2026-11-12 17:40:24 +00:00
fix(test): 템플릿 시험이 사본에 만드는 기능 ID를 예약 접두어로 옮긴다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m50s
frontend-quality-gates / merge / tests (pull_request) Failing after 14m15s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 10m29s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
4ab35c4a05
템플릿 시험과 드릴이 저장소 사본에 고정 ID로 기능을 만든다. 매뉴얼
코드 조각 시험은 매뉴얼 예시 invoice-feature를(FE-GATE-005), 생성 기능
e2e·청크 복구·부팅 실패 spec은 order-feature를(FE-GATE-008), scaffold
드릴은 scaffold-feature를(FE-GATE-020) 쓴다. 사본에는 제품 기능이 들어
있고 create:feature는 같은 ID나 같은 접두어를 거부한다. 그래서 매뉴얼
1단계 예시대로 invoice-feature를 만든 제품은 기능 코드와 상관없이 merge
게이트에서 막힌다.

고른 방법: 사본에 만드는 기능 ID를 모두 이미 정한 예약 접두어
typecheck-probe-로 옮기고 scripts/lib/template-probe-features.ts 한 곳에
둔다. 매뉴얼 조각은 invoice-feature 기준 그대로 두고, 시험이 조각과
검사 파일의 이름(INVOICE_, Invoice, invoice-, invoice)을 예약 기능의
이름으로 바꿔 넣는다(renameFeatureText). 생성 기능 e2e는 메시지 키와
계약 이름을 ID에서 만든다. 버린 대안: 사본에서 제품의 같은 이름
기능을 먼저 지우기(등록·조립 파일까지 지워야 해 사본이 제품과 달라진다),
create:feature가 흔한 이름을 거부하기(제품 이름을 막는다).

위험·한계: 이름 바꾸기는 낱말 단위 치환이라 조각의 영어 문장 속
invoice도 바뀐다(조각과 검사가 함께 바뀌어 결과는 같다). 제품이
typecheck-probe-로 시작하는 기능을 만들면 다시 부딪친다. 매뉴얼과
create-feature 참조에 쓰지 말라고 적었고 생성 명령이 막지는 않는다.
measure-feature-shape-growth의 s000-feature 꼴 ID는 그대로 뒀다.

검증: desktop에서 RED(이 커밋의 시험을 기준 커밋에 얹음)와 GREEN,
제품 상태(invoice-feature·order-feature를 만든 사본)의 FE-GATE-005·008
재현은 PR 본문에 적는다.

Refs: 1112/08-02
donghyeon.kang added 1 commit 2026-11-12 19:29:30 +00:00
Merge remote-tracking branch 'origin/main' into fix/r9-reserved-probe-feature-ids
frontend-quality-gates / merge / static checks (pull_request) Canceled after 0s
frontend-quality-gates / merge / tests (pull_request) Canceled after 0s
frontend-quality-gates / merge / browser tests (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Canceled after 0s
frontend-quality-gates / external-vulnerability-provider (pull_request) Canceled after 0s
frontend-quality-gates / external-provenance-provider (pull_request) Canceled after 0s
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Canceled after 0s
frontend-quality-gates / deploy-promoted-release (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Canceled after 0s
frontend-quality-gates / main / self-tests and removal drills (pull_request) Canceled after 0s
ed8c62041a
Author
Owner

#40으로 병합됐다(main ee47480c). 이 PR의 head ed8c6204가 #40 브랜치에 merge 커밋으로 들어 있고, #40의 runner merge job 셋이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).

#40으로 병합됐다(main `ee47480c`). 이 PR의 head `ed8c6204`가 #40 브랜치에 merge 커밋으로 들어 있고, #40의 runner merge job 셋이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).
donghyeon.kang closed this pull request 2026-11-12 23:43:38 +00:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-frontend-template#26