Files
clean-architecture-frontend…/.claude/rules/tests.md
DongHyeonka 574212225d
frontend-quality-gates / merge / static checks (pull_request) Successful in 1m44s
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 / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / self-tests and removal drills (pull_request) Skipped
frontend-quality-gates / merge / tests (pull_request) Successful in 14m29s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 6m43s
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
merge: PR #39를 합친 검사 브랜치에 넣는다
# Conflicts:
#	tests/unit/manual-code-blocks.test.ts
#	tests/unit/template-feature-removal-documents.test.ts
2026-11-13 07:30:33 +09:00

2.6 KiB

paths
paths
tests/**
**/*.spec.ts
vitest.config.ts
playwright*.config.ts

테스트를 쓰거나 고칠 때

정본은 docs/testing/taxonomy.md(층·명령·실행 환경)와 docs/work/reference/testing.md(결함을 막는지 확인하는 법)다.

  1. 층은 프레임워크가 아니라 필요한 실행 환경으로 정한다: Node만 tests/unit, React·hook tests/component, HTTP/MSW·IndexedDB·조립된 경계 tests/integration, 실제 브라우저 tests/e2e 등, 한 기능의 테스트 tests/features/<id>/.
  2. 동작을 바꾸면 재현 테스트가 먼저 실패하고(RED) 고친 뒤 통과한다(GREEN). 검출력이 문제였으면 보호 규칙을 지우는 변이를 넣어 새 테스트가 실패하는지 본다.
  3. 템플릿 원래 상태 밖에서도 돈다: 기능을 더한 상태, 확장 지점을 채운 상태, 입력·객체가 셋 이상.
  4. 단언이 대상에 닿는지 본다: fixture가 비어 첫 줄에서 return하지 않는가, 로딩·오류 화면이나 fixture 자신을 검사하지 않는가.
  5. .only를 두지 않는다. .skip·fixme는 Playwright spec에만, owner·defect·route·만료일이 있는 quarantine으로만 둔다(scripts/check-test-evidence.ts). 빠른 계층에는 quarantine이 없다. 편집 훅이 마지막 커밋보다 늘어난 skip·only·fixme·todo를 알린다.
  6. 가끔 떨어지는 테스트를 재시도·timeout 늘리기·worker 줄이기·force 클릭으로 덮지 않는다. 반복 실행 → 실패 기록 → 결정적 재현 → 수정 → 변이 순서로 원인을 찾는다.
  7. 환경에 기대지 않는다: gitignore된 생성물, 작성자 PC의 글꼴·CPU, 바깥 env(CI=true, 빌드 식별값). 테스트가 띄우는 빌드·서버의 env는 테스트가 정한다.
  8. 플랫폼 테스트를 기능·스타터 화면에 묶지 않는다(테스트 전용 라우트, tests/mocks/). 테스트가 지워도 되는 문서(docs/reviews/ 등)를 읽지 않는다.
  9. 자식 프로세스를 띄우는 suite는 자기 timeout을 선언한다. 전역 timeout을 올리지 않는다. 기본값보다 긴 timeout은 childProcessTimeout(<desktop에서 잰 가장 긴 ms>)로만 준다(손 숫자는 tests/unit/test-timeout-declarations.test.ts가 거절).

돌리는 법

  • 노트북에서는 돌리지 않는다. 한 파일도 desktop에서 scripts/verify.sh exec -- node scripts/run-vitest.ts run <file>로 돌린다(이 runner가 생성물을 먼저 만든다. pnpm exec vitest run <file>은 import 오류로 실패한다). 실행 위치의 정본은 docs/work/operate.md 4.1절이다.