# bpforbes/devops-multi-agent-team-skill architecture

> Architecture diagram of the GitHub repository bpforbes/devops-multi-agent-team-skill, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bpforbes/devops-multi-agent-team-skill
- Repository: https://github.com/bpforbes/devops-multi-agent-team-skill

## Overview

This repository packages a DevOps multi-agent workflow for Cursor and Claude Code, with chat-driven project setup, language/service configuration, QA and release safeguards, and a project mind map. The main setup path is user → MCP tools → project detection/planning → installation and profile generation; the Claude hooks separately add workflow context and enforce publish gates. The graph includes documented capabilities even where implementation was not sampled. Edges are limited to README statements and SOURCE INDEX references; unsampled relationships are omitted.

Main entry points: [`mcp/server.mjs`](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/mcp/server.mjs) (MCP tools), [`scripts/devops-setup.mjs`](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-setup.mjs) (Setup and detection), [`scripts/devops-cleanup.mjs`](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-cleanup.mjs) (Cleanup analysis), [`scripts/devops-mindmap.mjs`](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-mindmap.mjs) (Mind map engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Agent workflow"]
  node_team_skill["Team skill<br/>[SKILL.md]"]
  node_role_agents["Role agents"]
  node_team_commands["Workflow commands"]
  node_stories["Story tracking<br/>[devops-stories.mjs]"]
end

subgraph group_integration["Client integration"]
  node_mcp["MCP tools<br/>[server.mjs]"]
  node_claude(("Claude client"))
  node_hook_register["Hook registration<br/>[register.ts]"]
  node_hook_context["Session context<br/>[orchestrate.ts]"]
  node_push_guard["Publish guard<br/>[guard.ts]"]
  node_brief["Role brief<br/>[brief.ts]"]
end

subgraph group_setup["Project setup"]
  node_setup_cli["Setup and detection<br/>[devops-setup.mjs]"]
  node_language_config["Language catalog<br/>[languages.json]"]
  node_service_config["Service catalog<br/>[services.json]"]
end

subgraph group_quality["Quality and release"]
  node_standards["Standards config"]
  node_cleanup["Cleanup analysis<br/>[devops-cleanup.mjs]"]
  node_comments["Comment audit"]
  node_lint["Lint checks<br/>[devops-lint.mjs]"]
  node_lint_rules["Lint rules"]
  node_formal["Formal checks<br/>[devops-formal.mjs]"]
  node_security["Security checks<br/>[devops-ghas.mjs]"]
  node_release_tags["Release tags<br/>[devops-tags.mjs]"]
end

subgraph group_map["Project mind map"]
  node_research["Repository research"]
  node_mindmap["Mind map engine<br/>[devops-mindmap.mjs]"]
  node_mindmap_text["Map wording<br/>[mindmap-text.json]"]
end

node_user(("Engineer"))

node_user -->|"requests setup"| node_mcp
node_mcp -->|"plans installation"| node_setup_cli
node_setup_cli -->|"loads languages"| node_language_config
node_setup_cli -->|"loads services"| node_service_config
node_claude -->|"loads plugin"| node_hook_register
node_hook_register -->|"registers hook"| node_hook_context
node_hook_register -->|"registers guard"| node_push_guard
node_hook_context -->|"reads brief"| node_brief
node_hook_context -->|"runs setup"| node_setup_cli
node_user -->|"starts workflow"| node_team_skill
node_team_skill -->|"coordinates roles"| node_role_agents
node_team_skill -->|"uses commands"| node_team_commands
node_mcp -->|"calls analysis"| node_cleanup
node_mcp -->|"calls map tools"| node_mindmap
node_mcp -->|"exposes tools"| node_comments
node_mcp -->|"exposes tools"| node_formal
node_mcp -->|"exposes tools"| node_lint
node_mcp -->|"exposes tools"| node_security
node_mcp -->|"exposes tools"| node_stories
node_mcp -->|"exposes tools"| node_release_tags
node_cleanup -->|"loads limits"| node_standards
node_cleanup -->|"uses audit"| node_comments
node_cleanup -->|"uses language map"| node_research
node_comments -->|"loads settings"| node_standards
node_lint -->|"scans candidates"| node_cleanup
node_lint -->|"audits changes"| node_comments
node_lint -->|"uses rules"| node_lint_rules
node_standards -->|"validates rules"| node_lint_rules
node_research -->|"loads project files"| node_setup_cli
node_mindmap -->|"uses module analysis"| node_research
node_mindmap -->|"walks project"| node_setup_cli
node_mindmap -->|"loads wording"| node_mindmap_text
node_user -->|"asks map questions"| node_mindmap
node_user -->|"requests checks"| node_formal
node_user -->|"requests review"| node_security
node_user -->|"tracks work"| node_stories
node_user -.->|"plans release"| node_release_tags

click node_mcp "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/mcp/server.mjs"
click node_hook_register "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/hooks/register.ts"
click node_hook_context "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/hooks/orchestrate.ts"
click node_push_guard "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/hooks/guard.ts"
click node_brief "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/hooks/brief.ts"
click node_team_skill "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/skills/devops-multi-agent-team/SKILL.md"
click node_role_agents "https://github.com/bpforbes/devops-multi-agent-team-skill/tree/main/agents"
click node_team_commands "https://github.com/bpforbes/devops-multi-agent-team-skill/tree/main/commands"
click node_setup_cli "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-setup.mjs"
click node_language_config "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/languages.json"
click node_service_config "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/services.json"
click node_standards "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-standards.mjs"
click node_cleanup "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-cleanup.mjs"
click node_comments "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-comments.mjs"
click node_lint "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-lint.mjs"
click node_lint_rules "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-lint-rules.mjs"
click node_formal "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-formal.mjs"
click node_security "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-ghas.mjs"
click node_stories "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-stories.mjs"
click node_release_tags "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-tags.mjs"
click node_research "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-research.mjs"
click node_mindmap "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-mindmap.mjs"
click node_mindmap_text "https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/mindmap-text.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_team_skill,node_role_agents,node_team_commands,node_stories toneBlue
class node_mcp,node_claude,node_hook_register,node_hook_context,node_push_guard,node_brief toneAmber
class node_setup_cli,node_language_config,node_service_config toneMint
class node_standards,node_cleanup,node_comments,node_lint,node_lint_rules,node_formal,node_security,node_release_tags toneRose
class node_research,node_mindmap,node_mindmap_text,node_user toneIndigo
```

## Components

### Agent workflow

- [Team skill](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/skills/devops-multi-agent-team/SKILL.md): `skills/devops-multi-agent-team/SKILL.md`
- [Role agents](https://github.com/bpforbes/devops-multi-agent-team-skill/tree/main/agents): `agents`
- [Workflow commands](https://github.com/bpforbes/devops-multi-agent-team-skill/tree/main/commands): `commands`
- [Story tracking](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-stories.mjs): `scripts/devops-stories.mjs`

### Client integration

- [MCP tools](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/mcp/server.mjs): `mcp/server.mjs`
- **Claude client**
- [Hook registration](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/hooks/register.ts): `hooks/register.ts`
- [Session context](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/hooks/orchestrate.ts): `hooks/orchestrate.ts`
- [Publish guard](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/hooks/guard.ts): `hooks/guard.ts`
- [Role brief](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/hooks/brief.ts): `hooks/brief.ts`

### Project setup

- [Setup and detection](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-setup.mjs): `scripts/devops-setup.mjs`
- [Language catalog](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/languages.json): `languages.json`
- [Service catalog](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/services.json): `services.json`

### Quality and release

- [Standards config](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-standards.mjs): `scripts/devops-standards.mjs`
- [Cleanup analysis](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-cleanup.mjs): `scripts/devops-cleanup.mjs`
- [Comment audit](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-comments.mjs): `scripts/devops-comments.mjs`
- [Lint checks](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-lint.mjs): `scripts/devops-lint.mjs`
- [Lint rules](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-lint-rules.mjs): `scripts/devops-lint-rules.mjs`
- [Formal checks](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-formal.mjs): `scripts/devops-formal.mjs`
- [Security checks](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-ghas.mjs): `scripts/devops-ghas.mjs`
- [Release tags](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-tags.mjs): `scripts/devops-tags.mjs`

### Project mind map

- [Repository research](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-research.mjs): `scripts/devops-research.mjs`
- [Mind map engine](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/scripts/devops-mindmap.mjs): `scripts/devops-mindmap.mjs`
- [Map wording](https://github.com/bpforbes/devops-multi-agent-team-skill/blob/main/mindmap-text.json): `mindmap-text.json`

### Other components

- **Engineer**

## Connections

- Engineer → MCP tools: requests setup (evidence: `README.md`)
- MCP tools → Setup and detection: plans installation (evidence: `mcp/server.mjs`)
- Setup and detection → Language catalog: loads languages (evidence: `scripts/devops-setup.mjs`)
- Setup and detection → Service catalog: loads services
- Claude client → Hook registration: loads plugin (evidence: `README.md`)
- Hook registration → Session context: registers hook (evidence: `hooks/register.ts`)
- Hook registration → Publish guard: registers guard (evidence: `hooks/register.ts`)
- Session context → Role brief: reads brief (evidence: `hooks/orchestrate.ts`)
- Session context → Setup and detection: runs setup (evidence: `hooks/orchestrate.ts`)
- Engineer → Team skill: starts workflow (evidence: `README.md`)
- Team skill → Role agents: coordinates roles (evidence: `README.md`)
- Team skill → Workflow commands: uses commands (evidence: `README.md`)
- MCP tools → Cleanup analysis: calls analysis (evidence: `mcp/server.mjs`)
- MCP tools → Mind map engine: calls map tools (evidence: `mcp/server.mjs`)
- MCP tools → Comment audit: exposes tools (evidence: `mcp/server.mjs`)
- MCP tools → Formal checks: exposes tools (evidence: `mcp/server.mjs`)
- MCP tools → Lint checks: exposes tools (evidence: `mcp/server.mjs`)
- MCP tools → Security checks: exposes tools (evidence: `mcp/server.mjs`)
- MCP tools → Story tracking: exposes tools (evidence: `mcp/server.mjs`)
- MCP tools → Release tags: exposes tools (evidence: `mcp/server.mjs`)
- Cleanup analysis → Standards config: loads limits (evidence: `scripts/devops-cleanup.mjs`)
- Cleanup analysis → Comment audit: uses audit (evidence: `scripts/devops-cleanup.mjs`)
- Cleanup analysis → Repository research: uses language map (evidence: `scripts/devops-cleanup.mjs`)
- Comment audit → Standards config: loads settings (evidence: `scripts/devops-comments.mjs`)
- Lint checks → Cleanup analysis: scans candidates (evidence: `scripts/devops-lint.mjs`)
- Lint checks → Comment audit: audits changes (evidence: `scripts/devops-lint.mjs`)
- Lint checks → Lint rules: uses rules (evidence: `scripts/devops-lint.mjs`)
- Standards config → Lint rules: validates rules (evidence: `scripts/devops-standards.mjs`)
- Repository research → Setup and detection: loads project files (evidence: `scripts/devops-research.mjs`)
- Mind map engine → Repository research: uses module analysis (evidence: `scripts/devops-mindmap.mjs`)
- Mind map engine → Setup and detection: walks project (evidence: `scripts/devops-mindmap.mjs`)
- Mind map engine → Map wording: loads wording
- Engineer → Mind map engine: asks map questions (evidence: `README.md`)
- Engineer → Formal checks: requests checks (evidence: `README.md`)
- Engineer → Security checks: requests review (evidence: `README.md`)
- Engineer → Story tracking: tracks work (evidence: `README.md`)
- Engineer → Release tags: plans release
