Stel je project in

Voeg OpenSpec toe aan een project: voer init uit, bekijk wat het schreef, en pas het aan.

Kies waar OpenSpec leeft

• In je repo (de standaard): specs en changes staan naast de code die ze beschrijven en worden ermee versioneerd. De rest van deze pagina volgt dit pad.
• In een store: een aparte planningsrepo die wordt gedeeld door de repos die deze gebruiken, voor multi-repo-opstellingen of om planning volledig buiten de repo te houden. Stores (beta) behandelt wanneer dat de moeite waard is en hoe je er een opzet.

Initialiseer je project

Met de CLI geïnstalleerd (Installatie), voer je init uit in de hoofdmap van je project. In je terminal:

cd <your-project>
openspec init

Init vraagt welke AI-tools je gebruikt, schrijft de workflowbestanden voor degenen die je kiest, en rapporteert wat je hebt gekregen:

OpenSpec Setup Complete

Created: Claude Code
6 skills and 6 commands in .claude/
Config: openspec/config.yaml (schema: spec-driven)

Herstart je IDE om de nieuwe commando's te activeren.

Opnieuw init uitvoeren is veilig:

• Tools die je al hebt ingesteld tonen Refreshed in plaats van Created.
• Opnieuw init uitvoeren met een nieuw geselecteerd hulpmiddel voegt dat hulpmiddel toe.
• De --tools-vlag slaat de keuzelijst over (CLI-referentie).

Een bestaand project.md migreren

Init kopieert het verouderde openspec/project.md niet naar config.yaml. Het behoudt het bestand en drukt een AI-ondersteund migratieverzoek af.

In je AI-chat:

Review openspec/project.md and migrate its useful content to openspec/config.yaml.
Keep context concise: include only project-wide facts needed during artifact creation, apply, and archive.
Move artifact-specific guidance into rules for the matching artifacts.
Move guidance for apply or archive into the matching operations entry.
Leave out generic, outdated, or verbose material. Do not delete project.md.

Controleer config.yaml en verwijder daarna project.md wanneer je klaar bent.

Wat init installeert

Init uitvoeren creëert twee dingen in je project:

• Een openspec/-map in de hoofdmap van de repo
• Workflowbestanden (skills en commands) toegevoegd aan de map van je AI-tool (.agents/, .claude/, enz.)

Commit alles zoals de rest van je broncode. Init verandert niets anders in je repo (als het restanten van een oudere OpenSpec-versie vindt, vraagt het voordat het deze opruimt).

De openspec/-map

Elk OpenSpec-artefact leeft hier, in de hoofdmap van je project. Zo ziet dat eruit:

openspec/
├── config.yaml     project settings and context for the AI
├── specs/          your specs (empty for now)
└── changes/        in-motion changes (empty for now)
    └── archive/    completed changes move here

Projectconfig behandelt config.yaml.

De workflowbestanden (skills en commands)

Dit zijn de OpenSpec-workflows, de acties die je tijdens het werk gebruikt. Hier zijn ze als geïnstalleerde skills, in de gedeelde .agents/-map die de meeste tools gebruiken:

.agents/skills/
├── openspec-explore/              think through an idea first
├── openspec-propose/              propose a change
├── openspec-apply-change/         implement a change's tasks
├── openspec-update-change/        revise a change's plan
├── openspec-sync-specs/           sync a change's spec updates into specs/
├── openspec-archive-change/       move a finished change to the archive
├── openspec-verify-change/        check the implementation matches the plan (not included by default)
└── openspec-bulk-archive-change/  archive several changes at once (not included by default)

Dit is de standaardset plus twee optionele workflows. Profielen vermeldt alle twaalf.

Standaard installeert elke workflow in twee vormen:

• Skill (openspec-apply-change): instructies die je agent zelf oppikt wanneer je om het werk vraagt.
• Command (/opsx:apply in Claude Code): een getypt toegangspunt voor dezelfde workflow, onder een kortere naam.

De twee zijn functioneel identiek. De skill van een workflow en het bijbehorende command bevatten dezelfde instructies.

Waarom twee: commands kwamen eerst, en elke tool schrijft ze op zijn eigen manier. Skills zijn de nieuwere standaard die tools delen, maar niet elke tool kan een skill direct aanroepen, dus commands blijven het toegangspunt voor die tools.

Sommige tools installeren alleen in skillvorm. Waar de tool skills direct uitvoert, slaat init commands over en zegt dat (Commands skipped for: codex (uses skills)).

We geven de voorkeur aan skills en verwachten commands uiteindelijk af te schaffen.

Wijzigen wat wordt geïnstalleerd

De interactieve keuzelijst wijzigt de leveringsvorm en de workflowset (Profielen). In je terminal:

openspec config profile

Hier is het overschakelen naar alleen skills:

Current profile settings
  Delivery: both

? What do you want to configure? Delivery only
? Delivery mode (how workflows are installed): Skills only

Config changes:
  delivery: both -> skills
? Apply changes to this project now? (Y/n) y

Ja beantwoorden past het direct toe op het huidige project. Andere projecten nemen het over bij hun volgende openspec update. De instelling is wereldwijd, per machine.

Claude Code toont de workflows niet

Claude Code laadt OpenSpec-workflows uit een of beide van deze projectpaden, op basis van je leveringsinstelling:

• Skills: .claude/skills/openspec-*/SKILL.md
• Commands: .claude/commands/opsx/<id>.md

Als de bestanden ontbreken, ververs je het project. In je terminal:

openspec update

Als de commandbestanden bestaan maar /opsx: geen OpenSpec-commando's toont, werk je Claude Code bij en herstart je het. Als commands nog steeds niet laden, schakel je ook skills in. In je terminal:

openspec config set delivery both
openspec update

Herstart Claude Code en voer daarna /openspec-propose uit in de chat. Als slechts enkele workflows ontbreken, wijzig je profiel.

De installatie is klaar. De Snelstart neemt je eerste wijziging vanaf hier over.