Project Scaffolder

Overview

This skill guides the process of setting up Claude Code infrastructure in a project. It handles stack detection, template selection, and file generation. Use this when setting up Claude Code for a new project or adding it to an existing codebase.

Quick Reference

tsconfig.json

*.ts

*.tsx

pyproject.toml

requirements.txt

Cargo.toml

*.rs

Stack Detection

TypeScript Detection

Look for:

tsconfig.json
package.json (with "typescript" in dependencies/devDependencies)
*.ts or *.tsx files in src/

Indicators of specific frameworks:

• next.config.js

  → Next.js

• vite.config.ts

  → Vite

• express

  in package.json → Express backend

• prisma/

  directory → Prisma ORM

Python Detection

Look for:

pyproject.toml
requirements.txt
setup.py
*.py files

Indicators of specific frameworks:

• fastapi

  in dependencies → FastAPI

• django

  in dependencies → Django

• flask

  in dependencies → Flask

• alembic/

  directory → Alembic migrations

Rust Detection

Look for:

Cargo.toml
Cargo.lock
src/main.rs or src/lib.rs

Indicators of specific frameworks:

• axum

  in Cargo.toml → Axum

• actix-web

  in Cargo.toml → Actix-web

• diesel

  in Cargo.toml → Diesel ORM

• sqlx

  in Cargo.toml → SQLx

Skill Selection Matrix

Based on detected stack, select appropriate skills:

Universal Skills (All Stacks)

git-workflow

dev-docs-workflow

code-review-workflow

skill-developer

Domain Skills (Cross-Cutting)

api-validation

auth-guidelines

error-handling

error-tracking

TypeScript-Specific Skills

backend-dev-guidelines

frontend-dev-guidelines

database-guidelines

testing-guidelines

state-management

Python-Specific Skills

python-backend-guidelines

python-database-guidelines

python-testing-guidelines

Rust-Specific Skills

rust-backend-guidelines

rust-database-guidelines

rust-testing-guidelines

rust-error-handling

rust-ownership

CLAUDE.md Generation

Template Variables

{{PROJECT_NAME}}

{{FRAMEWORK_VERSION}}

{{STACK_NAME}}

{{STACK_VERSION}}

{{TIMESTAMP}}

Required Sections

Every CLAUDE.md should include:

1. Quick Commands - Build, test, lint, format
2. Project Structure - Directory layout
3. Tech Stack - Technologies used
4. Dev Docs Workflow - How to use /dev-docs
5. Available Skills - Listed by category
6. Available Agents - With usage examples
7. Coding Conventions - Project-specific rules

Directory Structure

After initialization:

project/
├── CLAUDE.md                 # Generated from template
├── .claude/
│   ├── settings.json         # Hook configurations
│   ├── hooks/               # Automation hooks
│   ├── skills/              # Skill files
│   ├── commands/            # Slash commands
│   ├── agents/              # Specialized agents
│   ├── templates/           # Scaffolding templates
│   └── cache/               # Session cache
└── dev/
    └── active/              # Dev docs workspace

Customization Points

After scaffolding, users should customize:

In CLAUDE.md

• Project structure section
• Coding conventions
• Quick commands (if different from defaults)

In skill-rules.json

• Add project-specific keywords
• Adjust enforcement levels
• Add custom file triggers

Create Custom Skills

For project-specific patterns not covered by standard skills.

Workflow

New Project

1. Create project directory
2. Initialize stack (npm init, cargo init, etc.)
3. Run

   /init-claude-code

4. Customize CLAUDE.md
5. Start developing with skills

Existing Project

1. Navigate to project root
2. Run

   /init-claude-code

3. Review detected stack (confirm or override)
4. Review generated CLAUDE.md
5. Merge with existing documentation if needed

Troubleshooting

Multiple Stacks Detected

If project has multiple config files:

• Ask user which is primary
• Consider monorepo setup
• May need custom configuration

No Stack Detected

If no config files found:

• Ask user to specify stack
• Or create minimal config first

Missing Skills

Some skills may not exist yet:

• Note which are missing
• Continue with available skills
• Create missing skills as needed

Resources