명령이 어떻게 작동하는지

알아야 할 한 가지: rasen은 두 종류의 명령을 가지고 있으며, 그들은 두 개의 다른 곳에서 실행됩니다.

• rasen ... 명령은 터미널에서 실행됩니다. (예: rasen init.)
• /rasen:... 명령은 AI 어시스턴트의 채팅에서 실행됩니다. (예: /rasen:propose.)

/rasen:propose를 터미널에 입력하고 아무것도 안 되면, 이 페이지가 이유입니다. rasen의 잘못된 절반과 대화하고 있습니다. 슬래시 명령은 터미널 명령이 아닙니다. AI 코딩 어시스턴트에게 주는 명령이며, "로그인 양식 추가"라고 입력하는 동일한 채팅 상자입니다.

이 단일 구분이 새 사용자의 가장 일반적인 걸림돌이므로, 명확히 해봅시다.

두 가지 절반

Rasen은 두 개의 모자를 쓴 하나의 프로젝트입니다.

CLI (터미널 절반). 셸에서 설치하고 실행하는 rasen이라는 프로그램입니다. 프로젝트를 설정하고, 변경을 나열하고 검증하고, 대시보드를 표시하고, 완료된 작업을 보관합니다. iTerm, VS Code 터미널, PowerShell, git 또는 npm을 실행하는 어디든지 이것들을 입력합니다.

rasen init        # 이 프로젝트에서 rasen 설정
rasen list        # 활성 변경 보기
rasen view        # 대화형 대시보드 열기

슬래시 명령 (채팅 절반). /rasen:propose와 /rasen:apply 같은 짧은 명령이며 AI 어시스턴트에 입력합니다. 이것들은 AI에게 rasen 워크플로우를 따르도록 지시합니다: 제안서 초안, 스펙 작성, 작업 목록에서 구축, 완료되면 보관. Claude Code, Cursor, Windsurf, Copilot 또는 사용하는 어떤 어시스턴트든 입력합니다.

/rasen:propose add-dark-mode    (AI 채팅에 입력)
/rasen:apply                    (AI 채팅에 입력)
/rasen:archive                  (AI 채팅에 입력)

정신 모델을 한 그림으로:

        당신의 터미널                         당신의 AI 어시스턴트의 채팅
   ┌──────────────────────┐               ┌──────────────────────────────┐
   │  $ rasen init     │   설치    │  /rasen:propose add-dark-mode  │
   │  $ rasen list     │  ──────────►  │  /rasen:apply                  │
   │  $ rasen view     │   명령    │  /rasen:archive                │
   └──────────────────────┘    & 스킬  └──────────────────────────────┘
        여기서 rasen 실행                   여기서 /rasen:* 실행

화살표를 주목하세요. 터미널에서 rasen init을 실행하는 것이 AI 도구에 슬래시 명령을 설치하는 것입니다. 터미널 절반이 채팅 절반을 설정합니다. 그 후 일일 운전은 대부분 채팅에서 발생합니다.

"대화형 모드를 시작하려면?"

시작할 별도의 대화형 모드는 없습니다. 이 질문은 많이 나오므로 평범한 답변을 받을 자격이 있습니다.

특별한 rasen 모드에 진입하지 않습니다. AI 코딩 어시스턴트를 항상처럼 열고 채팅에 슬래시 명령을 입력하세요. 슬래시 명령이 rasen에 "진입"하는 방법입니다. 어시스턴트가 그것을 인식하고, 일치하는 rasen 스킬을 로드하고, 워크플로우를 따르기 시작합니다.

따라서 실제 명령은:

1. 프로젝트에서 AI 코딩 어시스턴트 (Claude Code, Cursor, Windsurf 등)를 엽니다.
2. 채팅에 /rasen:propose를 입력합니다. 다른 요청을 입력하는 동일한 곳입니다.
3. 자동완성을 봅니다: rasen이 설치되어 있으면 슬래시를 입력하면서 /rasen:propose, /rasen:apply 등이 나타나야 합니다.

그것뿐입니다. 토글할 모드, 시작할 데몬, 별도의 창은 없습니다.

정말로 대화형인 것이 터미널에 있습니다: rasen view. 스펙과 변경을 탐색하기 위한 대시보드를 엽니다. 하지만 그것은 뷰어이고, 제안하고 구축하는 것이 아닙니다. 구축은 채팅의 슬래시 명령을 통해 발생합니다.

이 분리가 존재하는 이유

이해할 가치가 있습니다. rasen이 25개 이상의 다양한 AI 도구와 호환되는 이유를 설명하기 때문입니다.

CLI는 엔진입니다. 규칙을 알고 있습니다: 변경 폴더가 어떻게 보이는지, 어떤 산출물이 어디에 의존하는지, 증량 스펙을 신뢰할 수 있는 단일 소스로 병합하는 방법. 모든 곳에서 동일합니다.

슬래시 명령은 조향 바퀴이며, 모든 AI 도구는 약간 다른 것을 가지고 있습니다. Claude Code는 그들을 명령이라고 부릅니다. Cursor와 Windsurf는 자신만의 형식을 가지고 있습니다. 일부 도구는 스킬이라고 부릅니다. rasen init을 실행할 때, rasen은 선택한 각 도구에 대해 올바른 종류의 파일을 생성하므로 동일한 /rasen:propose 의도가 선호하는 어시스턴트가 무엇이든 작동합니다.

이 설계의 강점: 워크플로우를 한 번 배우고 도구 전체에서 이동합니다. 트레이드오프: 명령의 정확한 구문은 도구 간에 약간 다를 수 있으며, 이것이 다음 섹션입니다.

도구별 슬래시 명령 구문

의도는 어디에서나 동일합니다. 구두점이 다릅니다. 어시스턴트와 일치하는 형식을 사용하세요.

대부분의 도구는 콜론 형식 (/rasen:propose) 또는 대시 형식 (/rasen-propose) 중 하나를 사용합니다. 몇몇 도구 (ForgeCode, Kimi CLI, Mistral Vibe, Trae)는 스킬을 가져오지만 명령 어댑터는 없으므로, 슬래시 명령 대신 이름으로 스킬을 호출합니다. 정확히 어느 파일이 어디에 기록되는지를 포함한 전체 도구별 목록은 지원되는 도구에 있습니다.

의심할 때, AI 채팅에 슬래시를 입력하고 자동완성을 봅니다. 도구가 예상하는 형식을 보여줍니다.

명령이 어디서 나왔는지: 스킬과 명령

rasen init (또는 rasen update)을 실행하면, rasen은 AI 도구가 워크플로우를 찾을 수 있도록 프로젝트에 작은 파일을 씁니다. 도구와 설정에 따라 이것들은 스킬, 명령 또는 둘 다입니다.

• 스킬은 .claude/skills/rasen-*/SKILL.md와 같은 곳에 있습니다. 그들은 새로운 크로스 도구 표준입니다: 어시스턴트가 자동 감지하는 명령 폴더입니다.
• 명령은 .claude/commands/rasen/<id>.md와 같은 곳에 있습니다. 도구별 슬래시 명령 파일의 더 오래된 것입니다.

도구가 어떤 것을 사용하는지 관심 가질 필요가 없습니다. 슬래시 명령을 입력하면 작동합니다. 하지만 이 파일들이 존재한다는 것을 알면 뭔가 잘못되었을 때 도움이 됩니다: 명령이 사라지면, 일반적으로 이 파일들이 누락되었거나 오래되었다는 의미이며, rasen update는 그들을 재생성합니다.

도구별 정확한 경로는 지원되는 도구를 참조하고, 스킬이 더 오래된 명령 전용 접근 방식을 어떻게 대체했는지는 마이그레이션 가이드를 참조하세요.

설치되었는지 확인

빠른 체크, 가장 빠른 것부터:

1. AI 채팅에 슬래시를 입력하세요. /rasen을 입력하기 시작하고 자동완성 제안을 보세요. 나타나면 설정 완료입니다.
2. 파일을 찾아보세요. Claude Code의 경우, .claude/skills/에 rasen-* 폴더가 포함되어 있는지 확인합니다. 다른 도구는 자신만의 디렉터리를 사용합니다 (지원되는 도구에서 나열).
3. 설정 다시 실행. 프로젝트 루트에서 rasen update를 실행합니다. 이것은 구성한 모든 도구의 스킬과 명령 파일을 재생성합니다.
4. 어시스턴트 다시 시작. 많은 도구는 시작 시 스킬과 명령을 스캔하므로 새로운 창이 누락된 단계일 수 있습니다.

어떤 명령을 가지고 있나요?

기본적으로 rasen은 full 프로파일을 설치합니다 — 모든 슬래시 명령을 즉시 사용하며, 일일 리듬을 다루는 core 집합을 포함합니다:

• /rasen:explore: 변경에 커밋하기 전에 AI로 아이디어를 생각해보세요 (확실하지 않을 때 좋은 첫 단계)
• /rasen:propose: 변경을 생성하고 모든 계획 산출물을 한 단계로 초안하세요
• /rasen:apply: 작업 목록을 통해 작업하여 변경을 구축하세요
• /rasen:sync: 변경의 스펙 업데이트를 메인 스펙에 병합하세요 (대개 자동)
• /rasen:archive: 변경을 완료하고 보관하세요

좋은 기본 리듬: 뭘 할지 알아낼 때 explore, 그 후 propose, apply, archive. 먼저 탐색 가이드는 이 첫 단계가 왜 가치있는지 설명합니다.

full 프로파일은 또한 더 세밀한 제어를 원하는 사람들을 위해 확장 집합 (/rasen:new, /rasen:continue, /rasen:ff, /rasen:verify, /rasen:bulk-archive, /rasen:onboard)을 포함하며, /rasen:review-cycle과 /rasen:goal 같은 다른 단계도 포함합니다. core 집합으로만 축소하려면 rasen config profile core로 전환한 다음 rasen update를 적용합니다.

이 모든 것에 새로운가요? /rasen:onboard (확장 집합에서)는 완전한 변경을 각 단계에서 안내합니다. 가장 친절한 소개입니다.

각 명령이 상세히 무엇을 하는지는 명령을 참조하세요. 각각을 언제 사용할지는 워크플로우를 참조하세요.

깨끗한 첫 실행

모두 합쳐서, 전체 시퀀스가 있고 각 단계가 발생하는 위치로 라벨됨.

터미널     $ npm install -g @atelierai/rasen@latest
터미널     $ cd your-project
터미널     $ rasen init
              (AI 도구에 슬래시 명령 설치)

AI 채팅    /rasen:explore
              (선택사항: 먼저 AI로 아이디어를 생각해보세요)

AI 채팅    /rasen:propose add-dark-mode
              (AI가 제안서, 스펙, 설계, 작업을 초안)

AI 채팅    /rasen:apply
              (AI가 구축, 작업 체크오프)

AI 채팅    /rasen:archive
              (변경이 스펙에 병합되고 보관됨)

설정하는 두 터미널 단계. 그 후 채팅에서 살아갑니다. 그것이 리듬입니다.

관련

• 시작하기: 전체 첫 번째 변경 안내
• 명령: 모든 슬래시 명령 상세히
• CLI: 모든 터미널 명령 상세히
• 지원되는 도구: 도구별 구문과 파일 위치
• FAQ: 더 많은 빠른 답변
• 문제 해결: 명령이 나타나지 않을 때 수정