best-practicelisted

# Claude Code Best Practice (reference) Curated collection of Claude Code best practices for production usage. Not an executable skill — a reference document that an agent reads before tackling a non-trivial workflow. ## When to invoke - **Onboarding** a teammate to Claude Code → point them to this reference. - **Designing a new agent workflow** → cross-check against the conventions in the upstream doc. - **Refreshing rituals** every 2 months — the ecosystem moves fast and good habits decay. ## Topics covered upstream - Prompt structure (objective → constraints → output format) - Task decomposition (when to split, when to keep one shot) - Context management (the 50% rule, `/clear`, `/compact`, `/rewind`) - Commit conventions (one task = one commit, message format) - Hooks (SessionStart, PreToolUse, PostToolUse, Stop) - Plugins, sub-agents, MCP ## Coexistence with ulk ulk already encodes most of these rules in: - `framework/agents/_shared/base-rules.md` — common rules - `framework/agents/_shared/context-hygiene-protocol.md` — the 5 mandatory rules - `.claude/rules/session-practices.md` — 50% rule, `/rewind`, `/clear`, sub-agents, `/compact` - `framework/agents/_shared/claude-code-mastery.md` — mastery tips The shanraisshan/claude-code-best-practice doc is **complementary**: it covers the broader Claude Code surface (hooks, plugins, MCP wiring) at a level appropriate for newcomers. ## Fetching the latest version ```bash curl.md https://raw.githubusercontent.com/shanr