feat: initial Claude Code configuration scaffold
Comprehensive Claude Code guidance system with: - 5 agents: tdd-guardian, code-reviewer, security-scanner, refactor-scan, dependency-audit - 18 skills covering languages (Python, TypeScript, Rust, Go, Java, C#), infrastructure (AWS, Azure, GCP, Terraform, Ansible, Docker/K8s, Database, CI/CD), testing (TDD, UI, Browser), and patterns (Monorepo, API Design, Observability) - 3 hooks: secret detection, auto-formatting, TDD git pre-commit - Strict TDD enforcement with 80%+ coverage requirements - Multi-model strategy: Opus for planning, Sonnet for execution (opusplan) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
72
README.md
Normal file
72
README.md
Normal file
@@ -0,0 +1,72 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user