mise-en-space: Instructions file for Claude Code

CLAUDE.md

mise-en-space — Google Workspace MCP (Drive, Gmail) with mise-en-place philosophy: everything prepped, in its place, ready for Claude to cook with.

Versioning & releasing (suite-managed)

mise ships as part of the Batterie de Savoir suite, which carries one suite-wide version. So:

• Do NOT hand-bump .claude-plugin/plugin.json to release. This repo's own plugin.json version is local-dev-only — the assembler stamps every published plugin to the suite version, overwriting it.
• Release via /ship from this working tree — it bumps the suite version centrally and ships the change (a 2-repo push: this repo + the central suite bump). Never hand-run the assemble.
• mise is vendored full-source (it's the MCP plugin) — so any source edit here, plus CLAUDE.md / instructions.md / skills/ / hooks/ / scripts/, is vendored content that ships on a suite bump. A push to main IS a release: since 2026-09-09 (bds-hajeli) the assembler treats unbumped drift as a reason to bump, not to quarantine — it mints a suite patch version with a generated CHANGELOG line and ships the plugin on its next scheduled run (cron 07:00 UTC, observed firing ~12:20 UTC on 15 and 16 Sep 2026; NOT push-triggered — but ANY session's /ship or a manual dispatch of batterie's 'Assemble plugins' workflow reassembles every plugin, and on 2026-09-23 that happened seven times before 10:30 BST, so a push to main can be live within the hour; never assume it waits for tomorrow). gudeci's fix went live as 1.85.15 with no publish run because the schedule happened to fire nine minutes after its push. /ship is the "ship it now, with a human-written changelog line" verb, not the only door — so before running it, check whether the assembler already did (git -C ~/repos/spm1001/batterie fetch && git show origin/main:plugins/mise/.claude-plugin/plugin.json), or you mint an empty version. The free-to-commit set is the assembler's root-anchored exclude list (~/repos/spm1001/batterie/assemble.sh, the rsync near L193 — read it rather than this line when it matters): .bon/, handoffs/, tests/, docs/, fixtures/, bakeoff/, .github/, .claude/ and CHANGELOG.md (the assembler ships its own generated stub, so this repo's CHANGELOG is internal; its headings never say [Unreleased], and its header carries the one-function lookup for the suite version that shipped a commit — mise-leceva) — anything absent from that list ships. "Free" means unshipped, not private: this repo is PUBLIC, so docs/research/, handoffs/ and .bon/understanding.md are world-readable (a session without the bon CLI that files its handoff here is publishing it: on 2026-09-23 an atelier field report put two colleagues' names and a mail subject into history, left in place by Sameer's call on 27 Sep, mise-dimocu) — never paste colleagues', partners' or third parties' names, or quoted mail, into them. On 2026-09-22 an incident write-up quoted a partner thread's names into docs/research/ and main had to be force-rewritten the next morning (mise-tijeko). (Until 2026-09-17 this line named three free trees and called the list exhaustive; the missing six were free all along.) scripts/ is named explicitly because it reads like local tooling and is not: the shipped plugin carries it, which is how a capture_fixtures.py that had been broken since March 2026 went on being distributed to every user for four and a half months (mise-sowepo).