afv-library/skills/deployment-readiness-check/assets/deployment_checklist.md
Mohan Raj Rajamanickam 2320c50264
ci: publish skills as @salesforce/afv-skills npm package @W-21534193@ (#30)
* ci: update package details and add GitHub workflows for skills validation and release

* chore: update Node version, change license, and refactor skills validation script to TypeScript

* chore: remove unused deps

* fix: npm package

* fix: flatten skills to pass validation

* chore: add validation script to package.json and update GitHub workflow to use it

* chore: enhance skills validation and update workflows for npm publishing

* refactor: streamline skills validation process in workflow and script

* refactor: improve documentation and structure of skills validation script

* implement checks based on jeff's best practices doc

* chore: add pull request template for skill submissions

* chore: update pull request template with additional references and improve automated checks section

* chore: update pull request template to clarify naming convention with a warning for gerund form

* chore: update pull request template to reference skill authoring guide and enhance checklist structure

* chore: enhance GitHub workflows for skills validation and release process

* refactor: improve parsing logic for SKILL.md files and enhance error collection in validation

* chore: update validation checks to enforce character limits for skill names and descriptions

* fix: remove unnecessary whitespace in footer string in validate-skills.ts
2026-03-12 13:41:52 -07:00

7.4 KiB

Salesforce Deployment Checklist

Deployment Date: _________________
Deployment Time Window: _________ to _________
Environment: ☐ Production ☐ Sandbox ☐ UAT
Deployment Lead: _________________
Release Version: _________________


Pre-Deployment

1. Code & Configuration Review

  • All code reviewed and approved via pull request
  • Code follows organizational coding standards
  • No debugging statements or console.logs in production code
  • API versions are current (API 56.0+)
  • Hard-coded IDs/URLs removed (use Custom Settings or Custom Metadata)
  • Comments and documentation are up-to-date

2. Testing

  • All unit tests pass locally
  • Test coverage meets minimum requirements (≥75% org-wide)
  • Integration tests executed successfully
  • User acceptance testing (UAT) completed
  • Regression testing performed for existing features
  • Performance testing validates no degradation

Test Results:

  • Total classes: _____
  • Test coverage: _____%
  • Failed tests: _____
  • Test run ID: _________________

3. Security Review

  • Profile/permission set changes reviewed
  • Field-level security validated
  • Sharing rules appropriate for data sensitivity
  • No admin permissions granted to standard users
  • Connected Apps use appropriate OAuth scopes
  • Named Credentials use secure authentication
  • Sensitive data is encrypted or masked

4. Dependencies

  • All metadata dependencies identified
  • Missing components added to package.xml
  • External system dependencies documented
  • API integrations tested in target environment
  • Third-party packages compatible with deployment

5. Backup & Rollback

  • Pre-deployment backup completed
    • Metadata backup: ☐ Yes ☐ N/A
    • Data backup: ☐ Yes ☐ N/A
    • Backup location: _________________
  • Rollback procedure documented and tested
  • Rollback criteria defined
  • Emergency contacts list current

6. Documentation

  • Release notes prepared
  • Deployment guide created
  • User training materials ready (if applicable)
  • Help documentation updated
  • Known issues documented
  • FAQ prepared for support team

7. Communication

  • Stakeholders notified of deployment schedule
  • Users notified of system downtime (if applicable)
  • Support team briefed on changes
  • Change advisory board approval obtained
  • Post-deployment communication template ready

8. Validation

  • Validation deployment successful in production
  • Quick Deploy ID obtained: _________________
  • Validation results reviewed and approved
  • All deployment warnings addressed

Validation Command:

sf project deploy validate --manifest package.xml --test-level RunLocalTests --verbose

Deployment Execution

9. Pre-Deployment Actions

  • Announced maintenance window to users
  • Disabled scheduled jobs/batch processes (if required)
    • Jobs disabled: _________________
  • Created deployment tag in git: _________________
  • Verified target org connectivity
  • Team on standby for deployment

10. Deployment

Deployment Start Time: _________

  • Deployment initiated via validated package or change set
  • Deployment progress monitored
  • Test execution in progress
  • Any deployment errors addressed immediately

Deployment Command:

sf project deploy start --use-most-recent-validation
# OR
sf project deploy start --manifest package.xml --test-level RunLocalTests

Deployment ID: _________________

Deployment End Time: _________

Duration: _________ minutes

11. Post-Deployment Verification

  • Deployment completed successfully
  • All tests passed in production
  • Deployment results reviewed (no warnings/errors)
  • Smoke tests executed successfully
  • Critical user workflows verified:
    • Workflow 1: _________________
    • Workflow 2: _________________
    • Workflow 3: _________________
  • Re-enabled scheduled jobs/batch processes
  • Debug logs show no new errors

12. Post-Deployment Actions

  • Stakeholders notified of successful deployment
  • Users notified system is available
  • Release notes published
  • Support team provided with deployment summary
  • Monitoring dashboard reviewed

Post-Deployment Monitoring (24-48 Hours)

13. System Monitoring

  • Day 1 - Monitor debug logs for errors
    • Errors found: ☐ Yes ☐ No
    • If yes, describe: _________________
  • Day 1 - Review governor limit usage
    • Limits exceeded: ☐ Yes ☐ No
  • Day 1 - Check user-reported issues
    • Issues reported: ☐ Yes ☐ No
  • Day 2 - Confirm automation working correctly
  • Day 2 - Validate data integrity
  • Day 2 - Review performance metrics

14. User Acceptance

  • Key users confirmed functionality works
  • No critical bugs reported
  • User feedback collected
  • Support tickets categorized by severity

Feedback Summary:



Rollback (If Required)

Rollback Decision: ☐ Yes ☐ No

Reason: _________________

  • Stakeholder approval for rollback obtained
  • Users notified of rollback
  • Rollback procedure executed
  • Rollback verified successful
  • Post-rollback communication sent

Rollback Time: _________


Deployment Summary

Components Deployed

Component Type Count Examples
Apex Classes
Apex Triggers
LWC
Flows
Custom Objects
Custom Fields
Profiles
Perm Sets
Other

Total Components: _____

Deployment Metrics

  • Validation time: _________ minutes
  • Deployment time: _________ minutes
  • Test execution time: _________ minutes
  • Total elapsed time: _________ minutes
  • Downtime (if any): _________ minutes

Issues Encountered

Issue Severity Resolution Time to Resolve

Total Issues: _____


Sign-Off

Deployment Team

Deployment Lead: _________________ Date: _________
Developer(s): _________________ Date: _________
QA Lead: _________________ Date: _________
DevOps Engineer: _________________ Date: _________

Stakeholders

Product Owner: _________________ Date: _________
Business Analyst: _________________ Date: _________
Release Manager: _________________ Date: _________


Post-Deployment Review

Review Date: _________________

What Went Well




What Could Be Improved




Action Items

  • Action: _________________ Owner: _________ Due: _________
  • Action: _________________ Owner: _________ Due: _________
  • Action: _________________ Owner: _________ Due: _________

Attachments

  • package.xml
  • Test results report
  • Deployment log
  • Release notes
  • Rollback procedure (if executed)
  • Post-deployment monitoring reports

Storage Location: _________________


Notes: