From a4d670e505fc4d792b004c41837f8a5446c28964 Mon Sep 17 00:00:00 2001
From: parkhojeong <parkhj062@gmail.com>
Date: Wed, 14 Jan 2026 00:07:51 +0900
Subject: [PATCH 1/2] update README.md

- development setting guide
---
 README.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/README.md b/README.md
index 8c15ca9..6f39229 100644
--- a/README.md
+++ b/README.md
@@ -69,6 +69,28 @@ braillify는 **Rust 언어**로 개발되었으며, **Node.js**, **Rust**, **Pyt
 
 ---
 
+## 📦 개발 환경 가이드
+
+### 설치 목록
+- rust
+- cargo
+- bun (스크립트 관리)
+
+### 테스트 명령어
+```bash
+# 최소한의 것을 테스트 
+bun run test
+
+# 모든 것을 테스트
+cd libs/braillify && cargo test
+```
+
+### 디렉토리 설명
+
+- packages/ : 타언어 바인딩
+- libs/braillify : 코어 모듈
+
+
 ## 📦 설치
 
 ### Node.js

From cf93dbe6fa438fa084a1e3c2ad8e2c9f9aebe104 Mon Sep 17 00:00:00 2001
From: parkhojeong <parkhj062@gmail.com>
Date: Wed, 14 Jan 2026 00:13:41 +0900
Subject: [PATCH 2/2] update README.md

- development setting guide
---
 README.md | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 6f39229..a3f09bb 100644
--- a/README.md
+++ b/README.md
@@ -72,23 +72,22 @@ braillify는 **Rust 언어**로 개발되었으며, **Node.js**, **Rust**, **Pyt
 ## 📦 개발 환경 가이드
 
 ### 설치 목록
-- rust
-- cargo
-- bun (스크립트 관리)
+- Rust / Cargo: 코어 빌드 및 테스트
+- Bun: 스크립트 및 패키지 관리
 
 ### 테스트 명령어
 ```bash
-# 최소한의 것을 테스트 
+# 표준 테스트(권장)
 bun run test
 
-# 모든 것을 테스트
+# 모든 것을 테스트 (주의: 개선 중인 예외 케이스로 인해 일부 실패할 수 있습니다.)
 cd libs/braillify && cargo test
 ```
 
 ### 디렉토리 설명
 
-- packages/ : 타언어 바인딩
-- libs/braillify : 코어 모듈
+- packages/ : 타 언어 바인딩 (Node.js, Python 등)
+- libs/braillify: Rust 기반 핵심 로직 (Core)
 
 
 ## 📦 설치