Add AGENTS.md

[maxkfranz]

Ref: Add AGENTS.md #3441

Cross-references to related issues. If there is no existing issue that describes your bug or feature request, then create an issue before making your pull request.

Associated issues:

• Add AGENTS.md #3441

Notes re. the content of the pull request. Give context to reviewers or serve as a general record of the changes made. Add a screenshot or video to demonstrate your new feature, if possible.

• Adds AGENTS.md for use by Codex, Claude, Copilot, etc.
• Doesn't change any API so may as well be included in a patch release.

Checklist

Author:

• The proper base branch has been selected. New features go on unstable. Bug-fix patches can go on either unstable or master.
• N/A -- Automated tests have been included in this pull request, if possible, for the new feature(s) or bug fix. Check this box if tests are not pragmatically possible (e.g. rendering features could include screenshots or videos instead of automated tests).
• The associated GitHub issues are included (above).
• Notes have been included (above).
• For new or updated API, the index.d.ts Typescript definition file has been appropriately updated.

Reviewers:

• All automated checks are passing (green check next to latest commit).
• At least one reviewer has signed off on the pull request.
• For bug fixes: Just after this pull request is merged, it should be applied to both the master branch and the unstable branch. Normally, this just requires cherry-picking the corresponding merge commit from master to unstable -- or vice versa.

[maxkfranz]

Adding @chrtannus & @d2fong as reviewers. Let me know if you think anything should be added or amended.

[d2fong]

Looks good to me as a starting point. Because cytoscape.js is a large codebase. It may be worth exploring progressive disclosure techniques. Here is this one idea I found in this talk:

[chrtannus]

I can't think of anything else to add.

[maxkfranz]

Looks good to me as a starting point. Because cytoscape.js is a large codebase. It may be worth exploring progressive disclosure techniques. Here is this one idea I found in this talk:

This is a really good point. I did some research on this, and I don't think it's yet safe to depend on it unless you assume everyone uses Claude or Codex. E.g. Copilot doesn't yet have full support for progressive disclosure in the same way.

We should definitely add support for this later, but right now it could be a bit hit or miss.

In any case, for now I just want something good enough as compared to what we have now for agents (nothing).

[maxkfranz]

@copilot, please create an issue re. @d2fong's feedback re. progressive disclosure