claude-scaffold: Command for Claude Code

/new-project

Initializes a new project from the claude-scaffold template.

What This Command Does

1. Creates the full project directory structure
2. Copies and customizes template files (pyproject.toml, Dockerfile, etc.)
3. Initializes design-doc.md and dev/status.md
4. Sets up .claude/ directory with skills and hooks
5. Runs uv init and git init

Instructions for Claude Code

Ask the developer for:

• Project name (will be used as directory name and Python package name)
• Brief description (one sentence)
• Infrastructure tier: Docker Compose / K8s-ready / GPU
• Does it need a frontend? (HTMX or none)
• Does it need an agent pipeline? (LangGraph or none)
• CI/CD profile (choose one):
  • minimal — lint + typecheck + test (CLI tools, data scripts, scrapers — no Docker)
  • fastapi — + docker-build (standard FastAPI service)
  • fastapi-db — + postgres service + alembic migration check + docker-build
  • ml-heavy — + HuggingFace model cache + bandit security scan + docker-build
• Deploy target (choose one): none / yc (Yandex Cloud Serverless Container) / vps (SSH + docker-compose)

Then execute in order:

1. Create structure

mkdir -p {project-name}/src/{project_name}/{api/routers,api/pages,core,services,adapters/{llm,storage,db},models}
mkdir -p {project-name}/tests/{unit/{core,services},integration,features/steps}
mkdir -p {project-name}/{dev/active,infra/{packer,terraform},notebooks,.github/workflows,.claude/{skills,hooks,agents,commands}}
touch {project-name}/src/{project_name}/__init__.py
touch {project-name}/tests/__init__.py
touch {project-name}/data/.gitkeep
touch {project-name}/models/.gitkeep

2. Copy and customize templates

Copy from claude-scaffold/templates/:

• design-doc.md → project root (replace {Project Name} with actual name)
• status.md → dev/status.md (initialize Phase 0 as active)
• Dockerfile → project root (replace project_name placeholder)
• docker-compose.yml → project root (skip if CI profile is minimal)
• github-actions/{ci_profile}.yml → .github/workflows/ci.yml
• If deploy target is not none: github-actions/deploy/{deploy_target}.yml → .github/workflows/deploy.yml