# Project Setup

> Initialize Claude Code project management system. Creates .claude/skills/project/ with project-specific context skill, .claude/features/_planning/ for feature planning, and CLAUDE.md entry point. Use when setting up a new project for Claude Code workflows. Use when this capability is needed.

- Skill: `tomevault-io/project-setup-4` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/project-setup-4`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/project-setup-4/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/project-setup-4

---


# Project Setup

Initialize skill-based project context management.

**Required:** You MUST invoke the `skill-creator` skill (via `Skill tool`) when creating any skills in this process. Do not create skill files directly without going through skill-creator first.

## Created Structure

```
.claude/
  skills/
    project/
      SKILL.md            # Main project skill (/project)
      <feature>.md        # Feature skills (created later)
  features/
    _planning/            # Features being planned
    <feature>/            # Feature specs/domain docs (created later)
.vista/
  features/               # Feature planning artifacts
  ralph/                  # Ralph job working directories
CLAUDE.md                 # Mandates project skill at session start
```

## Process

### 1. Check Existing

If `.claude/skills/project/SKILL.md` or `CLAUDE.md` exists, ask: Skip | Backup & Replace | Cancel

### 2. Create Directories

```bash
mkdir -p .claude/skills/project
mkdir -p .claude/features/_planning
mkdir -p docs
mkdir -p .vista/ralph
```

If `.vista/` already exists, skip `.vista/` creation (same pattern as the existing check for `.claude/`).

### 3. Analyze Codebase

Use Explore agent to gather:
- Project name, type, primary language
- Architecture pattern
- Tech stack (core + dev/build tools)
- Directory structure, key directories
- Entry points, config locations
- Build/test/run commands
- Code patterns and conventions

### 4. Create Project Skill

**IMPORTANT: Invoke the skill-creator skill** using the Skill tool with `skill: "skill-creator"` to create `.claude/skills/project/SKILL.md`.

Provide the skill-creator with:
- The analysis gathered in step 3
- The template from [assets/project-skill-template.md](assets/project-skill-template.md)
- Target path: `.claude/skills/project/SKILL.md`

The skill-creator will ensure proper skill structure and best practices are followed.

### 5. Create CLAUDE.md

Write `CLAUDE.md` in project root using [assets/claude-md-template.md](assets/claude-md-template.md).

### 6. Report

Show created files and next steps.

## Feature Skill Creation

When adding features later:

**Invoke the skill-creator skill** using `Skill tool` with `skill: "skill-creator"` to create `.claude/skills/project/<feature>.md`.

Provide the skill-creator with:
- Feature requirements and context
- The template from [assets/feature-skill-template.md](assets/feature-skill-template.md)
- Target path: `.claude/skills/project/<feature>.md`

Feature skills contain:
- Brief overview
- Key patterns and entry points
- Dependencies
- Pointer to `.claude/features/<feature>/` for specs/domain requirements

## Flags

| Flag | Effect |
|------|--------|
| `--minimal` | Structure only, no analysis |
| `--force` | Overwrite with .bak backups |

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/ribeec20) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-15 -->