Skip to content

Releases: roadhero/claude-code-setup

v1.0.1 — Hook fixes and doc corrections

Choose a tag to compare

@roadhero roadhero released this 29 Jun 04:23

v1.0.1

Fixes to the commit-guard hook and documentation corrections.

Fixed

  • guard-commit.sh: AI-attribution check no longer scans the staged diff,
    which falsely blocked commits touching files that mention "Claude Code."
    It now checks the commit message only.
  • guard-commit.sh: human-committer check is anchored to whole tokens, so
    it no longer rejects real names (Aisha, Mikhail, Talbot, etc.).
  • guard-commit.sh: force-push detection now matches --force anywhere in a
    git push command, not only directly after "push."
  • guard-commit.sh: missing jq now fails loud instead of silently no-opping.
  • format.sh: dropped ruff check --fix so the formatter no longer rewrites
    code mid-edit.

Docs

  • Corrected the agent split in STRUCTURE.md (13 duplicate globals, 8 compute-specific).
  • Added compute to the rules list in CLAUDE.md.
  • Clarified that the guard is a Claude Code Bash hook, not a git pre-commit hook.
  • Scoped the scaffolder description to the stacks it actually ships.
  • Book line corrected: sample chapters on the site, full book on Amazon.

v1.0.0: First public release

Choose a tag to compare

@roadhero roadhero released this 28 Jun 13:14

First public release of my actual Claude Code setup. The same configuration I run day to day, and the one described in the book 42: The AI Builder's Stack.

Most people publish a single CLAUDE.md and call it a setup. This is the whole system: a global engineering spine, rules that auto-activate per stack, a roster of scoped agents, and hooks that stop bad commits before they happen.

What's in here

  • The spineCLAUDE.md, a stack-agnostic engineering baseline. Workflow, git rules, coding guidelines, secrets handling, anti-patterns.
  • 50 scoped subagents across four stacks — 15 web/default, 7 Android, 7 iOS, 21 compute. Each loads only the context it needs, so they're faster and drift less than one mega-prompt.
  • Auto-activating rule packsrules/{web,android,ios,compute}.md, loaded automatically based on what's in your repo.
  • Two safety hooksguard-commit.sh blocks force-pushes, non-human committers, AI attribution, and staged secrets. format.sh auto-formats by extension across every stack.
  • A repo scaffolder — the new-repo skill spins up a new project with the right CLAUDE.md, quality gate, and release workflow.
  • Templates + a worked example — blank project templates plus one filled-in example so you can see what "done" looks like.

How to use it

Install steps are in STRUCTURE.md. Two tiers: a global config you set once, and a short per-project CLAUDE.md you fill in per repo. Strip what you don't need.

Honest caveats

Opinionated, built for how my team works. Git rules assume PR flow with protected branches. Hooks assume formatters are installed (they no-op cleanly if not). The compute stack is C++/CUDA/Python and is overkill if you only ship web apps.

Free, MIT licensed, no email gate. Take what's useful.

The book: 42: The AI Builder's Stack — sample chapters are at eltexsoft.com. The full book is on Amazon.