README.md

October 25, 2025 · View on GitHub

A collection of CLAUDE.md templates for repository management, designed to work seamlessly with Claude Code CLI.

Overview

This repository provides pre-configured CLAUDE.md templates that give Claude Code context-aware instructions when working in different types of repository directories. Instead of a one-size-fits-all deployment script, this approach lets you selectively deploy templates using Claude Code's slash commands.

What are CLAUDE.md Files?

CLAUDE.md files are contextual documentation files that Claude Code reads when working in a directory. They provide:

Purpose and description of the directory
Common tasks and operations expected in that location
Best practices and guidelines
Typical directory structure
Development workflows and patterns

When Claude Code starts in a directory with a CLAUDE.md file, it automatically reads and follows the instructions, making it context-aware for that specific workspace.

Available Templates

All templates are located in the template-claude-md/ directory.

Hugging Face Templates

hf-spaces/: For Hugging Face Spaces directories (Gradio, Streamlit, Docker apps)
hf-datasets/: For Hugging Face Datasets directories
hf-models/: For Hugging Face Models directories

GitHub Repository Templates

for-gh-repo-base/: For the base GitHub repositories directory
for-gh-docs-base/: For documentation repositories
for-gh-websites-base/: For website/web project repositories
for-gh-forks-base/: For forked repositories
for-gh-collaborative-base/: For collaborative GitHub projects

Work & Collaboration Templates

for-work-repos-base/: For work-related repositories
for-datasets-collaborative-base/: For collaborative dataset projects
for-docs-collaborative-base/: For collaborative documentation projects

Project Templates

for-cloned-projects.base/: For cloned third-party projects

Complete Template List

template-claude-md/for-cloned-projects.base/CLAUDE.md - Cloned third-party projects
template-claude-md/for-datasets-collaborative-base/CLAUDE.md - Collaborative datasets
template-claude-md/for-docs-collaborative-base/CLAUDE.md - Collaborative documentation
template-claude-md/for-gh-collaborative-base/CLAUDE.md - Collaborative GitHub repos
template-claude-md/for-gh-docs-base/CLAUDE.md - GitHub documentation repos
template-claude-md/for-gh-forks-base/CLAUDE.md - GitHub forks
template-claude-md/for-gh-repo-base/CLAUDE.md - GitHub repositories base
template-claude-md/for-gh-websites-base/CLAUDE.md - GitHub website projects
template-claude-md/for-work-repos-base/CLAUDE.md - Work repositories
template-claude-md/hf-datasets/CLAUDE.md - Hugging Face datasets
template-claude-md/hf-models/CLAUDE.md - Hugging Face models
template-claude-md/hf-spaces/CLAUDE.md - Hugging Face Spaces

Quick Start

Installation

Clone this repository:

cd ~/repos/github
git clone https://github.com/danielrosehill/Claude-Code-Repo-Managers-ClaudeMD.git

Set up slash commands (optional):

cd Claude-Code-Repo-Managers-ClaudeMD
./grab-slash-commands.sh

This syncs the slash commands from .claude/commands/ to slash-commands/ directory.

Usage with Claude Code

The recommended workflow is to use Claude Code interactively to deploy templates:

Start Claude Code in this repository:

cd ~/repos/github/Claude-Code-Repo-Managers-ClaudeMD
claude-code

Ask Claude to help you deploy templates:
- "Please show me the available templates"
- "I'd like to deploy the GitHub repos template to ~/repos/github"
- "Help me set up CLAUDE.md files for my Hugging Face workspace"
Claude Code will:
- Show you the available templates
- Ask you which ones you want to deploy
- Confirm the target directory paths
- Copy the templates to the appropriate locations
- Customize them if needed based on your setup

Available Slash Commands

/set-stuff-up: Interactive setup wizard that guides you through deploying templates
/depersonalise: Remove personal information from CLAUDE.md files before sharing

How It Works

Template Structure

Each template directory contains a CLAUDE.md file with:

Purpose: What the directory is used for
Directory Structure: Expected subdirectories and organization
Common Tasks: Typical operations Claude might be asked to perform
Best Practices: Guidelines for working in this context
Workflows: Development patterns and procedures
Examples: Code snippets and usage patterns

Syncing Slash Commands

The repository includes a pre-commit hook that automatically syncs slash commands:

./grab-slash-commands.sh

This ensures the slash-commands/ directory stays in sync with .claude/commands/.

Use Cases

For Hugging Face Developers

Deploy context-aware documentation to your Hugging Face workspace. When Claude Code works in ~/repos/hugging-face/spaces/, it will know:

How to create Gradio/Streamlit apps
Proper Space configuration patterns
Hardware tier recommendations
Best practices for Space development

For GitHub Repository Management

Provide Claude Code with context when managing large collections of repositories. When working in ~/repos/github/, Claude will understand:

Batch operations across multiple repos
Repository analysis and auditing patterns
Maintenance workflows
Best practices for organization

For Forked Repository Management

Give Claude Code guidance on working with forks. In ~/repos/forks/, Claude knows:

How to handle upstream syncing
Pull request workflows
Contribution guidelines
Fork maintenance practices

Customizing Templates

Since everyone organizes their repositories differently, you can:

Browse the templates in template-claude-md/
Copy templates manually to your preferred locations
Customize them to match your workflow
Ask Claude Code to help - it can read the templates and adapt them to your needs