Specificatie-eerst werkwijze
Definieer vereisten voordat je code schrijft.
OpenSpecSpecificatiegedreven ontwikkeling voor AI-assistenten
Een lichtgewicht specificatie voor het bouwen en beheren van AI-assistentenprojecten.
Een lichtgewicht specificatie voor het bouwen en beheren van AI-assistentenprojecten.
Welkom. Dit is de centrale plek voor alles wat met OpenSpec te maken heeft.
OpenSpec helpt jou en je AI-coderingassistent overeenstemming te bereiken over wat er gebouwd moet worden voordat er überhaupt code wordt geschreven. Je beschrijft de wijziging, de AI stelt een korte specificatie en een takenlijst op, jullie kijken samen naar hetzelfde plan en daarna gaat het werk van start. Geen verrassingen meer halverwege dat de AI het verkeerde ding heeft gebouwd.
Als je niets anders leest, lees dan deze twee pagina's:
/opsx:propose intypt (tip: in je AI-chat, niet in de terminal). Dit zorgt bij bijna iedereen een keer voor verwarring.Die tweede pagina is belangrijker dan het lijkt. OpenSpec bestaat uit twee onderdelen: een opdrachtregelgereedschap dat je in je terminal uitvoert, en slashopdrachten die je aan je AI-assistent geeft. Weten wat het verschil is, bespaart je de meest voorkomende verwarring.
De beste gewoonte om eerst te ontwikkelen: als je niet zeker weet wat je moet bouwen, begin dan met
/opsx:explore. Het is een risicoloze denkpartner die je code leest, opties afweegt en een vaag idee aanscherpt tot een concreet plan voordat er enig artefact of code bestaat. De Eerst verkennen-gids legt uit waarom dit werkt.
Ik ben helemaal nieuw. Begin met Aan de slag, blader daarna door Kernconcepten in een oogopslag. Wanneer iets onduidelijk is, vind je het FAQ en Woordenlijst vlakbij.
Ik heb een probleem maar geen plan. Dit is de meest voorkomende situatie, en er is een specifiek antwoord voor: Eerst verkennen. Gebruik /opsx:explore om het met de AI te doordenken voordat je je op iets vastlegt.
Ik heb een grote bestaande codebase. Je hoeft niet de hele codebase te documenteren. OpenSpec gebruiken in een bestaand project toont hoe je begint met echte, brownfield-code zonder de zee te koken.
Ik wil het gewoon laten werken. Installeer, voer openspec init uit, en lees daarna Hoe opdrachten werken zodat je eerste slashopdracht op de juiste plek landt.
Ik leer aan de hand van voorbeelden. De pagina Voorbeelden & Recepten behandelt echte wijzigingen van begin tot eind: een kleine functie, een bugfix, een refactor, een verkenning.
De AI heeft zojuist een plan opgesteld — wat nu? Lees het. Een wijziging beoordelen laat de twee-minutencontrole zien die een verkeerde bocht opvangt terwijl dit nog weinig moeite kost, en Goede specificaties schrijven behandelt waar een plan dat het waard is om goed te keuren, uit bestaat.
Ik werk in een team. OpenSpec in een team laat zien hoe een wijziging wordt toegewezen aan een branch en een pull request, en hoe teamleden een plan beoordelen voordat er code wordt geschreven.
Ik kom uit de oude werkwijze. De Migratiegids legt uit wat er is veranderd en waarom, en belooft dat je bestaande werk veilig is.
Ik wil het aanpassen aan het werkproces van mijn team. Aanpassing behandelt projectconfiguratie, aangepaste schema's en gedeelde context.
Er gaat iets mis. Problemen oplossen verzamelt de fouten die mensen daadwerkelijk tegenkomen, met oplossingen.
| Document | Wat geeft het je? |
|---|---|
| Aan de slag | Installeer, initialiseer en voer je eerste wijziging volledig uit |
| Eerst verkennen | Gebruik /opsx:explore om een idee te doordenken voordat je je erop vastlegt |
| Hoe opdrachten werken | Waar slashopdrachten worden uitgevoerd, wat "interactieve modus" betekent, terminal versus chat |
| Kernconcepten in een oogopslag | Het volledige mentale model op één pagina: specificaties, wijzigingen, delta's, archief |
| Installatie | npm, pnpm, yarn, bun, Nix en hoe je controleert of het werkt |
| Document | Wat geeft het je? |
|---|---|
| Werkwijzen | Veelvoorkomende patronen en wanneer je welke opdracht gebruikt |
| Voorbeelden & Recepten | Volledige uitleg van echte wijzigingen, klaar om te kopiëren en plakken |
| Goede specificaties schrijven | Hoe een sterke vereiste en scenario eruitzien, en hoe je een wijziging de juiste omvang geeft |
| Een wijziging beoordelen | De twee-minutencontrole van een opgesteld plan voordat er code wordt geschreven |
| OpenSpec in een team | Hoe wijzigingen passen bij branches, pull requests en beoordeling |
| OpenSpec gebruiken in een bestaand project | OpenSpec adopteren op een grote, bestaande codebase |
| Een wijziging bewerken en herhalen | Artefacten bijwerken, teruggaan, handmatige bewerkingen verenigen |
| Opdrachten | Naslagwerk voor elke /opsx:*-slashopdracht |
| CLI | Naslagwerk voor elke openspec-terminalopdracht |
| Document | Wat geeft het je? |
|---|---|
| Concepten | De lange uitleg van specificaties, wijzigingen, artefacten, schema's en archief |
| OPSX-werkwijze | Waarom de werkwijze flexibel is in plaats van gefaseerd, plus een diepgaande architectuuranalyse |
| Woordenlijst | Elke term op één plek gedefinieerd |
| Document | Wat geeft het je? |
|---|---|
| Aanpassing | Projectconfiguratie, aangepaste schema's, gedeelde context |
| Meertalig | Genereer artefacten in andere talen dan Engels |
| Ondersteunde gereedschappen | De 25+ AI-gereedschappen waarmee OpenSpec integreert, en waar bestanden terechtkomen |
| Document | Wat geeft het je? |
|---|---|
| Veelgestelde vragen | Snelle antwoorden op de meest gestelde vragen |
| Problemen oplossen | Concrete oplossingen voor concrete fouten |
| Migratiegids | Overstappen van de verouderde werkwijze naar OPSX |
| Document | Wat geeft het je? |
|---|---|
| Stores: Gebruikershandleiding | Maak een plan in een eigen repository als je werk over repositories of teams heen gaat |
| Agentcontract | De machine-leesbare CLI-oppervlakken die agents aansturen |
1. Install npm install -g @fission-ai/openspec@latest
2. Initialize cd your-project && openspec init
3. Explore (in your AI chat) /opsx:explore ← optional, but a great habit
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:archiveStappen 1 en 2 gebeuren in je terminal. De rest gebeurt in de chat van je AI-assistent. Die splitsing is het enige waard om te onthouden, en Hoe opdrachten werken legt precies uit waarom. Stap 3 is optioneel, maar beginnen met /opsx:explore als je niet zeker weet, is de gewoonte die het meest waard is om te ontwikkelen.
openspec feedback "je bericht" verzendt feedback direct vanuit je terminal (het opent een GitHub-issue).Heb je iets in deze documentatie gevonden dat fout is, verouderd of verwarrend? Dat is een bug. Open een issue of een PR. Verbeteringen aan de documentatie behoren tot de meest waardevolle bijdragen die je kunt doen.