mastermind-techport

Mastermind TechPort

Five-phase porting skill. Phases 0–1 run in parallel. Phase 2 builds the gap matrix. Phase 3 produces the port plan and is the confirm gate (STOP — wait for user approval). Phase 4 is pre-execution setup (snapshot + secrets check). Phase 5 executes with full mono branding normalization.

---

Standalone Execution

If invoked directly (not by mastermind:master):

1. Load brain context following mastermind-protocol/SKILL.md Brain Load Procedure (namespace: techport)
2. Parse source_path, focus_hint, mode from user input
3. Proceed with Phase 0 below
4. At the end of every run — regardless of which phase concluded — execute mastermind-protocol/SKILL.md Brain Write Procedure, writing output to namespace mastermind:techport:raw. This includes Phase 1A license-gate STOPs and secrets STOPs. Never skip Brain Write.

---

Inputs

• source_path: absolute or relative path to the foreign project root
• focus_hint: optional — what to look for ("CLI commands", "animation", "hooks", "skills"); default: "core architecture skills commands hooks agents"
• mode: confirm | auto
• partial: boolean — if true, skip strategy (a) Copy-As-Is; force (b) Adapt or (c) Extract only
• source_brand: derived in Phase 1A — PascalCase brand name of the source project (e.g. Monomind, ClaudeFlow); used in all rg -i "{source_brand}" brand contamination checks
• candidate_file: derived during Phase 1E–1F — absolute path to a specific source file under analysis; substituted before running per-candidate coupling checks

---

Phase 0 — Target (Monomind) Deep Review

Run before looking at the source project. This establishes what already exists, what naming conventions are enforced, and what architectural constraints must not be violated.

Steps 0B–0D run in parallel with Phase 1. Phase 0A runs first in sequence.

0A — Existing Capability Inventory

Step 1 — check index freshness, rebuild only if stale (must complete before Step 2):

Call mcp__monomind__monograph_health({})
IF health.commitsBehind > 0 OR health.status != "fresh":
  Call mcp__monomind__monograph_build({ codeOnly: true })
  // monograph_build runs in the background. Poll freshness by re-calling monograph_health
  // every ~10s until health.status == "fresh" or health.commitsBehind == 0, then proceed to Step 2.
// If index is already fresh, skip monograph_build and proceed directly to Step 2