Introductie
Het schrijven van duidelijke, consistente en testbare eisen is een van de meest cruciale stappen in het requirements engineering-proces. Slecht geschreven eisen leiden vaak tot projectvertragingen, kostenoverschrijdingen, complianceproblemen en zelfs systeemstoringen. Om deze uitdaging aan te gaan, heeft de International Council on Systems Engineering (INCOSE) de wereldwijd erkende INCOSE Guide to Writing Requirements ontwikkeld, een gestructureerd raamwerk met bewezen methoden, voorbeelden en best practices voor het opstellen van hoogwaardige eisen.
De INCOSE Requirements Writing Guide wordt breed toegepast in sectoren zoals de lucht- en ruimtevaart, defensie, automotive, gezondheidszorg en IT en helpt organisaties een gemeenschappelijke standaard te ontwikkelen voor het definiëren, valideren en beheren van requirements. Door de principes voor requirementsspecificatie te volgen, kunnen projectteams ervoor zorgen dat requirements niet alleen duidelijk en ondubbelzinnig zijn, maar ook verifieerbaar, traceerbaar en afgestemd op de behoeften van stakeholders.
In dit artikel bespreken we wat de INCOSE Guide to Writing Requirements is, waarom deze belangrijk is, welke stapsgewijze richtlijnen, controlelijsten en voorbeelden het bevat en hoe organisaties deze werkwijzen kunnen integreren in hun requirements lifecycle management.
De INCOSE-gids begrijpen
Achtergrondinformatie over INCOSE (International Council on Systems Engineering)
De International Council on Systems Engineering (INCOSE) is een wereldwijde professionele organisatie die zich toelegt op het bevorderen van best practices in systems engineering. Met leden in de VS, Europa, Azië en andere regio's ontwikkelt INCOSE standaarden, raamwerken en richtlijnen die organisaties helpen bij het ontwerpen, ontwikkelen en beheren van complexe systemen. Een van de meest waardevolle bronnen is de INCOSE Guide to Writing Requirements, die dé maatstaf is geworden voor het definiëren en documenteren van effectieve vereisten in grootschalige, veiligheidskritische en Agile-gedreven projecten.
Doel van de INCOSE-gids voor schrijfvereisten (PDF)
De INCOSE Guide to Writing Requirements (PDF) is ontwikkeld om een terugkerend probleem in projecten aan te pakken: slecht geschreven, vage of niet-testbare vereisten. Het doel is om:
- Stel best practices vast voor het schrijven van duidelijke, ondubbelzinnige en testbare vereisten.
- Zorg voor een gestructureerde checklist en voorbeelden voor het valideren van de vereiste kwaliteit.
- Zorg voor traceerbaarheid en verificatie gedurende de gehele levenscyclus van de vereisten.
- Help organisaties om veelvoorkomende fouten bij het definiëren van vereisten te voorkomen, die vaak leiden tot kostbare projectrisico's.
Hoe het de INCOSE Systems Engineering Handbook aanvult
De INCOSE Systems Engineering Handbook biedt een breed overzicht van de principes van systems engineering, inclusief processen voor requirements engineering, verificatie en validatie. Het gaat echter niet in op de details over het daadwerkelijk schrijven van effectieve requirements.
De INCOSE Guide to Writing Requirements vult deze leemte door het volgende te bieden:
- Gedetailleerde voorbeelden van goed en slecht geschreven vereisten.
- Praktische regels voor duidelijkheid, volledigheid en testbaarheid van eisen.
- Stapsgewijze instructies voor het structureren van requirements statements.
Samen vormen de handleiding en de gids een compleet raamwerk voor zowel het begrijpen van systeemtechniek als het praktisch toepassen van normen voor het opstellen van eisen.
Voordelen van het gebruik van INCOSE-vereistenrichtlijnen
Organisaties die de INCOSE-richtlijnen hanteren, profiteren van verschillende voordelen:
- Verbeterde vereiste kwaliteit → minder onduidelijkheden en verkeerde interpretaties.
- Hogere nalevingsbereidheid → in overeenstemming met de industriële en wettelijke normen.
- Minder projectrisico's en kosten → minder fouten bij het ontwerpen, testen en implementeren.
- Verbeterde samenwerking → gemeenschappelijke taal voor ingenieurs, analisten en belanghebbenden.
- Sterker beheer van de levenscyclus van vereisten → duidelijke traceerbaarheid van definitie tot verificatie.
Pro Tip: Wanneer teams deze combineren met een tool voor requirements management, zoals het Visure Requirements ALM Platform, kunnen ze de validatie, traceerbaarheid en versiebeheer van requirements automatiseren en zo de naleving van INCOSE-richtlijnen versnellen.
Kernprincipes voor het schrijven van goede vereisten
INCOSE Definitie van een goede vereiste
Volgens de INCOSE Guide to Writing Requirements is een goede vereiste een vereiste die:
- Nodig → direct gekoppeld aan de behoeften van belanghebbenden of systemen.
- Duidelijk en eenduidig → geschreven in begrijpelijke taal, waarbij vage termen worden vermeden.
- uitvoerbaar → technisch en economisch haalbaar.
- Verifieerbaar en testbaar → meetbaar door inspectie, analyse, demonstratie of testen.
- traceerbaar → gekoppeld aan hogere eisen en stroomafwaartse systeemelementen.
Deze definitie zorgt ervoor dat eisen bijdragen aan de levenscyclus van requirements engineering en de risico's tijdens de projectuitvoering verminderen.
Kenmerken van hoge kwaliteitseisen
Vereisten van hoge kwaliteit zijn gebaseerd op een reeks kenmerken die breed worden gepromoot door de richtlijnen voor vereisten van INCOSE en best practices voor requirements engineering:
- Clarity – geen ruimte voor meerdere interpretaties.
- Volledigheid – alle noodzakelijke aspecten bestrijkend, zonder details te missen.
- Consistentie – afgestemd op andere vereisten, waarbij tegenstrijdigheden worden vermeden.
- controleerbaarheid – gedefinieerd in meetbare termen om validatie mogelijk te maken.
- Traceerbaarheid – verbonden in het hele requirements lifecycle managementproces.
Pro Tip: Gebruik altijd meetbare criteria zoals ‘minstens’, ‘niet meer dan’, ‘binnen X seconden’ in plaats van vage termen zoals ‘snel’, ‘gebruiksvriendelijk’ of ‘gemakkelijk’.
Validatie en verificatie van vereisten (INCOSE-benadering)
INCOSE benadrukt dat elke vereiste een validatie en verificatie (V&V) moet ondergaan:
- Validatie zorgt ervoor dat de vereiste overeenkomt met de werkelijke behoeften van de belanghebbenden.
- Bij verificatie wordt gecontroleerd of de eis kan worden getoetst of aangetoond.
Met dit beoordelingsproces van de vereisten worden fouten tot een minimum beperkt, doordat wordt bevestigd dat de vereisten zowel juist zijn (validatie) als correct zijn geformuleerd (verificatie).
Veelvoorkomende fouten die u moet vermijden bij het schrijven van vereisten
Zelfs ervaren ingenieurs maken fouten bij het opstellen van eisen. Volgens de best practices van INCOSE zijn de meest voorkomende fouten:
- Het gebruik van dubbelzinnige taal (bijvoorbeeld ‘zo spoedig mogelijk’, ‘voldoende snel’).
- Het formuleren van meerdere eisen in één verklaring leidt tot verwarring.
- Het combineren van ontwerpdetails met eisen (implementatie versus behoefte).
- Er is geen garantie dat de vereisten gedurende de hele levenscyclus traceerbaar zijn.
- Het negeren van de testbaarheid, wat resulteert in oncontroleerbare vereisten.
Pro Tip: Gebruik de checklist voor het schrijven van INCOSE-vereisten tijdens peer reviews om dubbelzinnigheid op te sporen, duidelijkheid te waarborgen en naleving te verbeteren.
INCOSE Best Practices voor het schrijven van vereisten
De INCOSE Guide to Writing Requirements biedt een praktisch kader voor het opstellen van duidelijke, testbare en op belanghebbenden gerichte vereisten. Het toepassen van deze best practices vermindert miscommunicatie, versnelt de naleving en zorgt voor end-to-end requirements lifecycle management.
Do's en don'ts bij het schrijven van effectieve vereisten
Do's:
- Gebruik duidelijke en beknopte taal, zonder vakjargon, tenzij anders gedefinieerd.
- Schrijf één eis per stelling om verwarring te voorkomen.
- Zorg ervoor dat elke vereiste verifieerbaar, traceerbaar en haalbaar is.
- Gebruik consistente terminologie in het hele document.
- Gebruik kwantificeerbare metingen in plaats van subjectieve termen.
don'ts:
- Gebruik geen dubbelzinnige woorden zoals “gebruiksvriendelijk”, “zo spoedig mogelijk” of “ongeveer”.
- Combineer ontwerpdetails niet met eisen (houd oplossingsonafhankelijk).
- Stel geen te brede eisen op die niet getest kunnen worden.
- Dupliceer geen vereisten, aangezien dit conflicten kan veroorzaken in systemen voor vereistenbeheer.
Pro Tip: Combineer de Do's en Don'ts met de checklist voor het schrijven van INCOSE-vereisten tijdens beoordelingen, zodat u fouten vroegtijdig kunt ontdekken.
Structureringsvereisten voor duidelijkheid
Goed gestructureerde requirements volgen een consistente opmaak en syntaxis, die vaak worden aanbevolen door requirements engineering software. INCOSE adviseert het volgende:
- Unieke identificatiegegevens voor elke vereiste (ter ondersteuning van traceerbaarheid).
- Een gestandaardiseerde sjabloon (bijv. “Het [systeem/subsysteem] moet [X doen] binnen [prestatie-criteria].”)
- Groeperen van vereisten op basis van functionaliteit, prestaties en beperkingen.
Deze gestructureerde aanpak garandeert dat de levenscyclus van de vereisten wordt bestreken, van de definitie tot en met de verificatie.
SMART-vereisten opstellen (specifiek, meetbaar, haalbaar, relevant, tijdsgebonden)
Het SMART-model, afgestemd op de INCOSE-richtlijnen, versterkt de kwaliteit van de vereisten:
- specifiek → Geeft duidelijk de functie of behoefte aan.
- Meetbaar → Bevat kwantificeerbare statistieken.
- Haalbare → Realistisch binnen technische en budgettaire beperkingen.
- Relevant → Direct gekoppeld aan stakeholder- of systeemdoelen.
- Tijdsgebonden → Definieert het tijdsbestek voor de uitvoering.
Voorbeeld:
- “Het systeem zal snel laden.”
- “Het systeem moet het dashboard binnen 3 seconden na het inloggen laden onder standaard netwerkcondities.”
Voorbeelden uit de INCOSE Requirements Writing Checklist
Met de checklist voor het schrijven van INCOSE-vereisten kunnen teams de kwaliteit evalueren voordat ze deze valideren:
- Heeft elke vereiste een unieke identificatie?
- Is de eis eenduidig en slechts voor één uitleg vatbaar?
- Kan dit geverifieerd worden door middel van testen, demonstraties of analyses?
- Is het in overeenstemming met de hogere systeemvereisten?
- Worden onnodige ontwerpbeperkingen vermeden?
Pro Tip: Veel organisaties combineren de INCOSE-checklist met hulpmiddelen zoals het Visure Requirements ALM Platform om de validatie en traceerbaarheid van vereisten te automatiseren. Zo besparen ze tijd bij projecten waarbij naleving een belangrijke rol speelt (bijvoorbeeld in de lucht- en ruimtevaart, automobielindustrie en medische apparatuur).
Stapsgewijs proces: hoe u vereisten schrijft met behulp van de INCOSE-richtlijnen
De INCOSE Guide to Writing Requirements biedt een duidelijke, systematische aanpak om ervoor te zorgen dat requirements goed gedefinieerd, traceerbaar en verifieerbaar zijn gedurende de gehele levenscyclus van requirements engineering. Hieronder vindt u de aanbevolen stapsgewijze workflow:
Eisen verzamelen en analyseren
- Begin met het verzamelen van de behoeften van belanghebbenden, klanten, regelgevende instanties en eindgebruikers.
- Pas agile requirements elicitation-technieken of gestructureerde interviews, workshops en enquêtes toe.
- Analyseer en prioriteer vereisten om ervoor te zorgen dat deze aansluiten bij de projectdoelstellingen.
Pro Tip: Gebruik een tool voor het verzamelen van vereisten (bijvoorbeeld Visure Requirements ALM Platform) om invoer te centraliseren en misinterpretaties te beperken.
Het opstellen van eisenverklaringen
- Beschrijf elke eis als één beknopte verklaring.
- Gebruik het standaard INCOSE-formaat: “Het [systeem/subsysteem] moet [X doen] binnen [prestatie-criteria].”
- Vermijd vage taal en zorg voor duidelijke specificaties van de vereisten.
Voorbeeld (goed): “Het systeem moet 1,000 transacties per seconde verwerken met een nauwkeurigheid van 99.9%.”
Voorbeeld (slecht): “Het systeem moet transacties snel verwerken.”
Zorgen voor duidelijkheid en traceerbaarheid
- Wijs aan elke vereiste een unieke identificatie toe.
- Zorg voor bidirectionele traceerbaarheid tussen vereisten-, ontwerp-, test- en nalevingsdocumenten.
- Gebruik een Requirements Traceability Matrix (RTM) of automatisering via een Requirements Engineering Tool.
Pro Tip: Duidelijke traceerbaarheid zorgt ervoor dat aan alle vereisten van begin tot eind wordt voldaan, wat van cruciaal belang is voor veiligheidsgerelateerde sectoren zoals de lucht- en ruimtevaart, defensie en medische apparatuur.
Validatie en verificatie met belanghebbenden
- Validatie → Bevestig dat de vereiste daadwerkelijk aansluit bij de behoeften van de belanghebbenden.
- Verificatie → Zorg ervoor dat de vereiste kan worden getest, gedemonstreerd en geanalyseerd.
- Betrek belanghebbenden bij beoordelingen en rondleidingen om de nauwkeurigheid te bevestigen.
Met deze stap worden kostbare wijzigingen in de laatste fase voorkomen en wordt de naleving gewaarborgd.
5. Iteratie- en beoordelingsproces
- Voer peer reviews en vereisteninspecties uit met behulp van de INCOSE-checklist voor het schrijven van vereisten.
- Verfijn de vereisten door middel van iteratieve feedbackloops.
- Werk de documentatie bij volgens de best practices voor versiebeheer van de vereisten.
Pro Tip: Door het beoordelings- en versiebeheerproces te automatiseren met platforms zoals Visure, blijft de naleving van Agile-, V-Model- en hybride ontwikkelingscycli gewaarborgd.
Door het stapsgewijze vereistenschrijfproces van INCOSE te volgen, weet u zeker dat de vereisten duidelijk, ondubbelzinnig, testbaar en traceerbaar zijn. Zo worden risico's verminderd en de projectresultaten verbeterd.
Voorbeelden en sjablonen
De INCOSE-gids voor het schrijven van requirements benadrukt dat requirements duidelijk, testbaar en gestructureerd moeten zijn. Door voorbeelden te bestuderen en gestandaardiseerde sjablonen toe te passen, kunnen teams consistentie garanderen gedurende de gehele levenscyclus van requirements engineering.
Voorbeeldvereisten (goed versus slecht)
Slecht voorbeeld (dubbelzinnig):
- “Het systeem moet gebruiksvriendelijk zijn.”
- Probleem: Dubbelzinnig, subjectief, niet meetbaar.
Goed voorbeeld (in lijn met de beste praktijken van INCOSE):
- “Het systeem moet gebruikers in staat stellen het inlogproces binnen 5 seconden te voltooien onder standaard netwerkomstandigheden.”
- Oplossing: Duidelijk, meetbaar, testbaar en verifieerbaar.
Pro Tip: Vervang vage bijvoeglijke naamwoorden (‘snel’, ‘veilig’, ‘robuust’) altijd door kwantificeerbare prestatiegegevens.
Het gebruik van de INCOSE-schrijfvereistenvoorbeelden
De INCOSE Requirements Writing Guide biedt talloze voorbeelden van slecht en goed geschreven vereisten. Deze voorbeelden laten zien hoe kleine wijzigingen in de formulering de duidelijkheid, traceerbaarheid en testbaarheid drastisch kunnen verbeteren.
- Arm: “Het apparaat mag niet te veel stroom verbruiken.”
- Verbeterd (INCOSE-voorbeeld): “Het apparaat mag niet meer dan 5 W verbruiken in de ruststand en 15 W tijdens piekbedrijf.”
Deze verschuiving is afgestemd op de best practices voor het valideren en verifiëren van vereisten.
Sjablonen en opmaakaanbevelingen
Om consistentie te garanderen, adviseren de INCOSE-gids en de requirements engineering tools om gestructureerde sjablonen te gebruiken:
- Sjabloonvoorbeeld:
- Het [systeem/subsysteem/component] moet [actie/gedrag] [prestatie criteria] [voorwaarden/beperkingen] hebben.
- Opmaakaanbevelingen:
- Wijs aan elke traceerbaarheidsvereiste een unieke identificatiecode toe.
- Groepeer de vereisten in categorieën: functioneel, prestatie, veiligheid, regelgeving.
- Gebruik tabellen, nummeringssystemen en koppen voor een betere leesbaarheid.
Pro Tip: Gebruik de checklist voor het schrijven van INCOSE-vereisten en sjablonen om te controleren of elke vereiste aan de kwaliteitsnormen voldoet.
Hoe u de INCOSE-richtlijnen kunt aanpassen aan verschillende sectoren
De INCOSE Guide to Writing Requirements PDF is ontworpen voor toepassing in verschillende sectoren, maar aanpassing zorgt voor afstemming op domeinspecifieke normen:
- Ruimtevaart en Defensie: Pas strengere veiligheidseisen toe en voldoe aan DO-178C, ARP4754A.
- Automotive: Pas de vereisten voor functionele veiligheid volgens ISO 26262 aan.
- Medische apparaten: Zorg voor afstemming op FDA, IEC 62304 voor software in medische apparaten.
- IT- en Agile-projecten: Gebruik de INCOSE-richtlijnen in combinatie met Agile-praktijken voor het verzamelen van vereisten, zoals gebruikersverhalen en acceptatiecriteria.
Deze flexibiliteit zorgt ervoor dat de INCOSE-richtlijnen universeel toepasbaar zijn in gereguleerde en Agile-gedreven sectoren.
Pro Tip: Voor grote organisaties zorgt de combinatie van INCOSE-sjablonen met een oplossing voor requirements management zoals het Visure Requirements ALM Platform voor een end-to-end dekking van de vereisten, versiebeheer en automatisering van de naleving.
Hulpmiddelen, training en bronnen
Effectieve implementatie van de INCOSE Guide to Writing Requirements gaat verder dan alleen het lezen van het document; het vereist praktische training en de juiste tools voor requirements management om acceptatie en succes op lange termijn te garanderen. Hieronder vindt u enkele van de meest waardevolle bronnen die professionals en organisaties kunnen helpen hun requirements engineering-praktijken te verbeteren.
INCOSE-vereisten Trainingscursussen
- Visure Master Training in het schrijven van veiligheidskritische vereisten – Deze training is speciaal ontwikkeld voor sectoren zoals de lucht- en ruimtevaart, defensie, automobielindustrie en medische apparatuur en voorziet teams van geavanceerde vaardigheden om hoogwaardige, veiligheidskritische vereisten te schrijven. De training richt zich op het vermijden van veelvoorkomende fouten en het toepassen van best practices voor de levenscyclus van vereisten.
- Webinar over de INCOSE-handleiding voor het schrijven van vereisten – Deze training, aangeboden door INCOSE, laat deelnemers kennismaken met versie 4 van de INCOSE-gids, waarin de bijgewerkte principes, voorbeelden en validatietechnieken worden behandeld.
- INCOSE Requirements Writing Guide (Samenvattingsblad, versie 4) – Een beknopte samenvatting van de meest recente INCOSE-vereistenrichtlijnen, die een snel naslagwerk vormen voor engineers en analisten.
Pro Tip: Door de formele INCOSE-training te combineren met branchegerichte cursussen zoals Visure's Safety-Critical Requirements Writing worden zowel de theoretische kennis als de praktische toepassing gemaximaliseerd.
Aanbevolen hulpmiddelen voor vereistenbeheer
Om de best practices van INCOSE te kunnen implementeren, hebben organisaties behoefte aan platforms voor requirements management die het volgende ondersteunen:
- Traceerbaarheid gedurende de volledige levenscyclus van vereisten
- Versiebeheer en wijzigingsbeheer
- Samenwerking tussen cross-functionele teams
- Compliance-klare sjablonen voor gereguleerde sectoren
Enkele van de belangrijkste hulpmiddelen zijn:
- Visuele vereisten ALM-platform – Een op AI gebaseerde oplossing voor requirements engineering die end-to-end levenscyclusdekking, live traceerbaarheid, geautomatiseerde kwaliteitscontroles en nalevingsondersteuning biedt en daarmee de beste keuze is voor INCOSE-afstemming.
- IBM DEUREN – Een verouderde tool voor requirementsmanagement die veel wordt gebruikt in grote ondernemingen, maar die vaak als minder flexibel wordt gezien in vergelijking met moderne platforms.
- Valiruimte – Een tool voor requirements- en systems engineering, gericht op agile samenwerking in hardware- en systeemprojecten.
Pro Tip: Voor organisaties die de INCOSE-richtlijnen hanteren, zorgt de combinatie van het Visure Requirements ALM Platform met INCOSE-training ervoor dat zowel de methodologie als de technologie op orde zijn voor succes.
Conclusie
De INCOSE Guide to Writing Requirements blijft de wereldwijde standaard voor het opstellen van duidelijke, ondubbelzinnige, verifieerbare en traceerbare vereisten. Door de principes ervan te volgen, ondersteund door voorbeelden, sjablonen en checklists, kunnen organisaties veelvoorkomende fouten vermijden, de naleving versterken en de volledige levenscyclus van vereisten bestrijken. Of ze nu worden toegepast in de lucht- en ruimtevaart, automotive, defensie, medische apparatuur of IT, de INCOSE-richtlijnen bieden een gestructureerde basis voor het specificeren en beheren van vereisten.
Hoewel de gids de regels en best practices biedt, halen organisaties de meeste waarde uit het combineren van deze standaarden met een krachtige tool voor requirements management. Dit is waar het Visure Requirements ALM Platform zich onderscheidt, met AI-ondersteuning, geautomatiseerde traceerbaarheid, compliance-ready templates, versiebeheer en end-to-end requirements lifecycle management, afgestemd op INCOSE.
Check out de 14 dagen gratis proefperiode bij Visure en ervaar hoe u het succes van uw project kunt vergroten door de INCOSE Guide to Writing Requirements te combineren met de AI-gestuurde requirements management-oplossing van Visure.