ados-rcm 1.1.1107 → 1.1.1108
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +56 -0
- package/dist/catalog/SKILL.md +22 -0
- package/dist/catalog/arcm.mjs +19600 -0
- package/dist/catalog/catalog.json +18925 -0
- package/dist/catalog/editor.tsx +20 -0
- package/dist/catalog/llms.txt +17 -0
- package/dist/catalog/search-table.tsx +35 -0
- package/dist/catalog/validated-form.tsx +32 -0
- package/dist/{index-5LX4WCGR.cjs → index-auVgJXi2.cjs} +42 -42
- package/dist/{index-D-akJ0P9.js → index-kKFcvdYx.js} +565 -563
- package/dist/index.cjs +1 -1
- package/dist/index.es.js +1 -1
- package/dist/{staticAdapterSerializer-mEUTX6RS.cjs → staticAdapterSerializer-C7gbv6bj.cjs} +1 -1
- package/dist/{staticAdapterSerializer-CNUTtGDB.js → staticAdapterSerializer-DEQqNZEZ.js} +1 -1
- package/package.json +13 -2
package/README.md
ADDED
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# ados-rcm
|
|
2
|
+
|
|
3
|
+
React 컴포넌트 라이브러리와, 설치된 컴포넌트를 AI가 정확하게 사용하도록 돕는 `arcm` CLI를 함께 제공합니다.
|
|
4
|
+
|
|
5
|
+
## 소비 프로젝트에서 AI 연결하기
|
|
6
|
+
|
|
7
|
+
React 프로젝트에 CLI가 포함된 `ados-rcm` 배포 버전을 설치한 뒤, **그 프로젝트 루트**에서 실행합니다.
|
|
8
|
+
|
|
9
|
+
```sh
|
|
10
|
+
npm install ados-rcm
|
|
11
|
+
npm exec --offline -- arcm init --agents --apply
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
이 명령은 `AGENTS.md`와 Claude의 프로젝트 지침에 ARCM 사용 안내를 연결합니다. 기존 지침은 보존하고 ARCM 관리 블록만 생성·갱신합니다. `CLAUDE.md`가 없고 `.claude/CLAUDE.md`가 이미 있다면 후자를 사용합니다. 미리 확인하려면 `--apply`를 생략하거나 `--dry-run`을 추가합니다.
|
|
15
|
+
|
|
16
|
+
**AI 세션을 새로 시작하거나 프로젝트 지침을 다시 읽은 뒤**, 평소처럼 요청합니다.
|
|
17
|
+
|
|
18
|
+
> ARCM으로 이름 검색과 정렬이 가능한 구성원 목록 화면을 만들어줘. 데이터는 이 프로젝트의 API를 사용해.
|
|
19
|
+
|
|
20
|
+
해당 프로젝트 지침을 읽는 AI는 기존 앱 래퍼를 먼저 확인하고, 설치된 CLI로 실제 props·상태 계약·조합 예제를 조회한 뒤 소비 프로젝트 코드를 구현할 수 있습니다. ARCM 저장소나 Storybook을 실행하거나 매번 `SKILL.md`를 지정할 필요는 없습니다. 실제 지침 로드와 구현 수행은 사용하는 AI 도구의 기능 및 권한에 따릅니다.
|
|
21
|
+
|
|
22
|
+
## 직접 조회하기
|
|
23
|
+
|
|
24
|
+
```sh
|
|
25
|
+
npm exec --offline -- arcm doctor --json
|
|
26
|
+
npm exec --offline -- arcm search "검색 테이블" --json
|
|
27
|
+
npm exec --offline -- arcm component BTable --json
|
|
28
|
+
npm exec --offline -- arcm build "검색 테이블" --json
|
|
29
|
+
npm exec --offline -- arcm template search-table src/SearchTable.tsx
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
- CLI는 별도 설치가 필요하지 않습니다. Node 20 이상을 대상으로 번들됩니다.
|
|
33
|
+
- `build`는 조합 추천이며 완성 앱 생성이나 서버 연결 명령이 아닙니다.
|
|
34
|
+
- 생성되는 TSX는 `ados-rcm`을 import하는 일반 React 코드입니다. 템플릿 데이터는 로컬 예제입니다.
|
|
35
|
+
- `doctor.ready`는 설치 의존성, `doctor.agentsReady`는 현재 설치 버전의 프로젝트 AI 안내 연결 여부입니다. 실제 AI 실행이나 브라우저 초기화 여부는 별도로 확인해야 합니다.
|
|
36
|
+
- 패키지를 업데이트한 뒤 같은 AI 초기화 명령을 다시 실행하면 안내가 갱신됩니다. 중복 블록은 추가하지 않습니다.
|
|
37
|
+
- AI 초기화는 앱 진입점·테마·package.json·전역 AI 설정을 변경하지 않습니다. 일반 템플릿 생성은 기존 파일을 덮어쓰지 않습니다.
|
|
38
|
+
|
|
39
|
+
## 앱 초기화와 상태 계약
|
|
40
|
+
|
|
41
|
+
기존 프로젝트의 테마 설정을 우선 사용합니다. 새 앱은 DOM이 준비된 브라우저 진입점에서 `AThemes.init({})`을 한 번 호출합니다. AI 연결 초기화와 테마 초기화는 서로 다릅니다.
|
|
42
|
+
|
|
43
|
+
```tsx
|
|
44
|
+
import { AThemes } from 'ados-rcm';
|
|
45
|
+
|
|
46
|
+
AThemes.init({});
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
자세한 사용법은 설치 버전에 포함된 문서로 확인합니다.
|
|
50
|
+
|
|
51
|
+
```sh
|
|
52
|
+
npm exec --offline -- arcm docs getting-started
|
|
53
|
+
npm exec --offline -- arcm docs controlled-state
|
|
54
|
+
npm exec --offline -- arcm docs theming
|
|
55
|
+
npm exec --offline -- arcm --help
|
|
56
|
+
```
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: arcm
|
|
3
|
+
description: Use when building UI with ados-rcm components.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# ARCM 1.1.1108
|
|
7
|
+
|
|
8
|
+
# Building React UI with ARCM
|
|
9
|
+
|
|
10
|
+
This project uses ados-rcm. For React UI work, reuse its existing project wrappers first, then compose the installed A*/B* components. Project-specific instructions take precedence. Do not guess props, add a different UI library, or require the ARCM source repository or Storybook.
|
|
11
|
+
|
|
12
|
+
Run commands from this consumer project root. Use `npm exec --offline -- arcm` so the installed project CLI answers without fetching an unrelated package or using a global copy. No separate CLI package or manual SKILL.md loading is needed.
|
|
13
|
+
|
|
14
|
+
1. `npm exec --offline -- arcm doctor --json` checks installed versions and dependencies. `ready` covers dependency checks; `agentsReady` covers these instructions, not actual browser initialization.
|
|
15
|
+
2. `npm exec --offline -- arcm search "purpose" --json` finds relevant components, recipes and guides.
|
|
16
|
+
3. `npm exec --offline -- arcm component AInput --json` reads actual props, inherited contracts and imports. Replace AInput with each component being used; never infer compatibility from another release.
|
|
17
|
+
4. `npm exec --offline -- arcm build "purpose" --json` recommends a starting recipe; it does not generate an application or connect APIs.
|
|
18
|
+
5. `npm exec --offline -- arcm docs controlled-state` explains useValue/useCheck tuples. `npm exec --offline -- arcm docs getting-started` explains browser-only AThemes initialization; preserve any initialization the project already owns.
|
|
19
|
+
6. `npm exec --offline -- arcm template search-table` reads a working recipe. To create a new file, preview with `npm exec --offline -- arcm template search-table src/SearchTable.tsx --dry-run`, then omit --dry-run. Never overwrite existing application code.
|
|
20
|
+
7. Implement the requested screen in this consumer project, wire its real data and actions, and run its own type checks, tests and relevant browser checks. Recipe data is a local example, not a server API, persistence or authentication implementation.
|
|
21
|
+
|
|
22
|
+
Check JSON errors by error.code and keep response.version equal to this project installed release. Do not automatically install packages, change global settings or modify another project. This CLI does not call an LLM or start an MCP server.
|