claude-code-best-practice is a repository of agents, commands, skills, hooks, plugins, and configuration guidance for Claude Code. It helps developers organize repeatable workflows and apply agentic engineering practices, including in monorepos. The catalogue entries are its reusable Claude Code workflow components.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add commands/shanraisshan/claude-code-best-practice/plangit clone --depth 1 https://github.com/shanraisshan/claude-code-best-practiceWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/commands/shanraisshan/claude-code-best-practice/plan)<a href="https://agentmods.dev/commands/shanraisshan/claude-code-best-practice/plan"><img src="https://agentmods.dev/badge/commands/shanraisshan/claude-code-best-practice/plan.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00007 | $0.02712 |
| Opus 5 | $0.00003 | $0.01356 |
| Sonnet 5 | $0.00001 | $0.00542 |
| Haiku 4.5 | $0.00001 | $0.00271 |
Grade A, and why
plan scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
Copies of this mod
1 near-identical copy found in the catalogue:
- plan — 100% identical, 0 lines differ
How it starts
The opening of the file, as written. The whole thing — 417 lines — stays where its author put it; the contents beside it link to each section on GitHub.
User Input
$ARGUMENTS
You MUST parse the user input to extract the feature slug (the folder name in rpi/).
Purpose
This command creates comprehensive planning documentation for a feature request. It generates detailed specifications, technical design, and implementation plans in the feature's RPI folder.
Prerequisites:
- Feature folder exists at
rpi/{feature-slug}/ - Research completed with GO recommendation (
rpi/{feature-slug}/research/RESEARCH.mdexists)
Output Location: All files saved to rpi/{feature-slug}/plan/
This is Step 3 of the RPI Workflow (after Research approves with GO).
Outline
- Load Context: Read research report and project constitution (if exists)
- Understand Requirements: Parse feature scope and requirements
- Analyze Technical Requirements: Review architecture and dependencies
- Design Architecture: Create high-level architecture and API contracts
- Break Down Implementation: Create phased task breakdown
- Generate Documentation: Create structured documentation files
- Validate Output: Ensure all quality gates pass
- Report Completion: Provide summary and next steps
Phases
Phase 0: Load Context
Prerequisites: Feature slug provided
Process:
-
Verify research completed:
- Check
rpi/{feature-slug}/research/RESEARCH.mdexists - Verify GO recommendation (warn if NO-GO or CONDITIONAL)
- Check
-
Read research findings:
- Extract product analysis
- Extract technical discovery
- Extract technical feasibility assessment
- Note risks and constraints
-
Load project constitution (if exists):
- Look for a constitution or principles document in the repository
- Extract relevant constraints and preferences
Outputs:
- Research summary
- Constitutional context (if found)
- Planning constraints
Validation:
- Research report exists
- GO recommendation confirmed
- Constitution loaded (if exists)
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 6d ago First seen · 417 lines · 7 tokens per session scan A 1417e095d66c
plan is a command published in the GitHub repository shanraisshan/claude-code-best-practice (65,618 stars, last pushed today), licensed MIT. It adds 7 tokens to every session and 2,712 once invoked, about $0.0000 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other commands, from other repositories
README
Git workflow and quality assurance commands for the claude-skills repository.
plan-feature
Plan a feature from BRD-lite brief or clear intent into PRD (What), decisions, implementation plan, and task slices.
version
Display current guide and Claude Code versions.
security
This command was migrated to a skill in Claude Code 2.1.3. See: examples/skills/security/SKILL.md.
ccboard-web
Launch ccboard web interface.
ox-session-pause
belongs in the ox CLI JSON output (guidance field), not here. Skills are agent-specific wrappers; ox serves all agents (Codex, etc.). --> Suspend the current session recording. Local cache continues to receive entries, but the upload at stop time will exclude the suspended range.