Hva administrerer du i tillegg til dokumentet?
Et dokument er bare én måte å dokumentere en beslutning på. Du må også vite hvilke punkter det er enighet om, hvilke som fortsatt er forslag, hvem som skal svare på spørsmål, og hva som endres når et punkt revideres. Dette bidrar til å unngå at man arbeider ut fra ulike tolkninger av samme forespørsel.
Den samme tilnærmingen kan hjelpe med apputvikling, interne verktøy, produktvilkår og driftsregler. Start med én funksjon eller arbeidsflyt i stedet for å forsøke å dokumentere alt på én gang.
Koble sammen mål, krav, spesifikasjon og akseptansekriterier
Team bruker disse begrepene på forskjellige måter. I dette eksemplet beskriver et krav et ønsket resultat eller en begrensning, en spesifikasjon dokumenterer avtalt atferd, og akseptansekriterier forklarer hvordan dette skal kontrolleres. Bli enige om disse betydningene med dem du samarbeider med.
Mål: redusere manuell transkribering
Den månedlige rapporteringsprosessen innebærer i dag at oppføringer kopieres manuelt. Hensikten med eksport er å gjøre dette arbeidet enklere.
Krav: eksporter oppføringene som trengs til rapporten
En medarbeider må eksportere oppføringene for en valgt måned, innenfor det vedkommende har tilgang til.
Spesifikasjon: definer filen og hvordan den skal fungere
Bli enige om kolonner, rekkefølge, tekstkoding, datoformat, håndtering av tomme resultater og feil. Dette er valg for dette eksemplet, ikke universelle standardinnstillinger.
Akseptansekriterier: gjør resultatet etterprøvbart
Klargjør oppføringer med kjente datoer og tillatelser, utfør eksporten, og sammenlign resultatet med det dere har avtalt.
Skriv én etterprøvbar idé per punkt
En formulering som «Gjør eksport praktisk» lar viktige valg stå åpne. Skill mellom å velge en periode, velge utdatafelt, håndtere tilfeller uten treff og kontrollere tilgang når disse punktene kan endres eller verifiseres uavhengig av hverandre.
Bruk konkrete betingelser i stedet for ord som «rask» eller «enkel». Hvis et mål for responstid er viktig, registrerer du arbeidsbelastning, miljø og målemetode i tillegg til tallet. Merk verdier som ikke er bestemt, tydelig som ubestemte.
Før: «Tillat CSV-eksport.»
Etter: «Eksporter den valgte måneden med de avtalte kolonnene og sorteringsrekkefølgen. Definer tomme resultater og tilgangskontroller som egne punkter.»
Den reviderte formuleringen viser hvilke valg man må bli enige om, og gjør det enklere å fordele og gjennomgå arbeidet. Det trengs fortsatt konkrete feltdefinisjoner før implementering.
Et lite sett med felt å starte med
ID, tittel og beskrivelse
Gi hvert element en stabil ID, for eksempel REQ-001. Oppgi emne, betingelse og forventet resultat. En stabil ID gjør det mulig å vise til elementet også etter at tittelen er endret.
Årsak og kilde
Registrer hvilket problem elementet løser, og hvor det kommer fra, for eksempel en samtale, en forespørsel eller et støttedokument.
Prioritet og omfang
Skill mellom det som trengs til denne utgivelsen, og det som kan vente. Forklar hvorfor noe har prioritet; ikke gi alt høyeste prioritet.
Ansvarlig og beslutningsstatus
Registrer hvem som skal avklare elementet, og om det er et utkast, under gjennomgang eller godkjent. Den som gjennomfører arbeidet, og den som godkjenner det, kan være forskjellige personer.
Akseptansekriterier og tilhørende informasjon
Knytt elementet til relevante spesifikasjoner, design, oppgaver og kontrollrapporter. Hold koblingene oppdatert når kravene endres.
Eksempel: tre krav til månedlig CSV-eksport
Følgende er et illustrerende eksempel. Feltnavn og virkemåte bør avtales for produktet du utvikler; eksemplet er ikke en fullstendig spesifikasjon for alle eksportfunksjoner.
REQ-001: oppføringer for den valgte måneden
Eksempel på spesifikasjon: Bruk den valgte måneden i den avtalte tidssonen for virksomheten, og eksporter ID, registreringsdato og tittel i UTF-8, sortert først etter dato og deretter ID. Eksempel på akseptansekriterium: Tre samsvarende poster gir én overskriftsrad og nøyaktig disse tre dataradene, uten poster fra andre måneder.
REQ-002: ingen samsvarende oppføringer
Eksempel på spesifikasjon: Eksporter den avtalte overskriftsraden selv når ingen oppføringer samsvarer. Eksempel på akseptanse: Et tomt testdatasett gir en fil med denne overskriften og ingen datarader. Hvis du foretrekker en melding fremfor en fil, må dere bli enige om og dokumentere denne alternative oppførselen.
REQ-003: tilgang kontrolleres før eksport
Eksempel på spesifikasjon: Brukere uten eksporttillatelse kan ikke generere filen, og oppføringer utenfor det tillatte omfanget blir ikke inkludert. Akseptanseeksemplene bør omfatte en bruker uten eksporttillatelse og en bruker som bare har tilgang til et begrenset utvalg oppføringer.
Bruk hierarki uten å miste de enkelte beslutningene
Grupper elementer etter formål eller funksjon, og legg deretter detaljerte betingelser under riktig gruppe. For eksempel: Rapportering → Månedlig CSV-eksport → Aktuelle poster / Filformat / Tomme resultater / Tilgang. Legg bakgrunnsinformasjon og åpne spørsmål i notater i stedet for å blande dem inn i ett langt krav.
Hvis én betingelse påvirker flere funksjoner, bør du ha en tydelig henvisning til den avtalte versjonen i stedet for å kopiere ulike versjoner inn i hver del. Kontroller hvilke etterfølgende spesifikasjoner og kontrollpunkter som er avhengige av den før du endrer den.
Hold enighet, implementering og verifisering atskilt
«Avtalt» betyr at innholdet er godkjent for det tiltenkte omfanget. Det betyr ikke at funksjonen er implementert. «Implementert» bekrefter ikke at de avtalte akseptkriteriene er oppfylt, eller at funksjonen er lansert. Sørg for at disse forskjellene er synlige, selv om du bruker en enkel statusliste.
Gå gjennom normaltilfellet, tomme eller manglende inndata, tillatelser og eksterne feil der det er relevant. Bestem hvilken dokumentasjon som skal beholdes, hvem som kontrollerer den, og hvem som kan avslutte et uavklart spørsmål.
Registrer en endring og konsekvensene av den før du anser den som avtalt
En ny forespørsel er et forslag inntil de ansvarlige er enige om hvordan den skal håndteres. Registrer årsaken til endringen, berørte ID-er og konsekvensene for arbeid, datoer, spesifikasjoner og verifisering. Vurder også om endringen gjelder poster eller brukere som allerede benytter funksjonen.
Etter beslutningen må du oppdatere den gjeldende spesifikasjonen og varsle de berørte personene. Ta vare på den forrige avtalte versjonen eller et endringsnotat når du må forklare hva som er endret. Ikke anta at et verktøy automatisk registrerer alle godkjenninger og revisjoner.
Velg et sted du kan holde oppdatert
For en liten liste kan et delt dokument eller regneark være nok. Når diskusjon, implementering og verifisering er fordelt på flere verktøy, bør du velge én hovedreferanse og lenke til relatert materiale derfra. Det viktige er at alle kan finne det gjeldende, avtalte innholdet.
Bruk AI til et utkast, og bekreft deretter beslutningene
KI kan hjelpe med å liste opp mulige krav, strukturere et utkast og foreslå spørsmål som mangler. Skill mellom bekreftede fakta og antakelser i instruksjonen, og be om at uavklarte verdier blir stående som spørsmål. Gå gjennom resultatet med dem som kjenner den tiltenkte bruken.
I ReqSpec AI kan du organisere krav og spesifikasjoner hierarkisk og bruke AI som støtte til oppretting, redigering og kontroll. Still et konkret spørsmål som «Hvilke betingelser for tomme resultater er fortsatt udefinerte?» Behandle hvert svar som et forslag som må verifiseres mot det registrerte innholdet, ikke som bevis på godkjenning eller fullstendighet.
Begynn med én funksjon og én gjennomgang
Velg én funksjon, list opp de ønskede resultatene, gi punktene ID-er og legg til akseptansekriterier og åpne spørsmål. Gå gjennom dette én gang med en relevant person, og registrer deretter beslutningene og hvem som har neste ansvar. Et lite sett som vedlikeholdes, er mer nyttig enn et stort dokument som ingen oppdaterer.
Organiser krav og spesifikasjoner med ReqSpec AI
ReqSpec AI gjør det enkelt å organisere krav og spesifikasjoner på mobil og nett. Utforsk funksjonene på appsiden.