DYN-10239: Add AI agent skills, rules, and IDE configuration#16952
Conversation
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
There was a problem hiding this comment.
See the ticket for this pull request: https://jira.autodesk.com/browse/DYN-10239
There was a problem hiding this comment.
Pull request overview
This PR adds shared AI agent guidance to the Dynamo repository to improve the quality and consistency of AI-assisted development. It introduces a canonical .ai/agents/ directory containing skills, rules, and templates, along with a CLAUDE.md at the repo root for Claude Code guidance and updates to .github/copilot-instructions.md.
Changes:
- New
.ai/agents/directory with 4 skills (dynamo-dotnet-expert,dynamo-onboarding,dynamo-pr-description,dynamo-jira-ticket), 1 rule file (dynamo-core-rules.md), and aREADME.mddocumenting the structure. - New
CLAUDE.mdat the repo root providing Claude Code with project context and pointers to the.ai/agents/directory. - Updated
.github/copilot-instructions.mdwith an "Agent Skills and Templates" section referencing the new.ai/agents/directory.
Reviewed changes
Copilot reviewed 9 out of 9 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
.ai/agents/README.md |
Canonical index of all agent skills, rules, and templates; documents folder structure and tool-specific mirrors |
.ai/agents/skills/dynamo-dotnet-expert/SKILL.md |
Comprehensive C#/.NET skill covering code design, testing, PublicAPI management, and security |
.ai/agents/skills/dynamo-onboarding/SKILL.md |
Architecture briefing skill covering Dynamo structure, key files, debugging, and related projects |
.ai/agents/skills/dynamo-pr-description/SKILL.md |
Skill for generating PR descriptions matching the Dynamo template |
.ai/agents/skills/dynamo-jira-ticket/SKILL.md |
Skill for creating structured Jira tickets from bug reports or feature requests |
.ai/agents/skills/dynamo-jira-ticket/template.md |
Copy/paste Jira ticket template |
.ai/agents/rules/dynamo-core-rules.md |
Short guardrail rules for C#/.NET, testing, PublicAPI, and security |
CLAUDE.md |
New root-level guidance file for Claude Code |
.github/copilot-instructions.md |
Adds "Agent Skills and Templates" section pointing to the .ai/agents/ directory |
| @@ -0,0 +1,45 @@ | |||
| # Dynamo Core Rules | |||
There was a problem hiding this comment.
There is a equivalent thing like rules for Cursor in Copilot world, I think it's https://github.com/DynamoDS/Dynamo/blob/master/.github/copilot-instructions.md. Feel free to validate and we may need some thing to keep them in sync. Not sure if there are some other online best practices to do the syncing part
QilongTang
left a comment
QilongTang
left a comment
There was a problem hiding this comment.
A couple comments then LGTM so that we can test
|
| @@ -0,0 +1,129 @@ | |||
| --- | |||
| name: dynamo-jira-ticket | |||
There was a problem hiding this comment.
My only comment here would be that this is the public repo but outside devs (non autodeskers) cannot write jira tickets. We could perharps suggest to the user that if he is not an insider he can turn this into a github issue instead?
Anyways it will be 99%+ used by autodeskers so maybe not worth the hassle, but just found it a bit weird to have this on the public repo.
There was a problem hiding this comment.
That is a very good point! We should either rename it or move it to a different location.
Purpose
Add shared AI agent guidance to the Dynamo repository so that AI-assisted development tools can produce higher-quality, repo-consistent output.
Key changes:
dynamo-dotnet-expert-- C#/.NET coding patterns, PublicAPI management, NUnit testing, securitydynamo-onboarding-- architecture overview, key files, debugging approaches, related projectsdynamo-pr-description-- PR description writer matching the Dynamo templatedynamo-jira-ticket-- structured Jira ticket creation (includes template.md)No source code, tests, or public API changes are included.
running the skills in claude code: @.ai/agents/skills/dynamo-onboarding/
running the skills in cursor using @.ai/agents/skills/dynamo-onboarding/
Declarations
Check these if you believe they are true
Release Notes
Add AI agent skills, rules, and IDE configuration for Dynamo development.
Reviewers
(FILL ME IN) Reviewer 1 (If possible, assign the Reviewer for the PR)
(FILL ME IN, optional) Any additional notes to reviewers or testers.
FYIs
(FILL ME IN, Optional) Names of anyone else you wish to be notified of