diff --git a/README.md b/README.md
new file mode 100644
index 0000000..089d794
--- /dev/null
+++ b/README.md
@@ -0,0 +1,38 @@
+# Ariweb Suite
+
+고객이 회원가입·로그인 → 상품 선택 → 사이트 제작(Webmaker) → 배포 → 도메인·HTTPS → 메일(AriMail) → 백업 → 운영(재배포·복원·이전·소유권·해지)까지 **하나의 연결된 서비스**로 이용하는 통합 플랫폼이다.
+운영자는 HAL(`hal.ariweb.net`)에서 릴리스·서버·모듈·작업·장애·복구를 관리하고, HAL 이 Node Agent 를 통해 나머지 모든 모듈을 배포·갱신·되돌리기·복구한다.
+
+- 버전: **0.1.1** — 변경 이력은 [VERSION_HISTORY.md](VERSION_HISTORY.md)
+- 설계·개발 규약: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) · 포털↔HAL 작업 계약: [docs/HAL-JOBS.md](docs/HAL-JOBS.md) · HAL↔Agent 프로토콜: [docs/HAL-AGENT.md](docs/HAL-AGENT.md)
+- 도입 소스(Webmaker 1.7.3 · AriMail 1.0.11): [IMPORTED_SOURCES.md](IMPORTED_SOURCES.md) — `node scripts/import-sources.mjs` 로 갱신
+- 개발 지시 원문: `Ariweb-Suitle_Dev-Order_v0.1.1.md`
+
+## 구성
+
+| 프로세스 | 진입점 | 포트 | 공개 주소 |
+|---|---|---|---|
+| HAL(제어 평면·운영자 콘솔·공개 상태) | `hal/index.mjs` | 127.0.0.1:8900 | https://hal.ariweb.net |
+| 고객 포털 | `portal/index.mjs` | 127.0.0.1:8910 | https://my.ariweb.net |
+| Node Agent | `agent/index.mjs` | — | 각 관리 서버 |
+| Webmaker(도입) | `modules/webmaker/server.js` | 127.0.0.1:3080 | https://webmaker.ariweb.net |
+| AriMail(도입) | `modules/arimail/server/index.mjs` | 127.0.0.1:8790 + 메일 포트 | https://webmail.ariweb.net |
+
+외부 npm 의존성 없음. Node 22.13 이상(`node:sqlite`).
+
+## 개발
+
+```bash
+node test/run.mjs                 # 전체 회귀 테스트 (test/*.test.mjs)
+node test/run.mjs lib             # 이름에 lib 가 들어간 테스트만
+node scripts/import-sources.mjs   # 참조 저장소 고정 커밋에서 모듈 소스 갱신 + manifest
+node scripts/release.mjs          # 릴리스 artifact(dist/<version>/) 생성·검사
+ARIWEB_PORTAL_DATA=./data/portal node portal/index.mjs
+ARIWEB_HAL_DATA=./data/hal node hal/index.mjs
+```
+
+## 배포 순서(§32)
+
+1. `main` 에 병합된 승인 릴리스에서 `node scripts/release.mjs` 로 artifact 생성
+2. 최초 설치에서만 `deploy/bootstrap-hal.sh` 로 HAL 설치(HAL 자체 건강·실행 버전 확인, 첫 Node Agent 등록)
+3. 이후 모든 모듈(포털·Webmaker·AriMail·Agent·백업·관측)은 HAL 운영자 콘솔의 모듈 배포 작업으로만 설치·갱신·되돌리기
diff --git a/VERSION_HISTORY.md b/VERSION_HISTORY.md
new file mode 100644
index 0000000..437f67b
--- /dev/null
+++ b/VERSION_HISTORY.md
@@ -0,0 +1,31 @@
+# VERSION_HISTORY
+
+## 0.1.1 (2026-10-26)
+
+- **작성자**: Hera(개발 지시 `Ariweb-Suitle_Dev-Order_v0.1.1.md`) · 구현: Claude Fable 5.1 (Ariweb Suite 통합 개발)
+- **이전 버전**: 0.1.0 (개발 지시 문서만 존재, 코드 없음 — 이번 0.1.1 이 첫 구현 릴리스)
+- **기준 저장소**: https://source.ibit.kr/OZ-Group/AriWeb-Suite
+
+### 경고 구간 변경
+- (통합 후 기입)
+
+### 재사용한 기존 기능(그대로 도입)
+- (통합 후 기입)
+
+### 수정한 기존 기능(최소 연결 변경·오류 수정·정책 개선)
+- (통합 후 기입)
+
+### 고객 화면
+### 운영자 화면
+### 사이트 생성과 배포
+### 호스팅
+### 메일
+### 도메인과 인증서
+### 상거래
+### 백업과 복원
+### 이전
+### 모니터링
+### HAL/Node Agent 운영
+### 도입 소스
+### 알려진 제한
+### 미확정 정책값