Update agent guidelines for internal links and file management

[CamSoper]

Revise agent guidelines for moving, renaming, or deleting files, including the creation of redirects.

[claude]

Pull Request Review

This PR improves the file management guidelines in AGENTS.md by adding comprehensive instructions for handling moved, renamed, or deleted files. The changes are well-structured and align with the repository's needs.

✅ Positive aspects:

• Clear structure: The new "Moving and Deleting Files" section is well-organized and easy to follow
• Comprehensive coverage: Addresses file history preservation, internal references, and redirect management
• Practical guidance: Provides specific examples (e.g., neo-redirects.txt) and format specifications
• Consistent formatting: Follows the existing style of the AGENTS.md file

✅ Technical accuracy:

• The redirect format source-path|destination-url matches the existing files in /scripts/redirects/
• The git mv recommendation for preserving file history is correct
• The S3 redirects location is accurate

✅ Style compliance:

• Uses semantic line breaks appropriately
• Follows proper heading hierarchy (H2 level)
• Uses consistent bullet point formatting
• Maintains the established tone and style of the document

Minor observations:

The removal of the internal links rule from "Absolute Prohibitions" (line 46) appears intentional but wasn't mentioned in the PR description. This change makes sense as STYLE-GUIDE.md (lines 37-39) allows normal Markdown syntax for internal links, so the removed restriction was creating a conflict between agent and human guidelines.

Recommendation: ✅ APPROVE

This PR enhances the agent guidelines with practical, accurate instructions that will help maintain link integrity and proper file management practices. No changes needed.

[pulumi-bot]

Your site preview for commit badb0ec is ready! 🎉

http://www-testing-pulumi-docs-origin-pr-16051-badb0ec2.s3-website.us-west-2.amazonaws.com.

[jkodroff]

Note that this is not always possible, for example when breaking out a single document into multiple documents.

[jkodroff]

This should be more specific:

• We need to add an alias in the moved document.
• I'm guessing we should ideally update links to use the new canonical path, but we do not enforce that today.
• Anchors links do not support aliases. (I think. Need to test.) This comes up when splitting up long docs.
• When can aliases be removed? (I don't know for sure, but I would guess when no other internal links refer to the old URI.)

[jkodroff]

See above. "Alias" is the right term, because that's what it's called in the front matter.

[pulumi-bot]

Your site preview for commit c647623 is ready! 🎉

http://www-testing-pulumi-docs-origin-pr-16051-c6476237.s3-website.us-west-2.amazonaws.com.