Skip to content

Ik wil een nieuw project starten ​

Bootstrap een nieuw project met Spexso scaffolding, klaar voor spec-driven development.

Steps ​

  1. Maak een GitLab repo aan en clone deze:
    bash
    git clone git@gitlab.com:your-org/my-project.git
    cd my-project
  2. Installeer en initialiseer Spexso. @flexso/spexso staat op Flexso's private GitLab npm registry — configureer eerst de @flexso scope en je token (één keer per machine), anders geeft npm install een 404:
    bash
    npm install -D @flexso/spexso
    npx @flexso/spexso init
    Dit maakt de .spexso/ directory, commands, agents en labels aan. Init maakt ook automatisch alle GitLab scoped labels aan (stage::*, type::*, size::*, priority::*, platform::*, ai::*) — je hoeft ze niet handmatig te maken. Init seedt daarnaast de rulebooks (incl. .spexso/rules/doctrine.md) en templates (constitution, learning-card, planner-registry) in .spexso/. Heeft .claude/settings.json nog geen hooks-blok, dan waarschuwt init dat observability en doctrine-injectie uit staan.
  3. Open Claude Code en configureer het project:
    /spexso-setup
    Setup scant je codebase, stelt vragen en genereert een CLAUDE.md.
  4. Commit de scaffolded bestanden:
    bash
    git add -A && git commit -m "chore: bootstrap spexso"
  5. Kickstart het project met /spexso-kickstart <naam> — een interview dat uitmondt in een epic, een milestone en een backlog met afhankelijkheden, plus een MR met de woordenlijst en de constitution (zie Project of traject kickstarten). Voor een losse feature of bug volstaat /spexso-brainstorm of /spexso-report.

TIP

/spexso-setup maakt interactief een CLAUDE.md aan die Claude context geeft over je project, stack en conventies.

Tips ​

  • Installeer eerst de aanbevolen plugins (superpowers + sap-skills)
  • Setup triaged ook eventuele bestaande issues en past labels toe
  • Voeg teamleden toe aan het GitLab project voor ze Spexso gaan gebruiken