← ClaudeAtlas

startlisted

Start a project on the Visual Stack — a multi-step setup form captures what's being built, recommends a stack, and either instantiates the vstack-template-base template, sets up a specs-and-design-only workspace, or records an existing codebase without touching it. Use when the user wants to start a new project, scaffold a repo, set up a codebase from the Cavalry template, pick a stack or add-ons, run Day-1 setup, or bring an existing app onto the visual stack.
Cavalry-Collective/visual-stack · ★ 11 · AI & Automation · score 72
Install: claude install-skill Cavalry-Collective/visual-stack
Turns an idea — or an existing repo — into *this* project. One multi-step form, then whichever of three paths its answers call for. ``` ┌─ skip dev ──► specs/ + design/ only (no clone) idea ──► setup form ──► choice ──┤ └─ full ─────► clone ──► delete the rest ──► toolchain ──► ready existing code ──► infer ──► confirm screen ──► recorded (nothing touched) ``` Every path ends with two files the rest of the chain reads: **`specs/product.md`** — what this product is — and **`.vstack/pipeline.json`** — where the pipeline stands. ## 1 · Pick the mode Look at the target directory first: | The directory is | Mode | |---|---| | empty, missing, or has no real code | **fresh** — the form runs before anything exists | | template-derived (`stacks/`, `add-ons/`, `design/`, `specs/` all present) | **template** — don't clone again; the form reads the real inventory | | a real codebase that isn't template-derived | **existing** — infer, confirm, record; never scaffold or delete | In fresh mode, don't interrogate up front — the form asks the questions. The only thing worth asking before serving it is where the project directory should go if the user hasn't said. ## 2 · Serve the form ```bash SKILL=<this skill dir> node "$SKILL/assets/chooser-server.mjs" --repo <project dir> --port 7799 ``` Start it with **`run_in_background: true`**, then tell the user to open **http://localhost:7799/**. The form is four step