gnn-system-integration - SKILL.md Agent Skill

name: gnn-system-integration description: GNN system integration and cross-module coordination. Use when coordinating data flow between pipeline steps, resolving cross-module dependencies, or configuring inter-step communication.

GNN System Integration (Step 17)

Purpose

Coordinates data flow and communication between pipeline modules. Manages cross-module dependencies, resolves data handoffs, and ensures consistent state across the 25-step pipeline.

Key Commands

# Run integration step
python src/17_integration.py --target-dir input/gnn_files --output-dir output --verbose

# As part of pipeline
python src/main.py --only-steps 17 --verbose

API

from integration import process_integration

# Process integration step (used by pipeline)
result = process_integration(target_dir, output_dir, verbose=True)

Key Exports

process_integration — main pipeline processing function

Integration Points

Source Step	Target Step	Data Flow
Step 3 (GNN)	Steps 5–8, 10–11, 13	Parsed models
Step 11 (Render)	Step 12 (Execute)	Generated scripts
Step 12 (Execute)	Step 16 (Analysis)	Execution results
Step 16 (Analysis)	Step 23 (Report)	Analysis summaries

Output

Integration reports in output/17_integration_output/
Cross-module dependency resolution logs

MCP Tools

This module registers tools with the GNN MCP server (see mcp.py):

check_integration_dependencies
get_integration_status
list_supported_integrations
process_integration

References

AGENTS.md — Module documentation
README.md — Usage guide
SPEC.md — Module specification

Documentation

README: Module Overview
AGENTS: Agentic Workflows
SPEC: Architectural Specification
SKILL: Capability API