~ / rigs / kayaman / effective-engineer-setup

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.

↗ GitHub ★ 3 no license updated 7mo ago personal setup Claude Code
stack: Shell
share on X
ARCHETYPE
Fort Knox
Deny lists, pre-tool hooks, sandboxing. Nothing touches prod without a signature.
CONTEXT TAX · EVERY TURN
~3.1k tokens
Moderate · median rig: 2.3k · breakdown
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-scannerIsolated 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.
reviewerIsolated 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)

eventmatcherruns
SessionStart*"$CLAUDE_PROJECT_DIR"/.claude/hooks/inject-context.sh
PreToolUseEdit|Write|MultiEdit"$CLAUDE_PROJECT_DIR"/.claude/hooks/protect-files.sh
PreToolUseEdit|Write|MultiEdit"$CLAUDE_PROJECT_DIR"/.claude/hooks/secrets-guard.sh
PreToolUseEdit|Write|MultiEdit"$CLAUDE_PROJECT_DIR"/.claude/hooks/licensing-check.sh
PostToolUseEdit|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

copied ✓