IMPORTANT

Important Project Guidelines

Documentation Files

• Use docs/*.md files: Refer to and use the documentation files in the docs/ directory for project-specific information and guidelines.

• Use .cursor/plans/*.md files: Refer to and use planning documents in the .cursor/plans/ directory for project planning and development guidance.

Updating Existing Documentation - CRITICAL REQUIREMENT

MANDATORY: When updating any file in the docs/ directory, you MUST follow the documented process. This is NON-NEGOTIABLE.

What you MUST do:

1. Understand the workflow first - Before making any changes to a doc file, understand the complete workflow
2. Extract references - Extract repository URLs, web page URLs, or Salesforce article references from the doc file itself
3. Re-research sources - Extract repository URLs, web page URLs, or other references from the doc file itself. CRITICAL: If a repository URL is already present in the existing docs/*.md file, extract the repository URL directly from the doc file and proceed to cloning.
4. Clone repository - Clone repo using full permissions to system's temporary folder (if applicable)
5. Systematic review - Go through every URL on the official page and every file in the repo (verify ALL files inspected)
6. Verify all content - All content in markdown file must be verified or removed/changed
7. Add missing content - Anything missing should be added
8. Cleanup - Delete temporary repository directory after inspection
9. Verify ALL todos completed - Before proceeding, verify ALL file inspection todos are completed (count must match file count exactly)
10. Optimize - Actually execute the OPTIMISE.md plan after updates (ONLY after ALL todos completed, read it, apply techniques, don't just mark as done)
11. Version - Follow VERSIONING.md to determine and update version numbers

What you MUST NOT do:

• ❌ Update doc files without understanding the workflow first
• ❌ Make changes without re-researching sources
• ❌ Skip repository cloning for repository-based docs
• ❌ Skip the verification process
• ❌ Skip file inspection (ALL files must be inspected)
• ❌ Leave temporary directories on the system
• ❌ Mark optimization as "done" without actually executing it
• ❌ Skip optimization or versioning steps
• ❌ Begin optimization before ALL file inspection todos are completed
• ❌ Cancel or skip remaining todos because "essential review is complete"