Vibe Coding Templates

Comprehensive project templates optimized for AI agents to bootstrap professional projects with modern tooling, CI/CD, and best practices.

Create a python hello world app using Create a python hello world app use https://github.com/jelcke/vibe-coding-templates/blob/main/CLAUDE.md as a guide as a guide

🤖 AI Agent Optimized

This repository is designed for AI agents (Claude Code, GitHub Copilot, Cursor, etc.) to quickly bootstrap professional projects with:

• ✅ Modern package management
• ✅ Comprehensive testing setup
• ✅ CI/CD pipelines
• ✅ Code quality enforcement
• ✅ Best practices baked in

📁 Repository Structure

vibe-coding-templates/
├── CLAUDE.md              # Instructions for AI agents
├── python/                # Python project templates
│   ├── BOOTSTRAP.md       # Step-by-step bootstrap guide
│   ├── AI_AGENT_GUIDE.md  # Common scenarios & quick reference
│   ├── EXAMPLE_USAGE.md   # Complete example walkthrough
│   ├── docs/              # Comprehensive documentation
│   │   ├── PACKAGE_MANAGEMENT.md
│   │   ├── cicd/
│   │   │   ├── GITHUB_ACTIONS.md
│   │   │   └── PRE_COMMIT.md
│   │   └── testing/
│   │       └── TEST_COVERAGE.md
│   └── templates/         # Reusable templates
│       └── cicd/
│           ├── workflows/ # GitHub Actions
│           └── hooks/     # Pre-commit hooks
└── README.md              # This file

🚀 Quick Start

For AI Agents

When a user requests a new project:

1. Identify the language (currently Python supported)
2. Navigate to language folder (e.g., python/)
3. Follow BOOTSTRAP.md systematically
4. Use templates and docs as references
5. Verify everything works before completion

For Human Developers

Browse the language-specific folders for:

• Documentation in {language}/docs/
• Templates in {language}/templates/
• Bootstrap guides in {language}/BOOTSTRAP.md

📚 Available Templates

Python Projects

Complete Python project setup with:

• Package Management: uv (10-100x faster than pip)
• Testing: pytest with coverage
• CI/CD: GitHub Actions workflows
• Code Quality: ruff, mypy, pre-commit hooks
• Documentation: Comprehensive guides

📖 Python Resources:

• Bootstrap Guide
• AI Agent Guide
• Package Management
• GitHub Actions
• Pre-commit Hooks

Future Languages

The structure supports adding:

• javascript/ - Node.js/TypeScript projects
• rust/ - Rust projects
• go/ - Go projects
• java/ - Java projects

💡 Example Usage

User: "Create a Python project called data-processor"

AI Agent: I'll bootstrap your project using vibe-coding-templates:
1. Creating project structure...
2. Setting up package management with uv...
3. Configuring testing and CI/CD...
4. Initializing git repository...

✅ Project created successfully!

The AI agent follows python/BOOTSTRAP.md to create a complete project.

🎯 Key Features

For Python Projects

Feature	Tool/Framework	Documentation
Package Management	uv	docs
Testing	pytest	docs
Linting	ruff	templates
Type Checking	mypy	templates
CI/CD	GitHub Actions	docs
Pre-commit	pre-commit	docs

🤝 Contributing

To add templates for a new language:

1. Create a language folder (e.g., rust/)
2. Add BOOTSTRAP.md with step-by-step guide
3. Add docs/ with comprehensive documentation
4. Add templates/ with reusable components
5. Update this README

📖 Documentation Philosophy

• No duplication - Reference existing docs
• Language-specific - Each language has its own guides
• AI-optimized - Clear steps for agents to follow
• Template-based - Reusable components
• Verification-focused - Always test that it works

🔧 For AI Agent Developers

If you're building an AI agent that creates projects:

1. Point your agent to this repository
2. Have it read CLAUDE.md for instructions
3. Use language-specific BOOTSTRAP.md guides
4. Reference docs/ for detailed information
5. Apply templates from templates/ directories

📬 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions

📄 License

MIT License - Use these templates freely in your projects.

---

Made with ❤️ for AI-assisted development