ガイド
rezero.md の使い方
rezero.md は、公開ウェブサイトを AI コーディングエージェントが読める根拠ベースの Markdown ドキュメントに変換します。ブラウザ拡張もアカウントもインストールも不要で、ターミナルだけで動きます。
始める前に
- Node.js 22 以上（node -v で確認）。
- プロジェクトフォルダで開いたターミナル。
- 開始にアカウントや API キーは不要です。
クイックスタート
コマンド 1 つだけ。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 などのコンテキストファイルも生成されます。
試してみますか？
すでに分析済みの製品を見る、あるいは 1 コマンドで自分で生成してみましょう。