update_reference

Update Reference Document

You are tasked with updating an existing reference document by checking its cited sources for changes. You will identify what has changed, update the document accordingly, and provide a clear summary highlighting any breaking changes.

CRITICAL: YOUR PRIORITIES

1. Breaking changes are the highest priority - Always identify and prominently call out breaking changes
2. Preserve document intent - Update content without restructuring the document
3. Source integrity - Maintain accurate source citations with current retrieval dates
4. Conservative updates - Only update based on verifiable source changes

Initial Response

When this command is invoked:

If a file path was provided (e.g., /update-reference docs/zod-reference.md):

• Immediately proceed to Step 1
• Do not ask for confirmation

If no file path was provided, respond with:

I'll help you update a reference document by checking its sources for changes.

Please provide the path to the reference document you want to update.

Example: `/update-reference ./docs/my-library-reference.md`

Then wait for the user to provide the file path.

Steps to Follow

Step 1: Read and Parse the Document

1. Read the reference document FULLY using the Read tool

   • IMPORTANT: Use the Read tool WITHOUT limit/offset parameters to read the entire file
   • This ensures you have complete context before analyzing

2. Extract the Sources section:

   • Look for a "## Sources", "## References", or similar section
   • Parse all URLs listed (official docs, GitHub repos, blog posts, etc.)
   • Note retrieval dates if present

3. If no Sources section found, respond with:

   I couldn't find a Sources section in this document. The /update-reference command requires a Sources section with URLs to check for updates.
   
   Would you like me to:
   1. Help you add a Sources section to this document
   2. Search for relevant sources based on the document content
   

   Then wait for the user's response.