chore: Transform README to production-first pedagogical approach

[lkronecker13]

Summary

Complete transformation of project documentation to embody production-first AI engineering principles:

• README overhaul: Clear WHY → WHAT → HOW structure with article reference at top
• Production-first positioning: Template as engineering foundation, not ML tutorial
• Removed artificial complexity: Cleaned up floating code examples and fake file references
• Updated CLAUDE.md: Reflects new Makefile targets and production-first development workflow
• Consistent messaging: All documentation now aligns with the foundational methodology

Key Changes

README Transformation

• Opens with reference to foundational Production-First AI Engineering article
• Clear problem statement: Why most AI projects fail in production
• Positions template as reliable engineering foundation, not prescriptive implementation
• Removes confusing code samples that referenced non-existent files
• Focuses on template's actual value: modern Python tooling + production patterns

CLAUDE.md Updates

• Updated all Makefile targets (init, sync, clean-env, test-* pattern)
• Added production-first development workflow guidance
• Includes AI-specific engineering patterns and best practices
• Comprehensive testing and deployment strategies

Documentation Consistency

• pyproject.toml description updated to match production-first positioning
• All command examples use correct Makefile targets
• Project structure reflects actual files, not conceptual examples
• Consistent production-first messaging across all documentation

Test Plan

• All documentation examples use correct Makefile targets
• README flows logically from problem → solution → usage
• No references to non-existent files or artificial complexity
• Pre-commit hooks pass with new documentation
• CLAUDE.md accurately reflects development workflow

🤖 Generated with Claude Code