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