Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions .claude/commands/builder-agent.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

# builder agent

Use the `/builder-agent` skill.

Read `AGENTS.md`, then load `skills/builder-agent/SKILL.md`.
Follow that skill for the current user request.
8 changes: 8 additions & 0 deletions .claude/commands/documentation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

# documentation

Use the `/documentation` skill.

Read `AGENTS.md`, then load `skills/documentation/SKILL.md`.
Follow that skill for the current user request.
8 changes: 8 additions & 0 deletions .claude/commands/explore.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

# explore

Use the `/explore` skill.

Read `AGENTS.md`, then load `skills/explore/SKILL.md`.
Follow that skill for the current user request.
8 changes: 8 additions & 0 deletions .claude/commands/flowagent-to-spec.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

# flowagent to spec

Use the `/flowagent-to-spec` skill.

Read `AGENTS.md`, then load `skills/flowagent-to-spec/SKILL.md`.
Follow that skill for the current user request.
8 changes: 8 additions & 0 deletions .claude/commands/flowagent.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

# flowagent

Use the `/flowagent` skill.

Read `AGENTS.md`, then load `skills/flowagent/SKILL.md`.
Follow that skill for the current user request.
8 changes: 8 additions & 0 deletions .claude/commands/iag.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

# iag

Use the `/iag` skill.

Read `AGENTS.md`, then load `skills/iag/SKILL.md`.
Follow that skill for the current user request.
8 changes: 8 additions & 0 deletions .claude/commands/itential-devices.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

# itential devices

Use the `/itential-devices` skill.

Read `AGENTS.md`, then load `skills/itential-devices/SKILL.md`.
Follow that skill for the current user request.
8 changes: 8 additions & 0 deletions .claude/commands/itential-golden-config.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

# itential golden config

Use the `/itential-golden-config` skill.

Read `AGENTS.md`, then load `skills/itential-golden-config/SKILL.md`.
Follow that skill for the current user request.
8 changes: 8 additions & 0 deletions .claude/commands/itential-inventory.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

# itential inventory

Use the `/itential-inventory` skill.

Read `AGENTS.md`, then load `skills/itential-inventory/SKILL.md`.
Follow that skill for the current user request.
8 changes: 8 additions & 0 deletions .claude/commands/itential-lcm.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

# itential lcm

Use the `/itential-lcm` skill.

Read `AGENTS.md`, then load `skills/itential-lcm/SKILL.md`.
Follow that skill for the current user request.
8 changes: 8 additions & 0 deletions .claude/commands/itential-mop.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

# itential mop

Use the `/itential-mop` skill.

Read `AGENTS.md`, then load `skills/itential-mop/SKILL.md`.
Follow that skill for the current user request.
8 changes: 8 additions & 0 deletions .claude/commands/project-to-spec.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

# project to spec

Use the `/project-to-spec` skill.

Read `AGENTS.md`, then load `skills/project-to-spec/SKILL.md`.
Follow that skill for the current user request.
8 changes: 8 additions & 0 deletions .claude/commands/solution-arch-agent.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

# solution arch agent

Use the `/solution-arch-agent` skill.

Read `AGENTS.md`, then load `skills/solution-arch-agent/SKILL.md`.
Follow that skill for the current user request.
8 changes: 8 additions & 0 deletions .claude/commands/spec-agent.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

# spec agent

Use the `/spec-agent` skill.

Read `AGENTS.md`, then load `skills/spec-agent/SKILL.md`.
Follow that skill for the current user request.
12 changes: 12 additions & 0 deletions .cursor/rules/itential-skills.mdc
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

---
description: Route Itential skill requests to canonical skill guides
alwaysApply: true
---

Read `AGENTS.md` first. It is the canonical cross-vendor agent guide for this repository.

Skill references use the form `/skill-name`. If a user invokes or mentions a skill such as `/builder-agent`, read `skills/builder-agent/SKILL.md` before acting in that domain.

Do not duplicate or reinterpret skill instructions in Cursor rules. The canonical skill content is always under `skills/{skill-name}/SKILL.md`.
7 changes: 7 additions & 0 deletions .github/copilot-instructions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

# Copilot Instructions

Read `AGENTS.md` first. It is the canonical cross-vendor agent guide for this repository.

When `AGENTS.md` routes work to a skill such as `/builder-agent`, read the matching `skills/builder-agent/SKILL.md` file before acting in that domain.
9 changes: 9 additions & 0 deletions .github/prompts/builder-agent.prompt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

---
mode: agent
description: Use the Itential builder agent skill
---

Read `AGENTS.md`, then load `skills/builder-agent/SKILL.md`.
Follow that skill for the current user request.
9 changes: 9 additions & 0 deletions .github/prompts/documentation.prompt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

---
mode: agent
description: Use the Itential documentation skill
---

Read `AGENTS.md`, then load `skills/documentation/SKILL.md`.
Follow that skill for the current user request.
9 changes: 9 additions & 0 deletions .github/prompts/explore.prompt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

---
mode: agent
description: Use the Itential explore skill
---

Read `AGENTS.md`, then load `skills/explore/SKILL.md`.
Follow that skill for the current user request.
9 changes: 9 additions & 0 deletions .github/prompts/flowagent-to-spec.prompt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

---
mode: agent
description: Use the Itential flowagent to spec skill
---

Read `AGENTS.md`, then load `skills/flowagent-to-spec/SKILL.md`.
Follow that skill for the current user request.
9 changes: 9 additions & 0 deletions .github/prompts/flowagent.prompt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

---
mode: agent
description: Use the Itential flowagent skill
---

Read `AGENTS.md`, then load `skills/flowagent/SKILL.md`.
Follow that skill for the current user request.
9 changes: 9 additions & 0 deletions .github/prompts/iag.prompt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

---
mode: agent
description: Use the Itential iag skill
---

Read `AGENTS.md`, then load `skills/iag/SKILL.md`.
Follow that skill for the current user request.
9 changes: 9 additions & 0 deletions .github/prompts/itential-devices.prompt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

---
mode: agent
description: Use the Itential itential devices skill
---

Read `AGENTS.md`, then load `skills/itential-devices/SKILL.md`.
Follow that skill for the current user request.
9 changes: 9 additions & 0 deletions .github/prompts/itential-golden-config.prompt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

---
mode: agent
description: Use the Itential itential golden config skill
---

Read `AGENTS.md`, then load `skills/itential-golden-config/SKILL.md`.
Follow that skill for the current user request.
9 changes: 9 additions & 0 deletions .github/prompts/itential-inventory.prompt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

---
mode: agent
description: Use the Itential itential inventory skill
---

Read `AGENTS.md`, then load `skills/itential-inventory/SKILL.md`.
Follow that skill for the current user request.
9 changes: 9 additions & 0 deletions .github/prompts/itential-lcm.prompt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

---
mode: agent
description: Use the Itential itential lcm skill
---

Read `AGENTS.md`, then load `skills/itential-lcm/SKILL.md`.
Follow that skill for the current user request.
9 changes: 9 additions & 0 deletions .github/prompts/itential-mop.prompt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

---
mode: agent
description: Use the Itential itential mop skill
---

Read `AGENTS.md`, then load `skills/itential-mop/SKILL.md`.
Follow that skill for the current user request.
9 changes: 9 additions & 0 deletions .github/prompts/project-to-spec.prompt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

---
mode: agent
description: Use the Itential project to spec skill
---

Read `AGENTS.md`, then load `skills/project-to-spec/SKILL.md`.
Follow that skill for the current user request.
9 changes: 9 additions & 0 deletions .github/prompts/solution-arch-agent.prompt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

---
mode: agent
description: Use the Itential solution arch agent skill
---

Read `AGENTS.md`, then load `skills/solution-arch-agent/SKILL.md`.
Follow that skill for the current user request.
9 changes: 9 additions & 0 deletions .github/prompts/spec-agent.prompt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<!-- Generated from canonical sources. Do not edit directly. Run scripts/generate-vendor-wrappers.sh. -->

---
mode: agent
description: Use the Itential spec agent skill
---

Read `AGENTS.md`, then load `skills/spec-agent/SKILL.md`.
Follow that skill for the current user request.
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,9 @@ desktop.ini
credentials.json
secrets.yaml
secrets.yml
customizations/developer/*
!customizations/developer/README.md
!customizations/developer/*.example.md

# =============================================================================
# Logs and Databases
Expand Down
13 changes: 13 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,19 @@

This project contains skills for assisting developers on the Itential Platform. Read this first, then use the skills for detailed API references.

`AGENTS.md` is the canonical cross-vendor agent guide. Canonical skill content lives in `skills/{skill-name}/SKILL.md`. For agents without a native Skill tool, treat each `/skill-name` reference as a pointer to `skills/skill-name/SKILL.md` and read that file before acting in the domain. `.claude/skills/` is a generated compatibility mirror for Claude. Project governance lives in `docs/constitution.md`.

## Customization Layers

Before acting, check optional customization guidance in this order:

1. `customizations/developer/` — local developer preferences, ignored by git except examples
2. `customizations/team/` — team-specific standards
3. `customizations/org/` — organization-wide standards
4. Core repository guidance — `AGENTS.md`, `skills/`, `docs/constitution.md`

Higher-priority customization may narrow style, naming, defaults, and review expectations, but it must not violate `docs/constitution.md` or fork canonical skill behavior.

## Skill Router

Each skill owns a domain. **Invoke the skill using the Skill tool before working in that domain.** Skills contain the correct API methods, request bodies, response shapes, and patterns. Don't guess — load the skill.
Expand Down
4 changes: 4 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,6 +98,8 @@ Then start your first delivery from inside that folder:

See [`docs/quickstart.md`](docs/quickstart.md) for the full setup and first delivery walkthrough.

For Claude slash commands, Codex global skill install, Cursor rules, and GitHub Copilot prompt compatibility, see [`docs/vendor-install.md`](docs/vendor-install.md). For the source/generated model, see [`docs/multi-vendor-architecture.md`](docs/multi-vendor-architecture.md). For governance, see [`docs/constitution.md`](docs/constitution.md).

---

## How to Use It
Expand Down Expand Up @@ -126,6 +128,8 @@ See [`docs/quickstart.md`](docs/quickstart.md) for the full setup and first deli

## Skills

This repository is AAIF-aligned around [`AGENTS.md`](AGENTS.md) as the canonical cross-vendor agent guide. Canonical skill content lives in [`skills/`](skills/). Claude compatibility files in `.claude/skills/` are generated from `skills/`; run `scripts/sync-vendor-skills.sh` after editing canonical skills and `scripts/check-vendor-skills.sh` before release.

**Delivery**

| Skill | What It Does |
Expand Down
46 changes: 46 additions & 0 deletions codex/itential-builder-skills/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
---
name: itential-builder-skills
description: Use for Itential Platform automation delivery, discovery, design, build, IAG services, FlowAI agents, MOP command templates, devices, golden config, inventory, and LCM.
metadata:
short-description: Itential Platform automation lifecycle and domain skills
---

# Itential Builder Skills

Generated from canonical sources. Do not edit directly. Run `scripts/generate-vendor-wrappers.sh`.

Use this skill for Itential Platform work: requirements, feasibility, solution design, build, as-built documentation, platform exploration, and domain-specific automation.

This is a Codex distributable meta-skill. It bundles the same domain skill content used by the repository-local `AGENTS.md` router.

## Routing

Load the referenced file before acting in that domain:

| Intent | Reference |
|---|---|
| Explore a platform, authenticate, discover assets, or work freestyle | `references/explore.md` |
| Start a new delivery from requirements or create a customer spec | `references/spec-agent.md` |
| Assess feasibility or produce a solution design | `references/solution-arch-agent.md` |
| Build approved assets, test components, or produce as-built docs | `references/builder-agent.md` |
| Document existing global platform assets by use case | `references/documentation.md` |
| Convert an existing project into spec/design docs | `references/project-to-spec.md` |
| Convert a FlowAI agent into a deterministic workflow spec | `references/flowagent-to-spec.md` |
| Build or manage IAG services | `references/iag.md` |
| Build or manage FlowAI agents, providers, tools, and missions | `references/flowagent.md` |
| Build MOP command or analytic templates | `references/itential-mop.md` |
| Work with devices, backups, diffs, or device groups | `references/itential-devices.md` |
| Build golden config trees, compliance, grading, or remediation | `references/itential-golden-config.md` |
| Work with device inventory nodes, actions, and tags | `references/itential-inventory.md` |
| Build LCM resource models, instances, or lifecycle actions | `references/itential-lcm.md` |

## Operating Rules

1. Read the matching reference file before acting.
2. If working inside this repository, also read `AGENTS.md`.
3. If customization files exist, apply them in priority order: `customizations/developer/`, `customizations/team/`, `customizations/org/`, then core.
4. Customizations may narrow style, naming, defaults, and review expectations, but must not violate `docs/constitution.md`.
5. Never guess Itential API endpoints, request bodies, task names, or response shapes.
6. Use local platform files first when present: `openapi.json`, `tasks.json`, `task-schemas.json`, `apps.json`, `adapters.json`, and `platform-summary.json`.
7. Use helper JSON templates from `helpers/` when creating assets in the repository.
8. Keep delivery stage gates intact: Requirements, Feasibility, Design, Build, As-Built.
Loading
Loading