Sandbox
@shanraisshan/claude-code-best-practice

Claude Code workflow files for agents, commands, and skills

This repo packages best-practice guidance and working examples for building with Claude Code. The core pattern is command → agent → skill, supported by hooks, memory, settings, and MCP connections. It also documents implementation details, so you can copy the pieces you want into your own setup instead of starting from scratch.

65,828 stars6.5k forksHTMLUpdated 7d ago
Ralph Wiggum Tutorial: How to Run It Safely and Efficiently
JeredBlu16k views • 8 months ago

Videos about this repo

Who it's for

Builders who use Claude Code and want repeatable project rules, subagents, skills, and workflows.

What it delivers

You can make agent-led work more consistent, reviewable, and easier to resume across sessions.

What it does

Command, agent, skill pattern

Shows a reusable orchestration flow where a command triggers an agent, which then uses a skill.

Subagent implementations

Includes `.claude/agents/` examples and documentation for Claude Code subagents.

Commands library

Includes `.claude/commands/` and a sample `/weather-orchestrator` workflow command.

Skills pack

Includes `.claude/skills/<name>/SKILL.md` examples and best-practice notes.

Hooks and settings

Includes `.claude/hooks/` and `.claude/settings.json` for behavior around agent actions and runtime settings.

Memory and rules

Uses `CLAUDE.md` and `.claude/rules/` to hold project memory and reusable instructions.

MCP and multi-model support

Includes `.mcp.json` and `.codex/` files, and the repo content references Claude, Codex, and Gemini workflows.

How to get it

  1. 1Run
    claude
    /weather-orchestrator

README

claude-code-best-practice

from vibe coding to agentic engineering - practice makes claude perfect

updated with Claude Code GitHub Stars

Best Practice Implemented Orchestration Workflow Claude Boris Community Click on these badges below to see the actual sources
= Agents · = Commands · = Skills

Claude Code mascot jumping
GitHub Trending #1 Repository Of The Day

Supported by:  Disrupt.com — Ventures Reimagined  ClaudeKit — Production-ready skills and workflows

Boris Cherny on Claude Code
Boris Cherny on X (tweet 1 · tweet 2 · tweet 3)

[!TIP] Visit the How to Use section to take full advantage of this repo.

🧠 CONCEPTS

FeatureLocationDescription
Subagents.claude/agents/<name>.mdBest Practice Implemented
Commands.claude/commands/<name>.mdBest Practice Implemented
Skills.claude/skills/<name>/SKILL.mdBest Practice Implemented Official Skills · Skills for Mono-repos
Workflows.claude/commands/weather-orchestrator.mdOrchestration Workflow
Hooks.claude/hooks/Best Practice Implemented Guide
MCP Servers.claude/settings.json, .mcp.jsonBest Practice Implemented
Pluginsdistributable packagesMarketplaces · Create Marketplaces
Settings.claude/settings.jsonBest Practice Implemented Permissions · Model Config · Output Styles · Sandboxing · Keybindings · Auto Mode Config
Status Line.claude/settings.jsonBest Practice Implemented
MemoryCLAUDE.md, .claude/rules/, ~/.claude/rules/, ~/.claude/projects/<project>/memory/Best Practice Implemented Auto Memory · Auto Memory Deep-dive · Rules
Checkpointingautomatic (file-edit tracking)
Sessions--resume, --continue, /resume, /branch
Context Window/compact, /clear, /context
CLI Startup Flagsclaude [flags]Best Practice Interactive Mode · Env Vars
AI TermsBest Practice
Best PracticesPrompt Engineering · Extend Claude Code
Prompt Library

🔥 Hot

FeatureLocationDescription
Ultrareview beta/code-review ultra, claude ultrareview [target]Tasks tracking
Devcontainers.devcontainer/
Channels beta--channels, plugin-basedReference
No Flicker Mode beta/tui fullscreen, CLAUDE_CODE_NO_FLICKER=1Best Practice
Auto Mode--permission-mode auto, Shift+TabBest Practice Blog
Power-ups/powerupBest Practice
Fast Mode beta/fast, "fastMode": true
Advisor beta/advisor, advisorModel, --advisorBlog
Computer Use betacomputer-use MCP serverDesktop
Agent SDKnpm / pip packageQuickstart · Examples
Ralph Wiggum LooppluginBest Practice Implemented
Chrome--chrome, extensionBest Practice
Claude Code Web betaclaude.ai/codeRoutines
Artifacts/share, Artifact tool
Slack@Claude in Slack
Code Review betaGitHub App (managed)Best Practice Blog Local /code-review
GitHub Actions.github/workflows/GitLab CI/CD
Remote Control/remote-control, /rcBest Practice Headless Mode
Deep Linksclaude-cli://open?repo=…&q=…
Dynamic Workflows/workflows, ultracode keyword, /effort ultracode, .claude/workflows/Deep Research
Agent Teams betabuilt-in (env var)Best Practice Implemented
Agent View betaclaude agents, --bg, /bg
Cross-Session MessagingSendMessage, ListAgents, /list-agents
Scheduled Tasks/loop, /schedule, cron toolsBest Practice Implemented Desktop scheduled tasks · Announcement
Routines betaclaude.ai/code/routines, /scheduleDesktop Tasks
Tasks/tasks, ~/.claude/tasks/Best Practice Ultrareview tracking
Goal/goal <condition>, /goal clearImplemented
Voice Dictation/voiceBest Practice
Bundled Skills/code-review, /batchBest Practice
Git Worktrees--worktree/-w, .worktreeinclude, EnterWorktree/ExitWorktree, isolation: "worktree", WorktreeCreate/WorktreeRemove hooksBest Practice

section divider

Orchestration Workflow

See orchestration-workflow for implementation details of Command Agent Skill pattern.

Command Skill Agent Architecture Flow

Orchestration Workflow Demo

How to Use

claude
/weather-orchestrator

section divider

⚙️ DEVELOPMENT WORKFLOWS

All major workflows converge on the same architectural pattern: Research → Plan → Execute → Review → Ship

NameWorkflow
Superpowers284kbrainstormingusing-git-worktreeswriting-planssubagent-driven-developmenttest-driven-developmentexecuting-plansverification-before-completionrequesting-code-reviewreceiving-code-reviewfinishing-a-development-branch0014
Matt Pocock Skills258kgrill-with-docsto-specto-ticketsimplementtddcode-reviewimprove-codebase-architecture0037
Everything Claude Code255kecc:plantdd-workflowimplementcode-reviewbuild-fixsecurity-scane2e-testingtest-coveragesave-session6894286
Spec Kit134k/speckit.constitution/speckit.specify/speckit.plan/speckit.tasks/speckit.implement/speckit.converge0100
gstack132k/office-hours/plan-ceo-review/plan-eng-review/plan-design-review/design-shotgun/design-html/review/qa/ship/retro0058
agent-skills89k/spec/plan/build/test/review/ship3721
OpenSpec67.8k/opsx:explore/opsx:propose/opsx:apply/opsx:archive01212
Get Shit Done64.6k/gsd-new-project/gsd-explore/gsd-spec-phase/gsd-plan-phase/gsd-execute-phase/gsd-review/gsd-validate-phase/gsd-ship33850
BMAD-METHOD52.8kbmad-helpbmad-prdbmad-architecturebmad-create-epics-and-storiesbmad-buildbmad-code-reviewbmad-qa-generate-e2e-testsbmad-retrospective5029
oh-my-claudecode39.1kdeep-interviewralplanteam-planteam-prdteam-execteam-verifyteam-fix19037
Compound Engineering25k/ce-brainstorm/ce-plan/ce-work/ce-simplify-code/ce-code-review/ce-compound0133
HumanLayer11.5k/research_codebase → <img src="h

Files in the repo

Repository payload20 top-level entries
  • !
  • .claude
  • .codex
  • .github
  • agent-teams
  • best-practice
  • changelog
  • development-workflows
  • implementation
  • orchestration-workflow
  • presentation
  • reports
  • tips
  • tutorial
  • videos
  • .gitignore
  • .mcp.json
  • CLAUDE.md
  • LICENSE
  • README.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More harnesses

affaan-m/
ECC
affaan-m/ECCHarnesses

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

258k
ruvnet/rufloHarnesses

🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

72k

Practical patterns, starters & CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.

11k
chaitanyagiri/
munder-difflin

A local multi-agent harness that works with your existing Claude Code, Codex subscriptions, allows you to run an office of agents

6.8k