docs(README): redesign for better readability and appeal

[nanasess]

Summary

• Restructure README with a clearer narrative flow: Why -> Quick Start -> How It Works -> Commands
• Add CI badge
• Improve worktree layout diagrams showing both single and multi-repo
• Highlight "Pure Bash — no dependencies beyond git and bash"
• Streamline command reference with inline examples

Test plan

• README renders correctly on GitHub

🤖 Generated with Claude Code

Summary by CodeRabbit

ドキュメント

• READMEを構造化し、ユースケースを説明する「Why?」セクションを追加
• 「How It Works」にマルチリポジトリと単一リポジトリのディレクトリレイアウト図を追加
• 全コマンド（worktree create/list/checkout/pull/cleanup）のドキュメントを明確化
• 自動依存関係インストール機能についての専用セクションを新規追加
• 環境変数とフック設定の説明をより詳細に改善

[coderabbitai]

Warning

Rate limit exceeded

@nanasess has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 11 minutes and 4 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 11 minutes and 4 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: e7170501-9c65-4ef1-9d5f-9598acbd53b1

📥 Commits

Reviewing files that changed from the base of the PR and between 877312e and 9c7e0d8.

📒 Files selected for processing (1)

• README.md

📝 Walkthrough

Walkthrough

README.mdを構造的なガイドに再構成しました。「Why?」セクション、拡張された「How It Works」、リファクタリングされたコマンドドキュメント、自動依存関係インストールに関する新しいセクション、および環境変数情報を追加しました。

Changes

Cohort / File(s)	Summary
README Documentation Restructuring README.md	新しい「Why?」セクションを追加、「How It Works」にディレクトリレイアウト図を追加、worktree create/checkout/pull/cleanupコマンドのドキュメントを明確化、環境変数テーブルを更新、「Auto Dependency Installation」セクションを追加、テストセクションを簡略化。

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• docs: README.md/CLAUDE.md の更新、英語化、テスト追記 #9: README.mdのドキュメント変更が重複しており、worktreeコマンド、.worktreerc、環境変数、テスト手順などの説明が共通しています。

Poem

📖✨ Documentation refreshed with care,
Why and how now crystal clear,
Commands dance in structured light,
README blooms, a joyful sight! 🐰

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	PRのタイトルは、README.mdの再設計と改善を明確に要約しており、変更セットの主要な目的と完全に一致しています。
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/update-readme-and-claude-md

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[gemini-code-assist]

Code Review

This pull request significantly refactors the README.md to improve documentation clarity, adding a quick-start guide, visual directory structures, and streamlined command references. Feedback suggests enhancing the single-repo diagram for better clarity and including command aliases for the cleanup utility to maintain consistency across the documentation.

[coderabbitai]

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Around line 58-66: The fenced code block showing the directory tree in
README.md lacks a language specifier; update the opening fence (the line with
```) to include a language tag such as "text" or "plaintext" so it becomes
```text (or ```plaintext) to follow Markdown best practices and ensure the
directory structure is rendered correctly; modify the existing triple-backtick
fence that surrounds the directory diagram accordingly.
- Around line 38-52: The README's directory-structure code block is missing a
Markdown language specifier; update the fenced code block surrounding the tree
(the triple-backtick block containing the ~/git-repos/ tree) to include a
language like "text" or "plaintext" (e.g., change ``` to ```text) so the block
follows Markdown best practices and ensures correct formatting/rendering.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 5680a50f-83ce-4a6e-b297-9b0ff882629e

📥 Commits

Reviewing files that changed from the base of the PR and between 0569877 and 877312e.

📒 Files selected for processing (1)

• README.md