자주 묻는 질문

가장 많이 받는 질문들에 대한 빠른 답변입니다. 질문이 정말 "뭔가가 깨졌다"는 질문이면 문제 해결이 더 나은 페이지입니다. 용어의 정의를 원하면 용어집을 참조하세요.

기본 사항

Rasen이 한 문장으로 무엇인가요?

의도를 결과물로 바꾸는 자율 하니스입니다. 원하는 것을 말하면, 스스로 계획하고 구현하고 리뷰하고 배포하고 보관합니다. 코드가 아니라 아이디어를 다루세요.

왜 이것을 원할까요?

AI 어시스턴트는 틀렸을 때도 자신감 있게 행동하기 때문입니다. 내버려 두면 AI는 요구사항의 빈틈을 추측으로 채우고, 코드가 존재한 후에야 그것을 발견합니다. Rasen의 외부 루프는 당신의 의도를 미리 스펙으로 기록해 둡니다 — 이는 하니스 자신의 작업 기억일 뿐, 당신에게 돌아오는 숙제가 아닙니다 — 그래서 어긋남이 아직 수정 비용이 작을 때 발견됩니다. 한눈에 핵심 개념을 참조하여 전체 경우를 확인하세요.

모든 것에 사용해야 하나요?

아니요. 어긋남을 일찍 발견하는 것이 중요한 곳에서 사용하세요. 대부분의 사소하지 않은 작업입니다. 한 글자 오타 수정의 경우 의식은 아마 가치가 없고, 그것도 괜찮습니다.

큰 기존 코드베이스에서 사용할 수 있나요, 아니면 새 프로젝트에만?

기존 코드베이스가 주요 사항입니다. Rasen은 기존 코드베이스 우선입니다: 앱 전체를 미리 문서화할 필요가 없습니다. 하니스가 각 변경이 접하는 것에 대해서만 스펙을 생성하고, 실제로 수행하는 작업 주위에 시간이 지나면서 스펙이 채워집니다. 전담 가이드가 있습니다: 기존 프로젝트에서 Rasen 사용.

하나의 AI 도구에 묶여 있나요?

아니요. Rasen은 Claude Code, Cursor, Windsurf, GitHub Copilot, Gemini CLI, Codex 등을 포함한 25개 이상의 어시스턴트와 호환됩니다. 전체 목록과 도구별 세부사항은 지원되는 도구에 있습니다.

명령 실행

/rasen:propose를 어디에 입력하나요?

AI 어시스턴트의 채팅에서, 터미널에서가 아닙니다. 이것은 가장 일반적인 혼동 지점이므로 자체 페이지가 있습니다: 명령이 어떻게 작동하는지. 짧은 버전: rasen ...은 터미널에서 실행되고, /rasen:...은 채팅에서 실행됩니다.

"대화형 모드"를 시작하려면 어떻게 하나요?

시작할 별도의 모드는 없습니다. AI 어시스턴트를 정상적으로 열고 채팅에 슬래시 명령을 입력합니다. 슬래시 명령이 rasen에 "진입"하는 방법입니다. (진정한 대화형 터미널 기능은 스펙과 변경을 탐색하기 위한 대시보드인 rasen view입니다.) 명령이 어떻게 작동하는지에서 전체 설명을 확인하세요.

슬래시 명령을 입력했는데 아무것도 안 됐어요. 왜죠?

대부분 터미널이 아니라 AI 채팅에 입력했거나, 명령이 아직 설치되지 않았습니다. 프로젝트에서 rasen update를 실행하고, 어시스턴트를 다시 시작한 다음, 채팅에 /rasen을 입력하고 자동완성을 확인하세요. 문제 해결에 전체 체크리스트가 있습니다.

/rasen:propose가 한 도구에서 그리고 /rasen-propose가 다른 도구에서인 이유는?

각 AI 도구는 커스텀 명령을 약간 다르게 노출합니다. 의도는 동일합니다. 구두점만 변합니다. 채팅에 슬래시를 입력하면 자동완성이 도구가 예상하는 형식을 보여줍니다. 도구별 표는 명령이 어떻게 작동하는지에 있습니다.

스킬과 명령의 차이점은?

둘 다 rasen이 작성하여 어시스턴트가 워크플로우를 실행할 수 있게 하는 파일입니다. 스킬 (.../skills/rasen-*/SKILL.md)은 새로운 크로스 도구 표준입니다. 명령 (.../commands/rasen-*)은 도구별 슬래시 파일의 더 오래된 버전입니다. 선택할 필요가 없습니다. 슬래시 명령을 입력하면 rasen이 도구가 사용하는 것을 설치합니다.

워크플로우

뭘 구축할지 확실하지 않으면 어디서 시작해야 하나요?

/rasen:explore로 시작하세요. 코드베이스를 읽고, 옵션을 배치하고, 모호한 문제를 구체적인 계획으로 바꾸는 무해한 생각 파트너입니다. 변경이나 코드가 존재하기 전입니다. 계획이 명확하면 /rasen:propose로 인계됩니다. 이것은 기꺼이 잘못된 것을 구축하는 열정적인 AI를 막기 때문에 형성할 가장 좋은 습관입니다. 먼저 탐색을 참조하세요.

가장 간단한 가능한 흐름은?

/rasen:explore (선택사항)   then   /rasen:propose <뭘 원하는지>   then   /rasen:apply   then   /rasen:archive

탐색하여 생각을 정리하고, 제안서로 계획을 초안하고, 적용하여 구축하고, 보관하여 보관합니다. 이미 정확히 뭘 원하는지 알면 탐색을 건너뜁니다.

/rasen:propose와 /rasen:new의 차이점은?

/rasen:propose는 기본 한 단계 명령입니다: 변경을 생성하고 모든 계획 산출물을 한 번에 초안합니다. /rasen:new는 확장 명령 집합의 일부이며 빈 변경만 스캐폴드하고, /rasen:continue (또는 한 번에 모두 /rasen:ff)로 산출물을 한 번에 하나씩 생성하도록 남겨둡니다. 단계별 제어를 원하지 않으면 제안서를 사용하세요. 명령을 참조하세요.

core와 확장 프로파일은 무엇인가요?

프로파일은 어떤 슬래시 명령이 설치되는지 결정합니다. Full (기본값)은 모든 워크플로우를 설치합니다. Core는 propose, explore, apply, sync, archive로 축소하고, custom으로 원하는 부분집합을 선택할 수 있습니다. rasen config profile로 전환한 다음 rasen update를 적용하세요.

/rasen:sync를 실행해야 하나요?

대부분 아니요. Sync는 변경의 증량 스펙을 메인 스펙에 병합하고, /rasen:archive가 당신을 위해 할 것을 제공합니다. 예를 들어 오래 실행되는 변경에서 보관 전에 스펙을 병합하려는 경우에만 동기화를 수동으로 실행하세요. 명령을 참조하세요.

시작한 후 제안서, 스펙 또는 작업을 편집하려면 어떻게 하나요?

그냥 파일을 편집하세요. 모든 산출물은 rasen/changes/<name>/의 순수 마크다운이며, 잠긴 단계나 특별한 편집 모드는 없습니다. 손으로 변경하거나 AI에 수정을 요청하세요 ("설계를 큐를 사용하도록 업데이트"), 계속 진행하세요. AI는 항상 현재 파일 내용에서 작동합니다. 전체 가이드: 변경 편집 및 반복.

구현의 일부를 한 후 계획을 다시 변경할 수 있나요?

네, 언제든지. 워크플로우가 유연하므로 검토 및 편집은 잠금을 해제하는 단계가 아닙니다. 산출물을 편집한 다음 계속하세요. 코드가 여전히 계획과 일치하는지 구조화된 확인을 원하면 /rasen:verify를 실행하세요. 변경 편집 및 반복을 참조하세요.

손으로 코드를 편집했어요. 스펙과 어떻게 조정하나요?

보관하기 전에 동기화를 되돌리세요. 보관은 스펙을 사실의 기록으로 만들기 때문입니다. 코드가 이제 올바르면, 전달한 것과 일치하도록 증량 스펙을 업데이트하세요. 스펙이 올바르면 코드가 동의할 때까지 구축을 계속하세요. /rasen:verify는 불일치를 노출시킵니다. 변경 편집 및 반복을 참조하세요.

기존 변경을 언제 업데이트할지 vs 새로 시작할지?

같은 작업을 정제할 때 업데이트하세요. 의도가 근본적으로 변경되거나 범위가 다른 작업으로 폭발할 때 새로 시작하세요. 결정 순서도와 예제는 워크플로우에 있습니다.

세션의 컨텍스트가 부족하거나 구현 중 요구사항이 변경되면?

이것은 스펙이 가치를 입증하는 곳입니다. 계획이 채팅 기록에만 있지 않고 파일에 있기 때문에, 컨텍스트를 지우고, 새 AI 세션을 시작하고, /rasen:apply로 선택할 수 있습니다. 산출물을 읽고 첫 번째 체크되지 않은 작업에서 재개됩니다. 요구사항이 변경되면 산출물을 새 현실과 일치하도록 편집하고 계속하세요. 깨끗한 컨텍스트 윈도우를 유지하면 더 나은 결과가 나옵니다. 구현 전에 지우세요.

rasen/ 폴더를 git에 커밋해야 하나요?

네. 스펙, 활성 변경 및 보관은 프로젝트의 역사의 일부입니다. 다른 소스처럼 커밋하세요. 특히 보관은 시스템이 현재 작동하는 방식에 대한 지속적인 기록이 됩니다.

스펙과 변경

스펙 vs 설계에 뭐가 들어가나요?

스펙은 관찰 가능한 동작을 설명합니다: 시스템이 무엇을 하는지, 입력, 출력 및 오류 조건. 설계는 구축 방법을 설명합니다: 기술적 접근 방식, 아키텍처 결정, 파일 변경. 구현이 외부적으로 보이는 동작을 변경하지 않고 변경될 수 있다면 스펙이 아닌 설계에 속합니다. 개념이 더 깊이 들어갑니다.

증량 스펙이 무엇인가요?

전체 스펙을 다시 명시하지 않고 ADDED, MODIFIED 및 REMOVED 섹션을 사용하여 변경되는 것만 설명하는 스펙입니다. 기존 시스템에 대한 편집을 rasen이 깔끔하게 처리하는 방법입니다. 개념을 참조하세요.

보관된 변경은 어디로 가나요?

rasen/changes/archive/YYYY-MM-DD-<name>/으로, 모든 산출물이 보존됩니다. 아무것도 삭제되지 않습니다. 변경은 활성 목록에서 벗어납니다.

설정 및 커스터마이징

AI에 기술 스택을 어떻게 말하나요?

rasen/config.yaml의 context: 아래에 넣으세요. 그 텍스트는 모든 계획 요청에 주입되므로 AI는 항상 스택과 규칙을 압니다. 커스터마이징을 참조하세요.

영어 외의 언어로 스펙을 생성할 수 있나요?

네. 설정의 context:에 언어 지침을 추가하세요. 다국어는 여러 언어의 복사 붙여넣기 스니펫을 제공합니다.

워크플로우 자체를 변경할 수 있나요?

네, 커스텀 스키마로. 스키마는 어떤 산출물이 존재하고 서로 어떻게 의존하는지 정의합니다. 기본값을 rasen schema fork spec-driven my-workflow로 포크한 다음 편집하세요. 커스터마이징을 참조하세요.

모델, 개인정보보호 및 업그레이드

어느 AI 모델을 사용해야 하나요?

Rasen은 기획과 구현 모두에 대해 높은 추론 모델에서 가장 잘 작동합니다 — 어시스턴트가 더 강할수록 스펙을 더 잘 초안하고 코드가 작성되기 전에 간격을 포착합니다. 또한 컨텍스트 윈도우를 깨끗하게 유지하세요: 최상의 결과를 위해 구현 전에 지우세요.

Rasen이 데이터를 수집하나요?

익명 사용 통계를 수집합니다: 명령 이름과 버전만. 인수, 경로, 내용 또는 개인 데이터는 없으며, CI에서 자동으로 꺼집니다. export RASEN_TELEMETRY=0 또는 export DO_NOT_TRACK=1로 옵트아웃하세요.

업그레이드하려면?

두 단계. 패키지 업그레이드 (npm install -g @atelierai/rasen@latest), 그런 다음 각 프로젝트 내에서 rasen update를 실행하여 생성된 스킬과 명령을 새로고침합니다.

Rasen을 제거하려면?

제거 명령이 없습니다. 글로벌 패키지와 프로젝트의 파일이기만 하기 때문입니다. 패키지 제거 (npm uninstall -g @atelierai/rasen), 선택적으로 rasen/ 디렉터리와 생성된 도구 파일을 삭제합니다. 안전하게 유지할 수 있는 것을 포함한 단계별은 설치: 제거에 있습니다.

도움 받기

질문을 하거나 버그를 보고하려면 어디로?

• Discord: discord.gg/YctCnvvshC
• GitHub Issues: github.com/DumoeDss/rasen/issues
• 터미널에서: rasen feedback "당신의 메시지"가 GitHub 이슈를 열어줍니다.

이 문서들이 잘못되었거나 혼란스러워요. 어떻게 하나요?

우리에게 말하세요 또는 수정하세요. 문서 PR은 환영받고 값어치 있습니다. 이슈를 열거나 풀 리퀘스트를 전송하세요.