# REA 사용법 (클로드 코드용)

REA는 앱 안쪽을 살펴 기능이 어떻게 돌아가는지 근거와 함께 알려 주는 오픈소스 도구예요. 다만 원리를 아는 것만으로는 원하는 걸 만들 수 없어요. 개발 스킬을 붙여 「앱 따라 만들어 보기」까지 하는 방법을 알려 드려요.

강의로 하나씩 따라 하세요. https://academy.thenoun.ai/l/rea-clone/

## 이게 뭐예요 · 앱 안쪽을 뜯어보는 AI 도구

- 앱 이름과 궁금한 기능만 말하면, 화면·코드·파일을 살펴 원리를 알려 줘요.
- 알려 줄 때 근거(어느 파일, 어느 화면)를 같이 보여 줘요.
- 알아낸 원리로 내 프로젝트에 비슷한 기능을 짜고 테스트까지 돌리게 할 수 있어요.
- MIT 라이선스 오픈소스라 무료예요.

## STEP 1 · 설치하기

1. 컴퓨터에 **Node.js**(22.19 이상 또는 24.11 이상)와 npm이 있어야 해요.
2. 터미널에 아래 한 줄을 넣어요. 클로드 코드에 REA를 연결하고 사용 지침까지 넣어 줘요.
3. 클로드 코드를 다시 열면 바로 쓸 수 있어요.
`npx rea-agents setup`

## STEP 2 · 바로 쓰는 문장 3개
클로드 코드 입력창에 그대로 넣고, ○○ 자리만 바꿔요.
1. 「○○ 웹 화면의 로그인 흐름을 REA로 분석해서 근거와 함께 설명해 줘.」
2. 「내 컴퓨터에 있는 ○○ 앱이 파일을 어디에 저장하는지 REA로 찾아서 알려 줘.」
3. 「방금 알아낸 원리로 내 프로젝트에 비슷한 기능을 짜고, 테스트까지 돌려 줘.」

## STEP 3 · 앱 따라 만들어 보기
REA는 원리를 알려 줄 뿐이에요. 설계하고, 코드를 짜고, 테스트하는 건 개발 스킬로 따로 시켜야 해요. 저는 공개 플러그인 **fullstack-dev-skills**(MIT, 무료)를 붙여 써요.
1. **원리 알아내기(REA)** — 기능이 어떤 순서로, 어떤 데이터로 돌아가는지 근거와 함께 받아요.
2. **개발 스킬 받기** — 클로드 코드 입력창에 이 칸 맨 아래 명령 두 줄을 차례로 넣어요.
3. **설계하고 짜기** — Feature Forge(요구사항) → Architecture Designer(설계) → Fullstack Guardian(구현) 순서로 시켜요.
4. **테스트로 확인하기** — Test Master 로 원래 앱과 같은 순서로 동작하는지 테스트를 만들고, 통과할 때까지 고쳐요.
① 원리 | 「○○ 화면의 ○○ 기능을 REA로 분석해서, 동작 순서와 근거(파일·화면 위치)를 표로 정리해 줘.」
② 설계·구현 | 「방금 정리한 원리로 내 프로젝트에 같은 기능을 만들려고 해. Feature Forge 로 요구사항을 정리하고, Architecture Designer 로 설계서를 보여 줘. 내가 좋다고 하면 Fullstack Guardian 으로 코드를 짜 줘.」
③ 테스트 | 「Test Master 로 원래 앱의 동작 순서를 테스트로 만들고 돌려 줘. 실패하면 고치고, 전부 통과하면 결과를 보여 줘.」
`/plugin marketplace add jeffallan/claude-skills
/plugin install fullstack-dev-skills@fullstack-dev-skills`

참고: 설치부터 테스트까지 순서대로 따라 하려면 위 강의를 보세요.

## 자주 묻는 질문

### REA는 무엇인가요?
앱 안쪽을 살펴 기능이 어떻게 돌아가는지 근거와 함께 알려 주는 오픈소스 도구예요. MIT 라이선스라 무료예요.

### REA로 알아낸 기능을 따라 만들려면 어떻게 하나요?
REA는 원리만 알려 줘요. 설계·구현·테스트는 개발 스킬(fullstack-dev-skills)로 따로 시켜요.
