OpenSpecSpecificatiegestuurde Ontwikkeling voor AI-Assistenten

→ vloeiend, niet rigide
→ iteratief, nieterval
→ eenvoudig, niet complex
→ gebouwd voor bestaande projecten, niet alleen voor nieuwe
→ schaalbaar van persoonlijke projecten tot ondernemingen

Volg @0xTab op X voor updates · Doe mee met de OpenSpec Discord voor hulp en vragen.

Zie het in actie ​

Jij: /opsx:propose voeg-donkere-modus-toe
AI:  Aangemaakt openspec/changes/voeg-donkere-modus-toe/
     ✓ proposal.md — waarom we dit doen, wat er verandert
     ✓ specs/       — vereisten en scenario's
     ✓ design.md    — technische aanpak
     ✓ tasks.md     — implementatiechecklijst
     Klaar voor implementatie!

Jij: /opsx:apply
AI:  Taken implementeren...
     ✓ 1.1 Thema-contextprovider toevoegen
     ✓ 1.2 Schakelcomponent aanmaken
     ✓ 2.1 CSS-variabelen toevoegen
     ✓ 2.2 Koppelen aan localStorage
     Alle taken voltooid!

Jij: /opsx:archive
AI:  Gearchiveerd naar openspec/changes/archive/2025-01-23-voeg-donkere-modus-toe/
     Specificaties bijgewerkt. Klaar voor de volgende functie.

Snelle Start ​

Vereist Node.js 20.19.0 of hoger.

Installeer OpenSpec wereldwijd:

npm install -g @fission-ai/openspec@latest

Navigeer vervolgens naar je projectmap en initialiseer:

cd jouw-project
openspec init

Vertel nu je AI: /opsx:propose <wat-je-wilt-bouwen>

Als je de uitgebreide werkwijze wilt (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard), selecteer deze dan met openspec config profile en pas toe met openspec update.

Documentatie ​

→ Aan de slag: eerste stappen
→ Werkwijzen: combinaties en patronen
→ Commando's: slash-commando's & vaardigheden
→ CLI: terminalreferentie
→ Ondersteunde Tools: toolintegraties & installatiepaden
→ Concepten: hoe het allemaal samenwerkt
→ Meertalig: meertalige ondersteuning
→ Aanpassing: maak het het jouwe

Waarom OpenSpec? ​

AI-codeerassistenten zijn krachtig maar onvoorspelbaar wanneer vereisten alleen in de chatgeschiedenis leven. OpenSpec voegt een lichtgewicht specificatielaag toe zodat je het erover eens bent wat er gebouwd moet worden voordat er ook maar één regel code wordt geschreven.

• Eens vóórdat je bouwt — mens en AI komen overeen over specificaties voordat code wordt geschreven
• Blijf georganiseerd — elke wijziging krijgt zijn eigen map met voorstel, specificaties, ontwerp en taken
• Werk vloeiend — werk elk artefact op elk moment bij, geen rigide fasemijlpalen
• Gebruik je tools — werkt met 20+ AI-assistenten via slash-commando's

Hoe wij ons verhouden ​

vs. Spec Kit (GitHub) — Grondig maar zwaar. Rigide fasemijlpalen, veel Markdown, Python-setup. OpenSpec is lichter en laat je vrij itereren.

vs. Kiro (AWS) — Krachtig maar je bent vastgelegd op hun IDE en beperkt tot Claude-modellen. OpenSpec werkt met de tools die je al gebruikt.

vs. niets — AI-codeerwerk zonder specificaties betekent vage prompts en onvoorspelbare resultaten. OpenSpec brengt voorspelbaarheid zonder de opsmuk.

OpenSpec bijwerken ​

Pakket upgraden

npm install -g @fission-ai/openspec@latest

Agentinstructies vernieuwen

Voer dit uit in elk project om de AI-begeleiding opnieuw te genereren en ervoor te zorgen dat de nieuwste slash-commando's actief zijn:

openspec update

Gebruiksaanmerkingen ​

Modelselectie: OpenSpec werkt het beste met modellen met hoge redeneervaardigheden. We raden Opus 4.5 en GPT 5.2 aan voor zowel planning als implementatie.

Context-hygiëne: OpenSpec profiteert van een schone contextvenster. Wis je context voordat je met implementatie begint en onderhoud een goede context-hygiëne gedurende je sessie.

Bijdragen ​

Kleine fixes — Bugfixes, typecorrecties en kleine verbeteringen kunnen direct als PR's worden ingediend.

Grotere wijzigingen — Voor nieuwe functies, significante refactors of architectonische wijzigingen, dien eerst een OpenSpec-wijzigingsvoorstel in zodat we over de intentie en doelen kunnen overeenkomen voordat de implementatie begint.

Houd bij het schrijven van voorstellen de OpenSpec-filosofie in gedachten: we bedienen een breed scala aan gebruikers over verschillende codeeragents, modellen en gebruikssituaties. Wijzigingen moeten voor iedereen goed werken.

AI-gegenereerde code is welkom — zolang deze getest en geverifieerd is. PR's met AI-gegenereerde code moeten de gebruikte codeeragent en het model vermelden (bijv. "Gegenereerd met Claude Code met behulp van claude-opus-4-5-20251101").

Ontwikkeling ​

• Afhankelijkheden installeren: pnpm install
• Bouwen: pnpm run build
• Testen: pnpm test
• CLI lokaal ontwikkelen: pnpm run dev of pnpm run dev:cli
• Conventionele commits (éénregelig): type(scope): onderwerp

Overig ​

Licentie ​

MIT