Claude Code Setup

Setup production-grade \.claude/\ AI collaboration layer for projects.

Overview

This skill ensures projects have a proper \.claude/\ configuration before agents start development work with Claude Code. It acts as a supervisor to maintain and enforce project standards.

Important: Target Project Directory

.claude/ must be created in the target project directory, NOT in your workspace root.

Example:

• - ❌ Wrong: /home/user/workspace-xiaolong/.claude/ (workspace root)
• ✅ Correct: /home/user/eave-web/.claude/ (actual project being developed)

Always identify which project you're working on first, then check/create .claude/ in that directory.

When to Use

• - Starting a new development task with Claude Code
• Entering a new project directory
• User mentions "Claude Code", ".claude", "AI collaboration layer", or "project standards"

Workflow

Step 1 — Check First

Always check if \.claude/\ directory already exists in the target project directory:

\\\bash ls -la .claude/ 2>/dev/null \\INLINECODE8

Step 2 — If Missing → Create

If the project doesn't have \.claude/\ directory, create it first before development:

\\\bash node ~/.openclaw/skills/claude-code-setup/index.js \\INLINECODE12

Step 3 — If Exists → Supervise

If \.claude/\ already exists:

• - ✅ DO NOT overwrite existing files
• ✅ DO NOT recreate the structure
• ✅ Let Claude Code naturally maintain and update during development

Step 4 — Be a Supervisor

Your role is supervisor, not executor:

• - Ensure Claude Code follows rules in \INLINECODE14
• During development, let Claude Code update configs based on actual code
• Periodically review if \.claude/\ content matches the project reality

Core Principles

1. 1. CLAUDE.md is core — Highest priority project instructions
2. Modular — Separate rules/skills/context
3. Clear directives — Use MUST/ALWAYS/NEVER
4. Project context — Must include project overview and tech stack
5. Don't reinvent — Reuse and maintain existing configs

.claude/ Directory Structure

\\\ .claude/ ├── CLAUDE.md # ⭐ Project-level global instructions (most important) ├── rules/ # Team rule library │ ├── frontend.md │ ├── typescript.md │ └── commit.md ├── context/ # Project context knowledge │ ├── project.md │ └── stack.md ├── skills/ # Project-private skills │ └── generate-crud.md └── prompts/ # Reusable prompt templates └── review.md \\INLINECODE18

Common Mistakes to Avoid

❌ Writing as requirements doc or README
❌ Vague rules ("try to", "should")
❌ Only CLAUDE.md without modularity
❌ Missing project context
❌ Overwriting existing configs
❌ Redundant recreation

Collaboration with Claude Code

When using Claude Code:

1. 1. Before starting: Ensure \.claude/\ exists
2. During development: Let Claude Code reference rules in \INLINECODE20
3. After completion: Update \.claude/\ with any new standards learned

Template Files

See \index.js\ for template definitions.