infrastructure-development

Implement thread-safe EventBus, logging, metrics, profiling, and plugin infrastructure in a Python streaming engine.

Updated Feb 4, 2026
One-click install
npx skills add https://github.com/FacundoDuranDev/Spatial-Iteration-Engine --skill infrastructure-development-facundodurandev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: infrastructure-development
Source: https://github.com/FacundoDuranDev/Spatial-Iteration-Engine/tree/main/.claude/skills/infrastructure-development
Command: npx skills add https://github.com/FacundoDuranDev/Spatial-Iteration-Engine --skill infrastructure-development-facundodurandev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill provides a guided approach to building and maintaining cross-cutting infrastructure (EventBus, logging, metrics, profiling, plugins, and services) within infrastructure/ and application/services/, ensuring consistency, observability, and safe integration across the streaming engine.

Core Features & Use Cases

  • Unified infrastructure primitives: EventBus pub/sub, StructuredLogger, EngineMetrics, LoopProfiler, and plugin system for extensibility.
  • Non-intrusive, thread-safe patterns: Guidelines enforce lock usage, avoiding blocking callbacks, and safe data sharing.
  • Cross-component collaboration: Applies to both infrastructure code and application services (frame buffering, error handling, retries) to improve reliability and observability.

Quick Start

Configure and extend the engine's cross-cutting infrastructure using the provided modules and guidelines.

Frequently Asked Questions about infrastructure-development

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

FAQPage Schema
How do I implement thread-safe pub/sub EventBus and logging in Python?

To implement thread-safe EventBus and logging in Python, use lock usage, avoid blocking callbacks, and apply safe data sharing patterns. This ensures non-intrusive behavior and reliable concurrency across infrastructure components.

What is the best way to add metrics and profiling to a Python streaming engine?

Adding metrics and profiling to a Python streaming engine requires integrating EngineMetrics and LoopProfiler components. This provides structured observability, measuring cross-cutting infrastructure performance without disrupting application services.

How do I build an extensible plugin system for Python infrastructure?

Building an extensible plugin system for Python infrastructure involves creating modules with optional dependency guards and safe error handling. This ensures non-intrusive extensibility and compatibility across existing domain types.

Does cross-cutting infrastructure require specific domain type alignment?

Yes, cross-cutting infrastructure requires domain type alignment. Components like EventBus and profiling services must maintain compatibility with existing modules and adhere to safe error handling to ensure consistent integration.

Can I use optional dependencies when building infrastructure services?

Yes, you can use optional dependencies when building infrastructure services. Implementing optional dependency guards and safe error handling allows the streaming engine to maintain functionality even when specific libraries are missing.

Why do my EventBus callbacks block the main thread in Python?

EventBus callbacks block the main thread in Python when safe data sharing patterns and lock usage are neglected. Avoiding blocking callbacks ensures non-intrusive, thread-safe behavior across the streaming engine.