Claude Code team conventions and hooks
Running Claude Code with an engineering team works when the team shares conventions before everyone starts prompting differently. The operating model covers CLAUDE.md, MCP access, hooks, review evidence, split-team alignment, and governance. Teams then compare outcomes against a baseline instead of trading anecdotes about which prompt worked.
Why conventions beat one-off prompting
The biggest gap is not tool access. It is inconsistent usage across engineers. Shared conventions reduce variability, make review easier, and let teams compare outcomes instead of anecdotes.
What becomes standard
We teach teams to write CLAUDE.md, branch and PR etiquette, review thresholds, test expectations, Claude Code MCP permissions, secret-handling rules, and escalation points for risky architectural or security decisions.
How adoption compounds
A team convention becomes useful when it is short enough to follow, visible in the repository, and reinforced by examples from the team’s own codebase.
Have you tried these?
Run the change on one branch. The methodology puts that in Review: an engineer still owns the merge. Training is the team version of that step.
Official references
Current product documentation we use when shaping this training topic.
Selected research
Representative field notes connected to this topic.
Claude Code Hooks, PreToolUse, and MCP Permissions
May 25, 2026 · A plain guide to Claude Code hooks, PreToolUse, and MCP permissions, turned into team conventions a reviewer can check.
Claude Code MCP team conventions
May 24, 2026 · Practical Claude Code guidance for claude mcp, CLAUDE.md, hooks, and reviewable team conventions.
Claude Code 2.1.139 team conventions
May 17, 2026 · Claude Code 2.1.139 team conventions: a CLAUDE TOC, red-folder approvals, data-class tags on MCP connectors, and a weekly retro note.
Use Figma MCP in Claude Code
Oct 12, 2026 · Use Figma MCP with Claude Code as a scoped design handoff workflow, with a paste-ready slash command and review limits.
Claude Code Review Workflow
Oct 7, 2026 · Shows how to use Claude Code for PR review with read-only integrations, scoped prompts, and a pasteable review receipt.
Adopt Claude Code as a Team
Jun 30, 2026 · A practical Claude Code rollout plan for shared CLAUDE.md rules, MCP access, hooks, skills, and review habits.
Related training topics
Bring this into your team
We tailor the training to your codebase, adoption stage, and review standards.