kayaman/effective-engineer-setup
A reusable, opinionated Claude Code template that operationalizes the principles from The Effective Software Engineer (Addy Osmani, O'Reilly, 2026) as skills, subagents, and hooks.
stack: Shell
ARCHETYPE
Fort Knox
Deny lists, pre-tool hooks, sandboxing. Nothing touches prod without a signature.
GUARDRAILS
5/5
Blocks destructive commands · Protects secrets · Pre-tool screening hook · No YOLO mode · Sandbox or ask-first rules · details
Quality 48/100 Guardrails v2
Copy this rig
# review before running: this installs third-party code
$ npx degit kayaman/effective-engineer-setup/.claude ./rig-effective-engineer-setup # 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.
$ npx degit kayaman/effective-engineer-setup/.claude/skills/adr .claude/skills/adr $ npx degit kayaman/effective-engineer-setup/.claude/skills/anti-patterns .claude/skills/anti-patterns $ npx degit kayaman/effective-engineer-setup/.claude/skills/brag .claude/skills/brag $ npx degit kayaman/effective-engineer-setup/.claude/skills/commit .claude/skills/commit $ npx degit kayaman/effective-engineer-setup/.claude/skills/debt .claude/skills/debt $ npx degit kayaman/effective-engineer-setup/.claude/skills/debug .claude/skills/debug $ npx degit kayaman/effective-engineer-setup/.claude/skills/outcomes-first .claude/skills/outcomes-first $ npx degit kayaman/effective-engineer-setup/.claude/skills/post-ship .claude/skills/post-ship $ npx degit kayaman/effective-engineer-setup/.claude/skills/prioritize .claude/skills/prioritize $ npx degit kayaman/effective-engineer-setup/.claude/skills/retro .claude/skills/retro $ npx degit kayaman/effective-engineer-setup/.claude/skills/review .claude/skills/review $ npx degit kayaman/effective-engineer-setup/.claude/skills/scope-guard .claude/skills/scope-guard $ npx degit kayaman/effective-engineer-setup/.claude/skills/tdd .claude/skills/tdd
$ curl -fsSL --create-dirs -o .claude/agents/anti-pattern-scanner.md https://raw.githubusercontent.com/kayaman/effective-engineer-setup/main/.claude/agents/anti-pattern-scanner.md $ curl -fsSL --create-dirs -o .claude/agents/reviewer.md https://raw.githubusercontent.com/kayaman/effective-engineer-setup/main/.claude/agents/reviewer.md
Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.
{
"permissions": {
"deny": [
"Bash(git push --force*)",
"Bash(git push -f*)",
"Bash(rm -rf /*)",
"Bash(rm -rf ~*)",
"Bash(sudo *)",
"Bash(chmod 777 *)",
"Read(.env*)",
"Read(**/*.pem)",
"Read(**/*.key)",
"Read(**/secrets/**)",
"Read(**/credentials/**)",
"Edit(.env*)",
"Edit(**/*.pem)",
"Edit(**/*.key)",
"Edit(**/secrets/**)",
"Write(.env*)",
"Write(**/*.pem)",
"Write(**/*.key)",
"Write(**/secrets/**)"
],
"ask": [
"Bash(git commit:*)",
"Bash(git push:*)",
"Bash(git merge:*)",
"Bash(git rebase:*)",
"Bash(npm publish:*)",
"Bash(pnpm publish:*)",
"Bash(yarn publish:*)",
"Bash(pip publish:*)",
"Bash(uv publish:*)"
]
},
"hooks": {
"PreToolUse": [
{
"matcher": "Edit|Write|MultiEdit",
"hooks": [
{
"type": "command",
"command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/protect-files.sh"
},
{
"type": "command",
"command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/secrets-guard.sh"
},
{
"type": "command",
"command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/licensing-check.sh"
}
]
}
]
}
} Skills (13)
Subagents (2)
| anti-pattern-scanner | Isolated subagent that scans a codebase for the 20 anti-patterns from Osmani's "The Effective Software Engineer" (Ch. 5 & 10). Read-only. Produces evidence-backed findings. |
| reviewer | Isolated reviewer subagent for the /review skill. Has read-only access to the repo and git. Does not modify files. Always returns a structured review report. |
Hooks (6)
| event | matcher | runs |
|---|---|---|
| SessionStart | * | "$CLAUDE_PROJECT_DIR"/.claude/hooks/inject-context.sh |
| PreToolUse | Edit|Write|MultiEdit | "$CLAUDE_PROJECT_DIR"/.claude/hooks/protect-files.sh |
| PreToolUse | Edit|Write|MultiEdit | "$CLAUDE_PROJECT_DIR"/.claude/hooks/secrets-guard.sh |
| PreToolUse | Edit|Write|MultiEdit | "$CLAUDE_PROJECT_DIR"/.claude/hooks/licensing-check.sh |
| PostToolUse | Edit|Write|MultiEdit | "$CLAUDE_PROJECT_DIR"/.claude/hooks/format-after-edit.sh |
| Stop | * | "$CLAUDE_PROJECT_DIR"/.claude/hooks/brag-log.sh |
Permissions
deny (19)
Bash(git push --force*)
Bash(git push -f*)
Bash(rm -rf /*)
Bash(rm -rf ~*)
Bash(sudo *)
Bash(chmod 777 *)
Read(.env*)
Read(**/*.pem)
Read(**/*.key)
Read(**/secrets/**)
Read(**/credentials/**)
Edit(.env*)
Edit(**/*.pem)
Edit(**/*.key)
Edit(**/secrets/**)
Write(.env*)
Write(**/*.pem)
Write(**/*.key)
Write(**/secrets/**)
ask (9)
Bash(git commit:*)
Bash(git push:*)
Bash(git merge:*)
Bash(git rebase:*)
Bash(npm publish:*)
Bash(pnpm publish:*)
Bash(yarn publish:*)
Bash(pip publish:*)
Bash(uv publish:*)
allow (13)
Bash(git status:*)
Bash(git diff:*)
Bash(git log:*)
Bash(git branch:*)
Bash(git show:*)
Bash(git add:*)
Bash(git restore:*)
Bash(ls:*)
Bash(cat:*)
Bash(rg:*)
Bash(find:*)
Bash(pwd)
Bash(echo:*)
Similar rigs
theNickNance/claude-code-setup
—
Pragmatist 3.5k tok · · Q3
Pharaoh-so/pharaoh-mcp
Agents ship invisible bugs. Plan, review and refactor with Pharaoh's map of your GitHub repos, so Claude sees what a change could break before it ships.
Pragmatist 3.1k tok · · Q0
promprit/dryas-workflow
Rules your AI agents can't ignore. Design-first, scope-locked, test-proven delivery for Claude Code and Codex, enforced by hooks.
Skill Collector 3.6k tok · · Q0
bkrishnamachari/claude-elements
Claude Code configuration: CLAUDE.md guidelines, skills, hooks, and settings
Minimalist 967 tok · · Q3