J-BlandandClaude Sonnet 5.5
d45d4bec97
Adds a marked global rules block, project AGENTS.md/CLAUDE.md template, an on-demand lean-review skill, a dry-run-first stdlib installer with backups, and tests using temp homes. README quick start no longer moves ~/.claude; legacy library stays opt-in. Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
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 (lean default)
git clone https://git.kinec.tech/kinec.tech/ai-development-scaffold.git
cd ai-development-scaffold
python3 scripts/lean-install.py global # dry-run: shows planned changes
python3 scripts/lean-install.py global --apply # merge rules into ~/.claude/CLAUDE.md and $CODEX_HOME/AGENTS.md
python3 scripts/lean-install.py project /path/to/repo --apply # optional per-project AGENTS.md + CLAUDE.md
python3 -m unittest discover -s tests # verify the installer
Existing files are merged, not replaced (timestamped backup first); settings and credentials are never touched. Details, sources and rejected patterns: docs/lean-setup.md.
Optional: full library
The sections below describe the full agent/skill/hook library. Install pieces selectively (see docs/lean-setup.md); do not move or overwrite ~/.claude.
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