Project Template

Template repository for new projects with Claude Code integration.

Quick Start

1. Clone this template:

   git clone git@git.htsn.io:hutson/template-project.git my-new-project
   cd my-new-project
   rm -rf .git && git init
   

2. Customize CLAUDE.md:

   • Update [PROJECT_NAME] with your project name
   • Fill in [CUSTOMIZE] sections
   • Remove template instructions blockquote

3. Start development with spec-kit:

   /speckit.specify   # Define requirements
   /speckit.plan      # Plan implementation
   /speckit.tasks     # Break into tasks
   /speckit.implement # Build it
   

What's Included

• CLAUDE.md - Comprehensive Claude Code configuration with:
  • Spec-driven development workflow
  • Type safety requirements (Python/TypeScript)
  • Tool usage guidelines (Ref, Exa, code review, etc.)
  • MCP configuration
  • Background agent patterns
  • Homelab infrastructure reference
  • Pre-commit checklist
  • Error recovery patterns

Directory Structure

.
├── CLAUDE.md          # Claude Code instructions
├── README.md          # This file
├── src/               # Source code (create as needed)
├── tests/             # Test files (create as needed)
├── docs/              # Documentation (create as needed)
└── specs/             # Spec-kit specifications (if using)

Workflow

New Feature

/speckit.specify → /speckit.plan → /speckit.tasks → /speckit.implement
/code-review:code-review
/commit-commands:commit

Bug Fix

# Direct implementation, then:
/code-review:code-review
/commit-commands:commit

Related

• Homelab Documentation
• Claude Code Best Practices