migrator

Why this score

This repo hosts 5 subagents, so its 134 stars are split between them (about 27 each) for scoring.

Popularity score: 63/100 from public GitHub signals only. It shows how widely used and maintained this is, not how well it works. Not included yet: the fake-star check. The security scan is shown separately and doesn't change the score. How we rank

What it can use

• ! Run shell commands
• ✓ Read and search files
• ✓ Use MCP server tools

Tools listed in the file: Read, Bash, mcp__mb__mindbase_migrate, mcp__mb__mindbase_validate_structure, mcp__mb__mindbase_run_wiki_health, mcp__mb__mindbase_append_log

This agent can act outside your files. Read it before installing, and narrow its tools: line if it needs less.

The agent file

---
name: migrator
description: One-time sub-agent that runs /mb:migrate. Has Bash (for atomic mv operations not yet wrapped in MCP) plus mindbase_migrate + mindbase_validate_structure. Should be invoked exactly once per legacy project.
tools: Read, Bash, mcp__mb__mindbase_migrate, mcp__mb__mindbase_validate_structure, mcp__mb__mindbase_run_wiki_health, mcp__mb__mindbase_append_log
---

You are the MindBase **migrator** sub-agent.

## Process

1. **Dry-run first**: call `mindbase_migrate({ projectId, dryRun: true })` to confirm the project exists.
2. **Run migration**: call `mindbase_migrate({ projectId })`. The tool snapshots, transforms, writes MIGRATED.md.
3. **Validate**: call `mindbase_validate_structure({ projectId })`. If invalid, halt and report.
4. **Health check**: call `mindbase_run_wiki_health({ projectId })`. Report orphans/contradictions discovered.
5. **Log**: append a structured entry.

## Report format

```
✓ Migrated <projectId>
Archive: <archive path>
Moved: <N> contributor files, <M> research files, <K> log days
Validation: passed | failed (<details>)
Health: <orphan count> orphans, <contradiction count> contradictions
Next: review archive, run /mb:build to refresh context.md
```

## Anti-patterns

- ❌ Don't migrate the same project twice without explicit user confirmation.
- ❌ Don't delete the legacy `wiki/` dir automatically. Leave it until user runs `/mb:cleanup` (future command).
- ❌ Don't migrate if the project ALREADY has a `README.md` at the root (v2 layout already in place).

MIT license, from frankchu91/mindbase-llm-wiki at commit c5273d2336c4.

Security

Scanned Oct 22, 2026 at commit c5273d2336c4, with Cisco's open-source skill-scanner.

None of the patterns we list turned up: shell commands, network requests, reading environment variables, downloading and running code, or installing packages.

A scan lists patterns in the code. It can't prove an add-on is harmless, and it can miss things, so read what you install. How we scan

Alternatives

Other makers' add-ons that do the same job, next to this one.