# Examples
Worked examples of mind features; each subdirectory has its own README with a
"Try it" section you can run.
## Start here: [starter/](starter/)
The most common use of mind is melding an arbitrary existing repo you did not
author and did not modify. Convention discovery finds skills, agents, rules,
commands, workflows, and tools by directory layout alone - no `mind.toml` and
no source changes required. `starter/` shows this from scratch.
## Reading order
Simplest to most advanced:
- [starter/](starter/) - zero-config: meld an unmodified repo, items (including
a workflow) found by convention. START HERE.
- [hello/](hello/) - the `hello-mind` hello-world skill the repo-root
`mind.toml` exposes via `[source].roots`; what `mind meld jaemk/mind` offers
to install. Note that the same `mind.toml` also registers two curated skill
libraries (anthropics/skills, ComposioHQ/awesome-claude-skills) as
register-only `[discover].sources`: browsable via `mind probe`, nothing
installed on meld.
- [namespacing/](namespacing/) - prefix namespacing and `{{ns:}}` reference
tokens for colliding item names.
- [explicit/](explicit/) - an authoritative `[[items]]` inventory with a custom
link target and install hooks.
- [monorepo/](monorepo/) - items under per-package subtrees, discovered via
`[source].roots`.
- [discover/](discover/) - `[discover]` kind globs with include/exclude.
- [tooling/](tooling/) - a store-only `tool` referenced by a skill through path
tokens.
- [hooks/](hooks/) - source hooks for the install, update, and uninstall
lifecycle events, with interactive disclosure.
- [policy/](policy/) - a managed `policy.toml` validated by `review --policy`.
- [super-source/](super-source/) - a curated registry that references and pins
nested sources; `dump` output; `mind curate` reconciling the registry after
the curator's list changes.
- [marketplace-plugin/](marketplace-plugin/) - a Claude `.claude-plugin/plugin.json`
melded as a source: skills, agents, commands, and workflows become items,
unsupported components report a skipped count, and a component-path override
(`workflows`) shows mind and the harness disagreeing about which file loads.
- [marketplace-catalog/](marketplace-catalog/) - a Claude `.claude-plugin/marketplace.json`
catalog of in-repo plugins, each a namespaced sub-source.
- [marketplace-curator/](marketplace-curator/) - a repo that is both a Claude
marketplace (its own in-repo plugin) and a `mind` curator: a `mind.toml`
`[discover].sources` composes with the manifest instead of suppressing it.
Operational walkthroughs (lifecycle verbs):
- [drift/](drift/) - detect and resolve item drift: `recall` flags an out-of-date item, `upgrade` re-links it, `introspect` reports it.
- [multi-lobe/](multi-lobe/) - link items into more than one agent home (lobe) via `config lobes`.
- [absorb/](absorb/) - claim an unmanaged lobe item into a version-controlled source with `absorb`.