# 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

```bash
# 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](.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