itential-builder

Itential — Agentic Builder Skills

Spec-driven infrastructure automation and orchestration — delivered by AI agents on Itential.

---

Table of Contents

• Prerequisites
• Getting Started
• How to Use It
• Skills
• Spec Library
• Demo Specs
• Docs
• Contributing
• Support

---

Most infrastructure automation is built without a delivery model. No consistent stages, no traceability, no repeatable process — just ad hoc builds that are hard to maintain, document, or hand off.

This repository introduces Spec-Driven Development for infrastructure automation. Every delivery follows five structured stages, with AI agents executing each stage and engineers approving the artifacts that gate the next one.

Requirements  →  Feasibility  →  Design  →  Build  →  As-Built
      │                │              │          │           │
  /spec-agent    /solution-       /solution-  /builder-  /builder-
                  arch-agent       arch-agent    agent      agent
      │                │              │          │           │
  customer-       feasibility.md  solution-    assets     as-built.md
  spec.md         (approved)      design.md    (delivered) (approved)
  (approved)                      (approved)

The result is infrastructure automation that is traceable, repeatable, and delivered faster.

---

Prerequisites

Requirement	Version	Notes
Itential Platform	6.x
IAG	5.x	Required only for the /iag skill
Claude Code	Latest	Install guide

---

Getting Started

Install the plugin:

/plugin marketplace add itential/builder-skills
/plugin install itential-builder@itential-builder

Already installed? Update to the latest version:

/plugin update itential-builder@itential-builder

First-time setup:

Create a folder for your use case and add a .env file with your platform credentials:

mkdir my-use-case && cd my-use-case

Cloud / OAuth:

# my-use-case/.env
PLATFORM_URL=https://your-instance.itential.io
AUTH_METHOD=oauth
CLIENT_ID=your-client-id
CLIENT_SECRET=your-client-secret

Local / Password:

# my-use-case/.env
PLATFORM_URL=http://localhost:4000
AUTH_METHOD=password
USERNAME=admin
PASSWORD=admin

Then start your first delivery from inside that folder:

/itential-builder:spec-agent

See docs/quickstart.md for the full setup and first delivery walkthrough.

---

How to Use It

"I need to automate VLAN provisioning on my platform"
→ /itential-builder:spec-agent

"I have a FlowAgent that's been running in production — productionize it"
→ /itential-builder:flowagent-to-spec

"I have an existing project with no documentation"
→ /itential-builder:project-to-spec

"Document all my global workflows and group them by use case"
→ /itential-builder:documentation

"I want to explore what's available on my platform"
→ /itential-builder:explore

"Help me build a golden config for my devices and run compliance"
→ /itential-builder:itential-golden-config

---

Skills

Delivery