agentforce-adlc

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 — Claude 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, and observability, following the agentskills.io standard

Pipeline

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

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

Installation

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 ./agentforce-adlc
claude plugin install agentforce-adlc@agentforce-adlc

When installed as a plugin, skills are namespaced: /agentforce-adlc:developing-agentforce, /agentforce-adlc:testing-agentforce, /agentforce-adlc:observing-agentforce.

File-copy install (Cursor or legacy Claude Code)

# 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                  # Auto-detects Claude Code / Cursor
python3 tools/install.py --target cursor  # Cursor only

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 (legacy)
python3 ~/.claude/adlc-install.py --status
python3 ~/.claude/adlc-install.py --update
python3 ~/.claude/adlc-install.py --uninstall

After install, restart your IDE. Skills are available in any project.

What installs where

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

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

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 (~/.claude/) or Cursor (~/.cursor/) — at least one must be installed
• Salesforce org with Agentforce enabled

Quick start

1. Build and deploy (/developing-agentforce)

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