AnswersPublished14 sources
Een werkbare structuur voor tests, specificaties en plannen
Tests kunnen meestal centraal staan, maar Go tests die niet geëxporteerde code controleren, horen vaak bij het geteste pakket. Specificaties beschrijven wat nu geldt; ADR’s leggen vast waarom een belangrijke keuze is gemaakt.
Gepubliceerd doorAfbeeldingen gegenereerd met GPT Image 2
Research answer
Key takeaways
- Tests kunnen meestal centraal staan, maar Go tests die niet geëxporteerde code controleren, horen vaak bij het geteste pakket.
- Specificaties beschrijven wat nu geldt; ADR’s leggen vast waarom een belangrijke keuze is gemaakt.
- Een bevroren plan is niet hetzelfde als een afgerond plan: openstaande werkzaamheden moeten zichtbaar blijven.
- Ruim tijdelijke bestanden op zonder het enige bewijs te verwijderen waarop een besluit of acceptatie steunt.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/L2Q8zxg7UqZZOsMb8CmQKOfK9IR2/images/53D2DD20E6A8C8FDDC17/74C3321FB646B5554586.png)
AI Prompt
openai.comCreate a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W. Article summary: <tool call {"name":"attempt completion","arguments":{"result":"这套布局可以作为收敛方向，但需要纠正三个等同关系：所有测试不能无条件迁出业务包，规范不是全部 ADR 的摘要，冻结也不是完成归档。以下是六项建议的明确边界；涉及的新路径均为候选，尚未创建或迁移。\n\n 1.. Topic tags: general web, openai, automation, workflow, code. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with fake numbers, clickbait thumbnails, icons, a
Een centrale plek voor tests, specificaties en plannen kan een project overzichtelijker maken. Maar een nette mappenstructuur is geen doel op zich: taalconventies, bestaande afspraken en de herkomst van bewijs blijven leidend.
De voorgestelde indeling is een bruikbaar vertrekpunt, met zes belangrijke nuances. De paden hieronder zijn voorstellen; er zijn in deze analyse geen bestanden aangemaakt of verplaatst.
1. Tests centraal beheren, met ruimte voor uitzonderingen
Maak een centrale testmap de standaard, maar beloof niet dat tests in elk project uit de broncodepakketten verdwijnen.
- Python: plaats tests bij voorkeur in
tests/. Controleer bij een verhuizing of imports, testontdekking, fixtures en CI blijven werken. De huidigeCI-configuratiegebruikt al een centrale testlocatie. - Go: tests die niet-geëxporteerde onderdelen van een pakket moeten aanspreken, kunnen het best in de map van dat pakket blijven. Tests op pakketniveau, tussen componenten en van begin tot eind kunnen doorgaans centraal staan. Go bouwt testbestanden mee met het pakket en ondersteunt zowel tests in hetzelfde pakket als externe testpakketten.
14
Verwar daarbij twee verschillende grenzen niet: de importregels voor internal-pakketten hangen af van de bovenliggende directorystructuur. Dat betekent niet dat code alleen vanuit dezelfde map kan importeren. Toegang tot niet-geëxporteerde namen is een afzonderlijke pakketgrens.10
16
Daarom is “verplaats alle Go-tests uit de codepakketten en behoud tegelijk white-boxtests en inkapseling” geen veilige standaard. Exporteer geen interne toestand en kopieer geen bedrijfslogica alleen om mappen op te ruimen.
Wat je wél wilt voorkomen, zijn betekenisloze testfragmenten en dubbel uitgevoerde controles. Regressietests die waarde blijven hebben, horen onder versiebeheer; een eenmalige probe kan naar een tijdelijke map.
2. Specificaties, ADR’s en algemene regels hebben elk een eigen rol
Een projectmap specs/ is niet bedoeld als een algemene samenvatting van alle ADR’s. Houd deze drie lagen uit elkaar:
| Laag | Centrale vraag | Inhoud komt van |
|---|---|---|
| Algemene werkwijze | Hoe analyseren, controleren en opleveren we? | Beheerders van de werkwijze |
Projectinstructies in AGENTS.md |
Hoe werk je in dit project? | Bevestigde projectafspraken en praktische instructies |
Projectspecificaties in specs/ |
Aan welk gedrag en welke contracten moet het project nu voldoen? | Gebruikerswensen, geaccepteerde besluiten en goedgekeurde wijzigingen |
Besluitregistraties in docs/adr/ |
Waarom is voor deze aanpak gekozen? | Belangrijke architectuurkeuzes en afgewogen alternatieven |
Cline documenteert een mechanisme voor blijvende regels die instructies tussen sessies bewaren.4 Dat bewijst niet dat Cline uit zichzelf bepaalde bestanden in een specificatiemap aanmaakt. Behandel die werkwijze dus als een projectafspraak, niet als een gegarandeerde functie van Cline.
Projectdocumentatie hoeft ook niet volledig handmatig te worden opgesteld of te wachten tot er problemen ontstaan:
- Bij de start kan een assistent op basis van gebruikerswensen en bewijs uit de repository een voorstel voor projectspecificaties doen. Onbekende zaken blijven expliciet onbekend.
- Begin een taak met de relevante specificaties en besluiten. Maak duidelijk wat deze keer moet worden opgeleverd en gecontroleerd.
- Stel alleen een nieuwe ADR voor als er een belangrijke nieuwe afweging is. Verwijs naar een bestaand, toepasselijk besluit in plaats van voor elk plan een nieuw document te maken.
- Gebruik testresultaten om te beoordelen of de implementatie voldoet én om mogelijke tekortkomingen in de specificatie te vinden. Een testresultaat bepaalt niet automatisch wat de eis had moeten zijn.
- Verwerk een geaccepteerd besluit pas na goedkeuring in de actuele specificatie. Verwijs naar de relevante ADR; kopieer niet de volledige besluitgeschiedenis.
Kort gezegd: de specificatie is het huidige contract, de ADR legt de onderbouwing van een keuze vast en tests zijn uitvoerbare controles. Ze horen bij elkaar, maar vervangen elkaar niet. Een projectbevinding wordt bovendien niet vanzelf een algemene regel.
3. Eén ADR-map is prima; de besluitstatus blijft belangrijk
Gebruik docs/adr/ als standaardlocatie voor nieuwe besluiten. Dat is een praktische projectconventie, geen universele indelingsregel.
Houd daarbij de bestaande besluitpraktijk intact:
- Bewaar voorstellen, geaccepteerde en afgewezen besluiten en besluiten die later zijn vervangen.
- Hergebruik toepasselijke besluiten in nieuwe taken; leg niet telkens hetzelfde besluit opnieuw vast.
- Leg bij vervanging de relatie met het eerdere besluit vast, zonder achteraf de oorspronkelijke motivering te herschrijven.
- Beschouw geslaagde tests niet automatisch als toestemming om een ADR te accepteren.
Een verhuizing vraagt ook om het bijwerken van verwijzingen, routes en toegangsregels. Alleen bestanden verplaatsen is niet genoeg.
4. Plannen kunnen plat worden opgeslagen, maar ‘bevroren’ is niet ‘afgerond’
Een platte indeling van plans/ kan goed werken; voor een beperkte hoeveelheid historische plannen zijn submappen niet per se nodig. Mogelijke namen zijn:
| Doel | Voorbeeldbestand | Betekenis |
|---|---|---|
| Actief plan | pending_implementation_plan.md |
De standaardingang voor het ene actieve plan |
| Afgerond plan | plan-20261022-example-id.md |
Afgerond en met toestemming gearchiveerd |
| Bevroren plan | plan-20261022-example-id-frozen.md |
Niet afgerond, maar niet langer standaard in uitvoering |
Voor bevroren plannen is geen extra map of nieuwe status nodig. De huidige validator ondersteunt al een gepauzeerde status. Die kan voorlopig worden gebruikt, zolang het bevroren plan de reden van de pauze, de resterende werkzaamheden en de voorwaarden voor hervatting vermeldt.
Maak het onderscheid expliciet:
- Afgerond en gearchiveerd: alle vereiste acceptatiecriteria zijn gehaald en archivering is goedgekeurd.
- Bevroren: het plan is niet meer de actieve ingang, maar bevat nog open werk. Noem het niet afgerond en presenteer onbewezen voorstellen niet als feiten.
- Bewust stopgezet: leg vast dat het werk niet doorgaat en wat daarvan de gevolgen zijn. Dat is iets anders dan tijdelijk pauzeren. Een formele status ‘stopgezet’ vraagt om een afzonderlijke wijziging van de afspraken.
Lees standaard alleen het actieve plan; doorzoek niet automatisch elk historisch bestand in de map. Zoek gericht in de geschiedenis wanneer iemand een oud plan wil bekijken of hervatten. Voor hervatting is nieuwe toestemming nodig, net als een nieuw uitvoeringsplan dat de herkomst behoudt en opnieuw wordt gecontroleerd. Een eerdere geslaagde controle is geen blijvende vrijgave. Dit sluit aan bij de huidige regels voor de levenscyclus.
Een bestand hernoemen is bovendien geen bewijs dat het werk is geaccepteerd. Voorkom overschrijven, behoud openstaande punten en werk relevante verwijzingen bij. Maak ook geen leeg planbestand aan alleen om een vaste ingang te behouden.
5. Koppel tests aan modules en contracten, niet één-op-één aan bestanden
Een regel als “één codebestand, één testbestand” is te rigide. Eén test kan meerdere onderdelen controleren; één component kan juist verschillende tests nodig hebben, zoals unit-, property- en regressietests.
Begin liever met tests in tests/, geordend naar module of verantwoordelijkheid. Beschrijf bij de relevante specificatie de belangrijkste invarianten, de testlocaties en de begrensde commando’s waarmee je ze controleert.
Voeg alleen een centrale testkaart toe als de verbanden anders lastig terug te vinden zijn, bijvoorbeeld in tests/test-map.yaml. Houd daarin alleen noodzakelijke gegevens bij: de module of het contract, het relevante broncodegebied, het testgebied en de controlecommando’s. Kopieer geen complete mappenstructuur en houd geen tweede lijst met testresultaten bij.
De controle hoort na te gaan of paden en commando’s nog kloppen. Het bestaan van een kaart bewijst niet dat de dekking voldoende is of dat tests slagen.
6. Tijdelijke bestanden opruimen zonder noodzakelijk bewijs te verliezen
Een map als .scratch/ is geschikt voor eenmalige concepten, tijdelijke scripts en verkennende rapporten. Maar de maplocatie bepaalt niet of informatie een betrouwbare bron is, en niet alles kan zonder meer worden verwijderd.
- Een door een model geschreven onderzoeksamenvatting is een secundaire uitleg; op zichzelf maakt die een bewering nog niet tot feit.
- Een oorspronkelijke testuitvoer of diagnostische registratie kan juist direct bewijs zijn, ook als die tijdelijk is opgeslagen. De betrouwbaarheid hangt af van herkomst, omgeving, tijdstip en volledigheid.
- Verwijder niet zomaar het enige bewijs waarnaar een plan, besluit of acceptatie verwijst. Bewaar zo nodig het origineel of trek de conclusie die erop steunt expliciet in.
- Leg bij een samengevatte bevinding vast waar het bewijs staat, waarvoor het geldt en wat onbekend blijft. Samenvatten mag een aanname niet veranderen in een feit.
Maak voor oude rapporten en architectuurdiagrammen in docs/ onderscheid tussen actuele documentatie, historische informatie en materiaal dat nog moet worden gecontroleerd. Oud betekent niet automatisch waardeloos:
- Geef actuele documenten een toepassingsgebied en controleer ze opnieuw wanneer de bijbehorende afspraken veranderen.
- Markeer oude diagrammen en voorstellen als historisch, achterhaald of vervangen. Gebruik ze niet stilzwijgend als actuele basis.
- Verplaats of verwijder procesmateriaal zonder blijvende waarde of verwijzingen pas na goedkeuring.
Bewaren en standaard inladen zijn twee verschillende zaken. Noodzakelijke geschiedenis bewaren betekent niet dat elke sessie die hele geschiedenis moet lezen. Richt het contextgebruik liever met gerichte zoekopdrachten en duidelijke geldigheidslabels in dan door bewijsmateriaal te wissen.
Conclusie: een bruikbaar voorstel, met duidelijke grenzen
De voorgestelde structuur is een goed vertrekpunt als vier grenzen overeind blijven: centraliseer tests waar dat past, maar respecteer uitzonderingen per taal; behandel specificaties als het actuele contract en ADR’s als onderbouwing van besluiten; houd bevroren werk onderscheiden van afgerond werk; en verwijder geen tijdelijk bestand dat het enige noodzakelijke bewijs bevat.
De standaardlocatie voor plannen en toegestane paden en de bewerkingsregels voor de analysemode verwijzen nog naar de oude indeling. Een latere verhuizing moet daarom ook regels, sjablonen, verwijzingen, validatie en ondersteuning in de hostomgeving bijwerken. Een map hernoemen maakt de nieuwe structuur niet vanzelf van kracht.
Deze analyse heeft geen bestanden gewijzigd, verplaatst, bevroren of opgeschoond.
Studio Global AI
Continue your research
This page includes a source-backed answer you can continue inside Studio Global.
People also ask
What is the short answer to "Een werkbare structuur voor tests, specificaties en plannen"?
Tests kunnen meestal centraal staan, maar Go tests die niet geëxporteerde code controleren, horen vaak bij het geteste pakket.
What are the key points to validate first?
Tests kunnen meestal centraal staan, maar Go tests die niet geëxporteerde code controleren, horen vaak bij het geteste pakket. Specificaties beschrijven wat nu geldt; ADR’s leggen vast waarom een belangrijke keuze is gemaakt.
What should I do next in practice?
Een bevroren plan is niet hetzelfde als een afgerond plan: openstaande werkzaamheden moeten zichtbaar blijven.