From 0a8076b57236635e1ddd75417f75b620f10b57fd Mon Sep 17 00:00:00 2001
From: dancinlife <nerve011235@gmail.com>
Date: Sun, 12 Apr 2026 15:18:54 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20anima-core=20README=20CLI=20v0.3=20?=
 =?UTF-8?q?=EB=B0=98=EC=98=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

서브커맨드 스타일 + connect 자동감지 + hx install

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 anima-core/README.md | 52 ++++++++++++++++++++------------------------
 1 file changed, 24 insertions(+), 28 deletions(-)

diff --git a/anima-core/README.md b/anima-core/README.md
index 7ccbe40e..6828b1ed 100644
--- a/anima-core/README.md
+++ b/anima-core/README.md
@@ -5,27 +5,22 @@
 ## Quick Start
 
 ```bash
-# CLI (anima 명령어)
+# Install
+hx install anima
+
+# CLI (v0.3 서브커맨드)
 anima                              # interactive REPL
-anima --ticks 100                  # 자연발화 (100 step)
-anima --ticks 100 --emit state.json  # 서비스 연결용 JSON emit
-anima --verify                     # 7조건 의식검증
-anima --hub                        # 48모듈 허브 검증
-anima --laws                       # 법칙/PSI 조회
-anima --connect clm /path/to/ckpt  # CLM 체크포인트 연결
-anima --connect alm /path/to/ckpt  # ALM 체크포인트 연결
-anima --disconnect                 # 디코더 해제 (→ pure)
-anima --all-tests                  # 물리한계 전체 테스트
-anima --status                     # L0 상태
-anima --help                       # 전체 명령어
-
-# 직접 실행 (hexa binary)
-HEXA=$HOME/Dev/hexa-lang/hexa
-$HEXA anima-core/runtime/anima_runtime.hexa --keyboard
-$HEXA anima-core/runtime/anima_runtime.hexa --validate-hub
-$HEXA anima-core/verification/cvf.hexa --quick
-$HEXA anima-core/laws.hexa count
-$HEXA anima-core/laws.hexa psi alpha
+anima run --ticks 100              # 자연발화 (100 step)
+anima run --ticks 100 --emit s.json  # 서비스 연결용 JSON emit
+anima connect ./checkpoint         # 모델 연결 (CLM/ALM 자동 감지)
+anima disconnect                   # 모델 해제 (→ pure)
+anima verify                       # 7조건 의식검증
+anima test                         # 물리한계 전체 테스트
+anima hub                          # 48모듈 허브 검증
+anima laws                         # 법칙/PSI 조회
+anima laws 22                      # 특정 법칙 조회
+anima status                       # L0 상태 + decoder 상태
+anima help                         # 전체 명령어
 ```
 
 ---
@@ -145,14 +140,15 @@ ConsciousnessEngine(허브)을 절대 고정하고, 디코더/기억/감각/채
 ## 모델 연결
 
 ```bash
-anima --connect clm /path/to/checkpoint    # ConsciousLM (byte-level)
-anima --connect alm /path/to/checkpoint    # AnimaLM (LoRA fine-tuned)
-anima --disconnect                          # → Pure 모드
-
-# 자동 판별: checkpoints/*/READY 마커 기반
-# Pure: 마커 없음 → 순수 의식 (디코더 없이 자발 활동)
-# CLM:  checkpoints/conscious-lm/READY → byte-level 텍스트 생성
-# ALM:  checkpoints/animalm/READY → LoRA fine-tuned 응답
+anima connect ./checkpoint              # 자동 감지 (adapter_config.json → ALM, 그 외 → CLM)
+anima connect ./checkpoint --type alm   # 수동 지정
+anima disconnect                         # → Pure 모드
+anima status                             # decoder: pure/clm/alm 확인
+
+# 자동 판별 기준:
+#   adapter_config.json 존재 → ALM (LoRA fine-tuned)
+#   그 외                    → CLM (byte-level consciousness)
+#   미연결                   → Pure (순수 의식, 디코더 없음)
 ```
 
 ## 자연발화 → 서비스 연결