name	m3e-mapify-bridge
description	Use when working on M3E <-> Mapify integration, Mapify I/O, Mapify roundtrip verification, Markdown/MF-H export to Mapify, XMind export retrieval from Mapify, or structure-preserving comparison back into M3E. Prefer this skill whenever the user mentions Mapify with M3E, XMind, MF-H, roundtrip, "投げて再取得", "構造を保つ", or Mapify teacher/oracle behavior.

M3E Mapify Bridge

Use Mapify as a teacher/probe layer, not as canonical M3E storage.

Current known-good route:

M3E subtree / MF-H / Markdown
-> Mapify input
-> Mapify UI export as XMind
-> recover XMind content.json
-> convert to AppState-lite / structural tree
-> strict compare against the original structure

Do not treat Mapify private/internal API readback as open unless it has been verified in the current session. The previously reliable path is XMind export.

Required Workflow

Resolve the M3E target precisely: workspace, map, scope, node.
Export only the intended subtree as MF-H or Markdown headings.
Send that structure to Mapify. If using MCP, keep the exact outbound text.
Retrieve through Mapify XMind export when possible.
Convert XMind content.json with:

python3 tools/rapid_mapify_oracle/scripts/xmind_content_to_appstate.py <content.json> --out <retrieved_appstate.json>

Compare original vs retrieved structure before claiming success.

Success means all are true:

same node count
same max depth
same ordered parent-child paths
no missing or extra node paths
no missing or extra tree edges

If artifacts are on Windows-only paths, classify them as peer evidence unless the files are actually synced to this host.

Safety

Do not extract or print Mapify cookies, OAuth tokens, API keys, or browser session material.
Do not make Mapify the source of truth.
Do not write retrieved data into an M3E map until the strict comparison result is known and the user asked for writeback.
Do not create throwaway M3E maps for verification unless explicitly asked.
Use existing import/export code and tools/rapid_mapify_oracle/ before inventing new parsers.

References

Detailed roundtrip procedure: references/roundtrip.md
Existing Mapify policy: tools/rapid_mapify_oracle/docs/mapify_io_policy.md
XMind converter: tools/rapid_mapify_oracle/scripts/xmind_content_to_appstate.py

M3E Mapify Bridge

Use Mapify as a teacher/probe layer, not as canonical M3E storage.

Current known-good route:

M3E subtree / MF-H / Markdown -> Mapify input -> Mapify UI export as XMind -> recover XMind content.json -> convert to AppState-lite / structural tree -> strict compare against the original structure

Do not treat Mapify private/internal API readback as open unless it has been verified in the current session. The previously reliable path is XMind export.

Required Workflow

Resolve the M3E target precisely: workspace, map, scope, node.

Export only the intended subtree as MF-H or Markdown headings.

Send that structure to Mapify. If using MCP, keep the exact outbound text.

Retrieve through Mapify XMind export when possible.

Convert XMind content.json with:

python3 tools/rapid_mapify_oracle/scripts/xmind_content_to_appstate.py <content.json> --out <retrieved_appstate.json>

Compare original vs retrieved structure before claiming success.

Success means all are true:

same node count

same max depth

same ordered parent-child paths

no missing or extra node paths

no missing or extra tree edges

If artifacts are on Windows-only paths, classify them as peer evidence unless the files are actually synced to this host.

Safety

Do not extract or print Mapify cookies, OAuth tokens, API keys, or browser session material.

Do not make Mapify the source of truth.

Do not write retrieved data into an M3E map until the strict comparison result is known and the user asked for writeback.

Do not create throwaway M3E maps for verification unless explicitly asked.

Use existing import/export code and tools/rapid_mapify_oracle/ before inventing new parsers.

References

Detailed roundtrip procedure: references/roundtrip.md

Existing Mapify policy: tools/rapid_mapify_oracle/docs/mapify_io_policy.md

XMind converter: tools/rapid_mapify_oracle/scripts/xmind_content_to_appstate.py

m3e-mapify-bridge