feat: Add development tooling and comprehensive setup guide

[anchapin]

Overview

Adds comprehensive Makefile and setup documentation for resume-cli development and usage.

What's Added

Makefile - Simplified developer experience:

make install           # Install from source
make install-ai        # Install with AI support (Claude, OpenAI, Gemini)
make install-dev       # Install with development tools

make validate          # Validate resume.yaml schema
make generate          # Generate resume from template
make generate-package  # Generate resume + cover letter package
make ats-check         # Check ATS compatibility
make variants          # List available variants

make test              # Run test suite
make test-coverage     # Run tests with coverage report
make lint              # Check code style
make format            # Auto-format code

make clean             # Clean build artifacts
make check-deps        # Verify dependencies
make check-config      # Validate configuration files

SETUP.md - Complete development and usage guide:

• System requirements (Python, LaTeX, GitHub CLI)
• Quick start (4 steps to first resume)
• Detailed step-by-step installation
• Configuration walkthrough
• Verification procedures
• Development workflow examples
• Common commands with examples
• Comprehensive troubleshooting section
• Advanced usage (custom variants, batch generation)
• Architecture overview
• Integration patterns

Benefits

✅ Easy installation: make install instead of manual pip commands
✅ Clear documentation: New users have step-by-step guide
✅ Development tools: Quick access to testing and linting
✅ Examples: Common commands shown with sample usage
✅ Troubleshooting: Covers most common issues and solutions
✅ Advanced patterns: Batch generation, custom templates, CI/CD integration

Usage

First time setup:

make install
cp resume.example.yaml resume.yaml
nano resume.yaml          # Edit with your info
make validate             # Check for errors
make generate             # Generate resume

With AI support:

make install-ai           # Install AI dependencies
# Edit .env with API keys
make generate-package --job-desc job.txt

Development:

make install-dev          # Install dev tools
make test                 # Run tests
make lint                 # Check code style
make format               # Auto-format code

File Changes

• New: Makefile - 250+ lines of make targets
• New: SETUP.md - Comprehensive setup and usage guide

Backward Compatibility

✅ All existing commands still work
✅ Makefile targets are optional
✅ No breaking changes

Documentation Improvements

The SETUP.md includes:

• System requirements checklist
• Installation methods (base, AI, dev)
• Configuration guide
• Verification procedures
• Development workflow
• Common command examples
• Troubleshooting section (30+ scenarios)
• Advanced usage patterns
• Integration examples

Testing

• Makefile targets tested
• Help text displays correctly
• Installation commands verified
• Configuration validation works
• Dependency checking accurate

Closes #XXX (if applicable)

[sourcery-ai]

Sorry @anchapin, you have reached your weekly rate limit of 500000 diff characters.

Please try again later or upgrade to continue using Sourcery