@salesforce/afv-skills 1.32.0 → 1.34.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/afv-skills",
-  "version": "1.32.0",
+  "version": "1.34.0",
   "description": "Salesforce skills for Agentforce Vibes",
   "license": "CC-BY-NC-4.0",
   "files": [

package/skills/agentforce-architecture-analyze/SKILL.md

@@ -3,6 +3,14 @@ name: agentforce-architecture-analyze
 description: "Declared architecture snapshot for one Agentforce agent: planner, topics, actions, flows, Apex, prompt templates, and NGA plugins. Renders a human-readable architecture document and Mermaid invocation graph from design-time metadata (not runtime audit rows). TRIGGER when user asks to describe, diagram, inventory, audit, document, or diff (e.g. v3 vs v5) the architecture / action tree / topic structure / tool inventory of a specific agent by agent API name in a specific org. DO NOT TRIGGER for runtime session traces, conversation transcripts, generation timings, or gateway audit chains — this skill reads design-time metadata only (use agentforce-d360-analyze for session traces)."
 metadata:
   version: "1.0"
+  minApiVersion: "64.0"
+  relatedSkills:
+    - "agentforce-d360-analyze"
+  cliTools:
+    - tool: ["sf"]
+      semver: ">=2.136.8"
+    - tool: ["python3"]
+      semver: ">=3.10.0"
 ---
 
 # agentforce-architecture-analyze — declared architecture snapshot

package/skills/agentforce-bot-upgrade/SKILL.md

@@ -7,8 +7,6 @@ metadata:
   minApiVersion: "63.0"
   relatedSkills:
     - "agentforce-generate"
-    - "agentforce-test"
-    - "agentforce-observe"
   cliTools:
     - tool: ["sf"]
       semver: ">=2.0.0"

package/skills/agentforce-d360-analyze/SKILL.md

@@ -2,7 +2,15 @@
 name: agentforce-d360-analyze
 description: "Data Cloud 360° view of a single Agentforce session. TRIGGER when user asks to trace, inspect, summarize, or describe a specific Agentforce session by session id (Agent Session UUID `019d…` or MessagingSession id `0Mw…`). Also triggers on session discovery — find/list/search sessions by time, agent, channel, outcome, or conversation text — when the user has no session id yet. DO NOT TRIGGER for design-time architecture questions (use agentforce-architecture-analyze instead) or for runtime perf/latency/SLO questions that require platform telemetry beyond Data Cloud."
 metadata:
+  cliTools:
+    - tool: ["python3"]
+      semver: ">=3.10.0"
+    - tool: ["sf"]
+      semver: ">=2.0.0"
+  relatedSkills:
+    - "agentforce-architecture-analyze"
   version: "1.0"
+  minApiVersion: "66.0"
 ---
 
 # agentforce-d360-analyze — Data Cloud 360° session view

package/skills/agentforce-generate/README.md

@@ -1,67 +1,55 @@
 # Agentforce Development Skill
 
-A Claude Code skill for building, modifying, debugging, and deploying Agentforce agents using Agent Script — Salesforce's scripting language for next-generation AI agents on the Atlas Reasoning Engine.
+A skill for developing Agentforce agents with Agent Script.
 
-## What This Skill Does
+## What This Skill Covers
 
-Agent Script was introduced in 2025 with zero training data in any AI model. This skill bridges that gap by providing structured reference material, design patterns, CLI workflows, and debugging guidance so that AI coding assistants can work with Agent Script accurately.
-
-The skill covers the full Agent Script lifecycle:
+The skill routes agent work across the full lifecycle:
 
 | Domain | What It Handles |
 |--------|----------------|
-| Create an Agent | Agent Spec design, environment validation, bundle generation, code authoring |
-| Modify an Agent | Subagent/action changes, instruction refinement, flow control updates |
-| Create or Modify Backing Logic | Invocable Apex stubs, Flow wrappers, Prompt Templates |
-| Deploy and Publish | Source deploy, agent activation, publishing to channels |
-| Diagnose Compilation Errors | Compiler error interpretation, syntax fixes, metadata resolution |
-| Diagnose Behavioral Issues | Trace-based debugging, subagent routing, action I/O analysis |
-| Diagnose Production Issues | Runtime failures, reserved keyword conflicts, deployment gotchas |
-| Test an Agent | Utterance-based validation, preview with live actions, trace analysis |
-| Generate Diagrams | Subagent map visualizations, agent architecture diagrams |
+| Create an Agent | Agent Spec design, environment checks, bundle generation, draft authoring |
+| Modify an Agent | Subagent/action changes, instruction refinement, flow updates |
+| Diagnose Compilation Errors | Error capture, classification, targeted fixes |
+| Diagnose Behavioral Issues | Trace-based debugging, routing/action analysis |
+| Deploy / Release | Draft iteration, deploy, explicit publish + activate |
+| Test an Agent | Coverage design, spec creation, run analysis |
 
 ## Skill Structure
 
-```
+```text
 agentforce-generate/
-├── SKILL.md                    # Router — maps user intent to task domains and reference files
-├── references/                 # Domain knowledge (14 files)
-│   ├── agent-script-core-language.md
+├── SKILL.md                    # Execution router and hard rules
+├── references/                 # Domain guidance and adjacent operational docs
+│   ├── patterns-by-requirement.md
+│   ├── posture-and-determinism.md
 │   ├── agent-design-and-spec-creation.md
-│   ├── agent-validation-and-debugging.md
+│   ├── architecture-patterns.md
+│   ├── agent-script-core-language.md
 │   ├── salesforce-cli-for-agents.md
+│   ├── agent-validation-and-debugging.md
+│   ├── deploy-reference.md
 │   ├── agent-metadata-and-lifecycle.md
-│   ├── agent-access-guide.md
-│   ├── agent-user-setup.md
-│   ├── actions-reference.md
-│   ├── action-prompt-templates.md
-│   ├── agent-subagent-map-diagrams.md
-│   ├── minimal-examples.md
-│   ├── known-issues.md
-│   ├── production-gotchas.md
-│   └── version-history.md
-├── assets/                     # Templates, examples, and starter agents
+│   ├── data-library-reference.md
+│   ├── ... (additional references)
+├── assets/                     # Templates, examples, and reusable snippets
 │   ├── agent-spec-template.md
-│   ├── invocable-apex-template.cls
 │   ├── bundle-meta.xml
-│   ├── patterns/               # Reusable Agent Script patterns
-│   ├── agents/                 # Annotated example agents
-│   ├── apex/                   # Apex backing logic examples
-│   ├── components/             # LWC components for agent channels
-│   ├── metadata/               # Metadata templates
-│   └── *.agent                 # Starter agent templates
-└── staging/                    # Unmerged reference material awaiting review
+│   ├── invocable-apex-template.cls
+│   ├── agents/                 # Complete agent templates (including router-first)
+│   └── patterns/               # Reusable implementation patterns
 ```
 
 ## How It Works
 
-SKILL.md acts as a router. It detects user intent from task descriptions, maps to a task domain, and instructs the AI assistant to read the relevant reference files before starting work. Reference files are loaded on demand — the assistant only reads what the current task requires.
+`SKILL.md` acts as the router. It maps user intent to task domains and required references, then enforces hard rules for safe execution.
 
-Three rules apply across all domains:
+Core rules include:
 
 1. **Always `--json`** on every `sf` CLI command
 2. **Diagnose before you fix** — preview with live actions and read traces before modifying code
 3. **Spec approval is a hard gate** — never proceed past Agent Spec creation without user approval
+4. **Draft-first lifecycle** — iterate in draft by default; publish/activate only with explicit user confirmation
 
 ## Prerequisites
 
@@ -75,7 +63,7 @@ Three rules apply across all domains:
 
 Copy the `agentforce-generate` folder into your project's `.claude/skills/` directory:
 
-```
+```text
 your-project/
 └── .claude/
     └── skills/
@@ -87,9 +75,19 @@ your-project/
 
 Restart Claude Code after installation.
 
+## Key References
+
+- Pattern selection: [references/patterns-by-requirement.md](references/patterns-by-requirement.md)
+- Posture guidance: [references/posture-and-determinism.md](references/posture-and-determinism.md)
+- Design/spec workflow: [references/agent-design-and-spec-creation.md](references/agent-design-and-spec-creation.md)
+- Architecture mechanics: [references/architecture-patterns.md](references/architecture-patterns.md)
+- Core language: [references/agent-script-core-language.md](references/agent-script-core-language.md)
+- Validation/debugging: [references/agent-validation-and-debugging.md](references/agent-validation-and-debugging.md)
+- Reference index and consolidation notes: [references/reference-map.md](references/reference-map.md)
+
 ## Version
 
-Current version: **0.4.9** (2026-03-20). See [references/version-history.md](references/version-history.md) for the full changelog.
+Current version: **0.6.1** (2026-05-20). See [references/version-history.md](references/version-history.md) for the full changelog.
 
 ## Credits