agentforce-adlc

Agent Development Life Cycle — Build, deploy, test, and optimize Agentforce agents using Claude Code skills and Agent Script DSL.

What is this?

agentforce-adlc provides a complete set of Claude Code skills for the full Agentforce agent lifecycle — from requirements to production optimization. Claude writes .agent files directly using the Agent Script DSL.

Key differentiators

• Direct authoring — The coding agent generates .agent files natively, not via markdown-to-agent conversion
• Full lifecycle — Author, discover, scaffold, deploy, test, and optimize in one toolchain
• Safety built-in — LLM-driven safety review across the entire lifecycle (authoring, deploy, test, optimize)
• Deterministic agents — Agent Script DSL enforces code-level guarantees (conditionals, guards, transitions)
• Session trace analysis — Extract STDM data from Data Cloud for data-driven optimization
• 3 consolidated skills — Development, testing (including security), and observability, following the Agent Skills standard

Pipeline

User prompt
  |  /agentforce-generate
  v
+--------------------------+
| Safety Review (Phase 0)  |<-- LLM-driven, 7 categories
| .agent file generated    |
+--------+-----------------+
         |  /agentforce-generate (discover)
         v
+--------------------------+
| Check org for targets    |--missing--> scaffold stubs
+--------+-----------------+
         |  /agentforce-generate (deploy)
         v
+--------------------------+
| Safety Gate -> Validate  |<-- Pre-publish check
| -> Publish -> Activate   |
+--------+-----------------+
         |  /agentforce-test
         v
+--------------------------+
| Preview + Batch tests    |<-- Safety probe utterances (adversarial)
| + Action execution       |
+--------+-----------------+
         |  /agentforce-observe
         v
+--------------------------+
| STDM session analysis    |<-- Safety issue detection in traces
| -> Reproduce -> Improve  |
+--------------------------+

Each skill can be invoked independently. Run /agentforce-test on an existing agent without touching the development steps. Run /agentforce-observe on production session data without redeploying.

Installation

As a Claude Code plugin (recommended)

# Clone the repo
git clone https://github.com/SalesforceAIResearch/agentforce-adlc.git

# Option A: Load directly (development)
claude --plugin-dir ./agentforce-adlc

# Option B: Install via marketplace
claude plugin marketplace add SalesforceAIResearch/agentforce-adlc
claude plugin install agentforce-adlc@agentforce-adlc

When installed as a plugin, skills are namespaced: /agentforce-adlc:agentforce-generate, /agentforce-adlc:agentforce-test, /agentforce-adlc:agentforce-observe.

File-copy install (Claude Code, Codex, or Cursor)

# One-command install
curl -sSL https://raw.githubusercontent.com/SalesforceAIResearch/agentforce-adlc/main/tools/install.sh | bash

# Or from local clone
python3 tools/install.py                  # Codex (default)
python3 tools/install.py --target claude  # Claude Code
python3 tools/install.py --target codex   # Codex
python3 tools/install.py --target cursor  # Cursor
python3 tools/install.py --target all     # All available targets

Post-install management

# Plugin management
claude plugin list                         # List installed plugins
claude plugin update agentforce-adlc@agentforce-adlc  # Update plugin
claude plugin uninstall agentforce-adlc@agentforce-adlc  # Remove plugin

# File-copy management (Codex)
python3 ~/.agents/adlc-install.py --status
python3 ~/.agents/adlc-install.py --update
python3 ~/.agents/adlc-install.py --uninstall

# File-copy management (Claude Code)
python3 ~/.claude/adlc-install.py --status
python3 ~/.claude/adlc-install.py --update
python3 ~/.claude/adlc-install.py --uninstall

After install, restart your coding agent if it does not discover the skills automatically. Skills are available in any project.

What installs where

Component	Plugin (Claude Code)	File-copy (~/.claude/)	File-copy (~/.agents/, Codex)	File-copy (~/.cursor/)
Skills	Auto-discovered from skills/	skills/agentforce-*/	skills/agentforce-*/	skills/agentforce-*/
Agents	Auto-discovered from agents/	agents/adlc-*.md	N/A	N/A
Hooks	Via hooks/hooks.json	hooks/scripts/adlc-*.py	N/A	N/A
Settings	settings.json (default agent)	settings.json entries	N/A	N/A

Plugin installation is self-contained — no files are copied to ~/.claude/. The file-copy installer supports Claude Code, Codex, and Cursor.

Prerequisites

• Python 3.9+ — check with python3 --version. If older, upgrade: brew install python@3.13 (macOS) / sudo apt install python3.13 (Ubuntu) / python.org (Windows)
• Salesforce CLI (sf) v2.x — install guide
• Claude Code, Codex, or Cursor — at least one must be installed
• Salesforce org with Agentforce enabled

Quick start

1. Build and deploy (/agentforce-generate)

This single skill handles the full development workflow — authoring, discovery, scaffolding, and deployment:

/agentforce-generate

Build a service agent that helps customers check order status,
request returns, and track shipments. It should verify identity
before showing order details. Deploy to my-org.

The skill will:

1. Author — Generate a .agent file with topics, actions, variables, and deterministic logic
2. Discover — Check which Flow/Apex/Retriever targets exist in the org
3. Scaffold — Generate stubs for missing targets (Flow XML, Apex classes, test classes, PermSets)
4. Deploy — Validate, publish