---
name: org-guide
description: Read org rules for project work and reporting MMI CLI, plugin, or workflow bugs.
---

# MMI organization guide

Read this short entry before MMI project work. Then read **only the topic relevant to the task**;
do not load the whole guidebook or repeat it in the conversation. For a human introduction, use
the [MMI help skill](../mmi-help/SKILL.md).

## Essential rules

- Install `@mutmutco/hub` through npm, run `mmi-hub install`, and keep automatic updates enabled.
  Check actual health with `mmi-hub status`; installation alone is not proof of a working updater.
- Use the scoped two-tier vault and keyless workflows. Never put secret values in chat, logs,
  command arguments, or repository environment files.
- Personal agent instructions and host settings stay local and gitignored in product repositories.
  Do not commit AGENTS.md, CLAUDE.md, or copied plugin instructions.
- Claim approved work through the board, use the repository's checks, and land through MMI.
  A request for help or a plan does not authorize a change or a production release.
- When an MMI tooling bug affects a developer other than `jervaise`, ask before filing a Hub report.
  Respect a decline. Follow [Work and releases](references/work-and-releases.md#report-mmi-tooling-bugs)
  for consent, duplicate handling, and optional released-fix Slack notifications.
- Read the registry for release tracks, domains, and OAuth configuration. Use MMI provisioning
  and release workflows rather than inventing parallel deployment or credential paths.

## Read one topic

| Task | Local reference |
| --- | --- |
| Install, update, reload, or diagnose tooling | [Getting started](references/getting-started.md) |
| Report an MMI tooling bug with developer consent | [Tooling bug reports](references/work-and-releases.md#report-mmi-tooling-bugs) |
| Work an issue, test, merge, or release | [Work and releases](references/work-and-releases.md) |
| Consume, declare, rotate, or request a secret | [Vault and keyless access](references/vault.md) |
| Register domains or configure Google OAuth | [Domains and OAuth](references/domains-and-oauth.md) |
| Decide what belongs in a product repository | [Repository rules](references/repository-rules.md) |
| Produce company-facing documents in the MM brand | not bundled — the MM-Strategy MCP serves the brand kit (`mm_brand_guide`); strategists install `@mutmutco/strategy` |

This is MMI organization guidance, not Jerv or JervCode operating instructions.
The plugin carries these files locally at its installed release version. Resolve current values
and exact command flags through the live CLI; a bundled guide is not a live status report.