feat: add Claude Code best practices to /learn command

[rohitg00]

Summary

• Enhanced /learn command to teach Claude Code best practices directly, linking to official docs at https://code.claude.com/docs/ for deep dives
• Added references/claude-code-resources.md with comprehensive best practices guide covering sessions, context, modes, CLAUDE.md, prompting, rules, skills, subagents, hooks, security, MCP, and integration
• Added Claude-Code and Prompting categories across all learning commands (learn-rule, learn, list)
• Added "Claude Code Mastery" section to core-rules.md and "Learn Claude Code" section to SKILL.md

Test plan

• Run /pro-workflow:learn and verify best practices guide displays
• Run /pro-workflow:learn-rule and verify new categories (Claude-Code, Prompting) are listed
• Run /pro-workflow:list and verify new categories appear
• Verify all docs links point to https://code.claude.com/docs/ (no external repo references)
• Verify references/claude-code-resources.md is included in npm package (npm pack --dry-run)

Summary by CodeRabbit

Release Notes

• Documentation

  • Expanded comprehensive documentation covering Claude Code best practices, memory management, and workflow optimization.
  • Added detailed reference guides for learning and search capabilities.

• New Features

  • New /learn command for capturing and organizing Claude Code best practices.
  • New /search command for keyword-based searching of learnings.
  • Enhanced /list command with expanded category support.

[coderabbitai]

📝 Walkthrough

Walkthrough

Documentation expansion adds Claude Code best practices guidance across multiple command files, introduces a new reference documentation file, updates core rules with mastery guidelines, extends the pro-workflow skill with learning sections and commands, and updates package.json to include the references file.

Changes

Cohort / File(s)	Summary
Command Documentation README.md, commands/learn.md, commands/learn-rule.md, commands/list.md	Updated command descriptions and examples; reworded /learn from "save learning to database" to "Claude Code best practices & learning capture"; added new /pro-workflow:search command; expanded categories to include Architecture, Performance, Claude-Code, and Prompting; introduced new Claude Code examples section.
Reference Documentation references/claude-code-resources.md	Added comprehensive new reference file documenting Claude Code best practices, including official resources, memory prompts, modes, CLI navigation, prompting structure, writing rules, skills, subagents, hooks, security, and MCP integration.
Rules rules/core-rules.md	Added new "Claude Code Mastery" section with operational guidelines for planning mode, CLAUDE.md structure, context management, prompt structure, and delegation practices.
Skills skills/pro-workflow/SKILL.md	Added "Learn Claude Code" section with best practices, official docs link, learning topics, and topic-to-pattern mappings; extended CLAUDE.md commands with /learn, /search, and /list.
Configuration package.json	Added "references" entry to the files array for package distribution.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

Poem

🐰 Hop hop, the docs now shine so bright,
With Claude Code wisdom gathered just right,
Learn, search, and list our precious lore,
Best practices tucked behind each door,
A burrow of knowledge to explore! 🌟

🚥 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	The title accurately summarizes the main change: adding Claude Code best practices to the /learn command, which is reflected throughout the PR with new documentation, command enhancements, and category additions.
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
• Post copyable unit tests in a comment
• Commit unit tests in branch feat/learn-claude-code-best-practices

---

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.}