Files
ai-development-scaffold/README.md
T
J-BlandandClaude Sonnet 5.5 d45d4bec97 feat: lean default install for Claude Code and Codex with safe installer
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]>
2026-09-30 13:43:26 -04:00

2.6 KiB

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