사람함께에이전트▾
사람 — 직접 정하고 책임지는 비즈니스 규칙과 흐름. 직접 읽어보세요.
함께 — 개념은 알아두고, 세부 규칙은 에이전트가 따릅니다.
에이전트 — 에이전트가 따르는 규칙과 레퍼런스. 필요할 때 찾아보세요.
CLI 레퍼런스▾
AkanJS 레퍼런스▾
UI 레퍼런스▾

스칼라 명령

앱이나 라이브러리 안에 스칼라를 만들고 지우는 명령 두 가지입니다. 스칼라는 다른 모델 안에 함께 저장되는 재사용 값 객체이며, 자체 테이블을 가진 모델이 아닙니다. 그런 모델에는 create-module을 씁니다.
이 페이지에서 쓰는 말
Price처럼 다른 모델 안에 함께 저장되는 필드 묶음입니다. 자체 테이블이 없습니다.
sys
스칼라가 들어가는 앱이나 라이브러리입니다. akan create-scalar price shop에서는 shop입니다.
스캐폴드
명령이 만들어 주는 시작 코드로, 직접 고쳐 쓰는 것을 전제로 합니다.
리포트
create-scalar가 끝날 때 출력하는 결과로, 만든 파일과 다음에 실행할 명령이 담깁니다.
명령마다 건드리는 파일
파일
create-
scalar
remove-
scalar
lib/__scalar/<scalar>/에 스캐폴드로 생기는 파일
<scalar>.abstract.md
✓
✓
값의 의미와 재사용 규칙을 채워 넣을 제목들입니다.
<scalar>.constant.ts
✓
✓
필드를 담는 클래스로, 자리표시자 field: field(String) 하나로 시작합니다.
<scalar>.dictionary.ts
✓
✓
scalarDictionary로 쓰는 영어·한국어 라벨입니다.
<scalar>.document.ts
✓
✓
서버 쪽 클래스로, by(cnst.<Scalar>) 한 줄입니다.
같은 폴더에 직접 작성하는 파일
<Scalar>.Template.tsx
✓
상위 폼 안에서 값을 편집하는 에디터입니다.
<Scalar>.Unit.tsx
✓
상위 카드나 상세 화면 안에서 값을 보여 주는 컴포넌트입니다.
폴더 밖
스칼라를 쓰는 코드
다른 모듈의 field(Price) 같은 필드와 import입니다. 두 명령 모두 건드리지 않습니다.
✓만들거나 지움건드리지 않음
알아 둘 규칙
  • 대상을 적거나, 목록에서 고릅니다. 두 번째 인자가 앱이나 라이브러리입니다. 생략하거나 없는 이름을 적으면 CLI가 목록을 띄웁니다. 스칼라 이름을 생략하면 입력을 받습니다.
  • create-scalar는 덮어쓰지 않습니다. 같은 경로에 파일이 있으면 내용을 바꾸지 않으므로, 다시 실행하면 빠진 파일만 새로 생깁니다.
  • create-scalar는 리포트로 끝납니다. 만든 파일과 다음 단계인 akan sync <sys>, akan lint <sys>가 적혀 있습니다. -o json을 붙이면 같은 리포트를 JSON 객체 하나로 받습니다.
  • remove-scalar는 폴더 이름을 적은 그대로 씁니다. 소문자로 바꾸지 않으므로 Coordinate가 아니라 coordinate로 적습니다. 리포트는 출력하지 않습니다.
관련 페이지

create-scalar

스칼라를 만듭니다. 자체 테이블이 필요 없는 재사용 값 객체나 데이터 형태입니다. lib/__scalar/<scalar>/에 파일 네 개를 만들고, 만든 파일 목록을 출력합니다.
형식
인자
scalar-nameString필수
스칼라 이름입니다. 공백은 없애고 첫 글자는 소문자로 바꾸며, 생략하면 입력을 받습니다.
sysString
대상 앱이나 라이브러리로, shop 같은 이름입니다. 생략하면 목록에서 고릅니다.
옵션
--formatString기본값 markdownmarkdown | json · -o
markdown은 사람이 읽는 형식이고, json은 같은 리포트를 객체 하나로 출력해 스크립트와 에이전트가 씁니다.
참고
파일
abstract, constant, dictionary, document 네 개입니다. Template과 Unit은 직접 작성합니다.
이름
AccessToken을 주면 폴더는 accessToken, 클래스는 AccessToken이 됩니다.
자리표시자
constant의 자리표시자 field와 dictionary의 라벨을 실제 필드로 바꿉니다.
기존 파일
같은 경로에 이미 있는 파일은 내용을 바꾸지 않고, 포매터로 모양만 정리할 수 있습니다.
예시

remove-scalar

앱이나 라이브러리에서 스칼라를 지웁니다. lib/__scalar/<scalar>/ 폴더 전체를 확인 없이 한 번에 지웁니다.
형식
인자
scalar-nameString필수
lib/__scalar/ 아래의 폴더 이름으로, 적은 그대로 씁니다. 생략하면 입력을 받습니다.
sysString
대상 앱이나 라이브러리로, shop 같은 이름입니다. 생략하면 목록에서 고릅니다.
참고
먼저 확인
모듈, 딕셔너리, 템플릿, 서비스 페이로드 타입이 스칼라를 import하는 경우가 많습니다.
정확한 이름
accessToken처럼 폴더 이름을 적습니다. 맞는 폴더가 없으면 아무것도 지우지 않고 조용히 끝납니다.
남는 것
다른 모듈에서 스칼라를 쓰는 필드와 import는 남으므로, 직접 지웁니다.
그다음
akan sync <sys>를 실행해 생성 파일에서도 스칼라를 뺍니다.
예시

MIT 라이선스 하에 배포되었습니다.

내 AI에 이 문서 연결하기

MCPhttps://akanjs.com/mcp
Copyright © 2026 Akan.js 모든 권리 보유.시스템 관리자bassman