docs: Rules doc improvements

[bdougie]

Description

Updating the rules documentation in preparation for improving user on boarding experiences.

fixes: #5968

Checklist

• I've read the contributing guide
• The relevant docs, if any, have been updated or created
• The relevant tests, if any, have been updated or created

Screenshots

[ For visual changes, include screenshots. Screen recordings are particularly helpful, and appreciated! ]

/agent/how-to-customize

Agent customization includes rules mention and links /agent/how-to-customize

/blocks/rules

More context in /blocks/rules

/customize/deep-dives/rules

info block for when rules don't work in /customize/deep-dives/rules

Added schema as a required option.

Tests

[ What tests were added or updated to ensure the changes work as expected? ]

n/a

[cubic-dev-ai]

Your cubic subscription is currently inactive. Please reactivate your subscription to receive AI reviews and use cubic.

[netlify]

✅ Deploy Preview for continuedev ready!

Name	Link
🔨 Latest commit	e87a3a5
🔍 Latest deploy log	https://app.netlify.com/projects/continuedev/deploys/6840ae15ba2a880008f3b634
😎 Deploy Preview	https://deploy-preview-5969--continuedev.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[github-actions]

All contributors have signed the CLA ✍️ ✅
_{Posted by the CLA Assistant Lite bot.}

[bdougie]

I have read the CLA Document and I hereby sign the CLA

[RomneyDa]

Nice improvements to the rules docs!

Missed some comments

[bdougie]

I've made some initial fixes per your review @RomneyDa and @Patrick-Erichsen. I also updated the side nav to flow to ensure theres is a flow of discovery in the file.

I will think through the other comments tonight, but plan on attacking the new markdown syntax and frontmatter features in my next PR.

[bdougie]

I've addressed more of the comments and continue the improvement. Now rules deep dive includes a quick start, more examples, and section titles.

The Quick is a pirates-rule.yaml. A simple example support the feature discovery. Open to other ideas here or in the example section.

[RomneyDa]

Looks good, left some nitpicks but not blocking
Note that screenshots in PR description are out of date

[bdougie]

Note that screenshots in PR description are out of date

updated