DevelopmentFile Structure

File Structure

Complete reference for installed files and directories.

User Directory (~/.claude/)

~/.claude/
├── CLAUDE.md           # Global workflow config
├── settings.json       # Claude Code settings
├── installed.json      # Tracks installed modules
├── commands/           # Slash commands
│   ├── catchup.md
│   ├── wrapup.md
│   ├── init-project.md
│   ├── claude-code-setup.md
│   ├── add-custom.md
│   └── todo.md
├── skills/             # Coding standards
│   ├── standards-python/
│   ├── standards-typescript/
│   ├── standards-javascript/
│   └── standards-shell/
├── scripts/            # Custom helper scripts (optional, chmod +x)
│   └── my-helper.sh
├── templates/          # Project templates
│   ├── project-CLAUDE.md
│   └── VERSION
└── custom/             # User customizations (via /add-custom)
    ├── commands/       # Command overrides/extensions
    ├── scripts/        # Helper scripts (source, deployed to ../scripts/)
    ├── skills/
    └── mcp/

MCP Configuration (~/.claude.json)

{
  "mcpServers": {
    "pdf-reader": { ... },
    "brave-search": { ... }
  }
}

Project Files

your-project/
├── CLAUDE.md           # Project status and tasks
└── docs/
    └── records/        # Design decisions
        ├── 001-feature.md
        └── 002-design.md

Key Files Explained

~/.claude/CLAUDE.md

Global configuration that applies to all projects:

  • Workflow instructions
  • Conventions (commit format, etc.)
  • Skill loading rules
  • User Instructions (your customizations)

~/.claude/installed.json

Tracks what’s installed and their versions:

{
  "content_version": 53,
  "mcp": ["pdf-reader", "brave-search"],
  "skills": ["standards-python", "custom:company-standards"],
  "external_plugins": ["comprehensive-review"],
  "scripts": ["my-helper.sh"],
  "command_overrides": ["catchup.md", "wrapup.md"],
  "custom": {
    "repo": "git@company.com:team/modules.git",
    "version": "1.0.0"
  }
}
  • command_overrides: Commands replaced or extended by custom versions
  • scripts: Helper scripts deployed from the custom repo

~/.claude/settings.json

Claude Code settings including status line:

{
  "statusLine": {
    "enabled": true,
    "command": ["npx", "-y", "ccstatusline"]
  }
}

Project CLAUDE.md

Project-specific status:

  • Current tasks and status
  • Recent Decisions
  • Project Instructions (preserved during migrations)
  • Architecture overview
  • File structure overview
  • Development commands

docs/records/

Permanent documentation:

  • Architecture decisions
  • Feature specifications
  • Implementation plans
OverviewContributing