AI agent kit for Salesforce development - patterns, best practices, and automation for Apex, LWC, Triggers, and more
npm install @cloudcrafter/salesforce-agent-kit> AI agent kit for Salesforce development - skills, workflows, patterns and automation for Apex, LWC, Triggers, and more.



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
``bashInitialize all skills and workflows in your project
npx @cloudcrafter/salesforce-agent-kit init
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
MIT © cloudcrafter