Skip to content

Versie- en release-workflow + doc-onderhoud vastleggen#35

Merged
stefvdwater merged 1 commit into
feat/dev-versie-markerfrom
chore/release-workflow
Jun 25, 2026
Merged

Versie- en release-workflow + doc-onderhoud vastleggen#35
stefvdwater merged 1 commit into
feat/dev-versie-markerfrom
chore/release-workflow

Conversation

@stefvdwater

Copy link
Copy Markdown
Owner

Legt het ontwikkelproces vast dat we deze sessie hebben uitgewerkt. Puur proces/tooling, geen app-wijziging.

Gestapeld op #34 (basis = feat/dev-versie-marker, niet main), zodat RELEASE_0.2.6.md zonder conflict aanvult. GitHub hangt deze PR automatisch om naar main zodra #34 merget.

CLAUDE.md (beleid)

  • Nieuwe sectie "Versie- en release-workflow": trunk-based, semver (zwaarste wijziging wint), cadans "bumpen pas bij de release", hotfix-pad, geen publieke pre-releases, dev-versie-conventie, signing-nota.
  • Nieuwe sectie "Documentatie-onderhoud": een bron van waarheid per feit, verplichte same-PR doc-updates, waarheidspas bij elke release.

/release-skill (runbook)

.claude/skills/release/SKILL.md: stap-voor-stap voor een normale release en een hotfix. Valkuilen van de eerste handmatige release ingebakken:

  • de workflow-conclusie wordt expliciet geverifieerd (gh run watch gaf misleidend exit 0 bij een gefaalde run);
  • doc-waarheidspas + dode-link-check + website-check als stap.

.gitignore versmald: .claude/skills/ wordt getrackt, lokale config (settings.local.json, launch.json) blijft genegeerd.

Nog te doen (aparte PR)

De consolidatie van de algoritme-/regel-docs (5 to 3) volgt apart, als eerste toepassing van de nieuwe same-PR-docregel.

🤖 Generated with Claude Code

CLAUDE.md krijgt het beleid (trunk-based, semver, bumpen-bij-release, hotfix,
geen publieke pre-releases, dev-versie-conventie) en een doc-onderhoud-sectie
(een bron van waarheid, same-PR doc-updates, waarheidspas bij release).

De uitvoerbare runbook leeft als /release-skill in .claude/skills/release/, met
de valkuilen van de eerste handmatige release ingebakken (expliciete verificatie
van de workflow-conclusie, --publish never). De .gitignore is versmald zodat
.claude/skills/ getrackt wordt maar lokale config genegeerd blijft.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@stefvdwater
stefvdwater merged commit bc70840 into feat/dev-versie-marker Jun 25, 2026
1 check passed
@stefvdwater
stefvdwater deleted the chore/release-workflow branch June 25, 2026 23:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant