Enterprise Guide - Codex and Claude in Salesforce

Documentation, Operations, and Prompt Library

Documentation, support, leadership usage, role-based adoption, and reusable prompt patterns.

18 min readUpdated March 11, 2026By Shivam Gupta
6Linked documentation pages
27Core guide sections
Mixed audienceArchitecture to leadership
OperationalPrompts, governance, roadmaps

Section 15: Use in Documentation

15.1 Documents AI can accelerate

  • technical design documents
  • low-level designs
  • architecture decision records
  • admin guides
  • runbooks
  • support guides
  • onboarding documents
  • release notes
  • troubleshooting guides
  • knowledge articles
  • README files
  • API docs
  • inline code comments
  • handover packs

15.2 Documentation operating model

Document TypeDraft byTechnical Validate byBusiness Validate by
TDD/LLDClaudeArchitect/LeadBA/Product Owner
RunbookClaudeSupport Lead/DeveloperOps Manager
Release notesClaudeRelease ManagerProduct Owner
Code comments/READMECodexDevelopern/a
API docsCodex + ClaudeIntegration LeadBA if external consumers exist

15.3 Best practice

  • generate first draft with AI
  • require named human owner
  • store docs in version control or controlled repository
  • maintain changelog and review date

Section 16: Use in Support and Maintenance

16.1 Support use cases

  • incident analysis
  • log interpretation
  • impact analysis
  • root cause drafts
  • bug triage
  • troubleshooting playbooks
  • user issue summaries
  • knowledge article creation
  • trend detection from recurring incidents

16.2 Example prompt

Analyze the following Salesforce production incident notes and logs.
Provide:
1. probable root cause
2. impacted user groups
3. immediate containment options
4. permanent fix options
5. support-friendly explanation
6. KB article draft

16.3 Support anti-patterns

  • pasting raw customer PII into prompts
  • using AI to communicate RCA before technical validation
  • skipping incident timelines and evidence

Section 17: Use for Leadership, PM, and Delivery Management

17.1 Management use cases

  • project planning
  • estimate decomposition
  • RAID logs
  • sprint planning summaries
  • steering committee packs
  • executive summaries
  • stakeholder communication drafts
  • adoption plans
  • training plans

17.2 Example outputs

  • project milestone summary
  • risk summary by workstream
  • sprint objective draft
  • executive one-page decision memo
  • training rollout plan

17.3 Prompt example

Create a steering committee summary for a Salesforce transformation.
Include:
- progress since last meeting
- top risks
- decisions required
- dependencies
- budget/scope watch items
- next 30-day priorities

Audience: CIO, business sponsor, enterprise architect, PMO

Section 18: Role-Based Usage Model

Salesforce Admin

  • Key use cases: formulas, Flow logic, page layouts, reports, release notes
  • High-value prompts: "draft validation rules with examples", "explain this Flow fault path"
  • Benefits: faster configuration drafting, better documentation
  • Risks: incorrect security assumptions, inefficient automation logic
  • Best practices: always request test scenarios and performance notes

Salesforce Developer

  • Key use cases: Apex/LWC/test classes/refactoring
  • High-value prompts: "review this trigger for bulk and sharing issues"
  • Benefits: faster implementation and review
  • Risks: subtle limit/security defects
  • Best practices: static analysis and peer review mandatory

Technical Lead

  • Key use cases: code review standards, refactoring plans, release risk analysis
  • Benefits: team acceleration, consistency
  • Risks: over-trusting generated fixes
  • Best practices: use AI to augment review, not replace it

Solution Architect

  • Key use cases: option analysis, NFRs, security model, integration patterns
  • Benefits: faster architecture artifacts
  • Risks: elegant but unvalidated design assumptions
  • Best practices: cross-check with org constraints and enterprise standards

Enterprise Architect

  • Key use cases: operating model, platform strategy, multi-org decisions, governance
  • Benefits: better standardization
  • Risks: abstract outputs disconnected from delivery reality
  • Best practices: tie recommendations to measurable controls

QA Engineer

  • Key use cases: test matrices, edge cases, defect summaries
  • Benefits: broader coverage
  • Risks: shallow tests if prompts are weak
  • Best practices: combine business risk and system dependency views

Business Analyst

  • Key use cases: stories, acceptance criteria, discovery packs, BRD/FRD
  • Benefits: stronger requirement clarity
  • Risks: missing domain nuance
  • Best practices: use AI to expose questions, not invent answers

Delivery Manager

  • Key use cases: status, RAID, release comms, planning artifacts
  • Benefits: lower reporting overhead
  • Risks: over-polished but inaccurate summaries
  • Best practices: verify with workstream leads before sharing

Support Analyst

  • Key use cases: triage summaries, incident patterns, KB articles
  • Benefits: faster issue handling
  • Risks: unsupported RCA assumptions
  • Best practices: require evidence references in every support draft

Product Owner

  • Key use cases: backlog shaping, priority articulation, acceptance readiness
  • Benefits: clearer stories and release communication
  • Risks: AI-generated priorities that miss business nuance
  • Best practices: keep final prioritization human-owned

Section 19: Prompt Library

Requirements

Act as a Salesforce business analyst.
Convert the following business requirement into epics, features, user stories, acceptance criteria, assumptions, open questions, and edge cases.
Prioritize standard Salesforce functionality.
Requirement:
[paste]

Architecture

Act as a Salesforce solution architect.
Given the requirements below, propose solution options with pros/cons, risks, scalability considerations, integration implications, and a recommended approach.
[paste]

Admin configuration

Design the Salesforce admin solution for this requirement.
Include:
- objects/fields
- validation rules
- Flow outline
- page layout or Dynamic Forms recommendations
- permission set impacts
- reporting impacts

Apex generation

Generate Apex for the following requirement using enterprise patterns:
- with sharing unless justified otherwise
- bulk-safe
- null-safe
- service layer
- test class included
- error handling included
Requirement:
[paste]

LWC generation

Create an LWC for the following use case.
Include:
- HTML
- JS
- CSS
- Apex interface assumptions
- accessibility notes
- performance considerations
- Jest tests outline

Flow design

Design a Salesforce Flow for this process.
Include:
- trigger type
- entry criteria
- decisions
- subflows
- fault paths
- naming conventions
- maintainability recommendations

Integrations

Create an integration design for Salesforce and [system].
Include:
- system of record
- API pattern
- auth model
- payload mapping
- retries
- logging
- error handling
- support ownership

Test classes

Create comprehensive Salesforce Apex tests for this class.
Cover:
- happy path
- validation failures
- limit-sensitive behavior
- bulk scenarios
- security assumptions

Test scenarios

Generate business and system test scenarios for this process.
Include:
- positive
- negative
- edge
- role-based
- integration failure
- data quality

Documentation

Turn the following implementation notes into a technical design document.
Audience: architects, developers, admins, support
Include assumptions, dependencies, design decisions, risks, and operational notes.

Release notes

Summarize these deployment changes into:
1. technical release notes
2. business release notes
3. support impact summary
4. rollback considerations

Support troubleshooting

Analyze this incident evidence and produce:
- probable root cause
- impact
- immediate workaround
- long-term fix
- required teams
- draft knowledge article

Data migration

Create a migration plan for these source datasets into Salesforce.
Include mappings, transformations, load order, validation impacts, reconciliation, and rollback considerations.

Security reviews

Review this Salesforce solution for security and compliance risks.
Consider:
- field access
- sharing
- secrets
- integration auth
- PII exposure
- auditability
- admin bypass risks

Code review

Review this Salesforce code with a senior code-review mindset.
Prioritize:
- bugs
- regressions
- bulkification
- security
- readability
- missing tests

Performance review

Review this design for Salesforce performance risks.
Focus on:
- limits
- large data volume
- query selectivity
- Flow recursion
- UI performance
- integration latency

Refactoring

Refactor this Salesforce implementation for maintainability.
Keep behavior unchanged.
Improve structure, naming, reuse, error handling, and tests.

User story writing

Write a user story for Salesforce implementation using:
As a
I want
So that

Also provide acceptance criteria, dependencies, and test notes.

Acceptance criteria creation

Create detailed acceptance criteria for this Salesforce requirement.
Include business rules, permissions, edge cases, and reporting expectations.