claude-code-setup
roadhero · roadhero/claude-code-setup
This repository shares a production-grade Claude Code setup, including a stack-agnostic engineering spine, auto-activating rule packs, and 42 scoped subagents.
My actual Claude Code setup: a stack-agnostic engineering spine, auto-activating rule packs, 50 scoped subagents across web/Android/iOS/compute, safety hooks, and a repo scaffolder. From the book "42: The AI Builder's Stack."
Preview
What you can do with it
- Set up a Claude Code environment with platform-specific rule packs for web, Android, or iOS development.
- Deploy a roster of specialized subagents for different coding tasks within your agent workflow.
- Integrate safety hooks into your agent's commit process to prevent bad code from being pushed.
Safety check
No risky patterns found in the files we scanned.
Automated scan of the repo files. Always review code you run.
From the README
Claude Code setup
This is the actual Claude Code configuration I run day to day at EltexSoft: a stack-agnostic engineering "spine," platform-specific rule packs that load per file via path globs, a roster of 42 subagents across four stacks, a commit-guard hook plus an auto-formatter, and a repo scaffolder. It's the same setup I describe in 42: The AI Builder's Stack. Take what's useful.
Most people publish a single CLAUDE.md and call it a setup. The thing that actually makes Claude Code reliable is structure: a global file that never changes, rules that load only when Claude reads a file matching their path globs, agents scoped to one job each, and hooks that stop bad commits before they happen. That's what's here.
What's inside
| Path | What it is |
|---|---|
CLAUDE.md | The universal spine — a lean (~220-line) always-loaded core: workflow, git rules, coding guidelines, secrets, anti-patterns. Stack-agnostic. Longer reference material lives in docs/ and loads on demand. |
rules/{web,android,ios,compute}.md | Platform rule packs. Each carries a paths: frontmatter glob; Claude Code loads a pack when it reads a file matching that glob (*.kt → android, *.swift → ios, *.ts/*.py → web, *.cpp/*.cu → compute). Path-triggered, so packs whose files you never touch stay out of context. |
agents/ (15 + explorer) | The default subagent roster: the four-hat chain (architect → senior-swe → code-reviewer → qa), plus specialists (security, performance, db-migration, debugger, devops, docs, design), release-engineer + tech-writer, and a delivery layer (TPM, scrum-master). Plus a read-only explorer search utility (cheap model) that the roster and main model delegate reads to — a tool, not counted in the 42-agent roster. |
agents-android/ (7), agents-ios/ (7), agents-compute/ (13) | Per-stack overrides. Drop them into a repo's .claude/agents/ and they override the generic ones of the same name with platform-brained versions. |
hooks/guard-commit.sh | A Claude Code Bash hook (PreToolUse) that blocks the agent from force-pushing, skipping git hooks with --no-verify, committing as a non-human, writing AI |