# 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 as a script file and run:

## 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 -->

## 快速使用

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

2. 在项目根目录运行：
```bash
claudeforge generate
```

3. `CLAUDE.md` 自动生成完毕，下次 Claude Code 会话自动加载。

---

## 简介

ClaudeForge 是一个自动化 CLAUDE.md 创建和维护工具，GitHub 340+ star。它扫描你的代码库结构、分析技术栈，自动生成上下文相关的指令文件，让 Claude Code 精确理解你的项目规范。适合正在采用 Claude Code 的团队，支持 TypeScript、Python、Go、React、Vue、FastAPI 等技术栈。

---

## ClaudeForge — 自动生成和维护 CLAUDE.md

### 核心功能

- **智能项目扫描** — 自动检测目录结构、框架、代码模式
- **质量评分** — 对现有 CLAUDE.md 打分（0-100）并建议改进
- **模块化架构** — 为 backend/、frontend/、database/ 分别生成上下文文件
- **后台同步** — 代码变更时自动更新 CLAUDE.md
- **技术栈模板** — 内置 TypeScript、Python、Go、React 等预配置

### 安装

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

### 使用方法

```bash
claudeforge generate        # 生成 CLAUDE.md
claudeforge score           # 评分现有文件
claudeforge generate --modular  # 分目录生成
claudeforge watch           # 后台自动同步
```

### FAQ

**Q: ClaudeForge 是什么？**
A: 一个开源 CLI 工具，自动为 Claude Code 项目生成和维护 CLAUDE.md 指令文件。

**Q: ClaudeForge 免费吗？**
A: 完全免费，MIT 开源许可。

---

## 来源与感谢

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


---
Source: https://tokrepo.com/en/workflows/a3d1ca2b-33ca-11f1-9bc6-00163e2b0d79
Author: Script Depot