nitingupta220/riperflow

약 1,350토큰(token) 분량의 단일 명세서로 10개의 AI 코딩 도구 — Cursor, Claude Code, OpenCode, Aider 및 기타 도구들 —를 아우르는 하나의 워크플로 방법론.

만약 당신이 두 개 이상의 AI 코딩 도구를 사용한다면 — 대부분의 사람들은 IDE 작업을 위해 Cursor를, 터미널 세션을 위해 Claude Code를, 리팩토링(refactor)을 위해 Aider를 섞어서 사용하므로 — 아마도 동일한 프로젝트 규칙을 네 가지 버전으로 작성했을 것입니다. 각 도구는 서로 다른 위치에 서로 다른 파일을 요구합니다: .cursor/rules/, CLAUDE.md, AGENTS.md, CONVENTIONS.md. 이들은 서로 어긋나게 됩니다.

Riperflow는 단일 진실 공급원 (one source of truth) (저장소 내의 작은 메모리 뱅크)을 유지하며, 각 도구에 맞는 규칙 파일을 해당 도구의 고유 형식으로 생성합니다. 작업 도중에 도구를 전환하더라도 프로젝트의 컨텍스트(context)가 함께 따라옵니다.

mkdir my-project && cd my-project
npx riperflow init # 대화형: 스캐폴딩(scaffold)할 도구 선택
npx riperflow setup --tools cursor,claude-code,opencode,aider

그러면 다음 파일들이 작성됩니다:

memory-bank/ — 요약, 아키텍처(architecture), 기술 컨텍스트(tech context), 활성 작업, 진행 상황, 그리고 코드 보호 레지스트리(code-protection registry)를 캡처하는 6개의 마크다운(markdown) 파일. 진실 공급원(source of truth).

• 당신이 선택한 각 도구에 맞는 규칙 파일이 각 도구의 고유 위치에 생성됩니다 (전체 목록은 아래 참조).
  .riper/config.json + .riper/state.json — Riperflow의 장부 기록.

이제 스캐폴딩한 도구 중 아무 곳에서나 프로젝트를 여세요. AI는 즉시 규칙을 확인합니다. /r, /p, /e 등을 사용하여 모드 전환을 요청하면, AI는 해당 모드에 맞는 올바른 메모리 파일을 읽을 것입니다.

비대화형(Non-interactive) 방식이 필요한가요? init에 -y를 추가하세요. CLI는 파이프(piped) stdin 또는 CI를 자동으로 감지하여 기본값으로 전환합니다.

Riperflow는 챗봇이 아닌 **방법론(methodology)**을 제공합니다. 당신의 AI 도구는 다섯 가지 모드를 통해 실행됩니다:

모드 (Mode)	기호 (Symbol)	기능 (What it can do)	사용 시점 (When to use)
Research (연구)	Ω₁ 🔍	읽기 전용 — 설명, 분석, 요약	새로운 코드 이해
Innovate (혁신)	Ω₂ 💡	접근 방식 제안; 직접 작성 불가	기능 브레인스토밍
Plan (계획)	Ω₃ 📝	문서만 작성, 소스 코드 작성 불가	작업 사양 정의 (Speccing)
Execute (실행)	Ω₄ ⚙️	전체 쓰기 권한	빌드 (Building)
Review (검토)	Ω₅ 🔎	읽기 전용 검증	병합 전 무결성 확인 (Pre-merge sanity check)

모드 권한은 생성된 규칙 파일(rule files)에 의해 강제됩니다. 사용자가 별도의 조치를 취하지 않아도 AI는 모드 범위를 벗어난 편집을 거부합니다.

도구 (Tool)	Riperflow가 작성하는 파일	네이티브 탐지 (Native discovery)?
Cursor	.cursor/rules/riper.mdc	✅
Claude Code	CLAUDE.md , .claude/rules/riper.md	✅
OpenCode	.opencode/AGENTS.md , .opencode/opencode.json	✅
KiloCode	.kilocode/rules/riper.md	✅
VS Code	.vscode/.riper.md	✅
Roo Code	.roo/rules/riper.md	✅
Aider	CONVENTIONS.md , .aider/riper.md , .aider.conf.yml	✅
Windsurf	.windsurf/rules/riper.md , .windsurf/cascade.md	✅
Cline	.cline/instructions/riper.md + 설정 (settings)	✅
Codex CLI	AGENT.md , .codex/riper.md	✅

각 도구에 맞춰 렌더링된 전체 RIPER 명세(spec) — 모드, 권한, 메모리 참조, BMAD 역할, 코드 보호 규칙 — 는 평균 ~1,350 토큰 (tokens) 내에 들어갑니다 (생성된 14개 규칙 파일 전체를 측정했을 때; 도구의 선호하는 상세도에 따라 518~1,763 범위). 이 인코딩은 기호 표기법(symbolic notation)을 사용합니다:

모드 (Modes): Ω₁ … Ω₅ (그리스 문자 오메가)
단계 (Phases): Π₁ … Π₄ (파이)
메모리 슬롯 (Memory slots): Σ₁ … Σ₆ (시그마)
보호 수준 (Protection levels): Ψ₁ … Ψ₆ (프사이)

의미론(semantics)은 동일하지만, 일반 산문 형태의 규칙 세트보다 약 10배 더 작습니다. 여러분의 모델은 어떻게 행동해야 하는지를 기억하는 데가 아니라, 여러분의 코드를 처리하는 데 컨텍스트 예산(context budget)을 사용하게 됩니다.

# 모드 (또는 단일 문자 단축키 r / i / p / e / rev 사용)
riperflow mode research
riperflow mode plan
...

전체 옵션을 확인하려면 모든 명령에 --help를 붙여 실행하세요.

메모리 뱅크 (Memory bank). memory-bank/ 디렉토리 내의 6개 마크다운 (markdown) 파일:
: projectbrief.md

(scope), systemPatterns.md (architecture), techContext.md (stack), activeContext.md (current focus — 작업 진행에 따라 업데이트됨), progress.md (milestones), protection.md (어떤 파일이 접근 금지인지 명시). 모든 도구의 생성된 규칙 파일(rule file)은 이 파일들을 참조합니다.

BMAD 역할 (roles). 팀을 위한 선택적 구조: Product Owner, Architect, Developer, QA, DevOps. 각 역할은 범위가 지정된 권한(scoped permissions)과 기본 모드를 가집니다. riperflow role set <role> 명령어로 전환할 수 있습니다.

품질 게이트 (Quality gates). 5단계 — Design → Development → Testing → Review → Deploy. riperflow gate advance로 단계를 진행하고, gate approve <stage>로 승인합니다. AI 주도 작업 내에서 경량화된 단계별 게이트 프로세스(stage-gate process)를 복제하는 데 유용합니다.

코드 보호 (Code protection). open (누구나, 검사 없음)부터 frozen (영구적 변경 불가)까지 6단계가 있습니다. 경로별로 적용 가능합니다: riperflow protect set src/auth locked. 생성된 규칙 파일은 AI가 어떠한 수정 작업을 수행하기 전에 protection.md를 확인하도록 지시합니다.

대시보드 (Dashboard). 모드, 단계, memory-bank 파일 크기, 최근 명령, 위반 사항에 대한 실시간 보기(Live view)를 제공합니다. 웹 버전은 실시간 업데이트를 위해 Express + WebSocket을 사용하며

MIT — LICENSE 참조.