Skip to content

forcedotcom/sf-skills / plugins/builder/agentforce-adlc/skills/agentforce-generate

agentforce-generate

Flagged

Build, modify, audit, repair, optimize, debug, and deploy agents with Agentforce Agent Script. TRIGGER when: user creates, reviews, or changes .agent files or aiAuthoringBundle metadata; asks to fix AgentScript, audit an existing agent, run an AgentScript health check, common-pitfall review, or baseline-versus-candidate repair loop; changes a response, action, subagent, route, state flow, or Agent Spec; migrates or upgrades a legacy GenAiPlannerBundle Agentforce agent (NOT an Einstein Bot) to an aiAuthoringBundle (Agent Script) agent; previews, debugs, deploys, publishes, or tests agents; uses sf agent generate/preview/publish/test; or manages Agentforce MCP servers, tools, assets, or authentication. DO NOT TRIGGER when: Apex, Flow, Prompt Template, Experience Cloud, or general Salesforce CLI work is unrelated to Agent Script; the source is an Einstein Bot (BotDefinition/BotVersion) — use agentforce-bot-upgrade; or the primary input is a production session or trace ID rather than an agent artifact.

FileKindSize
README.mdmarkdown5.4 KB
SKILL.mdskill md31.7 KB
assets/agent-spec-template.mdmarkdown6.4 KB
assets/agents/README.mdmarkdown2.6 KB
assets/agents/hello-world.agentother1.9 KB
assets/agents/knowledge-grounded.agentother5.6 KB
assets/agents/local-info-agent-annotated.agentother17.0 KB
assets/agents/order-service.agentother11.7 KB
assets/agents/production-faq.agentother3.9 KB
assets/agents/production-faq.bundle-meta.xmlconfig161 B
assets/agents/router-first.agentother5.6 KB
assets/agents/simple-qa.agentother1.9 KB
assets/agents/template-multi-subagent.agentother5.4 KB
assets/agents/template-single-subagent.agentother2.6 KB
assets/agents/verification-gate.agentother10.7 KB
assets/agents/voice-knowledge-grounded.agentother8.2 KB
assets/agents/voice-service-agent.agentother4.6 KB
assets/bundle-meta.xmlconfig808 B
assets/invocable-apex-template.clsother6.9 KB
assets/patterns/README.mdmarkdown10.8 KB
assets/patterns/action-callbacks.agentother4.7 KB
assets/patterns/advanced-input-bindings.agentother6.9 KB
assets/patterns/bidirectional-routing.agentother5.6 KB
assets/patterns/critical-input-collection.agentother12.2 KB
assets/patterns/delegation-routing.agentother6.4 KB
assets/patterns/lifecycle-events.agentother4.7 KB
assets/patterns/llm-controlled-actions.agentother5.1 KB
assets/patterns/multi-step-workflow.agentother10.1 KB
assets/patterns/open-gate-routing.agentother11.6 KB
assets/patterns/procedural-instructions.agentother4.8 KB
assets/patterns/prompt-template-action.agentother6.6 KB
assets/patterns/system-instruction-overrides.agentother10.6 KB
references/action-prompt-templates.mdmarkdown5.7 KB
references/actions-reference.mdmarkdown30.2 KB
references/agent-access-guide.mdmarkdown2.9 KB
references/agent-audit-and-repair.mdmarkdown7.9 KB
references/agent-audit-candidate-verification.mdmarkdown5.2 KB
references/agent-audit-diagnostic-catalog.mdmarkdown7.6 KB
references/agent-audit-diagnostics-actions-state.mdmarkdown6.9 KB
references/agent-audit-diagnostics-architecture-evaluation.mdmarkdown2.5 KB
references/agent-audit-diagnostics-instructions-routing.mdmarkdown11.8 KB
references/agent-audit-evaluation-loop.mdmarkdown6.0 KB
references/agent-audit-repair-report.mdmarkdown6.9 KB
references/agent-audit-scope-path-review.mdmarkdown8.5 KB
references/agent-design-and-spec-creation.mdmarkdown54.5 KB
references/agent-metadata-and-lifecycle.mdmarkdown30.2 KB
references/agent-script-core-language.mdmarkdown49.3 KB
references/agent-subagent-map-diagrams.mdmarkdown10.8 KB
references/agent-user-setup.mdmarkdown27.8 KB
references/agent-validation-and-debugging.mdmarkdown44.6 KB
references/agentscript-toolchain.mdmarkdown4.6 KB
references/architecture-patterns.mdmarkdown13.5 KB
references/common-control-flow-pitfalls.mdmarkdown9.4 KB
references/complex-data-types.mdmarkdown3.9 KB
references/control-flow-actions-sequencing.mdmarkdown6.9 KB
references/control-flow-lifecycle-side-effects.mdmarkdown3.3 KB
references/data-library-reference.mdmarkdown40.8 KB
references/deploy-reference.mdmarkdown6.7 KB
references/discover-reference.mdmarkdown4.3 KB
references/examples.mdmarkdown12.6 KB
references/feature-validity.mdmarkdown2.1 KB
references/instruction-resolution.mdmarkdown23.4 KB
references/known-issues.mdmarkdown27.6 KB
references/legacy-nga-regression-eval.mdmarkdown30.2 KB
references/mcp-management-reference.mdmarkdown37.6 KB
references/optimization-pattern-1-data-flow.mdmarkdown4.6 KB
references/optimization-pattern-2-deterministic-logic.mdmarkdown5.4 KB
references/optimization-pattern-3-reference-syntax.mdmarkdown4.1 KB
references/optimization-pattern-4-escalation.mdmarkdown2.2 KB
references/org-setup-for-adl.mdmarkdown23.7 KB
references/patterns-by-requirement.mdmarkdown5.4 KB
references/posture-and-determinism.mdmarkdown9.3 KB
references/production-gotchas.mdmarkdown12.6 KB
references/reference-map.mdmarkdown5.3 KB
references/safety-review-reference.mdmarkdown6.3 KB
references/salesforce-cli-for-agents.mdmarkdown16.7 KB
references/scaffold-reference.mdmarkdown6.7 KB
references/scoring-rubric.mdmarkdown3.3 KB
references/upgrade-legacy-agent-to-agentscript.mdmarkdown26.2 KB
references/version-history.mdmarkdown4.4 KB
references/voice-latency-heuristics.mdmarkdown9.7 KB
references/voice-modality-reference.mdmarkdown19.0 KB
references/voice-telephony-cli.mdmarkdown10.3 KB
references/zen-of-agentscript.mdmarkdown13.1 KB
scripts/__init__.pyscript0 B
scripts/agentscript-sdk-loader.mjsscript4.0 KB
scripts/discover.pyexecutablescript20.2 KB
scripts/generators/__init__.pyscript0 B
scripts/generators/apex_stub.pyscript13.4 KB
scripts/generators/apex_test_stub.pyscript3.8 KB
scripts/generators/flow_xml.pyscript7.6 KB
scripts/generators/permission_set_xml.pyscript1014 B
scripts/generators/remote_site_xml.pyscript1.4 KB
scripts/index-agent.mjsexecutablescript3.8 KB
scripts/org_describe.pyexecutablescript5.8 KB
scripts/scaffold.pyexecutablescript15.1 KB
scripts/setup-agentscript-sdk.mjsexecutablescript9.7 KB
scripts/upgrade-legacy-nga-analyze.pyexecutablescript20.0 KB
scripts/upgrade-legacy-nga-run-trials.shexecutablescript3.4 KB

references/agentscript-toolchain.md

View on GitHub
# AgentScript Compiler Setup and Provenance

For every authoring, repair, or audit task with an existing `.agent` file, run
the bundled compiler locally before target-org validation. This is the cheap,
repeatable first pass even when the customer has an authenticated org. The
customer should not need to clone this skills repository or modify their
project dependencies.

## Provider order

Use the first working local provider and record it:

1. an explicit `AGENTSCRIPT_SDK_ENTRY` override, when the user supplied one;
2. the last successfully verified SDK in the skill-owned cache;
3. an AgentScript SDK already installed in the customer project or skill host;
4. the public npm package installed into the skill-owned cache;
5. a fresh build from the public `salesforce/agentscript` source repository.

After the local pass, use target-org validation when an authenticated org is
available. The two checks are complementary: the local compiler provides fast
feedback, while the org establishes what that deployment target accepts. Use a
bounded static review only when no local compiler or org validation surface is
available.

An absent or unauthenticated org is not a reason to skip the local compiler.
Local compilation does not require org access. Do not report “no org” as the
cause of **compiler not used**; attempt the local providers below and report the
actual setup or loading failure if none works.

Compiler setup must not become an all-or-nothing gate. Try each applicable
install provider once. If installation fails, retain the error, continue with
the strongest remaining validation surface, and state **compiler not used**
with the cause rather than abandoning the authoring or audit result.

## Install from npm

Resolve the installed `agentforce-generate` skill directory and run:

```bash
node <skill-directory>/scripts/setup-agentscript-sdk.mjs --npm --json
```

The setup script installs the pinned public
`@sf-agentscript/agentforce` package into the user cache, not the customer
project or global npm prefix. It then runs a compiler smoke test and records the
resolved package version and entry point.

If evidence indicates that the bundled npm pin is behind the currently
published package, retry once with an exact newer version or `latest` and retain
the resolved version:

```bash
node <skill-directory>/scripts/setup-agentscript-sdk.mjs \
  --npm --version latest --force --json
```

Do not call a package current merely because `latest` resolved. Compare its
diagnostics with the syntax under review, the public source revision when
needed, and the deployment org before release.

## Build from public source

Use the source fallback when the npm package is unavailable, cannot load, or
appears older than the syntax under review:

```bash
node <skill-directory>/scripts/setup-agentscript-sdk.mjs \
  --source --source-ref main --force --json
```

This downloads `https://github.com/salesforce/agentscript.git` into the same
skill-owned cache, records the exact fetched commit, installs its pinned pnpm
dependencies, builds the Agentforce SDK and its dependencies, and runs the same
compiler smoke test. It requires Git, either pnpm or Corepack-provided pnpm, and
the operating-system build prerequisites required by the selected public
source revision. A missing native build prerequisite is an installation failure
to report and fall back from; it is not a reason to abandon the audit.

Use a tag or commit with `--source-ref` when reproducibility matters. A source
build can be newer than the deployment org; it is evidence about that source
revision, not proof that an org accepts the same syntax.

## Use and report the compiler

Run the bundled indexer after setup:

```bash
node <skill-directory>/scripts/index-agent.mjs <agent-file>
```

The JSON result includes a `compiler` object. Always carry these fields into
the audit or authoring report:

- provider: ambient npm, cached npm, public source, or explicit entry;
- exact npm package and resolved version, when applicable;
- exact source commit, when applicable;
- compiler entry path;
- whether target-org validation also ran.

If the indexer was not run, say so. If it failed before loading a compiler,
report **compiler not used** and the reason. Never describe a prompt-only or
regex inspection as compiler validation.

## Overrides and cache

- `AGENTSCRIPT_SDK_ENTRY` selects a specific built SDK entry file.
- `AGENTFORCE_GENERATE_CACHE` selects a different cache root.
- `XDG_CACHE_HOME` changes the standard cache root.

The default cache is `.cache/agentforce-generate` under the current user's home
directory. Setup writes only below the selected cache root and does not install
global packages.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall