docs: ideas·시나리오·UX 테스트 원칙 보강

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Claude-51124 2026-02-04 10:43:56 +09:00
parent 640eacdf55
commit d79ba256de
2 changed files with 23 additions and 2 deletions

View File

@ -1,7 +1,7 @@
# 문서 작성 원칙
**작성일**: 2025-10-13
**수정일**: 2026-01-21 (문서 크기 제한 완화: 트러블슈팅 100→150줄, 계획 150→200줄 등)
**수정일**: 2026-02-04 (아이디어·시나리오 관리 원칙 추가)
**참고**: AGENTS.md, 311_백엔드_구조_원칙.md
---
@ -90,6 +90,21 @@
**금지 사례**: 상세 내용 재작성, 코드/테스트 결과 상세 재현, "교훈" 섹션 전체 복사
### 아이디어 문서
**경로**: `DOCS/journey/ideas/`
**규칙**:
- **미구현 아이디어만 유지**: 구현 결과가 troubleshooting·plans에 정리되면 ideas 문서 삭제(또는 `deprecated/`로 이동)
- **핵심만 기록**: 간단한 흐름·배경만 남기고 상세 구현 내용은 계획/트러블슈팅으로 이동
### 시나리오 문서
**경로**: `DOCS/journey/scenarios/`
**규칙**:
- 문서 상단에 `상태: 완료 / 부분 / 미구현`을 명시
- 구현 완료 시 대응되는 troubleshooting·plans 링크를 함께 표기
- UX 흐름만 기록하고 내부 구현 세부 설명은 링크로 참조
---
## 2. 작성 규칙

View File

@ -1,7 +1,7 @@
# 테스트 원칙
**작성일**: 2025-01-03
**수정일**: 2026-02-05 (테스트 원칙으로 변경, TDD 원칙 추가)
**수정일**: 2026-02-04 (UX 검증 원칙 추가)
**참고**: 311_백엔드_구조_원칙.md, 312_문서_작성_원칙.md
---
@ -18,6 +18,12 @@
DecisionEngine, intent, 캘린더 로직 등은 항상 테스트에서 기대 행동을 확정한 뒤 수정한다.
### UX 검증 원칙
- 사용자가 실제로 보는 문구·행동만 검증한다 (예: 응답 문장, 버튼 노출 여부)
- 내부 안내/제약 설명(“직접 언급 금지” 같은 시스템 지시문)은 금지어 검증 대상이 아님
- UX 규칙(감정 직접 표현 금지 등)은 사용자 시나리오 테스트로 재현한다
### 테스트 코드 재작성 비효율 방지
**목표**: 테스트 코드를 매번 재작성하지 않고 재사용 가능하게 관리