빠른 시작

1) 설치

dotnet tool install -g coders

설치/사용법 상세

워크스페이스 초기화

coders init을 실행해 기본 설정과 샘플 .jssp 파일 묶음을 생성합니다.

• -f|--force가 없으면 config.yml이 있을 때 작업을 중단합니다.
• -v|--verbose로 콘솔 로그를 정보 레벨로 확장합니다.
• --force를 사용하면 기존 파일을 새 템플릿으로 덮어씁니다.

생성되는 config.yml 기본값은 다음과 같습니다:

llmOptions:
  # 사용할 LLM 공급자
  provider: "ollama"
  # 빌드 시 사용할 모델 이름
  model: "gpt-oss-safeguard:20b"
  # LLM 서비스 엔드포인트와 인증 정보
  url: "http://localhost:11434"
  apiKey: "OLLAMA_API_KEY"
  timeoutSeconds: 300
  stream: true
entry: main.jssp
projects: []

루트의 llmOptions는 LLM 호출에 필요한 공급자, 모델, 엔드포인트, 인증, 시간 제한, 스트리밍 설정을 담당합니다. projects는 플랫폼별 산출물을 정의하며, coders platform add로 항목을 추가한 뒤 수정하면 됩니다.

플랫폼 관리

• coders platform list [-v]: 등록된 플랫폼 키와 기본 타깃/언어 정보를 출력합니다.
• coders platform add <platform> [-v]: 지정한 플랫폼의 기본 프로젝트 구성을 config.yml에 추가합니다. 생성된 엔트리/출력 경로와 옵션은 필요에 따라 편집하면 됩니다.
• coders platform remove <platform> [-v]: 예약된 하위 명령입니다.

소스 빌드

coders build <platform> [-v]로 .jssp를 파싱하고 지정한 플랫폼에 맞춰 코드를 생성합니다.

• platform은 config.yml의 projects 항목에 선언된 플랫폼 키와 일치해야 합니다.
• config.yml이 없으면 빌드가 중단되며, 엔트리 파일이 없으면 오류가 발생합니다.
• 출력 디렉터리는 없으면 자동으로 만들어집니다.

프롬프트 추출

coders extract <target> <platform> [-o|--output <path>] [-v]로 프롬프트 등 리소스를 추출합니다.

• target은 추출 대상(예: prompt), platform은 플랫폼 키입니다.
• --output으로 결과를 저장할 디렉터리를 바꿀 수 있으며, 지정하지 않으면 현재 위치가 사용됩니다.

대표 흐름

coders init
coders platform add <platform>
coders build <platform> -v

초기화 후 필요한 플랫폼을 구성에 추가하고, 동일한 키로 빌드를 실행하는 순서입니다.

2) 워크스페이스 초기화

coders init

생성되는 기본 파일:

• config.yml
• main.jssp

3) 플랫폼 추가

coders platform add springboot
coders platform add reactjs
coders platform add mysql

config.yml에 projects 항목이 추가됩니다.

4) DSL 작성

main.jssp에 Coders DSL을 작성합니다.

domain Email string(320);

table user {
  user_id int64 auto;
  email Email unique;
  key(user_id);
}

5) 빌드

coders build springboot

결과물은 config.yml의 outPath에 생성됩니다.

플랫폼별 빌드 예시

coders build springboot
coders build reactjs
coders build mysql

각 플랫폼은 projects 설정에 맞춰 별도 출력 디렉터리로 생성됩니다.

단일 실행으로 여러 플랫폼 빌드

플랫폼 키를 반복 실행하거나, 스크립트로 묶어 실행합니다.

coders build springboot
coders build reactjs
coders build mysql

현재 CLI에는 다중 플랫폼 일괄 빌드 옵션이 없으므로 순차 실행합니다.

6) 프롬프트 추출 (선택)

coders extract prompt springboot

플랫폼별 변환 규칙을 확인할 때 유용합니다.

체크리스트

• config.yml의 projects에 플랫폼이 등록되어 있는가?
• entry 파일이 존재하는가?
• LLM 설정(llmOptions)이 올바른가?

자주 하는 실수

• coders build 실행 시 플랫폼 키 누락
• entry가 main.jssp와 다른데 수정하지 않음
• LLM 공급자/모델명이 실제 서비스와 불일치