docs: clarify stable regression test naming

2026-10-06 22:11:16 +00:00
parent af75139cc1
commit 18676070b2
2 changed files with 7 additions and 4 deletions
@@ -1,7 +1,7 @@
 ---
 name: gitea-issue-implementation
 description: 승인된 Gitea Issue를 구현·검증하고 Gitea PR로 전달한다.
-version: 0.4.4
+version: 0.4.5
 author: genichin, Hermes Agent
 license: MIT
 platforms: [linux]
@@ -149,6 +149,7 @@ Discovery가 `신규 작성` 또는 `수정`으로 판정한 문서만 작성한
 ### 7. Test-first 구현

 1. Acceptance matrix에서 변경 전 실패해야 하는 정상, 실패, 경계와 보안 test를 먼저 추가한다.
+   - Test file과 test function 이름은 추적 번호가 아니라 안정적인 기능·동작·불변조건을 표현한다. Issue, PR, review, comment 번호나 일시적인 finding ID를 이름에 넣지 않는다. 추적성은 acceptance matrix, commit, PR과 evidence metadata에 기록한다.
 2. 새 test가 의도한 이유로 실패하는지 실행해 확인한다. 환경 오류나 잘못된 fixture 실패를 RED evidence로 사용하지 않는다.
 3. 기존 architecture와 dependency direction을 유지하는 최소 source 변경으로 test를 통과시킨다.
 4. 실패 경로가 외부 상태를 변경하지 않는지 검증한다.