OpenSpec Documentatie ​

Welkom. Dit is de plek voor alles over OpenSpec.

OpenSpec helpt jou en je AI-coderingsassistent om het eens te zijn over wat er gebouwd moet worden voordat er ook maar een regel code is geschreven. Jij beschrijft de wijziging, de AI stelt een korte specificatie en een takenlijst op, jullie kijken allebei naar hetzelfde plan, en dan wordt het werk uitgevoerd. Je komt er niet meer halverwege achter dat de AI het verkeerde heeft gebouwd.

Als je niets anders leest, lees dan deze twee pagina's:

1. Aan de slag: installeer, initialiseer en rond je eerste wijziging af.
2. Hoe commando's werken: waar je daadwerkelijk /opsx:propose typt (hint: in je AI-chat, niet in de terminal). Bijna iedereen struikelt hier in het begin over.

Die tweede is belangrijker dan hij eruit ziet. OpenSpec bestaat uit twee helften: een commandoregelprogramma dat je in je terminal uitvoert, en slash-commando's die je aan je AI-assistent geeft. Weten welke je wanneer gebruikt, voorkomt het meest voorkomende moment van verwarring.

De beste gewoonte om als eerste op te bouwen: als je niet zeker weet wat je moet bouwen, begin dan met /opsx:explore. Het is een denkpartner zonder verplichtingen die je code leest, opties afweegt en een vaag idee aanscherpt tot een concreet plan voordat er een artefact of code bestaat. De Explore First-gids maakt het argument.

Kies je pad ​

Ik ben helemaal nieuw. Begin met Aan de slag, blader dan door de Kernconcepten in één oogopslag. Als iets onduidelijk aanvoelt, zijn de FAQ en Verklarende woordenlijst in de buurt.

Ik heb een probleem maar geen plan. Dit is een veelvoorkomende situatie en er is een specifiek antwoord voor: Explore First. Gebruik /opsx:explore om het samen met de AI te doordenken voordat je ergens aan vastzit.

Ik heb een grote bestaande codebase. Je documenteert niet alles. OpenSpec gebruiken in een bestaand project laat zien hoe je aan de slag kunt met echte, bestaande code zonder meteen alles te willen herzien.

Ik wil het gewoon werkend krijgen. Installeren, voer openspec init uit en lees daarna Hoe commando's werken zodat je eerste slash-commando op de juiste plek terechtkomt. Of geef de installatie uit handen aan je assistent met de AI-geassisteerde installatieprompt.

Ik leer het best via voorbeelden. De pagina Voorbeelden & Recepten loopt door echte wijzigingen van begin tot eind: een kleine functie, een bugfix, een refactor, een verkenning.

De AI heeft net een plan opgesteld — en nu? Lees het. Een wijziging beoordelen toont de twee-minutenblik waarmee je een verkeerde afslag nog opmerkt voordat het duur wordt, en Goede specificaties schrijven behandelt waar een plan dat goedkeuring verdient uit bestaat.

Ik werk in een team. OpenSpec in een team laat zien hoe een wijziging samengaat met een branch en een pull-request, en hoe teamleden een plan kunnen beoordelen voordat de code er is.

Ik kom van de oude workflow. De Migratiegids legt uit wat er veranderd is en waarom, en garandeert dat je bestaande werk veilig is.

Ik wil het aanpassen aan de werkwijze van mijn team. Aanpassen behandelt projectconfiguratie, aangepaste schema's en gedeelde context.

Er is iets kapot. Probleemoplossing verzamelt de fouten die mensen daadwerkelijk tegenkomen, met oplossingen.

De volledige kaart ​

Begin hier ​

Dagelijks gebruik ​

Dieper begrip ​

Maak het eigen ​

Wanneer je hulp nodig hebt ​

Coördineren over repositories (bèta) ​

De dertig-secondenversie ​

1. Install        npm install -g @fission-ai/openspec@latest
2. Initialize     cd your-project && openspec init
3. Explore        (in your AI chat)  /opsx:explore           ← optioneel, maar een goede gewoonte
4. Propose        (in your AI chat)  /opsx:propose add-dark-mode
5. Build          (in your AI chat)  /opsx:apply
6. Archive        (in your AI chat)  /opsx:archive

Stap 1 en 2 voer je uit in je terminal. De rest gebeurt in de chat van je AI-assistent. Dat onderscheid is het enige dat je echt moet onthouden, en Hoe commando's werken legt precies uit waarom. Stap 3 is optioneel, maar beginnen met /opsx:explore wanneer je twijfelt, is de gewoonte die het meest de moeite van het aanleren waard is.

Waar je nog meer hulp kunt krijgen ​

• Discord: discord.gg/YctCnvvshC voor vragen, ideeën en hulp.
• GitHub Issues: github.com/Fission-AI/OpenSpec/issues voor bugs en functieverzoeken.
• openspec feedback "your message" stuurt feedback rechtstreeks vanuit je terminal (het opent een GitHub-issue).

Vond je iets in deze documentatie dat fout, verouderd of verwarrend is? Dat is een bug. Maak een issue of een pull request aan. Verbeteringen aan de documentatie behoren tot de meest waardevolle bijdragen die je kunt leveren.