Skip to content

docs: voeg CLAUDE.md toe met repo-conventies#17

Open
Nozzit wants to merge 1 commit into
OpenAEC-Foundation:mainfrom
Nozzit:docs/claude-md
Open

docs: voeg CLAUDE.md toe met repo-conventies#17
Nozzit wants to merge 1 commit into
OpenAEC-Foundation:mainfrom
Nozzit:docs/claude-md

Conversation

@Nozzit

@Nozzit Nozzit commented Jul 27, 2026

Copy link
Copy Markdown

Voegt een CLAUDE.md toe met de repo-conventies die niet uit één bestand af te leiden zijn, zodat een nieuwe bijdrager (of AI-assistent) niet eerst tien bestanden hoeft te lezen.

Wat erin staat:

  • Twee naamruimtes per tool — paginaslug (open-pile-plan-studio) versus GitHub-repo (pile-plan-studio), en welke van de twee waar gebruikt wordt. Dit is de meest voorkomende struikelsteen.
  • Twee losse i18n-motoren — subpagina's gebruiken shared/i18n.js met meta[name=i18n-page], de homepage heeft een eigen inline vertaalobject en negeert dat systeem volledig.
  • Wat gegenereerd is en dus niet met de hand bewerkt mag wordenapi/tools.json, md/*, de tool-stats-chips ín index.html — versus wat wél handgeschreven is, waaronder llms.txt, dat juist een invoer is voor de markdown-generator.
  • De twee checkerscripts als enige tests, en dat ze niet in CI zitten.
  • De designtokens uit shared/style.css.
  • De checklist voor het toevoegen van een tool (negen plekken), overgenomen uit check-open-pile-plan-studio.js, dat feitelijk een uitvoerbare specificatie is.
  • De canonical- en Open Graph-conventies uit de bijbehorende SEO-PR.

Het bestand wordt niet meegedeployed (README.md en LICENSE.md staan al in rsync_excludes; CLAUDE.md zou daar eventueel bij kunnen, maar hij staat er nu niet in — zeg het als je dat wilt).

Puur documentatie; geen enkele gedragsverandering.

Beschrijft de dingen die niet uit één bestand af te leiden zijn: de twee
naamruimtes per tool (paginaslug versus GitHub-repo), de twee losse
i18n-motoren, welke bestanden gegenereerd zijn en dus niet met de hand
bewerkt mogen worden, de checkerscripts als enige tests, de designtokens,
en de checklist voor het toevoegen van een tool. Inclusief de nieuwe
canonical- en Open Graph-conventies.

Co-Authored-By: Claude <noreply@anthropic.com>
@Nozzit
Nozzit requested a review from jochem25 as a code owner July 27, 2026 07:51
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