# tool-design-lessons

> Design lessons for self-updating tools and package systems: pointer-flip activation, immutable instances, identity-is-source, vendor the bootstrap

A community documentation of nothing it declares, published by org.vibevm.world, in en.
Read it at /doc/org.vibevm.world/tool-design-lessons/1.0.0/. Rendered 2026-09-12.

Design lessons for self-updating tools and package systems: pointer-flip activation, immutable instances, identity-is-source, vendor the bootstrap

## For agents

- [Boot snippet](/doc/org.vibevm.world/tool-design-lessons/1.0.0/boot-snippet/): `org.vibevm.world/tool-design-lessons@1.0.0` contributes a boot snippet: text that a session reads before it starts work, placed into the project's generated boot lane by `vibe install`. It is not read on this page — it is read by the agent. (1 min · user, agent)

## Pages

- [Package manifest](/doc/org.vibevm.world/tool-design-lessons/1.0.0/manifest/): What `org.vibevm.world/tool-design-lessons@1.0.0` declares about itself. Everything on this page is the package's own manifest, read and shown — nothing here is an opinion about the package. (1 min · user, dev)