@aiready/agents

AIReady Spoke: Multi-Human Multi-Agent (MH-MA) orchestration, task execution, and collaborative workflow management.

Overview

The Agents package provides the orchestration layer for Multi-Human Multi-Agent Collaboration (MH-MA). It manages multi-step agent workflows, coordinates tool execution, and handles the feedback loops that enable autonomous analysis and remediation with human-in-the-loop oversight.

🏛️ Architecture

                    🎯 USER
                      │
                      ▼
         🎛️  @aiready/cli (orchestrator)
          │     │     │     │     │     │     │     │     │     │
          ▼     ▼     ▼     ▼     ▼     ▼     ▼     ▼     ▼     ▼
        [PAT] [CTX] [CON] [AMP] [DEP] [DOC] [SIG] [AGT] [TST] [CTR]
          │     │     │     │     │     │     │     │     │     │
          └─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┘
                               │
                               ▼
                      🏢 @aiready/core

Legend:
  PAT = pattern-detect        CTX = context-analyzer
  CON = consistency           AMP = change-amplification
  DEP = deps-health           DOC = doc-drift
  SIG = ai-signal-clarity     AGT = agent-grounding
  TST = testability           CTR = contract-enforcement

  agents = orchestration layer (this package)

Features

• MH-MA Orchestration: Manages multi-step workflows coordinating multiple AI agents and human stakeholders
• Workflow Orchestration: Manages multi-step agentic workflows coordinating multiple AIReady spokes
• Task Execution: Runs analysis tasks and remediation actions with proper error handling and retries
• Feedback Loops: Implements verify→fix→verify cycles for autonomous code improvement
• Tool Integration: Bridges AIReady analysis tools with AI model APIs
• Human-Agent Collaboration: Provides hooks for human-in-the-loop validation and strategic guidance

Installation

pnpm add @aiready/agents

Usage

This package is primarily used as an internal orchestration layer by @aiready/cli.

# Run via the unified CLI
aiready scan . --tools agents

License

MIT