forcedotcom/sf-skills / plugins/builder/agentforce-adlc/skills/agentforce-generate
agentforce-generate
FlaggedBuild, 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.
references/reference-map.md
View on GitHub# Reference Map and Consolidation Plan
> Meta document: describes how to use and maintain the reference set.
This file defines which references are primary vs supplemental so the skill stays
organized without risky deletions.
## Primary References (Authoritative)
- `agent-script-core-language.md` — syntax and execution model
- `agent-design-and-spec-creation.md` — design/spec workflow
- `patterns-by-requirement.md` — scenario-to-pattern selection
- `architecture-patterns.md` — architecture mechanics, HyperClassifier routing, and migration
- `posture-and-determinism.md` — subagent posture guidance
- `zen-of-agentscript.md` — concrete, unordered authoring invariants and merge checks
- `salesforce-cli-for-agents.md` — command reference
- `agent-validation-and-debugging.md` — runtime validation/debug flow
- `agent-audit-and-repair.md` — audit operating contract and workflow router
- `agent-audit-scope-path-review.md` — scope, use cases, and reachable-path review
- `agent-audit-repair-report.md` — intervention selection, repair, evaluation, and reporting
- `agent-audit-diagnostic-catalog.md` — intervention and diagnostic-category router
- `agent-audit-diagnostics-instructions-routing.md` — instruction and routing findings
- `agent-audit-diagnostics-actions-state.md` — action, contract, state, and sequencing findings
- `agent-audit-diagnostics-architecture-evaluation.md` — architecture, evidence, and non-findings
- `common-control-flow-pitfalls.md` — prompt and variable-visibility pitfalls
- `control-flow-actions-sequencing.md` — action availability and sequencing pitfalls
- `control-flow-lifecycle-side-effects.md` — lifecycle, transition, and side-effect pitfalls
- `agent-audit-evaluation-loop.md` — baseline capture and coherent-repair comparison
- `agent-audit-candidate-verification.md` — candidate inspection, regression handling, and reporting
- `agentscript-toolchain.md` — customer-local compiler setup, source fallback,
and provenance
- `deploy-reference.md` — draft-vs-release deployment lifecycle
## Adjacent Operational References (Keep)
- `agent-metadata-and-lifecycle.md`
- `agent-user-setup.md`
- `agent-access-guide.md`
- `data-library-reference.md`
- `known-issues.md`
- `production-gotchas.md`
- `mcp-management-reference.md`
## Supplemental References (Review for Merge/Prune Later)
- `examples.md` — long-form walkthroughs
- `actions-reference.md` — broad action property reference
- `action-prompt-templates.md` — prompt-template-specific action guidance
- `feature-validity.md` — utility-vs-target property validity matrix
## Full Reference Index (annotated)
The complete reference set available to the **Create an Agent** workflow. This
is an index, not a preload order: read only the references named by the active
SKILL.md step and the current feature decision.
1. [CLI for Agents](salesforce-cli-for-agents.md) — exact command syntax for generate, validate, deploy, publish, activate; Section 12 for Einstein Agent User creation
2. [Core Language](agent-script-core-language.md) — execution model, syntax, block structure, anti-patterns
3. [Design & Agent Spec](agent-design-and-spec-creation.md) — subagent graph design, flow control patterns, Agent Spec production, action implementation analysis; Section 3 for environment prerequisites
4. [Subagent Map Diagrams](agent-subagent-map-diagrams.md) — Mermaid diagram conventions for visualizing the agent's subagent graph
5. [Posture & Determinism](posture-and-determinism.md) — default agentic posture, deterministic controls with cause
6. [Agent User Setup & Permissions](agent-user-setup.md) — permission set assignment, object permissions, cross-subagent validation
7. [Metadata & Lifecycle](agent-metadata-and-lifecycle.md) — directory structure, bundle metadata; publish troubleshooting
8. [Validation & Debugging](agent-validation-and-debugging.md) — validate the agent compiles, preview to confirm behavior
9. [Agent Access Guide](agent-access-guide.md) — end-user access permissions, visibility troubleshooting
10. [Known Issues](known-issues.md) — only load when errors persist after code fixes
11. [Patterns by Requirement](patterns-by-requirement.md) — scenario-to-pattern mapping for architecture and flow choices
12. [Architecture Patterns](architecture-patterns.md) — router-first and HyperClassifier mechanics, verification gates, workflow-local linear patterns
13. [Complex Data Types](complex-data-types.md) — type mapping decision tree
14. [Safety Review](safety-review-reference.md) — 7-category safety review
15. [Discover Reference](discover-reference.md) — target discovery CLI
16. [Scaffold Reference](scaffold-reference.md) — stub generation CLI
17. [Deploy Reference](deploy-reference.md) — deployment lifecycle, error recovery
18. [Data Library Reference](data-library-reference.md) — provision a SFDRIVE Agentforce Data Library and wire it into the `.agent` via the `knowledge:` block + `AnswerQuestionsWithKnowledge` action
## Current Recommendation (No Deletions Yet)
1. Keep all files for now.
2. Treat supplemental references as second-level docs.
3. In a future cleanup pass, consider:
- keep `examples.md` as the single examples reference and avoid re-splitting minimal examples
- folding `feature-validity.md` into `actions-reference.md`
- keeping `action-prompt-templates.md` only if prompt-template depth remains valuable
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 471k | Updated | Claude CodeCodex | Verified | Install |
| 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: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |