참고

명령

이것은 Rasen의 슬래시 명령 참조입니다. 이 명령들은 AI 코딩 어시스턴트의 채팅 인터페이스에서 호출됩니다(예: Claude Code, Cursor, Windsurf).

워크플로우 패턴과 각 명령을 언제 사용하는지에 대해서는 Workflows를 참고하세요. CLI 명령은 CLI를 참고하세요.

빠른 참조

빠른 경로 (`core` 프로파일)

명령	용도
`/rasen:propose`	변경을 생성하고 계획 산출물을 한 단계에서 생성합니다
`/rasen:explore`	변경을 확정하기 전에 아이디어를 검토합니다
`/rasen:apply`	변경에서 작업을 구현합니다
`/rasen:sync`	델타 스펙을 메인 스펙으로 병합합니다
`/rasen:archive`	완료된 변경을 보관합니다

확장된 워크플로우 명령 (사용자 정의 워크플로우 선택)

명령	용도
`/rasen:new`	새 변경 스캐폴드를 시작합니다
`/rasen:continue`	의존성을 기반으로 다음 산출물을 생성합니다
`/rasen:ff`	고속 이동: 모든 계획 산출물을 한 번에 생성합니다
`/rasen:verify`	구현이 산출물과 일치하는지 검증합니다
`/rasen:bulk-archive`	여러 변경을 한 번에 보관합니다
`/rasen:onboard`	전체 워크플로우를 안내하는 자습서
`/rasen:review-cycle`	반복적인 리뷰 루프 — 리뷰, 분류, 수정, 델타 재검토, 깨끗할 때까지 또는 상위 단계로 올릴 때까지 반복
`/rasen:goal`	목표 기반 반복 — 측정값 또는 평가 게이트에 대해 수정→판단을 만족하거나 라운드 상한에 도달할 때까지 반복(성능 최적화, 규칙 정리 코드, 연구 개요)

기본 전역 프로파일은 full입니다 — 모든 워크플로우 명령이 기본으로 설치됩니다. 필수 기능으로만 축소하려면 rasen config profile core를 실행합니다(또는 rasen config profile로 사용자 정의 부분집합을 선택합니다). 그런 다음 프로젝트에서 rasen update를 실행합니다.

명령 참조

`/rasen:propose`

새 변경을 생성하고 한 단계에서 계획 산출물을 생성합니다. 이것은 core 프로파일의 기본 시작 명령입니다.

구문:

/rasen:propose [change-name-or-description]

인수:

인수	필수	설명
`change-name-or-description`	아니요	케밥 케이스 이름 또는 일반 언어 변경 설명

수행하는 작업:

rasen/changes/<change-name>/ 생성
구현 전에 필요한 산출물 생성(스펙 기반의 경우: 제안서, 스펙, 설계, 작업)
변경이 /rasen:apply를 실행할 준비가 되면 중지

예제:

You: /rasen:propose add-dark-mode

AI:  Created rasen/changes/add-dark-mode/
     ✓ proposal.md
     ✓ specs/ui/spec.md
     ✓ design.md
     ✓ tasks.md
     Ready for implementation. Run /rasen:apply.

팁:

가장 빠른 엔드투엔드 경로를 사용하려면 이를 사용합니다
단계별 산출물 제어를 원하면 확장된 워크플로우를 활성화하고 /rasen:new + /rasen:continue를 사용합니다

`/rasen:explore`

확실하지 않을 때 여기서 시작합니다. Explore는 위험이 없는 생각의 파트너입니다: 코드베이스를 읽고 옵션을 비교하고 변경이 존재하기 전에 모호한 아이디어를 구체적인 계획으로 선명하게 합니다. 기본 프로파일에 포함됩니다. 전체 사례 및 더 많은 예제를 보려면 Explore First 가이드를 참고하세요.

변경을 확정하기 전에 아이디어를 검토하고, 문제를 조사하고, 요구사항을 명확히 합니다.

구문:

/rasen:explore [topic]

인수:

인수	필수	설명
`topic`	아니요	탐색하거나 조사하고 싶은 주제

수행하는 작업:

구조가 필요하지 않은 탐색 대화를 시작합니다
질문에 답하기 위해 코드베이스를 조사합니다
옵션 및 접근 방식을 비교합니다
명확한 시각화 다이어그램을 생성합니다
통찰력이 명확해지면 /rasen:propose(기본값) 또는 /rasen:new(확장된 워크플로우)로 전환할 수 있습니다

예제:

You: /rasen:explore

AI:  What would you like to explore?

You: How should we handle authentication for the mobile app?

AI:  Let me investigate your current auth setup...
     [Analyzes codebase]

     I see you're using session-based auth for the web app.
     For mobile, we have three main options:

     1. JWT tokens (stateless, works offline)
     2. OAuth2 (if you need third-party login)
     3. Extend current sessions (simpler, but requires connectivity)

     Your API already has CORS configured. Which direction interests you?

You: Let's go with JWT. Can we start a change for that?

AI:  Ready when you are. Run /rasen:propose add-jwt-auth to begin.

팁:

요구사항이 명확하지 않거나 조사가 필요할 때 사용합니다
탐색 중에 산출물이 생성되지 않습니다
결정하기 전에 여러 접근 방식을 비교하는 데 좋습니다
파일을 읽고 코드베이스를 검색할 수 있습니다

`/rasen:new`

새 변경 스캐폴드를 시작합니다. 변경 폴더를 생성하고 /rasen:continue 또는 /rasen:ff로 산출물을 생성할 때까지 대기합니다.

이 명령은 확장된 워크플로우 집합의 일부입니다(core 프로파일에 포함되지 않음).

구문:

/rasen:new [change-name] [--schema <schema-name>]

인수:

인수	필수	설명
`change-name`	아니요	변경 폴더의 이름(제공하지 않으면 메시지 표시)
`--schema`	아니요	사용할 워크플로우 스키마(기본값: 설정의 `spec-driven` 또는 설정)

수행하는 작업:

rasen/changes/<change-name>/ 디렉토리 생성
변경 폴더에 .openspec.yaml 메타데이터 파일 생성
생성할 첫 번째 산출물 템플릿 표시
제공하지 않은 경우 변경 이름 및 스키마에 대한 메시지 표시

생성하는 항목:

rasen/changes/<change-name>/
└── .openspec.yaml    # Change metadata (schema, created date)

예제:

You: /rasen:new add-dark-mode

AI:  Created rasen/changes/add-dark-mode/
     Schema: spec-driven

     Ready to create: proposal
     Use /rasen:continue to create it, or /rasen:ff to create all artifacts.

팁:

설명적인 이름을 사용합니다: add-feature, fix-bug, refactor-module
update, changes, wip 같은 일반적인 이름은 피합니다
스키마는 프로젝트 설정(rasen/config.yaml)에서도 설정할 수 있습니다

`/rasen:continue`

의존성 체인의 다음 산출물을 생성합니다. 한 번에 하나의 산출물을 생성하여 점진적인 진행을 구현합니다.

구문:

/rasen:continue [change-name]

인수:

인수	필수	설명
`change-name`	아니요	계속할 변경(제공하지 않으면 컨텍스트에서 유추)

수행하는 작업:

산출물 의존성 그래프를 쿼리합니다
어떤 산출물이 준비되었는지 대 차단되었는지 표시합니다
첫 번째 준비된 산출물을 생성합니다
컨텍스트를 위해 의존성 파일을 읽습니다
생성 후 사용 가능해지는 항목을 표시합니다

예제:

You: /rasen:continue

AI:  Change: add-dark-mode

     Artifact status:
     ✓ proposal    (done)
     ◆ specs       (ready)
     ◆ design      (ready)
     ○ tasks       (blocked - needs: specs)

     Creating specs...

     [Reads proposal.md, creates specs based on requirements]

     ✓ Created rasen/changes/add-dark-mode/specs/ui/spec.md

     Now available: tasks
     Run /rasen:continue to create the next artifact.

팁:

진행하기 전에 각 산출물을 검토하고 싶을 때 사용합니다
제어가 필요한 복잡한 변경에 좋습니다
여러 산출물이 동시에 준비될 수 있습니다
계속하기 전에 생성된 산출물을 편집할 수 있습니다

`/rasen:ff`

산출물 생성을 빠르게 이동합니다. 모든 계획 산출물을 한 번에 생성합니다.

구문:

/rasen:ff [change-name]

인수:

인수	필수	설명
`change-name`	아니요	고속 이동할 변경(제공하지 않으면 컨텍스트에서 유추)

수행하는 작업:

의존성 순서대로 모든 산출물을 생성합니다
할 일 목록을 통해 진행률을 추적합니다
모든 apply-required 산출물이 완료되면 중지합니다
다음 산출물을 생성하기 전에 각 의존성을 읽습니다

예제:

You: /rasen:ff add-dark-mode

AI:  Fast-forwarding add-dark-mode...

     ✓ Creating proposal.md
     ✓ Creating specs/ui/spec.md
     ✓ Creating design.md
     ✓ Creating tasks.md

     All planning artifacts complete!
     Ready for implementation. Run /rasen:apply to begin.

팁:

만드는 것이 명확한 그림이 있을 때 사용합니다
/rasen:continue보다 빠릅니다(직선적인 변경의 경우)
여전히 나중에 산출물을 편집할 수 있습니다
작은 에서 중간 크기 기능에 좋습니다

`/rasen:apply`

변경에서 작업을 구현합니다. 작업 목록을 거쳐 코드를 작성하고 항목을 확인합니다.

구문:

/rasen:apply [change-name]

인수:

인수	필수	설명
`change-name`	아니요	구현할 변경(제공하지 않으면 컨텍스트에서 유추)

수행하는 작업:

tasks.md를 읽고 완료되지 않은 작업을 식별합니다
작업을 하나씩 진행합니다
필요에 따라 코드, 파일을 작성하고 테스트를 실행합니다
체크박스 [x]로 작업 완료 표시

예제:

You: /rasen:apply

AI:  Implementing add-dark-mode...

     Reading tasks.md:
     - [ ] 1.1 Create ThemeContext
     - [ ] 1.2 Add CSS custom properties
     - [ ] 1.3 Implement localStorage persistence

     Working on 1.1: Create ThemeContext...
     [Creates src/context/ThemeContext.tsx]

     ✓ 1.1 Complete

     Working on 1.2: Add CSS custom properties...
     [Updates src/styles/globals.css]

     ✓ 1.2 Complete
     ...

팁:

중단되면 중단한 곳에서 재개할 수 있습니다
변경 이름을 지정하여 병렬 변경을 사용합니다
완료 상태는 tasks.md 체크박스에 추적됩니다

`/rasen:verify`

구현이 변경 산출물과 일치하는지 검증합니다. 완성도, 정확성, 일관성을 확인합니다.

구문:

/rasen:verify [change-name]

인수:

인수	필수	설명
`change-name`	아니요	검증할 변경(제공하지 않으면 컨텍스트에서 유추)

수행하는 작업:

구현 품질의 세 가지 차원을 확인합니다
코드베이스에서 구현 증거를 검색합니다
문제를 CRITICAL, WARNING 또는 SUGGESTION으로 분류하여 보고합니다
보관을 차단하지 않지만 문제를 표시합니다

검증 차원:

차원	검증하는 항목
완성도	모든 작업 완료, 모든 요구사항 구현, 시나리오 적용
정확성	구현이 스펙 의도와 일치, 엣지 케이스 처리
일관성	설계 결정이 코드에 반영, 패턴 일관성

예제:

You: /rasen:verify

AI:  Verifying add-dark-mode...

     COMPLETENESS
     ✓ All 8 tasks in tasks.md are checked
     ✓ All requirements in specs have corresponding code
     ⚠ Scenario "System preference detection" has no test coverage

     CORRECTNESS
     ✓ Implementation matches spec intent
     ✓ Edge cases from scenarios are handled
     ✓ Error states match spec definitions

     COHERENCE
     ✓ Design decisions reflected in code structure
     ✓ Naming conventions consistent with design.md
     ⚠ Design mentions "CSS variables" but implementation uses Tailwind classes

     SUMMARY
     ─────────────────────────────
     Critical issues: 0
     Warnings: 2
     Ready to archive: Yes (with warnings)

     Recommendations:
     1. Add test for system preference detection
     2. Update design.md to reflect Tailwind usage, or refactor to use CSS variables

팁:

보관하기 전에 실행하여 불일치를 조기에 포착합니다
경고는 보관을 차단하지 않지만 잠재적 문제를 나타냅니다
AI의 작업을 커밋하기 전에 검토하는 데 좋습니다
산출물과 구현 간 드리프트를 드러낼 수 있습니다

`/rasen:review-cycle`

반복적인 루프를 사용하여 변경을 실제로 깨끗하게 이동합니다: review → triage → fix → re-review(Δ) → {pass | loop | escalate}. 검토자를 재구현하지 않습니다 — 각 통과는 항상 설치된 rasen-review 엔진에 위임합니다. 이 명령은 루프, 수정 크기 분류, 저자 대 검증자 불변식, 종료 및 상위 단계 올림을 소유합니다. 옵트인(core 프로파일에 없음).

구문:

/rasen:review-cycle [change-name]

인수:

인수	필수	설명
`change-name`	아니요	루프를 실행할 변경(제공하지 않으면 컨텍스트에서 유추)

수행하는 작업:

rasen-review를 통해 리뷰 통과를 실행한 다음 각 발견을 수정 크기로 분류합니다
수정을 라우팅합니다: 사소한 것 → 오케스트레이터 인라인; 중요한 것 → 구현 에이전트; 설계 수준 → 별도의 수정 에이전트
수정 델타만 재검토하고 저자가 아닌 검증자가 원래 발견에 대해 확인할 때만 발견을 해결된 것으로 표시합니다(저자 ≠ 검증자)
루프를 최대 라운드로 제한(기본값 3); 상한에서 미해결 Blocker/Major 발견 시 인간에게 상위 단계로 올립니다 — 절대 자동으로 통과하지 않습니다
라운드 기록과 각 저자 아닌 확인을 review-cycle-report.md에 기록합니다

저자 ≠ 검증자 불변식: 발견은 수정을 작성하지 않은 검토자가 확인할 때만 해결됩니다. 오케스트레이터가 수행한 사소한 인라인 수정의 경우, 동등한 저자 아닌 확인은 독립적인 게이트 실행(테스트/린트/빌드) 및 정확한 변경의 diff 읽기 — 그리고 해당 확인은 사이클 보고서에 기록되어야 합니다.

재검토 경로:

Claude Code 가속화(선택사항): 에이전트 팀이 활성화(CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1)된 경우, 리드는 원래 검토자를 SendMessage로 재개하여 델타만 재검토할 수 있습니다(리드만 SendMessage를 시작할 수 있음).
도구 불가지론 폴백(필수): 그렇지 않으면 신규 델타 리뷰를 실행하여 사전 발견 및 수정 diff를 공유 파일을 통해 전달합니다. 동등한 결과, 비용만 많습니다.

예제:

You: /rasen:review-cycle add-dark-mode

AI:  Review Cycle: add-dark-mode (round 1/3)
     Findings: 1 Blocker, 2 Major
       - [Blocker] missing null guard → trivial → orchestrator inline
       - [Major]   race in toggle      → non-trivial → implementing agent
       - [Major]   contract changed     → design-level → separate fix agent
     Fixes applied → re-reviewing delta (fresh non-author review)...
     Round 2/3: 0 Blocker, 0 Major → CLEAN
     Report: review-cycle-report.md

팁:

구현 후 라이브 diff에 대해 사용합니다; 단일 검증 게이트의 경우 /rasen:verify 사용합니다
루프는 제한됩니다 — 상위 단계로 올리면 미해결 발견과 라운드 기록이 인간에게 가고, 자동 통과로 가지 않습니다

`/rasen:goal`

"완료"가 문서가 아닌 조건인 작업을 위한 목표 기반 반복 — Lighthouse 점수를 90으로 이동하고, 모듈을 규칙 정리로 만들고, 개요를 연구하고 작성합니다. /rasen:auto의 형제 항목: LEAD가 작업을 분류하고 ONE 백엔드 파이프라인을 선택하고 게이트가 만족되거나 라운드 상한에 도달할 때까지 수정 → 판단을 반복합니다. /rasen:auto와 동일한 오케스트레이션 플레이북(LEAD + 역할 격리 워커, 계층, 실행 상태, 게이트, 재개)을 공유합니다. 전체 장은 저장소 docs/ 디렉토리의 opsx-workflow-guide.md §9(목표 기반 반복)를 참고합니다.

구문:

/rasen:goal [measure|evaluate|research] <task>
/rasen:goal --pipeline goal-loop-<variant> <task>

인수:

인수	필수	설명
`measure\|evaluate\|research`	아니요	백엔드 파이프라인을 강제; 없으면 LEAD가 키워드로 분류(명시적인 것이 항상 우승; 모호한 것은 기본값 `evaluate`)
`task`	예	반복할 목표의 자연스러운 언어 설명

수행하는 작업:

define-goal 단계 — 작업을 goal-plan.md로 변환: 목표, 구체적인 게이트({kind: measure, command, threshold/target} 또는 {kind: evaluate, goal, rubric}), 작업 제품(code | prose), maxRounds. 이 단계는 게이트입니다 — 라운드가 실행되기 전에 측정 명령을 확인합니다
iterate 루프 — 각 라운드는 따뜻하게 재사용된 구현자를 디스패치한 다음 게이트를 실행합니다: measure는 결정론적 명령({score, passed})을 실행합니다; evaluate는 신규 검토자 워커({satisfied, gaps})를 디스패치합니다. 각 라운드는 goal-run.json(권위 있는 루프 위치)에 기록됩니다
tail — measure/evaluate → ship → archive(반복된 코드는 정상적으로 배포됨); research → report(최종 문서로 요약됨; 배포할 코드 없음)
maxRounds(기본값 5) + loopStallLimit(기본값 2)로 제한; 라운드가 소진되면 maxRounds-exhausted로 표시 — 절대 성공으로 보고되지 않습니다

백엔드 파이프라인 패밀리:

작업의 키워드	선택된 파이프라인	게이트(검사자)	작업 제품	Tail
`score` `latency` `optimize` `lighthouse` `benchmark` `p99` `memory` `throughput`	goal-loop-measure	measure — 결정론적 명령	code	ship → archive
`rubric` `quality` `clean` `standard` `refactor-quality`	goal-loop-evaluate	evaluate — 신규 검토자	code	ship → archive
`research` `investigate` `write report` `write brief` `autoresearch` `literature`	goal-loop-research	evaluate — 신규 검토자	prose	report

예제:

You: /rasen:goal drive the Lighthouse performance score to 90

AI:  Keyword "lighthouse" + "score" -> goal-loop-measure
     Fetch DAG: define-goal -> iterate (measure gate) -> ship -> archive
     ▸ planner -> goal-plan.md (gate: measure, command: lighthouse --output=json, threshold: 90)
     ⏸ gate: confirm the measure command? -> You: continue
     ▸ implementer (round 1) -> edits the perf-critical path
     ▸ measure gate: score 82 (not passed) -> recorded to goal-run.json
     ▸ implementer (round 2, warm-reused) -> further edits
     ▸ measure gate: score 91 (satisfied) -> ship -> archive

팁:

제품이 반복으로 충족되는 조건일 때 /rasen:goal을 사용합니다; 제품이 코드 변경 문서일 때는 /rasen:auto를 사용합니다
루프 중간에 종료하고 rasen pipeline resume <change>를 실행합니다 — 목표 루프 재개 프로토콜은 마지막 goal-run.json 레코드를 읽고 올바른 라운드에서 재개합니다
define-goal 게이트는 "measure.command는 임의 셸"에 대한 안전 밸브입니다 — 계속하기 전에 명령을 검토합니다

`/rasen:sync`

선택 명령. 변경에서 델타 스펙을 메인 스펙으로 병합합니다. Archive는 필요한 경우 동기화 메시지를 표시하므로 일반적으로 이를 수동으로 실행할 필요가 없습니다.

구문:

/rasen:sync [change-name]

인수:

인수	필수	설명
`change-name`	아니요	동기화할 변경(제공하지 않으면 컨텍스트에서 유추)

수행하는 작업:

변경 폴더에서 델타 스펙을 읽습니다
ADDED/MODIFIED/REMOVED/RENAMED 섹션을 파싱합니다
변경 사항을 메인 rasen/specs/ 디렉토리로 병합합니다
델타에서 언급되지 않은 기존 콘텐츠를 보존합니다
변경을 보관하지 않습니다(활성 상태로 유지)

예제:

You: /rasen:sync

AI:  Syncing add-dark-mode delta specs...

     Reading: rasen/changes/add-dark-mode/specs/ui/spec.md
     Target:  rasen/specs/ui/spec.md

     Changes to apply:
     ✓ ADDED: Theme Selection requirement (2 scenarios)
     ✓ ADDED: Accessibility requirement (1 scenario)

     Merging...
     ✓ rasen/specs/ui/spec.md updated

     Change remains active. Run /rasen:archive when ready to complete.

수동으로 사용할 때:

시나리오	동기화 사용?
오래 실행된 변경, 보관하기 전에 메인에서 스펙 원함	예
여러 병렬 변경이 업데이트된 기본 스펙이 필요	예
병합을 별도로 미리보기/검토하려고 함	예
빠른 변경, 보관으로 직접 이동	아니요(보관이 처리)

팁:

동기화는 복사-붙여넣기가 아니라 지능적입니다
기존 요구사항에 시나리오를 중복없이 추가할 수 있습니다
변경은 동기화 후 활성 상태로 유지됩니다(보관되지 않음)
대부분의 사용자는 이를 직접 호출할 필요가 없습니다 — 보관이 필요한 경우 메시지를 표시합니다

`/rasen:archive`

완료된 변경을 보관합니다. 변경을 최종화하고 보관 폴더로 이동합니다.

구문:

/rasen:archive [change-name]

인수:

인수	필수	설명
`change-name`	아니요	보관할 변경(제공하지 않으면 컨텍스트에서 유추)

수행하는 작업:

산출물 완성도 상태 확인
작업 완성도 확인(완료되지 않은 경우 경고)
아직 동기화되지 않은 경우 델타 스펙 동기화 제안
변경 폴더를 rasen/changes/archive/YYYY-MM-DD-<name>/로 이동
감사 추적을 위해 모든 산출물 보존

예제:

You: /rasen:archive

AI:  Archiving add-dark-mode...

     Artifact status:
     ✓ proposal.md exists
     ✓ specs/ exists
     ✓ design.md exists
     ✓ tasks.md exists (8/8 tasks complete)

     Delta specs: Not yet synced
     → Sync now? (recommended)

You: Yes

AI:  ✓ Synced specs to rasen/specs/ui/spec.md
     ✓ Moved to rasen/changes/archive/2025-01-24-add-dark-mode/

     Change archived successfully.

팁:

Archive는 완료되지 않은 작업에서 차단하지 않지만 경고합니다
델타 스펙은 보관 중 또는 미리 동기화할 수 있습니다
보관된 변경은 기록을 위해 보존됩니다
먼저 /rasen:verify를 사용하여 문제를 포착합니다

`/rasen:bulk-archive`

여러 완료된 변경을 한 번에 보관합니다. 변경 간 스펙 충돌을 처리합니다.

구문:

/rasen:bulk-archive [change-names...]

인수:

인수	필수	설명
`change-names`	아니요	보관할 특정 변경(제공하지 않으면 선택 메시지 표시)

수행하는 작업:

모든 완료된 변경을 나열합니다
보관하기 전에 각 변경을 검증합니다
변경 간 스펙 충돌을 감지합니다
실제로 구현된 것을 확인하여 충돌을 해결합니다
시간 순서대로 보관합니다

예제:

You: /rasen:bulk-archive

AI:  Found 3 completed changes:
     - add-dark-mode (8/8 tasks complete)
     - fix-login-bug (3/3 tasks complete)
     - update-footer (2/2 tasks complete)

     Checking for spec conflicts...
     ⚠ add-dark-mode and update-footer both touch specs/ui/

     Inspecting codebase to resolve...
     Both changes are implemented. Will merge in chronological order:
     1. add-dark-mode (created Jan 20)
     2. update-footer (created Jan 22)

     Archive all 3 changes?

You: Yes

AI:  ✓ Archived add-dark-mode
     ✓ Archived fix-login-bug
     ✓ Archived update-footer
     Specs merged: add-dark-mode → update-footer

팁:

병렬 작업 흐름에 좋습니다
충돌 해결은 에이전트(코드베이스 확인)입니다
변경은 생성 순서대로 보관됩니다
스펙 콘텐츠 덮어쓰기 전에 메시지를 표시합니다

`/rasen:onboard`

전체 Rasen 워크플로우를 안내하는 온보딩입니다. 실제 코드베이스를 사용한 대화형 자습서입니다.

구문:

/rasen:onboard

수행하는 작업:

설명과 함께 완전한 워크플로우 사이클을 안내합니다
실제 개선 기회에 대한 코드베이스를 스캔합니다
실제 산출물을 사용하여 실제 변경을 생성합니다
실제 작업을 구현합니다(작고 안전한 변경)
완료된 변경을 보관합니다
진행하면서 각 단계를 설명합니다

단계:

환영 및 코드베이스 분석
개선 기회 찾기
변경 생성(/rasen:new)
제안서 작성
스펙 생성
설계 작성
작업 생성
작업 구현(/rasen:apply)
구현 검증
변경 보관
요약 및 다음 단계

예제:

You: /rasen:onboard

AI:  Welcome to Rasen!

     I'll walk you through the complete workflow using your actual codebase.
     We'll find something small to improve, create a proper change for it,
     implement it, and archive it.

     Let me scan your codebase for opportunities...

     [Analyzes codebase]

     I found a few things we could work on:
     1. Add input validation to the contact form
     2. Improve error messages in the auth flow
     3. Add loading states to async buttons

     Which interests you? (or suggest something else)

팁:

워크플로우를 배우는 신규 사용자에게 최고입니다
예제가 아닌 실제 코드를 사용합니다
유지하거나 삭제할 수 있는 실제 변경을 생성합니다
완료하는 데 15~30분 걸립니다

도구별 명령 구문

다른 AI 도구는 약간 다른 명령 구문을 사용합니다. 도구와 일치하는 형식을 사용합니다:

도구	구문 예제
Claude Code	`/rasen:propose`, `/rasen:apply`
Cursor	`/rasen-propose`, `/rasen-apply`
Windsurf	`/rasen-propose`, `/rasen-apply`
Copilot (IDE)	`/rasen-propose`, `/rasen-apply`
Kimi CLI	`/rasen-propose`, `/rasen-apply-change` 같은 스킬 기반 호출(생성된 명령 파일 없음)
Trae	`/rasen-propose`, `/rasen-apply-change` 같은 스킬 기반 호출(생성된 명령 파일 없음)

의도는 도구 전체에서 동일하지만 명령이 표시되는 방식은 통합에 따라 다를 수 있습니다.

참고: GitHub Copilot 명령(.github/prompts/*.prompt.md)은 IDE 확장(VS Code, JetBrains, Visual Studio)에서만 사용 가능합니다. GitHub Copilot CLI는 현재 사용자 정의 프롬프트 파일을 지원하지 않습니다 — 세부 사항 및 해결 방법은 Supported Tools를 참고합니다.

문제 해결

"Change not found"

명령이 작업할 변경을 식별할 수 없습니다.

해결 방법:

변경 이름을 명시적으로 지정합니다: /rasen:apply add-dark-mode
변경 폴더가 존재하는지 확인합니다: rasen list
올바른 프로젝트 디렉토리에 있는지 확인합니다

"No artifacts ready"

모든 산출물이 완료되거나 누락된 의존성으로 인해 차단됩니다.

해결 방법:

rasen status --change <name>을 실행하여 차단 사항을 확인합니다
필요한 산출물이 존재하는지 확인합니다
먼저 누락된 의존성 산출물을 생성합니다

"Schema not found"

지정된 스키마가 존재하지 않습니다.

해결 방법:

사용 가능한 스키마 나열: rasen schemas
스키마 이름의 철자를 확인합니다
사용자 정의인 경우 스키마 생성: rasen schema init <name>

Commands not recognized

AI 도구가 Rasen 명령을 인식하지 못합니다.

해결 방법:

Rasen이 초기화되었는지 확인: rasen init
스킬 재생성: rasen update
.claude/skills/ 디렉토리가 존재하는지 확인(Claude Code의 경우)
AI 도구를 재시작하여 새 스킬을 선택합니다

Artifacts not generating properly

AI가 불완전하거나 잘못된 산출물을 생성합니다.

해결 방법:

rasen/config.yaml에서 프로젝트 컨텍스트 추가
특정 지침을 위해 산출물별 규칙 추가
변경 설명에 더 많은 세부사항 제공
더 많은 제어를 위해 /rasen:ff 대신 /rasen:continue를 사용합니다

다음 단계

Workflows - 일반적인 패턴 및 각 명령 사용 시기
CLI - 관리 및 검증을 위한 터미널 명령
Customization - 사용자 정의 스키마 및 워크플로우 생성

명령

빠른 참조

빠른 경로 (core 프로파일)

확장된 워크플로우 명령 (사용자 정의 워크플로우 선택)

명령 참조

/rasen:propose

/rasen:explore

/rasen:new

/rasen:continue

/rasen:ff

/rasen:apply

/rasen:verify

/rasen:review-cycle

/rasen:goal

/rasen:sync

/rasen:archive

/rasen:bulk-archive

/rasen:onboard

도구별 명령 구문

문제 해결

"Change not found"

"No artifacts ready"

"Schema not found"

Commands not recognized

Artifacts not generating properly

다음 단계

빠른 경로 (`core` 프로파일)

`/rasen:propose`

`/rasen:explore`

`/rasen:new`

`/rasen:continue`

`/rasen:ff`

`/rasen:apply`

`/rasen:verify`

`/rasen:review-cycle`

`/rasen:goal`

`/rasen:sync`

`/rasen:archive`

`/rasen:bulk-archive`

`/rasen:onboard`