Add agent guides & claude file

[agibson-godaddy]

Summary

This creates a new .agents/guides/ directory, which is intended to serve as implementation guides for AI agents to follow. The first guide committed is for abilities implementation.

This also initializes a new CLAUDE.md file.

.gitattributes is also committed to exclude these files from composer, along with some other items that are not meaningful to end plugins.

QA

• Docs review

And to confirm gitattributes:

1. Upgrade to this branch in any plugin.
2. Run ls -la vendor/skyverge/wc-plugin-framework
   • CLAUDE.md not present
   • .agents/ directory not present
3. Load some WordPress pages with your chose plugin activated.
   • Everything still works as expected.

Before merge

• I have confirmed these changes in each supported minor WooCommerce version

[Copilot]

Pull request overview

Adds AI-agent–oriented documentation and ensures those development-only docs (and other non-distribution assets) are excluded from Composer dist archives for consumer plugins.

Changes:

• Added CLAUDE.md with repo build/test/linting/architecture guidance.
• Introduced .agents/guides/ with a common setup guide and a detailed abilities implementation guide.
• Added .gitattributes to export-ignore agent/docs/tests/build artifacts from git archive / Composer dist exports.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.

File	Description
CLAUDE.md	Repository-level guidance for Claude Code: build, tests, linting, architecture, and conventions.
.gitattributes	Marks dev-only files/dirs (including .agents/ and CLAUDE.md) as export-ignore for Composer dist archives.
.agents/guides/COMMON-SETUP.md	Shared discovery/setup steps and placeholder resolution used by implementation guides.
.agents/guides/ABILITIES-IMPLEMENTATION-GUIDE.md	Step-by-step guide (with examples, tests, QA template) for adding Abilities API support to plugins.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.