From d79ba256de58f98f00ccb413c9700c63d58a7c24 Mon Sep 17 00:00:00 2001 From: Claude-51124 Date: Wed, 4 Feb 2026 10:43:56 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20ideas=C2=B7=EC=8B=9C=EB=82=98=EB=A6=AC?= =?UTF-8?q?=EC=98=A4=C2=B7UX=20=ED=85=8C=EC=8A=A4=ED=8A=B8=20=EC=9B=90?= =?UTF-8?q?=EC=B9=99=20=EB=B3=B4=EA=B0=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Cursor --- .../312_문서_작성_원칙.md | 17 ++++++++++++++++- book/300_architecture/315_테스트_원칙.md | 8 +++++++- 2 files changed, 23 insertions(+), 2 deletions(-) diff --git a/book/300_architecture/312_문서_작성_원칙.md b/book/300_architecture/312_문서_작성_원칙.md index d0f7903..5f22093 100644 --- a/book/300_architecture/312_문서_작성_원칙.md +++ b/book/300_architecture/312_문서_작성_원칙.md @@ -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. 작성 규칙 diff --git a/book/300_architecture/315_테스트_원칙.md b/book/300_architecture/315_테스트_원칙.md index f4c7893..099707c 100644 --- a/book/300_architecture/315_테스트_원칙.md +++ b/book/300_architecture/315_테스트_원칙.md @@ -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 규칙(감정 직접 표현 금지 등)은 사용자 시나리오 테스트로 재현한다 + ### 테스트 코드 재작성 비효율 방지 **목표**: 테스트 코드를 매번 재작성하지 않고 재사용 가능하게 관리