한눈에 핵심 개념
Rasen은 당신과 AI 사이의 경량 동의 계층입니다. 변경이 무엇을 해야 하는지 작성하고, AI가 세부사항을 초안하고, 둘 다 동일한 계획을 보고, 그 다음에만 코드가 작성됩니다. 이 페이지는 한 화면의 전체 정신 모델입니다. 긴 버전을 원하면 개념이 있습니다.
다섯 단어로 전체 아이디어입니다. 먼저 동의하고 자신감 있게 구축합니다.
다섯 가지 아이디어
rasen의 모든 것은 다섯 가지 개념에서 구축됩니다. 이들을 배우면 나머지는 세부사항입니다.
1. 스펙이 진실입니다. 스펙은 시스템이 현재 어떻게 작동하는지 설명합니다. 도메인별로 구성된 rasen/specs/에 존재합니다(auth/, payments/, ui/). 스펙은 요구사항("시스템은 30분 후에 세션을 만료해야 함")과 시나리오(구체적인 given/when/then 예시)로 구성됩니다. 스펙을 "이 소프트웨어가 무엇을 하는가?"에 대한 단일 합의된 답변으로 생각하십시오.
2. 변경은 작업의 한 단위입니다. 동작을 추가, 수정 또는 제거하려면 변경을 생성합니다. 한 곳에서 해당 작업에 대한 모든 것을 보유하는 rasen/changes/ 폴더입니다. 제안, 설계, 작업 목록 및 스펙 편집. 하나의 변경, 하나의 폴더, 하나의 기능.
3. 델타 스펙은 전 세계가 아닌 변경되는 것을 설명합니다. 변경 내에서 전체 스펙을 다시 작성하지 않습니다. 작은 델타를 작성합니다. ADDED 이 요구사항, MODIFIED 그 요구사항, REMOVED 다른 요구사항. 이것이 rasen이 기존 시스템을 편집하는 데 좋아하는 트릭입니다. 녹색 필드 시스템이 아닙니다. 대상이 아닌 차이를 설명합니다.
4. 산출물은 서로의 기초 위에 구축됩니다. 변경에는 자연스러운 순서로 생성되고 다음을 먹이는 몇 가지 문서가 포함됩니다.
proposal ──► specs ──► design ──► tasks ──► implement
why what how steps do it
언제든지 이들 중 하나를 다시 방문할 수 있습니다. 게이트가 아닌 인에이블러입니다. (이에 대한 자세한 내용은 아래를 참조하세요.)
5. 보관은 변경을 진실로 다시 접습니다. 작업이 완료되면 변경을 보관합니다. 델타 스펙이 주 스펙으로 병합되고 변경 폴더가 날짜 스탬프와 함께 changes/archive/로 이동합니다. 이제 스펙이 새로운 현실을 설명하고 다음 변경을 위해 준비됩니다. 사이클이 닫힙니다.
그림
┌─────────────────────────────────────────────────────────────────┐
│ rasen/ │
│ │
│ ┌──────────────────┐ ┌──────────────────────────┐ │
│ │ specs/ │ │ changes/ │ │
│ │ │ ◄───── │ │ │
│ │ source of truth │ merge │ one folder per change │ │
│ │ how things work │ on │ proposal · design · │ │
│ │ today │ archive │ tasks · delta specs │ │
│ └──────────────────┘ └──────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
두 폴더. specs/는 진실입니다. changes/는 제안 중인 것입니다. 보관은 제안을 진실로 이동합니다.
실제로 실행할 루프
기본 설정에서 하루는 다음과 같이 보입니다. 선택적으로 먼저 생각해 봅니다. 그 다음 한 명령이 계획을 초안하고, 읽고, 다음이 구축하고, 마지막이 파일합니다.
/rasen:explore → (선택사항) 먼저 AI로 생각
/rasen:propose add-dark-mode → AI가 제안, 스펙, 설계, 작업 초안
(계획을 읽고 조정합니다)
/rasen:apply → AI가 구축, 작업 확인
/rasen:archive → 스펙 업데이트, 변경 보관
확실하지 않을 때는 탐색으로 시작합니다. /rasen:explore는 위험이 없는 생각 파트너입니다. 코드를 읽고, 옵션을 배치하고, 어떤 산출물도 존재하기 전에 모호한 아이디어를 구체적인 계획으로 바꿉니다. 그렇지 않으면 모호한 프롬프트에서 뭔가를 구축할 AI에 대한 최고의 해독제입니다. 정확히 무엇을 원하는지 이미 알고 있습니까? /rasen:propose로 바로 건너뜁니다. 어느 쪽이든 탐색은 기본 프로파일에 제공되므로 항상 있습니다. 탐색 가이드를 참조하세요.
이들은 AI 보조자의 채팅에 입력되는 슬래시 명령입니다. 설정(rasen init)은 터미널에서 발생합니다. 이 분할이 새로운 경우 먼저 명령이 작동하는 방법을 읽으세요. 가장 일반적인 혼동 지점입니다.
"인에이블러, 게이트가 아니다"
이 구절은 rasen 전체에 나타나므로 평문으로 의미하는 바입니다.
구식 스펙 프로세스는 폭포입니다. 계획 완료, 그런 다음 구현이 허용되고, 뒤로 가는 것은 고통스럽습니다. Rasen은 거부합니다. 순서 proposal → specs → design → tasks는 강제된 다음이 아니라 가능해지는 것을 보여줍니다.
구현 중에 설계가 잘못되었다는 것을 발견합니까? design.md를 편집하고 계속하세요. 범위를 축소해야 한다고 깨달으셨습니까? 제안을 업데이트하세요. 아무 것도 잠금하지 않습니다. 종속성은 AI가 필요한 컨텍스트를 갖도록 하기 위해서만 존재합니다(스펙을 기반으로 하지 않고 좋은 작업을 작성할 수 없습니다), 상자에 담기 위해서가 아닙니다.
여기서의 강점은 정직입니다. 실제 작업은 지저분하고 반복적이며, rasen은 그렇게 할 수 있습니다. 절충은 규율입니다. 아무것도 당신을 강제하지 않으므로 변경을 집중시키고 펼쳐지게 하지 않는 것은 당신에게 달려있습니다. 워크플로우 가이드에는 좋은 습관이 있습니다.
이것이 작은 오버헤드의 가치가 있는 이유
평문 진실: rasen은 단계를 추가합니다. 구축하기 전에 짧은 계획을 작성합니다. 그럼 뭘 얻나요?
- 비용이 드는 잘못된 회전을 잡으세요. 한 문단 제안에서 오해를 수정하는 것은 무료입니다. AI가 400줄을 작성한 후에 수정하는 것은 아닙니다.
- 계획과 코드는 동일한 리포지토리에 유지됩니다. 6개월 후 스펙은 시스템이 왜 그런 방식으로 작동하는지 알려줍니다(그리고 다음 AI 세션).
- 변경은 검토 가능합니다. 변경 폴더는 깔끔한 패키지입니다. 제안을 읽고, 델타를 스캔하고, 작업을 확인하세요. 채팅 기록을 통한 고고학 없음.
- 기존 코드베이스에 맞습니다. 델타는 먼저 전체를 문서화하지 않고 50,000줄 앱에 변경을 지정할 수 있음을 의미합니다.
그리고 정직한 절충. 정말 사소한 한 줄 수정의 경우 의식은 보수하지 않을 수 있으며 그것은 괜찮습니다. Rasen은 경량으로 설계되었지만 무료가 아닙니다. 동의가 중요한 곳에서 사용하세요. 모호하게 요청한 것을 자신있게 구축할 AI와 함께 작업하면 대부분의 시간이 됩니다.