# itential/builder-skills architecture

> Architecture diagram of the GitHub repository itential/builder-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/itential/builder-skills
- Repository: https://github.com/itential/builder-skills

## Overview

Itential Agentic Builder Skills is a collection of AI-assisted infrastructure automation skills, organized around an engineer-approved, spec-driven delivery lifecycle. Engineers start with requirements, proceed through feasibility and design, implementation, and QA, then review the delivered artifacts. Separate skills support reverse-engineering and documentation, platform exploration, and specialized platform operations. The README documents the handoffs and capabilities; unsampled skill implementations limit confidence about their internal wiring.

Main entry points: [`.claude/skills/spec-agent/SKILL.md`](https://github.com/itential/builder-skills/blob/main/.claude/skills/spec-agent/SKILL.md) (Spec agent), [`.claude/skills/iag/SKILL.md`](https://github.com/itential/builder-skills/blob/main/.claude/skills/iag/SKILL.md) (IAG services), [`.claude/skills/solution-arch-agent/SKILL.md`](https://github.com/itential/builder-skills/blob/main/.claude/skills/solution-arch-agent/SKILL.md) (Solution architect), [`.claude/skills/builder-agent/SKILL.md`](https://github.com/itential/builder-skills/blob/main/.claude/skills/builder-agent/SKILL.md) (Builder agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_delivery["Spec-driven delivery"]
  node_spec["Spec agent<br/>[SKILL.md]"]
  node_architecture["Solution architect<br/>[SKILL.md]"]
  node_builder["Builder agent<br/>[SKILL.md]"]
  node_qa["QA agent<br/>[SKILL.md]"]
end

subgraph group_discovery["Discovery and docs"]
  node_flowagent_spec["FlowAgent to spec<br/>[SKILL.md]"]
  node_project_spec["Project to spec<br/>[SKILL.md]"]
  node_documentation["Documentation<br/>[SKILL.md]"]
  node_explore["Platform explore<br/>[SKILL.md]"]
end

subgraph group_platform["Platform operations"]
  node_flowagent["FlowAgent<br/>[SKILL.md]"]
  node_iag["IAG services<br/>[SKILL.md]"]
  node_mop["MOP automation<br/>[SKILL.md]"]
  node_devices["Device management<br/>[SKILL.md]"]
  node_golden["Golden config<br/>[SKILL.md]"]
  node_inventory["Inventory management<br/>[SKILL.md]"]
  node_forms["JSON Forms<br/>[SKILL.md]"]
  node_lcm["Lifecycle management<br/>[SKILL.md]"]
end

subgraph group_migration["Migration"]
  node_gateway_migration["Gateway migration<br/>[SKILL.md]"]
end

node_engineer(("Engineer"))
node_platform_service["Itential Platform"]
node_iag_service["IAG 5"]

node_engineer -->|"requests requirements"| node_spec
node_spec -->|"approved spec"| node_architecture
node_architecture -->|"approved design"| node_builder
node_builder -->|"hands off build"| node_qa
node_qa -->|"presents for sign-off"| node_engineer
node_engineer -->|"requests conversion"| node_flowagent_spec
node_flowagent_spec -->|"produces spec input"| node_spec
node_engineer -->|"requests reverse engineering"| node_project_spec
node_project_spec -->|"produces spec"| node_spec
node_engineer -->|"requests survey"| node_documentation
node_documentation -->|"surveys assets"| node_platform_service
node_engineer -->|"requests exploration"| node_explore
node_explore -->|"pulls live data"| node_platform_service
node_flowagent -->|"creates and runs agents"| node_platform_service
node_iag -->|"builds and runs services"| node_iag_service
node_iag -->|"integrates workflows"| node_platform_service
node_mop -->|"runs device checks"| node_platform_service
node_devices -->|"manages devices"| node_platform_service
node_golden -->|"runs compliance"| node_platform_service
node_inventory -->|"manages inventory"| node_platform_service
node_forms -->|"manages forms"| node_platform_service
node_lcm -->|"manages lifecycle"| node_platform_service
node_gateway_migration -->|"assesses readiness"| node_platform_service

click node_spec "https://github.com/itential/builder-skills/blob/main/.claude/skills/spec-agent/SKILL.md"
click node_architecture "https://github.com/itential/builder-skills/blob/main/.claude/skills/solution-arch-agent/SKILL.md"
click node_builder "https://github.com/itential/builder-skills/blob/main/.claude/skills/builder-agent/SKILL.md"
click node_qa "https://github.com/itential/builder-skills/blob/main/.claude/skills/qa-agent/SKILL.md"
click node_flowagent_spec "https://github.com/itential/builder-skills/blob/main/.claude/skills/flowagent-to-spec/SKILL.md"
click node_project_spec "https://github.com/itential/builder-skills/blob/main/.claude/skills/project-to-spec/SKILL.md"
click node_documentation "https://github.com/itential/builder-skills/blob/main/.claude/skills/documentation/SKILL.md"
click node_explore "https://github.com/itential/builder-skills/blob/main/.claude/skills/explore/SKILL.md"
click node_flowagent "https://github.com/itential/builder-skills/blob/main/.claude/skills/flowagent/SKILL.md"
click node_iag "https://github.com/itential/builder-skills/blob/main/.claude/skills/iag/SKILL.md"
click node_mop "https://github.com/itential/builder-skills/blob/main/.claude/skills/itential-mop/SKILL.md"
click node_devices "https://github.com/itential/builder-skills/blob/main/.claude/skills/itential-devices/SKILL.md"
click node_golden "https://github.com/itential/builder-skills/blob/main/.claude/skills/itential-golden-config/SKILL.md"
click node_inventory "https://github.com/itential/builder-skills/blob/main/.claude/skills/itential-inventory/SKILL.md"
click node_forms "https://github.com/itential/builder-skills/blob/main/.claude/skills/itential-json-forms/SKILL.md"
click node_lcm "https://github.com/itential/builder-skills/blob/main/.claude/skills/itential-lcm/SKILL.md"
click node_gateway_migration "https://github.com/itential/builder-skills/blob/main/.claude/skills/gateway4-to-gateway5/SKILL.md"

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_spec,node_architecture,node_builder,node_qa toneBlue
class node_flowagent_spec,node_project_spec,node_documentation,node_explore toneAmber
class node_flowagent,node_iag,node_mop,node_devices,node_golden,node_inventory,node_forms,node_lcm toneMint
class node_gateway_migration toneRose
class node_engineer,node_platform_service,node_iag_service toneIndigo
```

## Components

### Spec-driven delivery

- [Spec agent](https://github.com/itential/builder-skills/blob/main/.claude/skills/spec-agent/SKILL.md): `.claude/skills/spec-agent/SKILL.md`
- [Solution architect](https://github.com/itential/builder-skills/blob/main/.claude/skills/solution-arch-agent/SKILL.md): `.claude/skills/solution-arch-agent/SKILL.md`
- [Builder agent](https://github.com/itential/builder-skills/blob/main/.claude/skills/builder-agent/SKILL.md): `.claude/skills/builder-agent/SKILL.md`
- [QA agent](https://github.com/itential/builder-skills/blob/main/.claude/skills/qa-agent/SKILL.md): `.claude/skills/qa-agent/SKILL.md`

### Discovery and docs

- [FlowAgent to spec](https://github.com/itential/builder-skills/blob/main/.claude/skills/flowagent-to-spec/SKILL.md): `.claude/skills/flowagent-to-spec/SKILL.md`
- [Project to spec](https://github.com/itential/builder-skills/blob/main/.claude/skills/project-to-spec/SKILL.md): `.claude/skills/project-to-spec/SKILL.md`
- [Documentation](https://github.com/itential/builder-skills/blob/main/.claude/skills/documentation/SKILL.md): `.claude/skills/documentation/SKILL.md`
- [Platform explore](https://github.com/itential/builder-skills/blob/main/.claude/skills/explore/SKILL.md): `.claude/skills/explore/SKILL.md`

### Platform operations

- [FlowAgent](https://github.com/itential/builder-skills/blob/main/.claude/skills/flowagent/SKILL.md): `.claude/skills/flowagent/SKILL.md`
- [IAG services](https://github.com/itential/builder-skills/blob/main/.claude/skills/iag/SKILL.md): `.claude/skills/iag/SKILL.md`
- [MOP automation](https://github.com/itential/builder-skills/blob/main/.claude/skills/itential-mop/SKILL.md): `.claude/skills/itential-mop/SKILL.md`
- [Device management](https://github.com/itential/builder-skills/blob/main/.claude/skills/itential-devices/SKILL.md): `.claude/skills/itential-devices/SKILL.md`
- [Golden config](https://github.com/itential/builder-skills/blob/main/.claude/skills/itential-golden-config/SKILL.md): `.claude/skills/itential-golden-config/SKILL.md`
- [Inventory management](https://github.com/itential/builder-skills/blob/main/.claude/skills/itential-inventory/SKILL.md): `.claude/skills/itential-inventory/SKILL.md`
- [JSON Forms](https://github.com/itential/builder-skills/blob/main/.claude/skills/itential-json-forms/SKILL.md): `.claude/skills/itential-json-forms/SKILL.md`
- [Lifecycle management](https://github.com/itential/builder-skills/blob/main/.claude/skills/itential-lcm/SKILL.md): `.claude/skills/itential-lcm/SKILL.md`

### Migration

- [Gateway migration](https://github.com/itential/builder-skills/blob/main/.claude/skills/gateway4-to-gateway5/SKILL.md): `.claude/skills/gateway4-to-gateway5/SKILL.md`

### Other components

- **Engineer**
- **Itential Platform**
- **IAG 5**

## Connections

- Engineer → Spec agent: requests requirements
- Spec agent → Solution architect: approved spec
- Solution architect → Builder agent: approved design
- Builder agent → QA agent: hands off build
- QA agent → Engineer: presents for sign-off
- Engineer → FlowAgent to spec: requests conversion
- FlowAgent to spec → Spec agent: produces spec input
- Engineer → Project to spec: requests reverse engineering
- Project to spec → Spec agent: produces spec
- Engineer → Documentation: requests survey
- Documentation → Itential Platform: surveys assets
- Engineer → Platform explore: requests exploration
- Platform explore → Itential Platform: pulls live data
- FlowAgent → Itential Platform: creates and runs agents
- IAG services → IAG 5: builds and runs services
- IAG services → Itential Platform: integrates workflows
- MOP automation → Itential Platform: runs device checks
- Device management → Itential Platform: manages devices
- Golden config → Itential Platform: runs compliance
- Inventory management → Itential Platform: manages inventory
- JSON Forms → Itential Platform: manages forms
- Lifecycle management → Itential Platform: manages lifecycle
- Gateway migration → Itential Platform: assesses readiness