Agent Clusters¶
Target
This page describes intended behaviour or structure. No implementation is claimed unless a section is explicitly marked Current implementation or Evidence.
Reviewed 2026-10-09
Clusters group agent roles specified on this site (100 specifications). The AgentKit registry that mirrors them is one of the earlier, non-Factory experiments (user decision D19, 2026-10-09) and is not the Factory's registry. A cluster is not a runtime unit, and "implemented" is not a deployed or evaluated agent. Cluster membership and ownership belong to the Software Factory pack; execution semantics belong here.
Target Architecture — Final-State Design
The Agent Mesh organizes its autonomous workforce into eight clusters. A cluster is a logical grouping of agents that share a delivery discipline, a body of skills, and a set of permission scopes. Clusters are an organizing concept for governance and collaboration — at runtime every agent is hosted uniformly on the Agent Runtime and registered in the Agent Registry.
Clusters mirror the end-to-end factory lifecycle: each cluster owns a phase, produces specific artifacts, and hands off to the next through the Control Plane. The full roster and per-agent specs are in the Agent Catalog and detailed agent specifications; collaboration mechanics are in Agent Collaboration Patterns.
Cluster Map¶
flowchart LR
Vision["Vision & Strategy"] --> Product["Product Planning"]
Product --> UX["UX/UI"]
UX --> Arch["Architecture"]
Arch --> Eng["Engineering"]
Eng --> QA["QA & Security"]
QA --> DevOps["DevOps & Release"]
DevOps --> Evolution["Runtime Evolution"]
Evolution -->|"feedback"| Vision1. Vision & Strategy¶
Turns business intent into validated product vision, market positioning, and prioritized strategy. Maps to vision-and-planning-agents-overview.
| Agent | Role |
|---|---|
ConnectSoft.Agent.VisionArchitect |
Synthesizes intent into a product vision and north-star outcomes. |
ConnectSoft.Agent.BusinessAnalyst |
Elicits and structures requirements and constraints. |
ConnectSoft.Agent.CompetitiveIntelligence |
Analyzes market and competitor positioning. |
ConnectSoft.Agent.GrowthStrategist |
Defines growth model, pricing levers, and adoption strategy. |
ConnectSoft.Agent.UserResearcher |
Produces personas and research-grounded insight. |
ConnectSoft.Agent.StakeholderAlignment |
Reconciles stakeholder goals into agreed priorities. |
2. Product Planning¶
Converts vision into a backlog, roadmap, and module breakdown. Maps to product-manager-agent and product-owner-agent.
| Agent | Role |
|---|---|
ConnectSoft.Agent.ProductManager |
Owns roadmap, scope, and prioritization. |
ConnectSoft.Agent.ProductOwner |
Authors epics, stories, and acceptance criteria. |
ConnectSoft.Agent.PersonaBuilder |
Builds and refines target personas. |
ConnectSoft.Agent.Onboarding |
Designs onboarding journeys and activation flows. |
3. UX/UI¶
Designs the experience, interaction model, and design system. Maps to ux-designer-agent and ui-designer-agent.
| Agent | Role |
|---|---|
ConnectSoft.Agent.UxDesigner |
Information architecture and interaction design. |
ConnectSoft.Agent.UiDesigner |
Visual design and high-fidelity screens. |
ConnectSoft.Agent.DesignSystem |
Maintains the reusable design system. |
ConnectSoft.Agent.ContentDesigner |
UX writing and content strategy. |
ConnectSoft.Agent.AccessibilityEngineer |
Ensures WCAG-conformant, inclusive design. |
4. Architecture¶
Produces domain models, service blueprints, and architecture decisions. Maps to architect-agents-overview.
| Agent | Role |
|---|---|
ConnectSoft.Agent.SolutionArchitect |
Designs service blueprints and system structure. |
ConnectSoft.Agent.EnterpriseArchitect |
Aligns solutions to enterprise standards. |
ConnectSoft.Agent.DomainModeler |
Produces bounded contexts and domain models. |
ConnectSoft.Agent.DataArchitect |
Designs data models and storage strategy. |
ConnectSoft.Agent.EventDrivenArchitect |
Designs events, topics, and messaging flows. |
ConnectSoft.Agent.SecurityArchitect |
Defines security architecture and threat model. |
ConnectSoft.Agent.IntegrationArchitect |
Designs integration and adapter strategy. |
ConnectSoft.Agent.Adr |
Records architecture decisions (ADRs). |
ConnectSoft.Agent.UbiquitousLanguage |
Curates the shared domain language. |
5. Engineering¶
Generates services, libraries, APIs, UIs, and commits. Maps to engineering-agents-overview.
| Agent | Role |
|---|---|
ConnectSoft.Agent.BackendDeveloper |
Implements backend logic and persistence. |
ConnectSoft.Agent.FrontendDeveloper |
Implements web UIs. |
ConnectSoft.Agent.MobileDeveloper |
Implements mobile applications. |
ConnectSoft.Agent.MicroserviceGenerator |
Scaffolds microservices from blueprints and templates. |
ConnectSoft.Agent.ApiDesigner |
Designs API contracts and gateways. |
ConnectSoft.Agent.LibraryGenerator |
Generates reusable libraries. |
ConnectSoft.Agent.DatabaseEngineer |
Builds schemas and migrations. |
ConnectSoft.Agent.TechLead |
Coordinates engineering decisions and reviews. |
ConnectSoft.Agent.CodeCommitter |
Commits and structures changes. |
ConnectSoft.Agent.PullRequestCreator |
Opens and describes pull requests. |
6. QA & Security¶
Validates correctness, coverage, and security. Maps to qa-agents-overview.
| Agent | Role |
|---|---|
ConnectSoft.Agent.QaEngineer |
Test strategy and quality gates. |
ConnectSoft.Agent.CodeReviewer |
Reviews generated code against standards. |
ConnectSoft.Agent.TestCaseGenerator |
Generates test cases from acceptance criteria. |
ConnectSoft.Agent.TestAutomationEngineer |
Builds automated test suites. |
ConnectSoft.Agent.SecurityEngineer |
Implements security controls and remediation. |
ConnectSoft.Agent.SecurityPenetrationTesting |
Performs penetration and abuse testing. |
ConnectSoft.Agent.VulnerabilityManagement |
Triages and tracks vulnerabilities. |
ConnectSoft.Agent.BugInvestigator |
Diagnoses defects. |
ConnectSoft.Agent.BugResolver |
Implements defect fixes. |
7. DevOps & Release¶
Provisions infrastructure and ships releases. Maps to devops-deployment-delivery-agents-overview. Infrastructure is provisioned as code with Pulumi.
| Agent | Role |
|---|---|
ConnectSoft.Agent.DevOpsEngineer |
Builds CI/CD and automation. |
ConnectSoft.Agent.DeploymentOrchestrator |
Coordinates multi-stage deployments. |
ConnectSoft.Agent.ReleaseManager |
Manages release trains and gates. |
ConnectSoft.Agent.CloudProvisioner |
Provisions cloud resources via Pulumi. |
ConnectSoft.Agent.InfrastructureEngineer |
Authors and maintains IaC. |
ConnectSoft.Agent.EnvironmentManager |
Manages environment topology. |
ConnectSoft.Agent.ConfigurationManager |
Manages configuration and secrets wiring. |
ConnectSoft.Agent.Iam |
Manages identity and access provisioning. |
8. Runtime Evolution¶
Observes the running SaaS and drives continuous improvement. Maps to observability-engineer-agent and feedback-evolution-agent.
| Agent | Role |
|---|---|
ConnectSoft.Agent.ObservabilityEngineer |
Instruments telemetry, dashboards, and SLOs. |
ConnectSoft.Agent.FeedbackEvolution |
Converts runtime feedback into improvement tasks. |
ConnectSoft.Agent.LogAnalysis |
Mines logs for signals and anomalies. |
ConnectSoft.Agent.AlertingIncidentManager |
Manages alerting and incident routing. |
ConnectSoft.Agent.IncidentResponse |
Drives incident response and remediation. |
ConnectSoft.Agent.SloSlaCompliance |
Tracks SLO/SLA conformance. |
ConnectSoft.Agent.AbTestingExperimentation |
Designs and analyzes experiments. |
ConnectSoft.Agent.Analytics |
Produces product and usage analytics. |
Skills¶
Every agent binds its skills by id from the skills catalog: 866 skills seeded from the specifications on 2026-10-14 (D53), grouped by cluster, each owned by one agent and Draft until it is curated, evaluated (ADR-0021) and released as a BC-04 asset. The role card of each specification lists the agent's skills with their operations; the catalog lists, per skill, the agents that bind it.
Cluster Collaboration¶
Clusters collaborate through the Control Plane's workflows and the shared event stream — never by direct, hidden coupling. A cluster's output artifacts become a downstream cluster's context.
sequenceDiagram
participant CP as Control Plane
participant Arch as Architecture Cluster
participant Eng as Engineering Cluster
participant QA as "QA & Security Cluster"
participant Evo as Runtime Evolution Cluster
CP->>Arch: AssignAgentTask (design blueprint)
Arch-->>CP: AgentTaskCompleted (ServiceBlueprint)
CP->>Eng: AssignAgentTask (generate service)
Eng-->>CP: AgentTaskCompleted (Microservice)
CP->>QA: AssignAgentTask (validate & secure)
QA-->>CP: AgentTaskCompleted (TestSuite, Findings)
CP->>Evo: observe runtime
Evo-->>CP: AgentTaskAssigned (improvement)This handoff pattern keeps the workforce autonomous yet governed: every transition is an event, every artifact is traceable, and every cluster reuses the artifacts and skills of those before it.
Related¶
- Agent Catalog
- Agent System Overview
- Agent Execution Flow
- Agent Collaboration Patterns
- Agent Registry
Clusters from the model (2026-10-09, design plan A2)¶
Every agent is modelled under model/agents/<cluster>/ with its role card, tools and classes, policies, budget and evaluation suite; the six clusters below are generated from the model. The June-2026 overview pages of five clusters stay as narrative; the operations cluster has no overview page and is listed only here.
Vision and product planning (vision-planning)¶
| Agent | Model profile | Max side-effect class | Tools | Release state |
|---|---|---|---|---|
| Analytics Agent | structured |
read | 3 | Draft |
| Architecture Orchestrator Agent | reasoning-high |
shared-write | 6 | Draft |
| Business Analyst Agent | reasoning |
shared-write | 6 | Draft |
| Competitive Intelligence Agent | long-context |
external | 4 | Draft |
| ConnectSoft Incubator Agent | reasoning-high |
shared-write | 6 | Draft |
| Content Designer Agent | reasoning |
shared-write | 6 | Draft |
| Customer Success Agent | reasoning |
external | 3 | Draft |
| Factory Workflow Orchestrator Agent | reasoning |
shared-write | 6 | Draft |
| Growth Strategist Agent | reasoning |
shared-write | 6 | Draft |
| Marketing Specialist Agent | reasoning |
external | 4 | Draft |
| Onboarding Agent | code-agent |
shared-write | 6 | Draft |
| Persona Builder Agent | reasoning |
shared-write | 6 | Draft |
| Product Manager Agent | reasoning |
shared-write | 6 | Draft |
| Product Owner Agent | reasoning |
shared-write | 6 | Draft |
| Stakeholder Alignment Agent | reasoning |
shared-write | 6 | Draft |
| User Researcher Agent | reasoning |
external | 4 | Draft |
| Vision Architect Agent | reasoning-high |
shared-write | 6 | Draft |
| Work Preparation Orchestrator Agent | reasoning |
shared-write | 6 | Draft |
Architecture and design (architecture)¶
| Agent | Model profile | Max side-effect class | Tools | Release state |
|---|---|---|---|---|
| Accessibility Engineer Agent | code-agent |
shared-write | 13 | Draft |
| ADR Agent | reasoning |
shared-write | 6 | Draft |
| API Designer Agent | code-agent |
shared-write | 6 | Draft |
| Application Architect Agent | reasoning |
shared-write | 6 | Draft |
| Cloud Architecture Agent | reasoning |
shared-write | 6 | Draft |
| Data Architect Agent | reasoning |
shared-write | 6 | Draft |
| Design System Agent | code-agent |
shared-write | 6 | Draft |
| DevOps Architect Agent | reasoning |
shared-write | 6 | Draft |
| Domain Modeler Agent | reasoning-high |
shared-write | 6 | Draft |
| Enterprise Architect Agent | reasoning-high |
shared-write | 6 | Draft |
| Event-Driven Architect Agent | reasoning |
shared-write | 6 | Draft |
| Infrastructure Architect Agent | reasoning |
shared-write | 6 | Draft |
| Integration Architect Agent | reasoning |
shared-write | 6 | Draft |
| Localization and Internationalization Agent | code-agent |
shared-write | 13 | Draft |
| Network Architect Agent | reasoning |
shared-write | 6 | Draft |
| Security Architect Agent | reasoning-high |
shared-write | 6 | Draft |
| Solution Architect Agent | reasoning-high |
shared-write | 6 | Draft |
| Ubiquitous Language Agent | reasoning |
shared-write | 6 | Draft |
| UI Designer Agent | reasoning |
shared-write | 6 | Draft |
| UX Designer Agent | reasoning-high |
shared-write | 6 | Draft |
Software engineering (engineering)¶
| Agent | Model profile | Max side-effect class | Tools | Release state |
|---|---|---|---|---|
| Adapter Generator Agent | code-agent |
shared-write | 13 | Draft |
| API Documentation Agent | structured |
shared-write | 6 | Draft |
| API Gateway Generator Agent | code-agent |
shared-write | 13 | Draft |
| API Library Generator Agent | code-agent |
shared-write | 13 | Draft |
| Backend Developer Agent | code-agent-strong |
shared-write | 13 | Draft |
| Bug Investigator Agent | code-agent-strong |
sandbox | 12 | Draft |
| Bug Resolver Agent | code-agent-strong |
shared-write | 13 | Draft |
| Code Committer Agent | code-fast |
shared-write | 4 | Draft |
| Code Quality Agent | code-agent |
sandbox | 12 | Draft |
| Code Reviewer Agent | code-agent-strong |
sandbox | 12 | Draft |
| Configuration Manager Agent | code-agent |
shared-write | 13 | Draft |
| Database Engineer Agent | code-agent |
shared-write | 13 | Draft |
| Documentation Site Generator Agent | code-agent |
shared-write | 13 | Draft |
| Documentation Writer Agent | reasoning |
shared-write | 6 | Draft |
| Feature Toggle Edition Manager Agent | code-agent |
shared-write | 13 | Draft |
| Frontend Developer Agent | code-agent-strong |
shared-write | 13 | Draft |
| IAM Agent | code-agent |
shared-write | 13 | Draft |
| Knowledge Management Agent | reasoning |
shared-write | 4 | Draft |
| Backend Library Generator Agent | code-agent |
shared-write | 13 | Draft |
| Low-Code API Platform Agent | code-agent |
shared-write | 13 | Draft |
| Microservice Generator Agent | code-agent-strong |
shared-write | 13 | Draft |
| Mobile Developer Agent | code-agent-strong |
shared-write | 13 | Draft |
| Pull Request Creator Agent | code-fast |
shared-write | 4 | Draft |
| Refactoring Agent | code-agent-strong |
shared-write | 13 | Draft |
| Self-Service Portal Builder Agent | code-agent |
shared-write | 13 | Draft |
| Tech Lead Agent | reasoning-high |
shared-write | 13 | Draft |
| Tenant Management Agent | code-agent |
shared-write | 13 | Draft |
| UI Component Library Generator Agent | code-agent |
shared-write | 13 | Draft |
| Usage Metering and Billing Agent | code-agent |
shared-write | 13 | Draft |
Quality assurance (qa)¶
| Agent | Model profile | Max side-effect class | Tools | Release state |
|---|---|---|---|---|
| A/B Testing and Experimentation Agent | structured |
shared-write | 3 | Draft |
| Contract Testing Agent | code-agent |
sandbox | 12 | Draft |
| E2E Testing Agent | code-agent |
sandbox | 6 | Draft |
| Load and Performance Testing Agent | code-agent |
sandbox | 12 | Draft |
| QA Engineer Agent | code-agent |
sandbox | 12 | Draft |
| Resiliency and Chaos Agent | code-agent |
sandbox | 4 | Draft |
| Security Penetration Testing Agent | code-agent-strong |
sandbox | 5 | Draft |
| Test Automation Engineer Agent | code-agent |
sandbox | 12 | Draft |
| Test Case Generator Agent | structured |
sandbox | 12 | Draft |
| Test Coverage Validator Agent | structured |
sandbox | 12 | Draft |
| Test Generator Agent | code-agent |
sandbox | 12 | Draft |
| Usability Testing Agent | reasoning |
sandbox | 3 | Draft |
DevOps, deployment and delivery (devops-delivery)¶
| Agent | Model profile | Max side-effect class | Tools | Release state |
|---|---|---|---|---|
| Cloud Provisioner Agent | code-agent |
production | 14 | Draft |
| Deployment Orchestrator Agent | reasoning |
production | 4 | Draft |
| DevOps Engineer Agent | code-agent |
shared-write | 15 | Draft |
| Environment Manager Agent | code-agent |
production | 4 | Draft |
| Infrastructure Engineer Agent | code-agent |
production | 14 | Draft |
| Release Manager Agent | reasoning |
production | 4 | Draft |
Operations, security and evolution (operations)¶
| Agent | Model profile | Max side-effect class | Tools | Release state |
|---|---|---|---|---|
| Alerting and Incident Manager Agent | structured |
shared-write | 5 | Draft |
| Feedback and Evolution Agent | reasoning-high |
shared-write | 5 | Draft |
| Incident Response Agent | reasoning-high |
external | 6 | Draft |
| Log Analysis Agent | long-context |
read | 3 | Draft |
| Observability Engineer Agent | code-agent |
shared-write | 13 | Draft |
| Platform Cost Optimization Agent | structured |
shared-write | 5 | Draft |
| Privacy Compliance Agent | reasoning-high |
shared-write | 6 | Draft |
| Security Engineer Agent | code-agent-strong |
shared-write | 13 | Draft |
| SLO/SLA Compliance Agent | structured |
shared-write | 5 | Draft |
| Vulnerability Management Agent | structured |
shared-write | 5 | Draft |