zz-migrate

Migrate an mma repository's journal and historical documents into the ZZ platform as knowledge nodes and sources.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/zhixuan312/zz-stack --skill zz-migrate-zhixuan312
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: zz-migrate
Source: https://github.com/zhixuan312/zz-stack/tree/main/catalog/zz/zz-access/skills/zz-migrate
Command: npx skills add https://github.com/zhixuan312/zz-stack --skill zz-migrate-zhixuan312

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams moving off an mma-based workflow need their accumulated history — journal lessons, specs, plans, audits — preserved on the ZZ platform without losing provenance or falsely stamping unapproved historical documents as gated, approved work. ## Core Features & Use Cases - Journal-to-knowledge migration: Converts .mma/journal/nodes/*.md into ZZ knowledge nodes, preserving the six shared node types, tags, and supersede edges. - Historical archive as sources: Imports specs, plans, explorations, audits, and other historical folders as immutable, ungated sources on one archive initiative that every migrated node cites as evidence. - Resumable and idempotent: Records every successful send in .mma/.zz-migrated.json, so an interrupted run resumes where it stopped and never mints duplicates. - Use Case: A team with a repository containing a .mma/ directory runs a dry-run rehearsal, reviews the counts, then imports several hundred records into their ZZ deployment in minutes. ## Quick Start Run the zz-migrate skill from inside the mma repository to rehearse the import with a dry run, then confirm to migrate its history onto the platform.

Frequently Asked Questions about zz-migrate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate an mma repository to the ZZ platform?▼

Run the migrate script from inside the mma repository, first with --dry-run to review the planned counts, then without it to import. Journal nodes become knowledge nodes and historical folders become sources on one archive initiative.

What happens to mma journal nodes during migration?▼

Journal nodes become ZZ knowledge nodes because mma's six node types match the platform's six. Only adopted and superseded nodes are imported, since dropped or inconclusive nodes would be falsely stamped as adopted.

Can I resume an interrupted mma migration?▼

Yes, every successful send is recorded in .mma/.zz-migrated.json the moment it completes. Running the script again sends only what is missing and never creates duplicate records.

Why are historical specs imported as sources instead of documents?▼

Initiative documents on the platform are gated and require approvals, which historical material never received. Importing them as ungated, immutable sources via source_add avoids signing gates on behalf of people who signed nothing.

Does the migration require credentials or network access?▼

Yes, it needs a platform token from $ZZ_TOKEN, $ZZ_TOKEN_FILE, or ~/.zz/token, and it discovers the gateway from the installed zz-stack plugin. All imports go over HTTP to that deployment's core MCP door.