init-cc-structure

Original：🇺🇸 English

Translated

Initialize a Claude Code project structure with CLAUDE.md, .claude/ (settings, hooks, skills), docs/, tools/, and src/ module-level context files. Use when the user asks to "init claude code project", "initialize project structure", "scaffold claude project", "set up AI-native repo", or wants to create an AI-friendly repository layout for Claude Code.

2installs

Sourcegoodpostidea-tech/skills

Added on2026-03-17

NPX Install

npx skill4agent add goodpostidea-tech/skills init-cc-structure

SKILL.md Content

View Translation Comparison →

Init Claude Code Project Structure

Scaffold an AI-native repository so Claude Code operates like an engineer, not a chatbot.

Structure Modes

Full Mode (default)

project-root/
├── CLAUDE.md
├── README.md
├── docs/
│   ├── architecture.md
│   ├── decisions/
│   │   └── 000-template.md
│   └── runbooks/
├── .claude/
│   ├── settings.json
│   ├── hooks/
│   └── skills/
│       ├── code-review/
│       │   └── SKILL.md
│       ├── refactor/
│       │   └── SKILL.md
│       └── release/
│           └── SKILL.md
├── tools/
│   ├── scripts/
│   └── prompts/
│       └── example-prompt.md
└── src/
    ├── {module}/
    │   └── CLAUDE.md
    └── {module}/
        └── CLAUDE.md

Lite Mode

project-root/
├── CLAUDE.md
├── README.md
├── docs/
│   ├── architecture.md
│   ├── decisions/
│   │   └── 000-template.md
│   └── runbooks/
└── .claude/
    └── settings.json

Workflow

Step 1: Gather Project Info

Ask the user for the following. Tell the user they can say "skip" or "use defaults" to accept all defaults and proceed immediately.

Question	Default
Structure mode ( `full` or `lite` )	`full`
Project name	Current directory name
Project description	`A project powered by Claude Code`
Tech stack	(leave blank)
Source modules needing local CLAUDE.md (comma-separated)	`api, persistence`

If the user chose lite mode, skip the "Source modules" question — it does not apply.

For common configurations, see examples.md to suggest sensible defaults based on the user's tech stack.

Step 2: Check Existing Files

Check every target file and directory before creating. Skip anything that already exists. Collect skipped items for the summary in Step 4.

Step 3: Create Files

Read references/templates.md to get the file content templates. Substitute

{PROJECT_NAME}

,

{PROJECT_DESCRIPTION}

,

{TECH_STACK}

, and

{MODULE}

with values from Step 1. If a value is blank, remove the placeholder line entirely rather than leaving an empty line.

Lite mode adjustment: When creating files in lite mode, remove all lines that reference full-mode-only directories from the templates:

In CLAUDE.md Repo Structure: remove lines for
```
src/
```
,
```
.claude/skills/
```
,
```
.claude/hooks/
```
,
```
tools/
```
In CLAUDE.md Allowed: remove
```
Refactor any file in src/
```
In README.md Project Structure: remove lines for
```
src/
```
and
```
tools/
```

Common (both modes)

Directories to create (with
.gitkeep
):

```
docs/runbooks/
```

Files to create (from templates):

```
CLAUDE.md
```
— project memory and navigation
```
README.md
```
— project overview
```
docs/architecture.md
```
— system architecture placeholder
```
docs/decisions/000-template.md
```
— ADR template
```
.claude/settings.json
```
— empty config

Full mode only

Additional directories to create (with
.gitkeep
):

```
.claude/hooks/
```
```
tools/scripts/
```

Additional files to create (from templates):

```
tools/prompts/example-prompt.md
```
— sample prompt template
```
.claude/skills/code-review/SKILL.md
```
— code review skill
```
.claude/skills/refactor/SKILL.md
```
— refactor skill
```
.claude/skills/release/SKILL.md
```
— release skill
```
src/{module}/CLAUDE.md
```
— one per module from Step 1. If a module path already contains a top-level directory (e.g.
```
apps/web
```
), use it directly instead of nesting under
```
src/
```
.

Step 4: Output Summary

Print results in this format:

Claude Code project structure initialized! (mode: {full|lite})

Created:
  - CLAUDE.md                       — Project memory & navigation
  - README.md                       — Project overview
  - docs/architecture.md            — System architecture placeholder
  - docs/decisions/000-template.md  — ADR template (ready to use)
  - .claude/settings.json           — Claude Code configuration
  [full mode only:]
  - tools/                          — Scripts and prompt templates
  - .claude/skills/                 — 3 built-in skills (code-review, refactor, release)
  - .claude/hooks/                  — Automation hooks directory
  - src/{modules}                   — Module-level context files

Skipped (already exist):
  - {list or "None"}

Next steps:
  1. Fill in the TODO placeholders in CLAUDE.md
  2. Document your architecture in docs/architecture.md
  [full mode only:]
  3. Customize the skills in .claude/skills/
  4. Add module-specific context in src/*/CLAUDE.md

Reference Files

references/templates.md — file content templates for all generated files
examples.md — common project configurations (Vue, React, Next.js, FastAPI, etc.)