가이드
rezero.md 사용법
rezero.md는 공개 웹사이트를 AI 코딩 에이전트가 읽을 수 있는 근거 기반 Markdown 문서로 바꿔 줍니다. 브라우저 확장도, 계정도, 설치도 필요 없이 터미널에서 바로 실행됩니다.
시작하기 전에
- Node.js 22 이상 (node -v 로 확인).
- 프로젝트 폴더에서 연 터미널.
- 시작하는 데 계정이나 API 키는 필요 없습니다.
빠른 시작
명령 하나면 됩니다. npx가 처음 실행할 때 패키지를 내려받으므로 따로 설치할 것이 없습니다.
1. 사이트 분석하기
아무 공개 URL이나 지정하세요. 공개 페이지를 크롤링해 현재 폴더의 .rezero/<domain>/ 안에 8개의 Markdown 문서를 씁니다.
$ npx rezero-md analyze https://linear.app2. 또는 init 으로 에이전트용 파일까지 생성
init 은 동일한 분석을 한 뒤, 에이전트 컨텍스트 파일(CLAUDE.md, AGENTS.md, .cursor 규칙 등)을 프로젝트 루트에 추가로 써서 AI 툴이 자동으로 인식하도록 합니다.
$ npx rezero-md init https://linear.app결과물
.rezero/<domain>/ 안에 8개의 근거 기반 문서가 생성됩니다. 각 문서는 관찰·추론·권장을 분리합니다:
init 은 프로젝트 루트에 에이전트용 컨텍스트 파일을 추가해, 코딩 툴이 별도 설정 없이 읽도록 합니다:
작동 방식
모든 문서는 “의견보다 근거 먼저”라는 원칙 위에 만들어집니다. 제품을 복제하기 위한 것이 아니라 어떻게 만들어졌는지 배우기 위한 것입니다.
관찰 (Observe)
공개된 메타데이터, 구조, 링크, 인터페이스 토큰, 기술 시그니처 — 페이지가 실제로 제공하는 것만.
추론 (Infer)
확신도를 함께 표시한 신중한 가설. 사실이 아니라 추측임을 분명히 표시합니다.
권장 (Recommend)
원본을 복제하는 대신, 패턴을 당신의 제품에 맞게 적용할 수 있는 전이 가능한 조언.
AI 툴에서 사용하기
결과물은 저장소 안의 평범한 Markdown이므로 어떤 에이전트든 읽을 수 있습니다. 대표 툴별 안내:
Claude Code
자동 인식. Claude Code는 저장소 루트의 CLAUDE.md와 AGENTS.md를 읽습니다. 해당 폴더에서 claude 를 실행하고 rezero.md 레퍼런스를 사용하라고 요청하세요.
Cursor
자동 인식. 생성된 .cursor/rules/rezero.mdc 가 Cursor의 제안을 안내합니다. 채팅에서 .rezero/ 안의 파일을 @로 언급할 수도 있습니다.
Codex CLI
AGENTS.md를 자동으로 읽습니다. 폴더에서 codex 를 실행하거나 .rezero/<domain>/ 문서를 지정하세요.
Gemini CLI
프롬프트에서 생성된 Markdown을 참조하세요 — 예: “.rezero/<domain>/ 안의 파일을 디자인 컨텍스트로 사용해줘”.
그 밖의 에이전트
Windsurf, Cline, Continue 등: 모두 .rezero/ 안의 평범한 Markdown이므로 해당 파일을 툴 컨텍스트에 추가하면 됩니다.
전체 AI 생성 (선택)
키가 없으면 rezero.md는 결정적(deterministic) 기본 문서를 써서 형태를 바로 볼 수 있게 합니다. 전체 AI 분석을 원하면 GEMINI_API_KEY(또는 OPENAI_API_KEY)를 설정하세요. 키와 파일은 모두 당신의 컴퓨터에만 남습니다.
$ export GEMINI_API_KEY=your_key_here$ npx rezero-md init https://linear.app문제 해결
명령을 실행해도 아무 일이 없거나 “not found”가 뜹니다.
node -v 로 Node.js 22 이상인지 확인한 뒤 npx rezero-md analyze <url> 을 실행하세요. npx가 처음 실행 시 패키지를 내려받으며, 전역 설치는 필요 없습니다.
문서가 너무 얇거나 일반적으로 보입니다.
키가 없을 때의 기본 출력입니다. 전체 분석을 원하면 GEMINI_API_KEY(또는 OPENAI_API_KEY)를 설정하거나, 이미 완전히 생성된 라이브러리를 둘러보세요.
“No public HTML pages could be fetched.” 오류가 납니다.
대상은 크롤링이 허용된 공개 페이지여야 합니다. 사이트의 공개 랜딩 URL을 사용하고, 로그인 뒤에 있거나 봇을 차단하지 않는지 확인하세요.
파일은 어디에 생성되나요?
명령을 실행한 폴더의 .rezero/<domain>/ 안에 생성됩니다. init 을 쓰면 CLAUDE.md, AGENTS.md 등 컨텍스트 파일도 함께 생성됩니다.
이제 직접 써볼까요?
이미 분석된 제품들을 둘러보거나, 명령 하나로 직접 생성해 보세요.