Project Setup

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

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
• 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.

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
• 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

Converted and distributed by TomeVault — claim your Tome and manage your conversions.