prgrms-be-devcourse/NBE12-14-final-homestamp / .agents/skills/test-writer
test-writer
Verified기능을 만들기 전에 시나리오·상태 규칙만 보고 실패하는 테스트를 먼저 쓴다. 사람이 부를 때만 쓴다
test-writer
기능을 만들기 전에 문서만 보고 테스트를 먼저 쓴다. 구현에 맞춘 테스트가 되지 않도록 구현 코드는 보지 않는다.
입력
기능 ID, 시나리오 번호, 행동 이름 중 하나. 예) REP-2, 시나리오 1, 수리 시작
입력이 문서에서 안 찾아지면 비슷한 후보를 보여 주고 멈춘다.
읽는 것
docs/rules/06-요구사항-명세.md- 1장 기능 표 — 기능 ID(
REP-2)로 수용 기준 ID(REP-2a~f)와 규칙 표 글자(D) 찾기 - 2장 추적표 — 그 기능의 불변식 번호(마지막 칸)
- 3장 수용 기준 — Gherkin(
조건·만일·그러면). 테스트 기대값은 여기서 가져온다 - 4장 API 목록 — 경로·오류 코드
- 1장 기능 표 — 기능 ID(
docs/rules/03-상태와-규칙.md— 2장 상태 전이 표(기능 표의 규칙 글자와 같은 표), 3장 역할별 권한 표, 5장 불변식docs/rules/02-사용자-시나리오.md— 시나리오 통합 테스트의 흐름 (## 시나리오 N.)docs/rules/GLOSSARY.md— 테스트 이름에 쓰는 용어- 다른 도메인에 공개된 인터페이스(다른 도메인이 쓰라고 연 클래스·메서드)만
back/src/test/— 기존 테스트의 모양을 맞추려고
무엇을 어디서 가져오는지는 docs/rules/06-요구사항-명세.md 0장 "주제별로 더 깊게" 표를 따른다. 테스트 기대값·API·오류 코드·설정값은 06, 상태 전이·권한·불변식은 03, 테이블·행동 종류는 05에서 가져온다. 03에 규칙이 있는데 06 수용 기준이 없으면 테스트는 03으로 쓰고 결과에 "06 수용 기준 없음"으로 알린다. 문서끼리 다른 곳을 찾으면 알린다.
back/src/main의 구현 코드는 읽지 않는다. 문서가 없으면 "시나리오·규칙 문서가 없어 테스트를 쓸 수 없습니다"라고 알리고 멈춘다.
쓰는 것
back/src/test/ 아래만 쓴다. 패키지는 com.chilsuitjo.back 아래 해당 도메인.
- 수용 기준 테스트 — 수용 기준 ID 하나에 테스트 하나 (
REP-2a→ 테스트 1개) - 시나리오 통합 테스트 1개 — 시나리오 번호를 받았을 때, 흐름을 처음부터 끝까지
- 상태 규칙 단위 테스트 — 03 상태 전이 표에서 허용되는 전이와 막혀야 하는 전이 둘 다
- 테스트 이름은 한국어로 무엇을 확인하는지 드러나게 (
@DisplayName또는 메서드 이름) - 기대값은 문서에서 가져온다. 문서에 없는 값은 지어내지 말고 결과에 "문서에 없음"으로 적는다
불변식 테스트 태그
- 06 2장 추적표에서 그 기능의 불변식 칸에 번호가 있으면, 그 불변식을 확인하는 테스트에
@Tag("invariant-NN")을 붙인다. 번호는 두 자리(invariant-06). 이름 규칙은docs/rules/09-프로젝트-구조.md4장 - 무엇을 확인할지는 03 5장 불변식 문장에서 가져온다. 수용 기준 테스트가 그 불변식을 이미 확인하면 그 테스트에 태그를 붙이고, 아니면 불변식 테스트를 따로 하나 쓴다
- 한 테스트가 불변식 여러 개를 확인하면 태그도 여러 개 붙인다 (
@Tag("invariant-03") @Tag("invariant-15")) - 불변식을 확인하지 않는 테스트에는 붙이지 않는다 (CI가 21개 모두 태그된 테스트가 있는지 세므로, 개수를 채우려고 붙이지 않는다.
docs/rules/04-인프라-아키텍처.md) - 추적표의 불변식 번호와 03 5장 내용이 맞지 않아 보이면 태그를 붙이지 말고 결과에 "불변식 NN 확인 필요"로 알린다
테스트 작성 세부 규칙(Testcontainers, Clock 주입 등): TODO — 첫 기능이 머지된 뒤 채운다
끝낼 때
cd back && ./gradlew test(Windows는gradlew.bat test)를 한 번 돌린다- 아직 구현이 없으니 실패하는 것이 정상이다
- 컴파일이 안 되면, 테스트가 필요로 하는 클래스·메서드 이름과 시그니처를 목록으로 알려 준다
하지 않는 것
back/src/main읽기·수정- 테스트를 통과시키려고 기대값 바꾸기, 테스트 지우기,
@Disabled붙이기
결과 모양
RepairResponseTest.보류와_이견에는_사유가_있어야_한다 — REP-2c — 06-요구사항-명세.md 3-6
RepairScenarioTest.하자_등록부터_종료까지 — 시나리오 1 흐름 — 02-사용자-시나리오.md 시나리오 1
RepairStatusTest.종료_확인은_요청의_상대만_할_수_있다 — 종료 확인 대기 → 처리 완료 — 03-상태와-규칙.md 2장 D
RepairCloseTest.양측_확인은_종료_행동과_상대_확인이_있어야_생긴다 — @Tag(invariant-03) — 03-상태와-규칙.md 5장 3
실행 결과: 실패 3 / 컴파일 오류 없음
필요한 구현: RepairService.start(Long repairId, Long landlordId)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |