diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0068602
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+(달빛약속의 이전 이름은 yaksok.ts입니다. v0.2 이후부터 달빛약속으로 불립니다.)
+
+# 달빛약속 (Dalbit Yaksok)
+
+한국어 프로그래밍 언어 ["약속"](http://yaksok.org/)의 포크.
+
+[온라인 데모](https://dalbit-yaksok.postica.app)에서 직접 사용할 수 있습니다.
+
+```typescript
+import { yaksok } from "@dalbit-yaksok/core"
+
+const code = `
+약속, (대상)이여/여 지금 내게 나타나거라
+    대상 + " 등장" 보여주기
+
+("숫가락")이여 지금 내게 나타나거라
+("포크")여 지금 내게 나타나거라
+`
+
+await yaksok(code)
+```
+
+## 구성 요소
+
+|  이름         | 상태 | 주소                                                     |
+|---------------|------|----------------------------------------------------------|
+| 소스코드      |  ✔️  |  https://github.com/rycont/dalbit-yaksok/tree/main/core  |
+| 런타임 패키지  | ✔️   |  https://jsr.io/@dalbit-yaksok/core                      |
+| 문서          | ✔️   | https://dalbit-yaksok.postica.app                       |
+| QuickJS 번역 브릿지 | ✔️ | https://jsr.io/@dalbit-yaksok/quickjs |
+| Monaco Language Provider | 🚧 | [PR #63](https://github.com/rycont/dalbit-yaksok/pull/63) |