james.bland
7ec467451b
Eleven agents lived only in `~/.claude/agents/`, which is not a git repository — they would have gone with the laptop. Eight of those were product-specific reviewers already defined in the projects that need them, and they are removed from the user level rather than duplicated here. Two were genuinely generic and already product-neutral (zero references to any product, customer or employer), so they belong in the shared scaffold: `mr-reviewer` reviews open MRs/PRs on a non-primary remote in a multi-remote repository, and `solution-reviewer` does a whole-codebase health review. `irs-validator` is deliberately NOT brought in. It is personal tooling rather than a development capability, and per the user CLAUDE.md personal tooling must not be referenced inside a project repository because those are mirrored to other remotes. The client manifest gains `fetch` and `websearch` capability mappings, which `solution-reviewer` needs. Worth noting how that surfaced: the sync REFUSED to render rather than dropping the two tools silently, which is the fail-safe behaviour the capability mapping exists to provide — an unmapped capability that rendered as absent would have quietly removed the agent's web access. `~/.claude/agents/README.md` now records that ten of the eleven agents there are installed output from this repository, how to regenerate and reinstall them, and which one is deliberately personal.
AI Development Scaffold
A comprehensive Claude Code configuration for professional software development with strict TDD enforcement, multi-language support, and cloud infrastructure patterns.
What's Included
- TDD Enforcement - Strict RED-GREEN-REFACTOR workflow with 80%+ coverage requirements
- Multi-Language Support - Python, TypeScript, Rust, Go, Java, C#
- Cloud Patterns - AWS, Azure, GCP infrastructure templates
- IaC - Terraform and Ansible best practices
- Testing - Unit, UI, and browser testing patterns (Playwright + Chrome MCP)
- Security - Automatic secret detection and blocking
- Model Strategy - Opus for planning, Sonnet for execution (
opusplan)
Quick Start
# 1. Clone this repo
git clone https://github.com/yourusername/ai-development-scaffold.git
# 2. Backup existing Claude config (if any)
mv ~/.claude ~/.claude.backup
# 3. Deploy
cp -r ai-development-scaffold/.claude/* ~/.claude/
chmod +x ~/.claude/hooks/*.sh
# 4. Verify
ls ~/.claude/
# Should show: CLAUDE.md, settings.json, agents/, skills/, hooks/
Documentation
See .claude/README.md for:
- Complete file structure
- Hook configuration (Claude hooks vs git hooks)
- Usage examples
- Customization options
- Troubleshooting
Agents Available
| Agent | Purpose |
|---|---|
@tdd-guardian |
TDD enforcement and guidance |
@code-reviewer |
Comprehensive PR review (uses Opus) |
@security-scanner |
Vulnerability and secrets detection |
@refactor-scan |
Refactoring assessment (TDD step 3) |
@dependency-audit |
Outdated/vulnerable package checks |
Skills Available
| Category | Skills |
|---|---|
| Languages | Python, TypeScript, Rust, Go, Java, C# |
| Infrastructure | AWS, Azure, GCP, Terraform, Ansible, Docker/K8s, Database, CI/CD |
| Testing | TDD, UI Testing, Browser Testing |
| Patterns | Monorepo, API Design, Observability |
Coverage Targets
| Layer | Target |
|---|---|
| Domain/Business Logic | 90%+ |
| API Routes | 80%+ |
| Infrastructure/DB | 70%+ |
| UI Components | 80%+ |
License
MIT