nacl-migrate-ba

Migrate BA Markdown artifacts into a Neo4j graph via Python scripts.

23|2|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ITSalt/NaCl --skill nacl-migrate-ba
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nacl-migrate-ba
Source: https://github.com/ITSalt/NaCl/tree/main/nacl-migrate-ba
Command: npx skills add https://github.com/ITSalt/NaCl --skill nacl-migrate-ba

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires nacl-migrate-core, and includes scripts (resource) components.

What problem does it solve?

Migrates an old methodology BA layer from Markdown into a live Neo4j graph by parsing structured docs (docs/00-context, docs/01-business-processes, docs/02-business-entities, docs/03-business-roles, docs/04-business-rules, docs/99-meta/glossary) and emitting a Cypher plan that writes BA nodes and relationships via mcp__neo4j__write-cypher. The result is a graph-backed BA model that supports queries, traceability, and updates.

Core Features & Use Cases

  • Deterministic parsing of BA docs via dedicated Python scripts (no LLM parsing)
  • Generates a MERGE-based Cypher plan and executes it against Neo4j
  • Validates and audits live counts to ensure migration fidelity

Quick Start

Run the migration workflow to parse your BA docs and load them into Neo4j.

Frequently Asked Questions about nacl-migrate-ba

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

FAQPage Schema
How do I migrate business architecture Markdown docs into a Neo4j graph?

Business architecture Markdown migration to Neo4j uses deterministic Python scripts to parse structured docs and generate a MERGE-based Cypher plan. This plan executes via Neo4j write operations to create BA nodes and relationships for graph-backed traceability.

Does migrating BA docs to Neo4j require an LLM to parse the Markdown?

Migrating BA docs to Neo4j does not require an LLM for parsing. The workflow relies entirely on deterministic Python scripts to parse the structured Markdown files and emit the Cypher plan for graph ingestion.

What directory structure is needed for business architecture migration to Neo4j?

Business architecture migration to Neo4j requires a specific docs/ directory structure. This includes subdirectories like 00-context, 01-business-processes, 02-business-entities, 03-business-roles, 04-business-rules, and 99-meta/glossary for parsing.

Can I validate the Neo4j graph migration after executing the Cypher plan?

You can validate the Neo4j graph migration after executing the Cypher plan. The workflow generates a ba-validation.json file and runs audit steps to validate live counts and ensure migration fidelity against the parsed BA artifacts.

Do I need nacl-migrate-core to migrate business architecture layers into Neo4j?

You need nacl-migrate-core to migrate business architecture layers into Neo4j. The migration scripts require these core adapters to function and successfully output the ba-ir.json intermediate file before writing to the graph.