@cloudcrafter/salesforce-agent-kit

> AI agent kit for Salesforce development - skills, workflows, patterns and automation for Apex, LWC, Triggers, and more.


What is this?

This CLI package provides AI coding assistants with Salesforce-specific knowledge through a collection of skills, agents, and workflow guides. When installed in your project, these help AI assistants understand Salesforce patterns, best practices, and common solutions.

- Skills: Reference knowledge about patterns and best practices
- Agents: Specialized personas for specific tasks (legacy code, product management)
- Workflows: Step-by-step guidance for common development tasks

Quick Start

``bash


Initialize all skills and workflows in your project

npx @cloudcrafter/salesforce-agent-kit init

Or add specific categories

npx @cloudcrafter/salesforce-agent-kit add apex
npx @cloudcrafter/salesforce-agent-kit add triggers
`

Available Skills

| Category | Skills | Description |
|------------------|--------|------------------------------------------------------|
| apex | 4 | Batch, Queueable, Governor Limits, Error Handling |
| triggers | 5 | Handler Framework, Recursion, Context, Bulkification |
| lwc | 4 | Architecture, Wire, Events, Imperative Apex |
| soql | 3 | Optimization, Relationships, Dynamic SOQL |
| flows | 2 | Design Patterns, Record-Triggered |
| security | 2 | CRUD/FLS, Sharing Rules |
| data-modeling | 1 | Relationships |
| testing | 1 | Test Data Factory |
| deployment | 1 | Salesforce CLI |
| integrations | 1 | REST API |
| migration | 5 | VF to LWC, Aura to LWC, JS Button Replacement |

Specialized Agents

| Agent | Description |
|--------------------------|--------------------------------------------------------------------------|
| code-archaeologist | Expert in legacy Salesforce code, refactoring, and reverse engineering |
| devops-engineer | Expert in CI/CD, deployment pipelines, scratch orgs, and automation |
| performance-optimizer | Expert in governor limits, SOQL optimization, and bulk processing |
| product-manager | Expert in Salesforce requirements, user stories, and acceptance criteria |
| security-guardian | Expert in CRUD/FLS, sharing models, and secure coding practices |
| solution-architect | Expert in org architecture, system design, and scalability planning |

Available Workflows

Step-by-step guides for common Salesforce development tasks:

| Workflow | Description |
|------------------------|----------------------------------------------|
| apex-development | Apex classes, Batch, Queueable, async patterns |
| lwc-development | Lightning Web Components from scratch |
| triggers-automation | Trigger handler framework and best practices |
| data-modeling | Custom objects, fields, relationships |
| soql-optimization | Query performance and optimization |
| security-sharing | CRUD/FLS, sharing rules, permissions |
| testing-quality | Test classes, data factories, coverage |
| deployment-devops | SFDX, scratch orgs, CI/CD |
| integrations | REST callouts, Named Credentials |
| flows-automation | Record-triggered and screen flows |
| classic-to-lightning | VF→LWC, Aura→LWC migration |

Commands

$3

Initialize all skills and workflows in your project:

`bash
npx @cloudcrafter/salesforce-agent-kit init
npx @cloudcrafter/salesforce-agent-kit init --force # Overwrite existing
`

$3

Add a specific category:

`bash
npx @cloudcrafter/salesforce-agent-kit add apex
npx @cloudcrafter/salesforce-agent-kit add lwc --force
`

$3

Show available categories and installed status:

`bash
npx @cloudcrafter/salesforce-agent-kit list
npx @cloudcrafter/salesforce-agent-kit list --verbose # Show individual skills
`

$3

Update installed skills to the latest version:

`bash
npx @cloudcrafter/salesforce-agent-kit update
`

$3

Remove an installed category:

`bash
npx @cloudcrafter/salesforce-agent-kit remove apex
`

How It Works

Skills and workflows are installed to .agent/ in your project root. AI coding assistants that support these files will automatically read them to enhance their Salesforce knowledge.

`text
your-project/
├── .agent/
│ ├── agents/ # Specialized agent personas
│ │ ├── code-archaeologist.md
│ │ └── product-manager.md
│ ├── skills/ # Technical knowledge by category
│ │ ├── apex/
│ │ │ ├── batch-apex.md
│ │ │ └── ...
│ │ ├── triggers/
│ │ └── ...
│ └── workflows/ # Step-by-step guides
│ ├── apex-development.md
│ └── ...
└── force-app/
`

File Format

Each skill and workflow file uses a simple format:

`markdown
---
description: Brief description for AI context
---

Title

Content with code examples, patterns, and best practices...
`

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

$3

This project uses automated releases based on conventional commits:

- feat: commits trigger minor version bumps (1.1.3 → 1.2.0)
- fix: commits trigger patch version bumps (1.1.3 → 1.1.4)
- ci: commits trigger patch version bumps (1.1.3 → 1.1.4)
- BREAKING CHANGE` in commit message triggers major version bumps (1.1.3 → 2.0.0)

The release process is fully automated:
1. Push commits to main → Release PR created automatically
2. Merge PR → Git tag created automatically
3. Tag push → NPM publish happens automatically

License

MIT © cloudcrafter