[ contents ]
시작하기

Rasen 문서

환영합니다. 이것은 모든 rasen을 위한 집입니다.

Rasen은 코드가 작성되기 전에 무엇을 구축할지에 대해 사용자와 AI 코딩 보조자가 동의할 수 있도록 도움을 줍니다. 변경을 설명하고, AI가 짧은 스펙과 작업 목록을 초안하고, 둘 다 동일한 계획을 보고, 그 다음 작업이 진행됩니다. AI가 잘못된 것을 구축한 것을 절반쯤 발견하는 경우가 더 이상 없습니다.

다른 것을 읽지 않으면 이 두 페이지를 읽으십시오.

  1. 시작하기: 설치, 초기화 및 첫 변경 배송.
  2. 명령이 작동하는 방법: /rasen:propose를 실제로 입력하는 위치(힌트: 터미널이 아닌 AI 채팅에서). 이것은 거의 모든 사람을 한 번 방해합니다.

두 번째 것은 보이는 것보다 더 중요합니다. Rasen에는 두 부분이 있습니다. 터미널에서 실행하는 명령줄 도구와 AI 보조자에게 제공하는 슬래시 명령. 어느 것인지 알면 가장 일반적인 혼동 순간을 저장합니다.

먼저 구축할 최고의 습관: 무엇을 구축해야 할지 확실하지 않을 때 /rasen:explore로 시작합니다. 위험이 없는 생각 파트너이며, 코드를 읽고, 옵션을 계량하고, 어떤 산출물이나 코드가 존재하기 전에 모호한 아이디어를 구체적인 계획으로 날카롭게 합니다. 먼저 탐색 가이드가 경우를 만듭니다.

경로 선택

나는 완전히 새로워요. 시작하기로 시작한 후 한눈에 핵심 개념을 스캔합니다. 뭔가 신비로울 때 FAQ용어집이 근처에 있습니다.

나는 계획이 아닌 문제가 있습니다. 이것이 일반적인 경우이며 전용 답변이 있습니다. 먼저 탐색. /rasen:explore를 사용하여 무엇에 약속하기 전에 AI와 함께 생각합니다.

큰 기존 코드베이스가 있습니다. 모두 문서화하지 않습니다. 기존 프로젝트에서 Rasen 사용은 바다를 끓이지 않고 실제 갈색 필드 코드에서 시작하는 방법을 보여줍니다.

작동되도록 하고 싶습니다. 설치, rasen init을 실행한 후 명령이 작동하는 방법을 읽어서 첫 슬래시 명령이 올바른 장소에 닿습니다.

예시로 배웁니다. 예시 & 레시피 페이지는 시작부터 끝까지 실제 변경을 거칩니다. 작은 기능, 버그 수정, 리팩터, 탐색.

AI가 방금 계획을 초안했습니다 — 이제 뭘 하지? 읽기. 변경 검토는 여전히 저렴할 때 잘못된 회전을 잡는 2분 통과를 보여주고, 좋은 스펙 작성은 승인할 가치가 있는 계획으로 구성된 것을 다룹니다.

팀에서 일합니다. 팀에서 Rasen은 변경이 브랜치 및 풀 리퀘스트에 매핑되는 방법과 팀 동료가 코드 전에 계획을 검토하는 방법을 보여줍니다.

나는 이전 워크플로우에서 와요. 마이그레이션 가이드는 변경된 내용과 이유를 설명하고 기존 작업이 안전함을 약속합니다.

팀의 프로세스에 맞게 구부리고 싶습니다. 사용자 정의는 프로젝트 구성, 커스텀 스키마 및 공유 컨텍스트를 다룹니다.

뭔가 깨졌습니다. 문제 해결은 실제로 사람들이 맞닥뜨린 실패를 수정과 함께 수집합니다.

전체 지도

시작 위치

문서 제공되는 것
시작하기 설치, 초기화 및 첫 변경 전체 실행
먼저 탐색 /rasen:explore를 사용하여 커밋하기 전에 아이디어를 생각
명령이 작동하는 방법 슬래시 명령이 실행되는 위치, "대화형 모드"의 의미, 터미널 vs 채팅
한눈에 핵심 개념 한 페이지의 전체 정신 모델. 스펙, 변경, 델타, 보관
설치 npm, pnpm, yarn, bun, Nix 및 작동했는지 확인하는 방법

매일 사용

문서 제공되는 것
워크플로우 일반적인 패턴 및 각 명령에 도달할 시기
예시 & 레시피 실제 변경의 전체 연습, 복사 붙여넣기 가능
좋은 스펙 작성 강한 요구사항과 시나리오의 모습, 변경 크기 조정 방법
변경 검토 코드가 작성되기 전에 초안 계획의 2분 통과
팀에서 Rasen 변경이 브랜치, 풀 리퀘스트 및 검토에 맞는 방법
기존 프로젝트에서 Rasen 사용 큰 갈색 필드 코드베이스에서 rasen 채택
변경 편집 & 반복 산출물 업데이트, 돌아가기, 수동 편집 조화
명령 모든 /rasen:* 슬래시 명령의 참조
CLI 모든 rasen 터미널 명령의 참조

깊이 있게 이해

문서 제공되는 것
개념 스펙, 변경, 산출물, 스키마 및 보관의 장형 설명
OPSX 워크플로우 워크플로우가 단계 잠금 대신 유동적인 이유, 그리고 아키텍처 심층 분석
용어집 한 곳에 정의된 모든 용어

자신의 것으로 만들기

문서 제공되는 것
사용자 정의 프로젝트 구성, 커스텀 스키마, 공유 컨텍스트
다국어 영어 이외의 언어로 산출물 생성
지원 도구 25개 이상의 AI 도구 rasen이 통합되고 파일이 도착하는 위치

도움이 필요할 때

문서 제공되는 것
FAQ 사람들이 가장 자주 묻는 질문에 빠른 답변
문제 해결 구체적인 실패에 대한 구체적인 수정사항
마이그레이션 가이드 레거시 워크플로우에서 Rasen으로 이동

리포지토리 간 조정(베타)

문서 제공되는 것
스토어: 사용자 가이드 작업이 리포지토리 또는 팀에 걸쳐 있을 때 자체 리포지토리에서 계획
에이전트 계약 에이전트가 구동하는 머신 읽기 가능 CLI 표면

30초 버전

1. 설치        npm install -g @atelierai/rasen@latest
2. 초기화     cd your-project && rasen init
3. 탐색        (AI 채팅에서)  /rasen:explore           ← 선택사항이지만 좋은 습관
4. 제안        (AI 채팅에서)  /rasen:propose add-dark-mode
5. 구축        (AI 채팅에서)  /rasen:apply
6. 보관        (AI 채팅에서)  /rasen:archive

단계 1과 2는 터미널에서 발생합니다. 나머지는 AI 보조자의 채팅에서 발생합니다. 이 분할은 기억할 가치가 있는 유일한 것이고, 명령이 작동하는 방법은 정확히 이유를 설명합니다. 단계 3은 선택사항이지만 확실하지 않을 때 /rasen:explore로 시작하는 것이 구축할 가장 가치있는 습관입니다.

도움을 받을 다른 곳

이 문서에서 잘못되었거나, 오래되었거나, 혼란스러운 것을 찾았습니까? 그것은 버그입니다. 이슈나 PR을 엽니다. 문서 개선은 할 수 있는 가장 가치있는 기여 중 일부입니다.

웹사이트 게시

공개 rasen 웹사이트는 이 docs/ 트리의 정리되고 정렬된 부분 집합을 게시합니다. 이 디렉토리의 website-manifest.json은 인터페이스입니다. 게시된 페이지, 섹션, 순서, 제목 및 슬러그를 정확히 선언합니다. 사이트에 나타나야 하는 문서를 추가하거나 이름을 바꾸고 있으면 매니페스트를 함께 업데이트합니다 — 사이트 빌드가 직접 읽고 추측하지 않습니다.