agentrigs
+ submit rig
~ / rigs / shanraisshan / claude-code-best-practice

shanraisshan/claude-code-best-practice

from vibe coding to agentic engineering - practice makes claude perfect

↗ GitHub ★ 67.0k mit updated 7d ago project Claude CodeCodex
share on X
ARCHETYPE
YOLO Cowboy
Permissions? Never heard of 'em. Ships at the speed of `--dangerously-skip-permissions`.
CONTEXT TAX · EVERY TURN
~12.9k tokens
Heavy · median rig: 2.3k · breakdown
GUARDRAILS
3/5
Blocks destructive commands · Pre-tool screening hook · Sandbox or ask-first rules · details

Copy this rig

# review before running: this installs third-party code
$ claude mcp add playwright -- npx -y @playwright/mcp@0.0.70
$ claude mcp add context7 -- npx -y @upstash/context7-mcp@2.1.8
$ claude mcp add deepwiki -- npx -y deepwiki-mcp@0.0.6
$ npx degit shanraisshan/claude-code-best-practice/.claude ./rig-claude-code-best-practice  # inspect, then merge into .claude/

MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.

$ claude mcp add playwright -- npx -y @playwright/mcp@0.0.70
$ claude mcp add context7 -- npx -y @upstash/context7-mcp@2.1.8
$ claude mcp add deepwiki -- npx -y deepwiki-mcp@0.0.6
$ npx degit shanraisshan/claude-code-best-practice/.claude/skills/agent-browser .claude/skills/agent-browser
$ npx degit shanraisshan/claude-code-best-practice/.claude/skills/time-skill .claude/skills/time-skill
$ npx degit shanraisshan/claude-code-best-practice/.claude/skills/weather-fetcher .claude/skills/weather-fetcher
$ npx degit shanraisshan/claude-code-best-practice/.claude/skills/weather-svg-creator .claude/skills/weather-svg-creator
$ npx degit shanraisshan/claude-code-best-practice/agent-teams/.claude/skills/time-fetcher .claude/skills/time-fetcher
$ npx degit shanraisshan/claude-code-best-practice/agent-teams/.claude/skills/time-svg-creator .claude/skills/time-svg-creator
$ curl -fsSL --create-dirs -o .claude/agents/development-workflows-research-agent.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/.claude/agents/development-workflows-research-agent.md
$ curl -fsSL --create-dirs -o .claude/agents/presentation-claude-code.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/.claude/agents/presentation-claude-code.md
$ curl -fsSL --create-dirs -o .claude/agents/presentation-claude-gemini.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/.claude/agents/presentation-claude-gemini.md
$ curl -fsSL --create-dirs -o .claude/agents/presentation-vibe-coding.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/.claude/agents/presentation-vibe-coding.md
$ curl -fsSL --create-dirs -o .claude/agents/time-agent.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/.claude/agents/time-agent.md
$ curl -fsSL --create-dirs -o .claude/agents/weather-agent.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/.claude/agents/weather-agent.md
$ curl -fsSL --create-dirs -o .claude/agents/workflow-claude-commands-agent.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/.claude/agents/workflows/best-practice/workflow-claude-commands-agent.md
$ curl -fsSL --create-dirs -o .claude/agents/workflow-claude-settings-agent.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/.claude/agents/workflows/best-practice/workflow-claude-settings-agent.md
$ curl -fsSL --create-dirs -o .claude/agents/workflow-claude-skills-agent.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/.claude/agents/workflows/best-practice/workflow-claude-skills-agent.md
$ curl -fsSL --create-dirs -o .claude/agents/workflow-claude-subagents-agent.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/.claude/agents/workflows/best-practice/workflow-claude-subagents-agent.md
$ curl -fsSL --create-dirs -o .claude/agents/workflow-concepts-agent.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/.claude/agents/workflows/best-practice/workflow-concepts-agent.md
$ curl -fsSL --create-dirs -o .claude/agents/time-agent.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/agent-teams/.claude/agents/time-agent.md
$ curl -fsSL --create-dirs -o .claude/agents/code-reviewer.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/development-workflows/rpi/.claude/agents/code-reviewer.md
$ curl -fsSL --create-dirs -o .claude/agents/constitutional-validator.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/development-workflows/rpi/.claude/agents/constitutional-validator.md
$ curl -fsSL --create-dirs -o .claude/agents/documentation-analyst-writer.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/development-workflows/rpi/.claude/agents/documentation-analyst-writer.md
$ curl -fsSL --create-dirs -o .claude/agents/product-manager.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/development-workflows/rpi/.claude/agents/product-manager.md
$ curl -fsSL --create-dirs -o .claude/agents/requirement-parser.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/development-workflows/rpi/.claude/agents/requirement-parser.md
$ curl -fsSL --create-dirs -o .claude/agents/senior-software-engineer.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/development-workflows/rpi/.claude/agents/senior-software-engineer.md
$ curl -fsSL --create-dirs -o .claude/agents/technical-cto-advisor.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/development-workflows/rpi/.claude/agents/technical-cto-advisor.md
$ curl -fsSL --create-dirs -o .claude/agents/ux-designer.md https://raw.githubusercontent.com/shanraisshan/claude-code-best-practice/main/development-workflows/rpi/.claude/agents/ux-designer.md

Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.

{
  "permissions": {
    "ask": [
      "Bash(rm *)",
      "Bash(rmdir *)",
      "Bash(shred *)",
      "Bash(unlink *)",
      "Bash(dd *)",
      "Bash(mkfs *)",
      "Bash(fdisk *)",
      "Bash(chmod *)",
      "Bash(chown *)",
      "Bash(npm *)",
      "Bash(pip *)",
      "Bash(pip3 *)",
      "Bash(yarn *)",
      "Bash(pnpm *)",
      "Bash(docker *)",
      "Bash(kubectl *)",
      "Bash(firebase *)",
      "Bash(gcloud *)",
      "Bash(wget *)",
      "Bash(kill *)",
      "Bash(killall *)",
      "Bash(pkill *)"
    ]
  },
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py"
          }
        ]
      }
    ]
  }
}

MCP servers (3)

serversourceest. tokens
Playwright MCP · "playwright" npm 7.5k
Context7 npm 1.2k
DeepWiki npm 900

Skills (6)

agent-browsertime-skillweather-fetcherweather-svg-creatortime-fetchertime-svg-creator

Subagents (20)

development-workflows-research-agent
model: sonnet
Research agent that fetches GitHub repos, counts agents/skills/commands, gets star counts, and analyzes Claude Code workflow repositories
presentation-claude-code
model: sonnet
PROACTIVELY use this agent whenever the user wants to update, modify, rearrange, or fix the CLAUDE-CODE-BEST-PRACTICE presentation (`presentation/claude-code-best-practice/index.html`) — slides, struc
presentation-claude-gemini
model: sonnet
PROACTIVELY use this agent whenever the user wants to update, modify, rearrange, or fix the CLAUDE-GEMINI presentation (`presentation/2026-04-25-gdg-kolachi-cli-claude-code-gemini/index.html`) — slide
presentation-vibe-coding
model: sonnet
PROACTIVELY use this agent whenever the user wants to update, modify, or fix the VIBE-CODING presentation (`presentation/vibe-coding-to-agentic-engineering/index.html`) — slides, structure, styling, o
time-agent-pkt
model: haiku
Use this agent to display the current time in Pakistan Standard Time (PKT, UTC+5). (root scope — see agent-teams for Dubai time)
weather-agent
model: sonnet
Use this agent PROACTIVELY when you need to fetch weather data for Dubai, UAE. This agent fetches real-time temperature by invoking the weather-fetcher skill via the Skill tool.
workflow-claude-commands-agent
model: opus
Research agent that fetches Claude Code docs, reads the local commands report, and analyzes drift
workflow-claude-settings-agent
model: opus
Research agent that fetches Claude Code docs, reads the local settings report, and analyzes drift
workflow-claude-skills-agent
model: opus
Research agent that fetches Claude Code docs, reads the local skills report, and analyzes drift
workflow-claude-subagents-agent
model: opus
Research agent that fetches Claude Code docs, reads the local subagents report, and analyzes drift
workflow-concepts-agent
model: opus
Research agent that fetches Claude Code docs and changelog, reads the local README CONCEPTS section, and analyzes drift
time-agent
model: haiku
Use this agent to fetch the current time for Dubai, UAE (Asia/Dubai timezone, UTC+4). This agent fetches real-time Dubai time using its preloaded time-fetcher skill.
code-reviewer
model: opus
Meticulous, constructive reviewer for correctness, clarity, security, and maintainability.
constitutional-validator
model: opus
Validates roadmap items, features, and technical decisions against the project's constitution, principles, and core values. Ensures all proposals align with the mission, established methodology, and d
documentation-analyst-writer
model: opus
Use this agent when you need to analyze existing documentation and create new or updated documentation that strictly adheres to project-specific documentation standards defined in claude.md. This agen
product-manager
model: opus
Turns a high-level ask into a crisp, exec-ready PRD with acceptance criteria and scope.
requirement-parser
model: sonnet
Analyzes feature request descriptions and extracts structured requirements, goals, constraints, and metadata for downstream planning agents.
senior-software-engineer
model: opus
Pragmatic IC who plans sanely, ships small reversible slices with tests, and writes clear PRs.
technical-cto-advisor
model: opus
Use this agent to align technological decisions with engineering principles and organizational standards. This agent acts as a CTO, evaluating technical recommendations against established engineering
ux-designer
model: opus
Produces a concise, accessible UX brief with flows, states, and annotations.

Hooks (30)

eventmatcherruns
PreToolUse*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
PermissionRequest*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
PostToolUse*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
PostToolUseFailure*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
PostToolBatch*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
UserPromptSubmit*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
UserPromptExpansion*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
Notification*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
MessageDisplay*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
Stop*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
SubagentStart*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
SubagentStop*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
PreCompact*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
PostCompact*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
SessionStart*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
SessionEnd*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
Setup*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
TeammateIdle*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
TaskCreated*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
TaskCompleted*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
ConfigChange*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
WorktreeCreate*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
WorktreeRemove*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
InstructionsLoaded*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
Elicitation*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
ElicitationResult*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
StopFailure*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
CwdChanged*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
FileChanged.envrc|.env|.env.localpython3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py
PermissionDenied*python3 ${CLAUDE_PROJECT_DIR}/.claude/hooks/scripts/hooks.py

Slash commands (14)

/time-command/weather-orchestrator/workflows/agent-collections/workflows/best-practice/workflow-claude-commands/workflows/best-practice/workflow-claude-settings/workflows/best-practice/workflow-claude-skills/workflows/best-practice/workflow-claude-subagents/workflows/best-practice/workflow-concepts/workflows/development-workflows/workflows/skill-collections/time-orchestrator/rpi/implement/rpi/plan/rpi/research

Permissions

deny (0)
—
ask (22)
Bash(rm *)
Bash(rmdir *)
Bash(shred *)
Bash(unlink *)
Bash(dd *)
Bash(mkfs *)
Bash(fdisk *)
Bash(chmod *)
Bash(chown *)
Bash(npm *)
Bash(pip *)
Bash(pip3 *)
Bash(yarn *)
Bash(pnpm *)
Bash(docker *)
Bash(kubectl *)
Bash(firebase *)
Bash(gcloud *)
Bash(wget *)
Bash(kill *)
Bash(killall *)
Bash(pkill *)
allow (24)
Edit(*)
Write(*)
NotebookEdit(*)
Bash(*)
WebFetch(domain:*)
WebSearch
mcp__ide__*
mcp__chrome-devtools__*
mcp__claude-in-chrome__*
mcp__playwright__*
mcp__reddit-mcp-server__search_reddit
mcp__reddit-mcp-server__get_post_details
mcp__tavily-web-search__tavily_search
mcp__tavily-web-search__tavily_extract
WebFetch(domain:api.open-meteo.com)
WebFetch(domain:raw.githubusercontent.com)
WebFetch(domain:docs.anthropic.com)
WebFetch(domain:support.claude.com)
WebFetch(domain:github.com)
WebFetch(domain:api.github.com)
WebFetch(domain:json.schemastore.org)
WebFetch(domain:claudelog.com)
WebFetch(domain:www.eesel.ai)
WebFetch(domain:shipyard.build)

Similar rigs

clxzl/claude-code-best-practice-cn
Claude Code 最佳实践中文版
★ 132 project Claude CodeCodex 3 mcp 6 skills 21 agents 22 hooks 5mo ago
YOLO Cowboy 11.5k tok ·
hmzainjamil/claude-code-best-practice
Claude Code best practices — production patterns, CLAUDE.md templates, skill architecture, multi-agent workflows
★ 0 project Claude CodeCodex 3 mcp 6 skills 19 agents 22 hooks 7d ago
YOLO Cowboy 12.5k tok ·
Muzharov-D/claude-dotfiles
—
★ 0 setup Claude Code 9 skills 20 agents 4mo ago
Orchestrator 1.5k tok ·
HIDORAKAI002/ai-workspace-archive
A massive, self-updating local archive of AI tools — 11,000+ agent skills, 240+ MCP servers, 2,200+ IDE rules (Cursor/Cline), and 30+ system prompt collections. One repo to rule them all.
★ 37 project Claude CodeCodexCursor 13 mcp 105 skills 29 agents 13d ago
MCP Hoarder 63.2k tok ·
copied ✓