Mappamind
Skill mappamind/mappamind/plugins/mappamind/skills/mappamind
See what your AI coding agent just did to your system's behavior, flow, and architecture. Grounded in real code, visual, in-session at the accept moment.
npx -y skills add mappamind/mappamind --skill mappamindAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
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
2.5 KB, as published. Nobody here has run it
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
- Check Mappamind status for the current git repo or parent workspace:
mappamind status "$(git rev-parse --show-toplevel 2>/dev/null || pwd)" --json
- If the command is missing, tell the user to install the CLI:
npm i -g mappamind-cli
- If status reports
baseline.stateasmissingorstale, 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.
- Before making code edits in a session, run:
mappamind snapshot "$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
- After meaningful code changes and before the final response, run:
mappamind shift "$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
-
If the command prints
card: file://..., include that URL in the final response underMappamind card. -
If the command folds the card, report the folded reason instead of inventing an impact.
-
If browser opening fails, still relay the
file://URL. The Studio is one self-contained app at.mappamind/index.htmlwith four tabs (Studio, Shifts, Capabilities, Contracts) — no server, no scripts. A non-cosmetic shift card is written at.mappamind/shift/latest.htmland 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.warningsmentions duplicate Codex project hooks, tell the user to runmappamind hooks --remove --agent codexin the target root. - Opening can be suppressed with
MAPPAMIND_OPEN=0. - Mappamind depends on the
mappamindCLI being available onPATH.