# ClaudeForge — Auto-Generate CLAUDE.md for Any Project

> Generate and maintain CLAUDE.md files automatically. Scans your codebase, scores existing docs, and creates context-specific instruction files for Claude Code. MIT, 340+ stars.

## Install

Save the content below to `.claude/skills/` or append to your `CLAUDE.md`:

## Quick Use

1. Install ClaudeForge:
```bash
curl -fsSL https://raw.githubusercontent.com/alirezarezvani/ClaudeForge/main/install.sh | bash
```

2. Run in your project root:
```bash
claudeforge generate
```

3. Your `CLAUDE.md` is ready — Claude Code loads it automatically on next session.

---

## Intro

ClaudeForge is an automated CLAUDE.md creation and maintenance tool with 340+ GitHub stars. It scans your codebase structure, analyzes your tech stack, and generates context-specific instruction files that tell Claude Code exactly how to work with your project. Best for teams adopting Claude Code who want consistent AI behavior across repos. Works with TypeScript, Python, Go, React, Vue, FastAPI, and more.

See also: [Claude Code Skills collection](https://tokrepo.com/en/collections/skills) on TokRepo for ready-made skill files.

---

## ClaudeForge — Automated CLAUDE.md Creation & Maintenance

### Why You Need This

Every Claude Code project benefits from a `CLAUDE.md` file — it tells the AI your project conventions, architecture, and coding standards. But writing one from scratch is tedious and error-prone. ClaudeForge automates the entire process.

### Key Features

- **Interactive project exploration** — scans directory structure, detects frameworks, identifies patterns
- **Quality scoring** — rates existing CLAUDE.md files 0-100 and suggests improvements
- **Modular architecture** — generates separate files for backend/, frontend/, database/ contexts
- **Background sync agent** — automatically updates CLAUDE.md when your codebase changes
- **Tech stack templates** — pre-built configurations for TypeScript, Python, Go, React, Vue, FastAPI
- **Adaptive complexity** — adjusts output for solo developers vs. large teams

### Installation

**macOS/Linux:**
```bash
curl -fsSL https://raw.githubusercontent.com/alirezarezvani/ClaudeForge/main/install.sh | bash
```

**Windows (PowerShell):**
```powershell
iwr https://raw.githubusercontent.com/alirezarezvani/ClaudeForge/main/install.ps1 -useb | iex
```

### Usage

```bash
# Generate CLAUDE.md for current project
claudeforge generate

# Score existing CLAUDE.md quality (0-100)
claudeforge score

# Generate context-specific files for subdirectories
claudeforge generate --modular

# Start background sync agent
claudeforge watch
```

### What It Generates

- Root `CLAUDE.md` navigation hub with project overview
- Context-specific instruction files per directory
- ASCII project structure diagrams
- Setup and installation instructions
- Architecture documentation
- Tech stack specifications and coding conventions

### FAQ

**Q: What is ClaudeForge?**
A: ClaudeForge is an open-source CLI tool that automatically generates and maintains CLAUDE.md instruction files for Claude Code projects. It scans your codebase and creates context-aware AI guidelines.

**Q: Is ClaudeForge free?**
A: Yes, ClaudeForge is free and open-source under the MIT license.

**Q: Does ClaudeForge work with any programming language?**
A: Yes, it supports TypeScript, Python, Go, React, Vue, FastAPI, and auto-detects most common tech stacks.

---

## Source & Thanks

> Created by [Alireza Rezvani](https://github.com/alirezarezvani). Licensed under MIT.
>
> [ClaudeForge](https://github.com/alirezarezvani/ClaudeForge) — ⭐ 340+

Thanks to Alireza for building a tool that makes Claude Code adoption significantly easier.

---

<!-- ZH -->

## Quick Use

1. Install ClaudeForge:
```bash
curl -fsSL https://raw.githubusercontent.com/alirezarezvani/ClaudeForge/main/install.sh | bash
```

2. Run in your project root:
```bash
claudeforge generate
```

3. `CLAUDE.md` is generated automatically and loaded by the next Claude Code session.

---

## Introduction

ClaudeForge is an automated CLAUDE.md creation and maintenance tool with 340+ GitHub stars. It scans your codebase structure, analyzes the tech stack, and generates context-aware instruction files so Claude Code understands your project conventions precisely. Ideal for teams adopting Claude Code. Supports TypeScript, Python, Go, React, Vue, FastAPI, and more.

---

## ClaudeForge — Automatically Generate and Maintain CLAUDE.md

### Core Features

- **Smart project scanning** — auto-detects directory structure, frameworks, and code patterns
- **Quality scoring** — scores existing CLAUDE.md (0–100) and suggests improvements
- **Modular architecture** — generates separate context files for backend/, frontend/, database/
- **Background sync** — updates CLAUDE.md automatically as code changes
- **Stack templates** — pre-configured for TypeScript, Python, Go, React, and more

### Install

```bash
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/alirezarezvani/ClaudeForge/main/install.sh | bash
```

### Usage

```bash
claudeforge generate        # Generate CLAUDE.md
claudeforge score           # Score an existing file
claudeforge generate --modular  # Generate per directory
claudeforge watch           # Background auto-sync
```

### FAQ

**Q: What is ClaudeForge?**
A: An open-source CLI tool that automatically generates and maintains CLAUDE.md instruction files for Claude Code projects.

**Q: Is ClaudeForge free?**
A: Completely free under the MIT open-source license.

---

## Source & Thanks

> Created by [Alireza Rezvani](https://github.com/alirezarezvani). Licensed under MIT.
>
> [ClaudeForge](https://github.com/alirezarezvani/ClaudeForge) — ⭐ 340+


---
Source: https://tokrepo.com/en/workflows/claudeforge-auto-generate-claude-md-any-project-a3d1ca2b
Author: Script Depot