CC Directory Generator

One master CLAUDE.md, hardlinked across all your projects — edit once, update everywhere.
1つのマスター CLAUDE.md をハードリンクで全プロジェクトに展開 — 1回の編集で全プロジェクトに即反映。

---

English | 日本語

---

English

What is this?

CC Directory Generator (CCDG) is a Windows GUI tool that scaffolds and manages Claude Code project directories.

The Problem

If you use Claude Code across multiple projects, you end up with a CLAUDE.md in every project folder. When you improve your rules or fix a prompt, you have to manually copy the changes to every single project. Miss one, and that project runs on stale instructions.

The Solution: Hardlink-based CLAUDE.md Management

CCDG maintains one master CLAUDE.md and places it into every project via hardlink. Since all hardlinks share the same file on disk:

• Edit once, update everywhere — change the master and all projects instantly see the new content
• No sync needed — hardlinks are a filesystem-level feature, not a copy
• No admin rights — unlike symlinks, hardlinks work on NTFS without Developer Mode
• Health checks — CCDG verifies all links are intact via inode comparison

Master CLAUDE.md  ←──hardlink──→  Project_A/CLAUDE.md
                  ←──hardlink──→  Project_B/CLAUDE.md
                  ←──hardlink──→  Project_C/CLAUDE.md
                  (same file on disk — zero duplication)

Other Features

• Generates standardized folder structures with numbered PascalCase layout
• Detects, registers, and health-checks all managed projects
• Normalizes legacy folder naming inconsistencies with dry-run preview
• Launches Claude Code directly from the project list

Features

Feature	Description
Generate	Create project folders with standard structure + CLAUDE.md hardlink
Update Master	Safely update master CLAUDE.md (preserves hardlinks, auto-backup with timestamp)
Check Links	Verify CLAUDE.md hardlink health via inode comparison
Detect Links	Auto-detect CLAUDE.md files and batch-register unregistered projects
Normalize	Batch-rename inconsistent folder names (with dry-run preview)
▶ CC	Launch Claude Code in the selected project (double-click also works)
Open	Open project folder in Windows Explorer
Dangerous Option	Launch with --dangerously-skip-permissions (persisted setting)

Generated Folder Structure

{ProjectName}/
├── CLAUDE.md                      # Hardlink to master
└── _Prompt/
    ├── 00_FromDesignAi/           # Design instructions
    │   └── _Specs/
    ├── 01_FromBuilderAi/          # Builder AI reports
    │   └── _Research/
    ├── 02_Prj/                    # Project definition
    ├── 03_Specs/                  # Interface specifications
    └── 99_Tmp/

Quick Start

Double-click Run_CCDirGen.bat, or:

python main.py

CLAUDE.md Link Method

Method	Default	Notes
Hardlink	Yes	No admin rights or Developer Mode needed
Symlink	Fallback	Used when hardlink creation fails

Build from Source

.\build.ps1

Requires: PyInstaller, Inno Setup 6

Output: dist\CCDirGen_Setup_v1.1.exe

---

日本語

これは何？

CC Directory Generator (CCDG) は、Claude Code 向けプロジェクトディレクトリを標準化された構成で生成・管理するWindows GUIツールです。

課題

Claude Codeを複数プロジェクトで使っていると、各プロジェクトに CLAUDE.md が散在する。ルールを改善したとき、全プロジェクトに手動でコピーする必要がある。1つでも漏れれば、そのプロジェクトは古いルールで動き続ける。

解決策: ハードリンクによるCLAUDE.md一元管理

CCDGは1つのマスター CLAUDE.md をハードリンクで全プロジェクトに配置する。ハードリンクはディスク上の同一ファイルを共有するため:

• 1回の編集で全プロジェクトに即反映 — マスターを変えれば全プロジェクトが即座に更新される
• 同期不要 — ハードリンクはファイルシステムレベルの機能。コピーではない
• 管理者権限不要 — シンボリックリンクと違い、Developer Modeなしで動作
• 健全性チェック — inode比較で全リンクの整合性を検証

マスター CLAUDE.md  ←──hardlink──→  Project_A/CLAUDE.md
                    ←──hardlink──→  Project_B/CLAUDE.md
                    ←──hardlink──→  Project_C/CLAUDE.md
                    (ディスク上は同一ファイル — 重複ゼロ)

その他の機能

• 番号付きPascalCase形式のフォルダ構成を自動生成
• 登録済みプロジェクトのリンク健全性チェック・未登録PJの自動検出
• 旧命名規則からの表記揺れをdry-runプレビュー付きで一括修正
• プロジェクト一覧からClaude Codeをワンクリック起動

機能一覧

機能	概要
Generate	正式フォルダ構成でプロジェクト一発作成（CLAUDE.mdハードリンク自動配置）
Update Master	マスターCLAUDE.mdを安全に更新（ハードリンク非切断・タイムスタンプバックアップ）
Check Links	全登録プロジェクトのCLAUDE.mdリンク健全性をinode比較でチェック
Detect Links	指定フォルダ以下のCLAUDE.mdを自動検出、未登録プロジェクトを一括登録
Normalize	_Prompt配下の表記揺れを一括修正（dry-runプレビュー付き）
▶ CC	登録プロジェクトをワンクリックでClaude Code起動（ダブルクリック対応）
Open	プロジェクトフォルダをエクスプローラーで開く
Dangerous Option	--dangerously-skip-permissions付き起動（状態永続化）

生成されるフォルダ構成

{ProjectName}/
├── CLAUDE.md                      # マスターへのハードリンク
└── _Prompt/
    ├── 00_FromDesignAi/           # 設計AIからの指示
    │   └── _Specs/
    ├── 01_FromBuilderAi/          # 実装AIの報告・出力
    │   └── _Research/
    ├── 02_Prj/                    # プロジェクト定義
    ├── 03_Specs/                  # IF仕様書
    └── 99_Tmp/

クイックスタート

Run_CCDirGen.bat をダブルクリック、または:

python main.py

CLAUDE.md リンク方式

方式	デフォルト	備考
ハードリンク	Yes	管理者権限・Developer Mode不要
シンボリックリンク	フォールバック	ハードリンク失敗時に自動切替

ソースからビルド

.\build.ps1

必要ツール: PyInstaller, Inno Setup 6

出力: dist\CCDirGen_Setup_v1.1.exe

---

Configuration Files / 設定ファイル

File	Purpose / 用途
config.json	App settings / アプリ設定
projects.json	Project registry (auto-generated) / プロジェクトレジストリ
folder_template.json	Folder structure template / フォルダ構成テンプレート
constants.json	UI layout values and rename mappings / UIレイアウト定数

License

See LICENSE file.

---

Here you go! Made with care.
ほれよ！真心を込めて！