@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

# 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

init

Initialize all skills and workflows in your project:

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

add <category>

Add a specific category:

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

list

Show available categories and installed status:

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

update

Update installed skills to the latest version:

npx @cloudcrafter/salesforce-agent-kit update

remove <category>

Remove an installed category:

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.

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:

---
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.

Automated Releases

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