Skip to content

CLAUDE.md

Latest commit

 

History

History
76 lines (55 loc) · 4.61 KB

CLAUDE.md

File metadata and controls

76 lines (55 loc) · 4.61 KB
Raw

Guardrails voor dit repository

Branching

Dit is een trainingsrepo. Commit en push direct op de uitgecheckte branch — feature branches en pull requests zijn niet vereist. Maak een feature branch alleen als je expliciet gevraagd wordt om wijzigingen te isoleren.

Bronnen voor de scripts

De scripts in Scripts/ zijn gebaseerd op:

  • Midpoint-quickstart-guides/7 - Midpoint config export documentation.ipynb
  • Midpoint-quickstart-guides/8 - Midpoint config import documentation.ipynb

Het volgende notebook is niet gebruikt als bron (bevat omgevingsspecifieke runbook-stappen):

  • Midpoint-quickstart-guides/4 - Ninja runbook changeset HR-sync - Identities.ipynb
  • Midpoint-quickstart-guides/6 - HR sync met HR demo - Organization.ipynb

Voor Claude Code (AI-assistent)

Claude heeft volledige autonomie voor bouw- en testactiviteiten in de uitgecheckte repo.

Toegestaan zonder toestemming:

  • Scripts en code aanpassen, aanmaken of verwijderen in Scripts/
  • Scripts op hosts (midpoint-dev, midpoint-tst) aanpassen voor testdoeleinden
  • SSH-verbindingen naar nodes voor het aanmaken van bestanden t.b.v. tests
  • Tests uitvoeren op alle omgevingen
  • SSH, SCP en CURL naar/van de midpoint-hosts en de GitHub-repository Fortigi/MidPoint-training — voor deployen van scripts, downloaden van bestanden en uploaden naar de repo

Toegestaan bij expliciete opdrachtenlijst (optie D):

  • Wanneer Rob een expliciete, genummerde lijst van uit te voeren acties geeft, mag Claude deze op de dev-omgeving autonoom uitvoeren — inclusief destructieve operaties (importeren, exporteren), exclusief destructieve operatie omgeving leegmaken
  • Na elke uitgevoerde stap wordt bewijs geleverd (output, screenshot of verificatie)
  • Alle MD- en README-bestanden worden na afloop bijgewerkt

Vereist altijd toestemming:

  • Destructieve operaties op test, acc of prod (ook bij expliciete opdrachtenlijst)
  • Acties volledig buiten de scope van dit project

MidPoint Resource Skill

De map midpoint-resource/ bevat een connector-agnostische skill voor het opzetten van MidPoint-resources. Lees bij elke skill-aanroep verplicht:

  1. midpoint-resource/SKILL.md — kernprincipes (lifecycle, notebook-trouw, test vs. productie)
  2. midpoint-resource/lessons-learned/REGISTER.md — pre-scan vóór elke intake of deploy
  3. Bij intake: midpoint-resource/playbook/01-intake.md
  4. Bij runtime: notebook-execution-reports/NEXT-RUNTIME-PLAN.md (indien aanwezig)

Skill-discipline (niet-onderhandelbaar):

  • Geen XML/Groovy zonder verificatie via docs-cache/ of docs.evolveum.com.
  • GUI-first tijdens runtime; Edit-Raw / Import-XML alleen waar GUI een gap heeft.
  • Run-type (productie vs. skill-validatie) is altijd eerste vraag — bepaalt output-pad.
  • Notebook-invulvakken worden tijdens elke stap gevuld, niet pas in wrap-up.
  • Post-deploy housekeeping (README's + REGISTER + memory) wordt in dezelfde sessie afgerond.

Post-deploy housekeeping checklist (verplicht aan het einde van elke deploy-sessie):

Elke productie-deploy-sessie is pas compleet als alle onderstaande punten zijn afgevinkt. Niet uitstellen naar een volgende sessie.

  • Elke nieuwe LL krijgt een ## Skill-impact-sectie met per skill-artefact [x] APPLIED of [ ] geen wijziging, plus Status: APPLIED in commit <hash>. Een LL zonder deze sectie is technische schuld.
  • midpoint-resource/intake/README.md — nieuwe rij in de tabel + status-sectie bijgewerkt.
  • notebooks/README.md — nieuwe rij in de tabel + status-sectie bijgewerkt.
  • midpoint-resource/lessons-learned/REGISTER.md — entry voor elke nieuwe LL.
  • Auto-memory project_midpoint_resource_skill.md — nieuw "Update <datum>"-blok bovenaan met commit-hash + delta + status. Maak het bestand aan als het nog niet bestaat.
  • Auto-memory MEMORY.md-index — regel toevoegen of bijwerken bij materiële status-wijziging.

Mapstructuur van de skill:

Map Doel
midpoint-resource/ Skill: playbook, connectors, lessons-learned, templates
notebooks/ Productie-notebooks (klantgerichte deploys)
tests/ Skill-validatie per connector-type
notebook-execution-reports/ Runtime-rapporten en deploy-XML's
evaluations/ Skill-evaluaties per run
templates/ Notebook-blocks (JSON-fragments voor generator-scripts)
Scripts/ Pipeline-scripts + generator-scripts voor notebooks (skill-generators zijn Python, pipeline-scripts zijn Shell)