/mappamind
Use Mappamind to set up the first workspace baseline, snapshot before an AI coding agent session, render the shift card after changes, and include local Studio/card URLs in the final response.
$ npx -y skills add mappamind/mappamind --skill mappamind --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/mappamind
Context preview
The summary Claude sees to decide when to auto-load this skill.
Use Mappamind to set up the first workspace baseline, snapshot before an AI coding agent session, render the shift card after changes, and include local Studio/card URLs in the final response.
SKILL.md
mappamind.SKILL.mdname: mappamind
description: Use Mappamind to set up the first workspace baseline, snapshot before an AI coding agent session, render the shift card after changes, and include local Studio/card URLs in the final response.
Mappamind
Use this skill when a user wants Mappamind enabled for a repo/workspace, asks for the initial architecture map, wants an impact card for an AI coding agent session, asks to inspect what the agent changed, or explicitly invokes Mappamind.
Workflow
1. Check Mappamind status for the current git repo or parent workspace:
mappamind status "$(git rev-parse --show-toplevel 2>/dev/null || pwd)" --json
2. If the command is missing, tell the user to install the CLI:
npm i -g mappamind-cli
3. If status reports `baseline.state` as `missing` or `stale`, ask the user before running the expensive initial map. After approval, run:
mappamind setup "$(git rev-parse --show-toplevel 2>/dev/null || pwd)" --host claude --yes
If setup prints `studio: file://...`, include that URL in the response under `Mappamind Studio`.
Baselines are local to the repo/workspace path, not to each git branch. A branch checkout can make the stored baseline stale; shifts still compare the session-start snapshot to the session-end tree.
4. Before making code edits in a session, run:
mappamind snapshot "$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
5. After meaningful code changes and before the final response, run:
mappamind shift "$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
6. If the command prints `card: file://...`, include that URL in the final response under `Mappamind card`.
7. If the command folds the card, report the folded reason instead of inventing an impact.
8. If browser opening fails, still relay the `file://` URL. The Studio is one self-contained app at `.mappamind/index.html` with four tabs (Studio, Shifts, Capabilities, Contracts) — no server, no scripts. A non-cosmetic shift card is written at `.mappamind/shift/latest.html` and archived per session at `.mappamind/shift/<timestamp>.html`; the Shifts tab links to every archived card.
Notes
- Platform-specific packages can bundle lifecycle hooks; users may need to review or trust those hooks in their agent.
- If `status.hooks.warnings` mentions duplicate Codex project hooks, tell the user to run `mappamind hooks --remove --agent codex` in the target root.
- Opening can be suppressed with `MAPPAMIND_OPEN=0`.
- Mappamind depends on the `mappamind` CLI being available on `PATH`.
Read more
name: mappamind description: Use Mappamind to set up the first workspace baseline, snapshot before an AI coding agent session, render the shift card after changes, and include local Studio/card URLs in the final response.
Mappamind
Use this skill when a user wants Mappamind enabled for a repo/workspace, asks for the initial architecture map, wants an impact card for an AI coding agent session, asks to inspect what the agent changed, or explicitly invokes Mappamind.
Workflow
1. Check Mappamind status for the current git repo or parent workspace:
mappamind status "$(git rev-parse --show-toplevel 2>/dev/null || pwd)" --json
2. If the command is missing, tell the user to install the CLI:
npm i -g mappamind-cli
3. If status reports `baseline.state` as `missing` or `stale`, ask the user before running the expensive initial map. After approval, run:
mappamind setup "$(git rev-parse --show-toplevel 2>/dev/null || pwd)" --host claude --yes
If setup prints `studio: file://...`, include that URL in the response under `Mappamind Studio`.
Baselines are local to the repo/workspace path, not to each git branch. A branch checkout can make the stored baseline stale; shifts still compare the session-start snapshot to the session-end tree.
4. Before making code edits in a session, run:
mappamind snapshot "$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
5. After meaningful code changes and before the final response, run:
mappamind shift "$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
6. If the command prints `card: file://...`, include that URL in the final response under `Mappamind card`.
7. If the command folds the card, report the folded reason instead of inventing an impact.
8. If browser opening fails, still relay the `file://` URL. The Studio is one self-contained app at `.mappamind/index.html` with four tabs (Studio, Shifts, Capabilities, Contracts) — no server, no scripts. A non-cosmetic shift card is written at `.mappamind/shift/latest.html` and archived per session at `.mappamind/shift/<timestamp>.html`; the Shifts tab links to every archived card.
Notes
- Platform-specific packages can bundle lifecycle hooks; users may need to review or trust those hooks in their agent.
- If `status.hooks.warnings` mentions duplicate Codex project hooks, tell the user to run `mappamind hooks --remove --agent codex` in the target root.
- Opening can be suppressed with `MAPPAMIND_OPEN=0`.
- Mappamind depends on the `mappamind` CLI being available on `PATH`.
Before you accept an agent's diff, see what changed in behavior, flow, contracts, and architecture — with every claim grounded in real code. ▶ See live examples → · static cards from a fictional storefront, exactly what Mappamind renders for your repo
Repo: mappamind/mappamind