xpz-kb-parallel-setup

Bootstrap and validate XPZ KB parallel-folder structures with metadata.

11|3|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/GxBrasilNOficial/GeneXus-XPZ-Skills --skill xpz-kb-parallel-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xpz-kb-parallel-setup
Source: https://github.com/GxBrasilNOficial/GeneXus-XPZ-Skills/tree/main/xpz-kb-parallel-setup
Command: npx skills add https://github.com/GxBrasilNOficial/GeneXus-XPZ-Skills --skill xpz-kb-parallel-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prepares and validates the initial structure of the Knowledge Base (KB) parallel-folder, enabling XPZ workflows while keeping the native KB untouched.

Core Features & Use Cases

  • Bootstrap the parallel folder with standard subfolders (scripts, Temp, XpzExportadosPelaIDE, ObjetosDaKbEmXml, KbIntelligence, ObjetosGeradosParaImportacaoNaKbNoGenexus, PacotesGeradosParaImportacaoNaKbNoGenexus) and essential metadata (kb-source-metadata.md, AGENTS.md, README.md).
  • Validate structure and presence of required components via Test-KbStructure-like checks, and gate progress with a compatibility workflow when KB Intelligence is involved.
  • Provide thin local wrappers in scripts for materialization, index regeneration, and quick health checks, without altering the official motor flow.

Quick Start

Run xpz-kb-parallel-setup to bootstrap the parallel KB folder structure and perform an initial compatibility check.

Frequently Asked Questions about xpz-kb-parallel-setup

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

FAQPage Schema
How do I set up a parallel folder structure for my Knowledge Base without modifying the native KB?

To set up a parallel folder structure safely, bootstrap standard subfolders for scripts, exports, and metadata while keeping the native KB untouched. This creates a reliable isolation layer for running materialization and indexing workflows.

What folders and metadata files are required to bootstrap an XPZ parallel workflow?

Bootstrapping an XPZ parallel workflow requires subfolders like scripts, Temp, XpzExportadosPelaIDE, ObjetosDaKbEmXml, and KbIntelligence, alongside essential metadata files such as kb-source-metadata.md, AGENTS.md, and README.md.

Can I use KB Intelligence workflows with a parallel folder structure?

Yes, you can use KB Intelligence with a parallel folder structure. The setup includes a compatibility workflow gate that validates preconditions and tracks necessary metadata to ensure reliable integration with the shared motor.

How do I validate the structure of my KB parallel folder before running imports?

You validate the KB parallel folder structure by running Test-KbStructure-like checks. These verify the presence of required components and enforce preconditions, ensuring compatibility before you execute materialization or import workflows.

Does setting up a parallel folder alter the official motor flow for GeneXus imports?

No, setting up a parallel folder does not alter the official motor flow. It provides thin local wrappers in scripts for materialization and indexing, maintaining operational boundaries while enabling safe GeneXus import workflows.

Why do I need a kb-source-metadata.md file in my parallel KB setup?

You need a kb-source-metadata.md file to track necessary metadata during parallel KB setup. It enforces preconditions and documents operational boundaries, ensuring compatibility with the shared motor and reliable indexing workflows.