ps-new-project

name	ps-new-project
description	Orchestrate the day-1 setup that remains after cloning a PrestaShop repo and running lando-setup: scaffold the child theme (panda or elementflow track), wire the CSS build, and write CLAUDE.md. Composes existing skills (ps-css-build, ps-project-doc, lando-setup). Does NOT create the GitLab repo, the server, or install PrestaShop core. Use when starting a new client project locally and you need the standard scaffold fast.
version	0.1.0
metadata	{"author":"Eduardo Calvo"}

ps-new-project — new client day-1 scaffold

Runs the repetitive setup that's still manual after clone + lando-setup: child theme → CSS build → CLAUDE.md. Pure orchestration over skills that already exist. Server/repo/PS-core stay out of scope (manual / PM-owned).

Universal rule: always a child theme

Every project gets a child theme, on both tracks — you never edit the parent (panda/classic) directly. The child is the safe override layer; parent files stay untouched so parent updates don't wipe your work. Creating the child is not optional.

Tracks

• panda — legacy majority: child of the Panda theme (parent: panda). Storefront work (templates + CSS) happens in the child.
• elementflow — emerging default: child of classic, relies on the stsitebuilder module. The child is still mandatory (same rule). What differs is where the visual work goes: in ElementFlow the site layout/content is built in the builder (stsitebuilder), so the child's hand-work concentrates on the checkout and my-account pages (building those with the builder causes compatibility issues). Don't build the whole site in the child — but you still always have one.

EF child — prefer the official download over generating. The canonical EF child theme is downloaded from the store itself so it preserves existing image types (installing a theme on PS 1.7/8 erases image types; the BO download re-adds them):

• PS 1.7 / 8: BO → Element Flow → Settings → Child theme (downloads with the store's image types baked in).
• PS 9: the elementflow.zip (classic) / elementflow_hb.zip (Hummingbird) — PS 9 keeps image types on install.

This skill's generated EF skeleton (below) is a fallback/starting point only. When the store already has the stsitebuilder module, tell the user to grab the official child instead, and warn: on PS 1.7/8 a hand-generated child will not carry the store's image types — re-add them or use the BO download. Consult the elementflow-kb skill for builder specifics (navigation items, terms modal terms-and-conditions-modal.tpl, one-column mobile checkout).

The CSS build for both tracks is the same lightningcss pipeline ps-css-build ships (bundle+minify _dev/css/custom.css → assets/css/custom.css, chokidar watch, zero-dep pre-commit fallback), so one build system serves both.

Flow

0. Preconditions

Confirm cwd is a PS repo (themes/ + modules/). Detect installed base: themes/panda → Panda available; modules/stsitebuilder → ElementFlow available. If --track mismatches what's installed, warn before proceeding.

1. Child theme scaffold

~/.claude/skills/ps-new-project/scripts/scaffold-theme.sh <track> <name> "<display_name>" .

• Default <name> = <repo-slug>-child (derive slug from the repo dir name; override with --name).
• The script creates themes/<name>/ with config/theme.yml (per track), config/.htaccess, templates/{_partials,catalog,checkout,customer,errors}/, modules/, assets/{css,js}/.
• For elementflow, verify modules/stsitebuilder exists; warn if missing. Also recommend the official EF child download (BO → Element Flow → Settings → Child theme on PS 1.7/8, or the zip on PS 9) since it preserves image types — the generated skeleton is a fallback. On PS 1.7/8 warn that a generated child won't carry the store's image types.
• It refuses to clobber an existing themes/<name>/.

2. CSS build — reuse ps-css-build

Run the ps-css-build skill targeting themes/<name>/ (lightningcss + pnpm + pre-commit). Same for both tracks. Skip with --no-css.

3. CLAUDE.md — reuse ps-project-doc (non-interactive)

Call ps-project-doc with known values (track, theme name, PS version, git remote) so it writes CLAUDE.md without re-prompting. Stays gitignored, never committed. Skip with --no-doc.

4. Lando — reuse lando-setup (optional)

If Lando isn't configured and --no-lando not passed, hand off to lando-setup. Usually already done → skip.

5. Report

List created/skipped, the child theme path, and remaining manual steps: activate the theme in the Back Office, and (if from scratch) create the repo/server — which this skill deliberately does not touch.

Hard rules

• Never create the GitLab repo or server, never install PS core, never deploy.
• Never clobber an existing child theme without explicit confirmation.
• English-only content; no company names in the skill. (Generated CLAUDE.md may name the client — it's private/untracked.)