feat(core): improve AI agent rules for CLAUDE.md generation#34304
feat(core): improve AI agent rules for CLAUDE.md generation#34304
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
✅ Deploy Preview for nx-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
|
View your CI Pipeline Execution ↗ for commit 234e97c
☁️ Nx Cloud last updated this comment at |
|
What about adding another for never using |
- Add nx-workspace skill first guidance - Add package manager prefix rule - Add "never guess CLI flags" rule - Add Scaffolding & Generators section - Add "When to use nx_docs" guidance
91980b0 to
b0507e7
Compare
✅ Deploy Preview for nx-dev ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
@Stanzilla can you elaborate? when does it use it? |
I can try to remember to copy the session when it happens the next time but it was usually when it was trying to see which targets are available afair |
There was a problem hiding this comment.
Important
At least one additional CI pipeline execution has run since the conclusion below was written and it may no longer be applicable.
Nx Cloud has identified a possible root cause for your failed CI:
Our e2e-gradle tests are failing due to an external service outage, not the PR changes. The Foojay toolchain resolver (which Gradle uses to provision Java installations) is returning 503 errors, preventing Java 21 from being resolved. This is an infrastructure issue requiring the external service to recover.
No code changes were suggested for this issue.
🔂 A CI rerun has been triggered by adding an empty commit to this branch.
🎓 Learn more about Self-Healing CI on nx.dev
- Add nx-workspace skill first guidance - Add package manager prefix rule - Add "never guess CLI flags" rule - Add Scaffolding & Generators section - Add "When to use nx_docs" guidance [Self-Healing CI Rerun]
Pull Request is not mergeable
## Summary Updates the generated CLAUDE.md content with improved guidance for AI agents working with Nx workspaces. **Changes:** - Add "nx-workspace skill first" for workspace navigation - Add "prefix nx commands with package manager" rule - Add "NEVER guess CLI flags" rule - Add "Scaffolding & Generators" section (invoke nx-generate skill first) - Add "When to use nx_docs" guidance (USE for advanced config, DON'T USE for basic syntax) ## Why These Changes Based on testing with repeated scaffolding tasks, agents were: | Issue | Fix | |-------|-----| | Calling `nx_docs` for basic generator syntax | Added clear guidance on when to use/not use nx_docs | | Guessing CLI flags incorrectly (e.g., `nx sync --apply`) | Added "never guess flags" rule | | Using global nx CLI causing version mismatches | Added package manager prefix rule | | Not invoking nx-generate skill on scaffolding tasks | Added explicit "Scaffolding & Generators" section | ## Related Companion PR with skill improvements: nrwl/nx-ai-agents-config#26 --------- Co-authored-by: nx-cloud[bot] <71083854+nx-cloud[bot]@users.noreply.github.com>
|
This pull request has already been merged/closed. If you experience issues related to these changes, please open a new issue referencing this pull request. |
Summary
Updates the generated CLAUDE.md content with improved guidance for AI agents working with Nx workspaces.
Changes:
Why These Changes
Based on testing with repeated scaffolding tasks, agents were:
nx_docsfor basic generator syntaxnx sync --apply)Related
Companion PR with skill improvements: nrwl/nx-ai-agents-config#26