new-project

/new-project

Greenfield entry point. Guides from an empty directory to a scaffolded project with a configured Claude harness.

Prerequisite Check

Scan for stack indicator files before anything else:

package.json  pom.xml  build.gradle  go.mod  Cargo.toml
pyproject.toml  Gemfile  composer.json  mix.exs

If any found:

"This directory already has a project. Use /shipwithai-starter:init instead." → stop

Overview

3 phases, each ending with a confirmed artifact. User can redirect at any checkpoint.

Phase 1 → confirm tech stack
Phase 2 → confirm architecture + folder structure
Phase 3 → confirm conventions → final preview → execute

---

Phase 1 — Project Goals

Ask 5 questions, one per message. Do not bundle questions.

Q0: What's the project name? (used for scaffold command and CLAUDE.md)

"What should we call this project? (e.g. my-app, acme-api)"

Q1: What are you building?

"What type of project is this?"

• Web app
• REST API
• Mobile backend
• CLI tool
• Library

Q2: Who will use it?

"Who's the primary audience for this project?"

• Just me (personal / internal tool)
• Small team or customers (< 1k users)
• Product with real growth targets

Q3: Any hard constraints? (free text, or "none")

"Any constraints I should know? e.g. must use a specific language, existing database to integrate with, specific hosting (Vercel, AWS, self-hosted)."

Q4: One-line description of what the project does. (free text)

---

After Q4, generate and show a tech stack recommendation:

Based on your answers, I recommend:

  Project:     [name]
  Type:        [web app / REST API / mobile backend / CLI / library]
  Language:    [language]
  Framework:   [framework + version]
  Database:    [database]
  Hosting:     [hosting]

  Why: [2-3 sentence reasoning grounded in their specific answers]

Use this stack? (yes / swap one thing / different direction)

Response	Action
yes	Proceed to Phase 2 with confirmed stack
swap one thing	"What would you like to swap?" → regenerate recommendation
different direction	Return to Q1