agent-team-architecture

Create and update agent-team packages with explicit ownership, validation, and result-based handoff.

2|1|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/AutoByteus/autobyteus-agents --skill agent-team-architecture-autobyteus
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-team-architecture
Source: https://github.com/AutoByteus/autobyteus-agents/tree/main/agents/agent-team-architect/skills/agent-team-architecture
Command: npx skills add https://github.com/AutoByteus/autobyteus-agents --skill agent-team-architecture-autobyteus

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Designing or modifying multi-agent team packages often leads to duplicated rules, conflicting ownership across agent.md, team.md, and config files, and unvalidated changes. This Skill provides a disciplined create/update workflow that keeps every rule in one canonical owner and produces a durable, validated result artifact. ## Core Features & Use Cases - Two operation modes: Create new agent-team packages or update existing ones with a recorded update intent such as optimize, repair, or extend. - Ownership contract enforcement: Assigns each concern to exactly one canonical file (agent.md, agent-config.json, SKILL.md, team.md, team-config.json, references, templates, README) to prevent conflicting definitions. - Validation and recovery: Parses changed JSON, checks frontmatter and skill name alignment, resolves links and handoff addresses, and classifies failures as in-scope corrections, requirement gaps, design impacts, or blockers. - Use Case: When asked to add a new specialist agent to an existing team, the Skill reads the full package topology, applies the smallest coherent delta to the canonical owners, reconciles team-config.json routing, validates the diff, and hands off a persisted result artifact. ## Quick Start Use the agent-team-architecture skill to create a new agent team package for code review with a coordinator and two specialist agents.

Frequently Asked Questions about agent-team-architecture

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

FAQPage Schema
How do I create a new agent team package?▼

Use the create operation mode: identify the team outcome and target repository, design the ownership spine, then add agent.md and agent-config.json per agent plus team.md and team-config.json for the team. Finish by validating all files and persisting a result artifact from the provided template.

How do I update an existing agent team without breaking it?▼

Use the update mode with a recorded update_intent such as optimize, repair, or extend. Read the complete existing package topology first, change only the canonical owner files required by the approved scope, reconcile all references, and validate before handoff.

Which file owns routing rules in an agent team?▼

team-config.json owns the runtime roster, coordinator, canonical rooted addresses, and conditional handoff rules. Skills and agent prompts must not hard-code recipient addresses; routing is resolved at runtime via get_handoff_rules.

When should I use a bundled skill versus a shared skill?▼

Choose a bundled skill under the owning agent's skills directory when one agent owns the behavior. Use a shared standalone skill source only when multiple agents genuinely need the same behavior, avoiding duplicate ownership.

What happens when validation of a package change fails?▼

Failures are classified before acting: in-scope corrections update the canonical owner and rerun checks, requirement or approval gaps stop before material changes, design impacts revise the ownership design, and external blockers are recorded in the result artifact.