Claude Code Repository Template

Create unlimited projects from 10 battle-tested templates. Your template stays pristine; your projects get their own git history.

New to Claude Code? Read the Manifesto to understand why this changes everything.

---

Table of Contents

• Choose Your Path
• Quick Start
• Session Management System
• What's Included
• Template Testing Status
• Using with Claude Code
• Repository Structure
• Security Features
• Common Commands
• Benefits
• Getting Help
• Contributing
• License

---

👋 Choose Your Path

This template serves two audiences. Pick the guide that matches your experience:

🚀 Everyone: Quick Start

Perfect for: Anyone wanting to get started fast

Start here: Quick Start

This guide gets you building in 5-10 minutes:

• ✅ Simple numbered steps
• ✅ Clone, install, create first project
• ✅ Works on Windows, Mac, Linux
• ✅ True 5-10 minute execution time
• ⏱️ Time needed: 5-10 minutes

📚 Want More Detail?

Perfect for: Beginners, people new to coding, or those wanting comprehensive guidance

Start here: Complete Guide

This guide includes everything:

• ✅ Beginner-friendly explanations
• ✅ Developer quick-start commands
• ✅ Session management setup
• ✅ Troubleshooting guide
• ✅ Glossary of technical terms
• ⏱️ Choose your depth: 10 minutes to 1 hour

---

Quick Start

Note: This is a brief overview. For detailed step-by-step instructions, see the Quick Start Guide or Complete Guide.

For Everyone: 4-Step Setup

1. Clone the template repository:

   git clone https://github.com/prapanch/template-repo-claude-code.git
   cd template-repo-claude-code

2. Install the project-setup agent:

   macOS/Linux:

   mkdir -p ~/.claude/agents
   cp .claude-agents/project-setup.md ~/.claude/agents/

   Windows (PowerShell):

   New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\agents"
   Copy-Item .claude-agents\project-setup.md "$env:USERPROFILE\.claude\agents\"

3. Run the project-setup agent:

   claude

   The project-setup agent will automatically offer to help you:

   • Create a NEW project as a sibling directory
   • Select a template (React, Python, ComfyUI, etc.)
   • Customize project information (name, contact, copyright)
   • Initialize session management
   • Set up fresh git repository

   Or manually trigger: /project-setup

4. Start building:

   cd ../your-new-project
   npm install  # or pip install, etc.
   npm run dev  # start developing!

Result: Your new project is created as a sibling directory. The template repo stays pristine and reusable for creating more projects!

Directory structure after setup:

parent-folder/
├── template-repo-claude-code/  # Stays pristine, reusable
└── your-new-project/           # Your project, ready to build

Need more details?

• Quick Start Guide (5-10 min) - Simple numbered steps
• Complete Guide - Comprehensive documentation for all levels

---

Session Management System

The Problem

Claude Code has no memory between sessions. Every time you return to your project, you spend 10-15 minutes re-explaining what you were working on, decisions you made, and what's next.

The Solution

Session management agents give Claude Code persistent memory. Two simple commands handle everything:

• project open - Get a 10-second briefing from memory files
• project close - Save session progress automatically

The Memory Files

Session agents maintain 3 files in .claude/ (automatically created):

1. PRE_SESSION_LOG.md - Quick status: what you did last time, top 3-5 next steps, any blockers
2. POST_SESSION_LOG.md - Complete history: all sessions, accomplishments, decisions, git activity
3. PROJECT_MEMORY.md - Long-term knowledge: architectural decisions, patterns, lessons learned

Quick Setup (2 minutes)

# macOS/Linux
mkdir -p ~/.claude/agents
cp .claude-agents/*.md ~/.claude/agents/

# Windows (PowerShell)
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\agents"
Copy-Item .claude-agents\*.md "$env:USERPROFILE\.claude\agents\"

Daily Workflow

Morning:

You: project open
Claude: [Provides briefing in 10 seconds]
  Last session: Implemented user authentication
  Next: Email verification, password reset
  Decisions: Using JWT tokens, bcrypt for passwords

Evening:

You: project close
Claude: [Saves everything to memory files]
  ✓ What you accomplished
  ✓ Files modified and commits
  ✓ Next steps for tomorrow

Why This Matters

Without Sessions	With Sessions
Start fresh every time	10-second briefing
Re-explain everything	Full context instantly
Forget decisions	All decisions documented

Learn More

→ Complete Session Management Guide - Setup instructions, examples, troubleshooting

---

What's Included

• 10 Technology Templates - React, Python, ComfyUI, VertexAI, N8N, File Ops, Research, Solana Trading, Pump.fun, Generic
• Security-First Design - CI blocks credential commits, comprehensive .gitignore
• GitHub Actions - Automated security checks, PR labeling, documentation validation
• Claude Code Optimized - Structure and docs that Claude Code understands instantly

This repository keeps growing - more templates, more examples, more ways to build. See the Manifesto for the vision.

🔒 Security-First Design

• Automated credential detection - CI blocks .env files and API keys from being committed
• Multi-layer protection - Comprehensive .gitignore for 10+ technologies
• Best practices built-in - Environment variable patterns, secret management guidelines

📝 Claude Code-Optimized Documentation

• Structured READMEs - Every template has comprehensive setup instructions
• Clear patterns - Help Claude Code understand your codebase architecture
• Consistent formatting - Markdown linting ensures quality across all docs

🎨 10 Ready-to-Use Templates

Each template includes complete setup instructions, example code, and configuration files:

Template	Technology	Use Case
.template-react/	React 19 + Vite 7	Modern web applications
.template-python/	Python 3.10+	Scripts, APIs, data processing
.template-comfyui/	ComfyUI	AI image generation workflows
.template-vertexai/	Google VertexAI	Generative AI, ML pipelines
.template-n8n/	N8N Cloud	Workflow automation, integrations
.template-file-ops/	Claude Code	Everyday file & folder management
.template-research/	Claude Code	Research, analysis & decision support
.template-solana-trading/	Python + Solana	Trading bots, swaps, limit orders
.template-pumpfun/	Python + Solana	Token launches on pump.fun
.template-generic/	Generic	Any other technology

🤖 GitHub Actions Automation

• Security Checks (ci-basic.yml) - Prevents credential commits automatically
• PR Automation (pr-automation.yml) - Auto-labels by technology and size
• Documentation Quality (documentation-check.yml) - Validates markdown and links
• Community Friendly (welcome.yml) - Greets first-time contributors

---

Template Testing Status

All 10 templates are production-ready with comprehensive testing. See TESTING_RESULTS.md for detailed reports.

Template	Grade	Key Features
React	A+	React 19, Vite 7, modern hooks
Solana Trading	A+	Jupiter/Raydium, limit orders
Python	A	Virtual envs, testing, type hints
ComfyUI	A	Working workflow, 7 nodes
N8N Cloud	A	Automation workflows, Docker
VertexAI	A	Gemini 2.5, function calling
File Ops	A	158-line prompt library
Research	A	Multi-doc analysis workflows
Solana Pump.fun	A	Token launches, bonding curves
Generic	A	Flexible starter template

---

Using This Template with Claude Code

Quick Start with Claude Code

1. Open Claude Code in your repository:

   claude

2. Set the model (recommended):

   /model sonnet
   

   Sonnet 4 provides 200K context, ideal for monorepos.

3. Create your first project:

   Create a React app called "todo-app" using the React template
   

Daily Workflow

Claude Code understands the monorepo structure and will work within the correct project directories:

New features:

Add dark mode to the todo-app project

Debugging:

Fix the import errors in the Python script

Testing:

Write tests for the authentication module

Session Management

Track progress across work sessions with built-in agents. See the Session Management System section above for a complete explanation, or read the detailed Session Management Guide.

Repository Structure

your-repository/
├── .github/                      # GitHub configuration
│   ├── workflows/               # CI/CD automations
│   │   ├── ci-basic.yml        # Security checks
│   │   ├── pr-automation.yml   # PR auto-labeling
│   │   └── documentation-check.yml
│   └── ISSUE_TEMPLATE/         # Issue templates
│
├── .claude-agents/              # Session management agents
│   ├── project-setup.md         # Creates new projects
│   ├── project-open.md          # Session start agent
│   └── project-close.md         # Session end agent
│
├── .template-react/             # React + Vite template
│   ├── README.md               # Comprehensive setup guide
│   ├── package.json
│   ├── src/
│   └── .env.example
│
├── .template-python/            # Python template
│   ├── README.md               # Python best practices
│   ├── requirements.txt
│   ├── src/
│   └── tests/
│
├── .template-comfyui/          # ComfyUI template
│   ├── README.md               # Workflow setup guide
│   ├── custom_nodes.txt
│   └── models/
│
├── .template-vertexai/         # VertexAI template
│   ├── README.md               # GCP AI setup guide
│   ├── requirements.txt
│   └── workflows/
│
├── .template-n8n/              # N8N Cloud template
│   ├── README.md               # Workflow automation guide
│   ├── workflows/              # Workflow JSON files
│   └── credentials/            # Credential management docs
│
├── .template-file-ops/         # File operations template
│   ├── README.md               # File management guide
│   ├── workspace/              # Working area
│   └── scripts/                # Saved prompts
│
├── .template-research/         # Research & analysis template
│   ├── README.md               # Research workflow guide
│   ├── sources/                # Input documents
│   ├── analysis/               # Working notes
│   └── outputs/                # Summaries & recommendations
│
├── .template-solana-trading/   # Solana trading bot template
│   ├── README.md               # Trading bot setup guide
│   ├── requirements.txt
│   └── src/                    # Jupiter/Raydium integrations
│
├── .template-pumpfun/          # Pump.fun token launcher template
│   ├── README.md               # Token launch guide
│   ├── requirements.txt
│   ├── src/                    # PumpPortal API integration
│   └── assets/                 # Token images
│
├── .template-generic/          # Generic template
│   └── README.md               # Basic structure
│
├── docs/                        # Documentation
│   ├── COMPLETE_GUIDE.md           # All-in-one guide
│   ├── REFERENCE.md                # Technical reference
│   └── TESTING_GUIDE.md            # Testing instructions
│
├── scripts/                     # Automation scripts
│   ├── customize.sh            # Bash customization
│   └── customize.ps1           # PowerShell customization
│
├── examples/                    # Real-world example projects
│   ├── README.md               # Examples overview and roadmap
│   ├── react-dashboard/        # React dashboard example
│   ├── python-data-pipeline/   # Python CLI pipeline example
│   ├── solana-sniper-bot/      # Solana trading bot example
│   └── ...                     # More examples (see folder)
│
├── your-project-1/             # Your actual projects
├── your-project-2/             # (created from templates)
│
├── .gitignore                  # Multi-technology patterns
├── .gitattributes              # Line endings
├── LICENSE                     # MIT License
├── README.md                   # This file
├── QUICK_START.md              # 5-10 minute quick start
├── claude.md                   # Project knowledge for Claude Code
├── SESSION_MANAGEMENT.md       # Session agents guide
├── MANIFESTO.md                # Vision and philosophy
├── SECURITY.md                 # Security policy
├── TESTING_RESULTS.md          # Template testing reports
└── FINAL_TESTING_REPORT.md     # Comprehensive testing summary

Security Features

Built-in Protection

• ✅ CI blocks credential commits - .env files trigger build failures
• ✅ Credential file detection - Checks for *-key.json, *credentials*.json
• ✅ Comprehensive .gitignore - Prevents accidental commits
• ✅ Environment variable templates - All templates use .env.example pattern
• ✅ Security policy - Clear vulnerability reporting process

Why This Matters for Claude Code

When using AI assistants like Claude Code:

• 🔴 Risk: AI might accidentally include real API keys in generated code
• 🟢 Protection: This template's CI catches and prevents such commits
• 🟢 Best Practice: Templates enforce .env file patterns from day one
• 🟢 Education: Documentation teaches secure patterns

Benefits

• ⏱️ Save hours of setup with pre-configured templates
• 🤖 Maximize Claude Code effectiveness with optimized structure
• 🔒 Security by default with automated credential detection
• 🏗️ Consistent patterns across all projects
• 📚 Professional documentation from day one

Common Commands

Commands vary by project technology:

Node.js/React Projects

cd your-project/
npm install              # Install dependencies
npm start                # Start dev server
npm test                 # Run tests
npm run build            # Build for production

Python Projects

cd your-project/
python -m venv venv                      # Create virtual environment
source venv/bin/activate                 # Activate (Linux/macOS)
venv\Scripts\activate                    # Activate (Windows)
pip install -r requirements.txt          # Install dependencies
python src/main.py                       # Run the script

For advanced configuration (CI testing, auto-labeling), see Complete Guide

Getting Help

• 📖 Quick Start: QUICK_START.md
• 📚 Complete Guide: docs/COMPLETE_GUIDE.md
• 🔧 Technical Reference: docs/REFERENCE.md
• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 🤖 Claude Code Docs: claude.ai/code

Contributing

Contributions are welcome! Have improvements to the templates? Found a better pattern? Open a pull request!

Ways to contribute:

• Add new templates for different technologies
• Improve existing template documentation
• Fix bugs or enhance features
• Share your real-world examples
• Improve documentation clarity

License

This template is licensed under the MIT License - see LICENSE file for details.

When you use this template, you can choose any license for your own repository.

Acknowledgments

This template was created to optimize development workflows with Claude Code, incorporating:

• Security-first development patterns
• Multi-technology monorepo best practices
• Claude Code-friendly documentation structures
• Community-tested configurations

Built for rapid prototyping, maintained for production use.

---

Ready to start?

1. Clone the template repository
2. Install the project-setup agent
3. Run Claude Code: claude
4. Create your first project: /project-setup
5. Start building! 🚀

For detailed instructions, see QUICK_START.md (5-10 minutes) or docs/COMPLETE_GUIDE.md (comprehensive)

---

Created By

Prapanch - Building the future with AI, one template at a time.

• X/Twitter: @prapanch
• Instagram: @timespark
• Reddit: r/ClaudeCode