feat: rewrite /guide as interactive beginner walkthrough

[justinjdev]

Summary

• Replaces the passive wall-of-text /guide with an interactive learn-by-doing walkthrough
• Act 1: brief pitch, then ask the user for a real task from their codebase
• Act 2: guided quest — research → plan → implement → PR, with natural-language checkpoints at each stage
• Act 3: graduation — names the concepts (quest, gates), points to /quest and /fellowship
• Silently uses council/gather-lore/lembas patterns without exposing jargon
• No CLI binary, hooks, or gate enforcement needed — pure prompt

Test plan

• Run /guide in a test project, provide a real task, verify the three-act flow works end-to-end
• Verify no internal jargon (gates, lembas, tome, worktree, etc.) appears before Act 3
• Verify branch creation (guide/<slug>) and PR creation work
• Verify graduation offers config setup when ~/.claude/fellowship.json doesn't exist

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Restructured the guide from a concepts overview to an interactive, hands-on learning experience organized by acts and stages.
  • Added concrete operational steps and workflows for completing real tasks.
  • Enhanced guidance for research, planning, and implementation phases with explicit approval checkpoints.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: da2f54c7-33cb-4c97-a27a-1851be9be086

📥 Commits

Reviewing files that changed from the base of the PR and between a0c9e13 and db49be7.

📒 Files selected for processing (1)

• plugin/commands/guide.md

---

📝 Walkthrough

Walkthrough

The guide was restructured from a concepts-and-commands reference into an interactive Act-based task walkthrough. It now guides users through a real-codebase task via three acts: task selection, guided quest with explicit research/plan/implement stages, and graduation. Concrete operational steps and a context checkpoint requirement were added.

Changes

Cohort / File(s)

Summary

Documentation Restructuring plugin/commands/guide.md

Transformed from high-level concepts overview to interactive learn-by-doing guide. Introduced Act-based flow (Pitch → Guided Quest → Graduation) with explicit stages: Research (Explore agent, structured findings), Plan (EnterPlanMode → draft → approval → ExitPlanMode), and Implement (execute with tests). Added concrete operational steps (branch creation, PR commands) and context checkpoint (silent) requirement.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/beginner-guide

---

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

Tip

You can validate your CodeRabbit configuration file in your editor.

If your editor has YAML language server, you can enable auto-completion and validation by adding # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json at the top of your CodeRabbit configuration file.