ai-agents

Govern GeoDS AI agents with typed state transitions and EventBus routing rules.

Updated Mar 5, 2026
One-click install
npx skills add https://github.com/ShubhamManachekar/GeoSupply --skill ai-agents-shubhammanachekar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-agents
Source: https://github.com/ShubhamManachekar/GeoSupply/tree/main/.agent/skills/ai-agents
Command: npx skills add https://github.com/ShubhamManachekar/GeoSupply --skill ai-agents-shubhammanachekar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GeoSupply's AI agent governance framework provides structured rules and patterns to build, modify, and audit multi-agent systems, ensuring guarded state transitions, safe communication patterns, and compliant auditing.

Core Features & Use Cases

  • Layered agent architecture guidance (BaseSupervisor, BaseAgent, BaseSubAgent) and centralized orchestration.
  • EventBus-based routing and single-writer state discipline for deterministic workflows.
  • Dynamic audit compliance, testing contracts, and guardrail enforcement.

Quick Start

Create a new manager-agent by extending the appropriate base class, implement a robust _transition() method, and wire interactions through the EventBus.

Frequently Asked Questions about ai-agents

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

FAQPage Schema
How do I build auditable AI agents with guarded state transitions?

Auditable AI agents are built by extending base supervisor and subagent classes, enforcing single-writer state models and EventBus routing to ensure deterministic, compliant state transitions across multi-agent workflows.

What is EventBus routing in multi-agent AI orchestration?

EventBus routing in multi-agent orchestration centralizes communication by directing agent interactions through a single channel, preventing lateral agent calls and maintaining deterministic workflow execution.

How do I enforce guardrails and audit compliance in AI agent workflows?

Guardrails and audit compliance in AI agent workflows are enforced through dynamic testing contracts, strongly typed Pydantic v2 inputs and outputs, and cost tracking within a meta dictionary across all agent layers.

Can I use Pydantic v2 for strongly typed inputs in AI agent state machines?

Yes, Pydantic v2 is required for strongly typed inputs and outputs in this AI agent state machine framework, ensuring data validation and structural integrity across supervisor, agent, and subagent components.

Why does my multi-agent AI workflow require a single-writer state model?

A single-writer state model is required in multi-agent AI workflows to prevent race conditions and unauthorized state mutations, ensuring that only designated components modify state transitions for reliable auditing.

What are the limitations of preventing lateral calls in AI agent orchestration?

Preventing lateral calls in AI agent orchestration limits direct peer-to-peer communication, requiring all interactions to route through the EventBus and supervisor layers, which ensures strict auditability but restricts ad-hoc agent messaging.