Release Notes: v0.3.0

Release Date: 2026-01-24

Highlights

Add namespace support for organizing agents into subdirectories.

What's New

Namespace Support

• Optional namespace field in agent schema for organizing agents
• Recursive directory scanning in LoadAgentsFromDir - agents in subdirectories get namespace from directory name
• LoadAgentsFromDirFlat function for non-recursive loading (backward compatibility)

Loader Functions

• LoadAgentFromFile - Load single agent from file
• LoadTeamFromFile - Load team from file
• LoadDeploymentFromFile - Load deployment from file

Go SDK Enhancements

• Namespace field on Agent struct
• AllowedTools field on Agent struct
• QualifiedName() method on Agent to get namespace/name format
• ParseQualifiedName() function to split qualified names
• WithNamespace() builder method on Agent
• YAML struct tags on all Agent fields

Team Schema

• Support for namespace/agent-name references in team schema (agents, orchestrator, step.agent)

Documentation

• README section on nested agent directories with examples

Installation

Go SDK

go get github.com/plexusone/multi-agent-spec/sdk/go@v0.3.0

Example: Nested Agent Directories

specs/
├── agents/
│   ├── pm.md              # namespace: "" (root)
│   ├── qa/
│   │   ├── unit.md        # namespace: "qa"
│   │   └── integration.md # namespace: "qa"
│   └── security/
│       └── scanner.md     # namespace: "security"

Reference in teams:

{
  "agents": ["pm", "qa/unit", "qa/integration", "security/scanner"]
}