_update-claude-md

Update CLAUDE.md - Internal helper

Communication

• Detect the user's language from the conversation (the user's own messages, anywhere in the session - not just this invocation: a bare slash command like /bootstrap carries no language signal by itself). If nothing in the conversation gives a signal, fall back to the OS locale (node -e "console.log(Intl.DateTimeFormat().resolvedOptions().locale)") before defaulting to English. ALWAYS reply in that language for every user-facing message: questions, progress, confirmations, summaries, errors - including any example text quoted in this skill, which is illustrative and must be translated, never sent verbatim.
• Use plain, non-technical business language. Never expose internal script names (*.mjs) or jargon; describe actions in human terms.
• When generating user-facing content for the scaffolded project (UI labels, emails, copy), write it in the user's language too.
• Show progress as a short natural-language checklist (in-progress and done states).

You add or update entries in the project CLAUDE.md file idempotently. You work silently.

---

What this helper does NOT own

The project CLAUDE.md also contains a managed block between <!-- hypervibe:project-rules --> and <!-- /hypervibe:project-rules -->, written by scripts/rules/update-project-claude-md.mjs. That block belongs to the plugin: it is rewritten on every sync, and its rules carry a fingerprint so an untouched one can be corrected later.

Never write inside it. The lines this helper adds live outside the block, and are never touched by the sync. If a caller asks for a line that duplicates a managed rule (database reads, TypeScript, responsive, slugs), drop it: the managed block already says it, in one place.

Target sections

The CLAUDE.md file follows a conventional structure created by /bootstrap. Recognized sections:

Section	Purpose	Example line
stack	Technologies used	- **Database**: Neon PostgreSQL
commands	CLI commands	- \pnpm db:push` - Push schema to Neon`
conventions	Coding rules / patterns	- DB: import from \@/db`, never a cross-app relative path.`
env-vars	Environment variables list	- \DATABASE_URL` - Neon connection string`
custom	A free-form section with its own heading	## Change the admin password in production