## Summary
Move all slash command files to `.mastracode/commands/` and replace the
files in `.claude/commands/`, `.cursor/commands/`, and
`.opencode/command/` with symlinks pointing back to
`.mastracode/commands/`.
This means edits to any command file only need to happen in one place.
## Changes
- Created `.mastracode/commands/` with all 12 command files (canonical
copies)
- Replaced all files in `.claude/commands/`, `.cursor/commands/`,
`.opencode/command/` with symlinks
- Updated `AGENTS.md` to reference `.mastracode/commands/changeset.md`
## Test Plan
- Verified all symlinks resolve correctly (`cat` through each directory
returns identical content)
- No code changes — only config/docs files affected
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit
* **New Features**
* Added comprehensive command documentation and workflow guidance for
managing GitHub issues, pull requests, changesets, and CI/CD processes.
* Introduced structured command specifications for bulk issue
resolution, debugging workflows, and collaborative code review
processes.
* **Documentation**
* Added detailed instructions for conventional commits, PR creation,
linting fixes, and changelog management.
* Centralized command definitions across development tools.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
Co-authored-by: Mastra Code (anthropic/claude-opus-4-6) <noreply@mastra.ai>
Fixes a problem where MastraCode agents lose track of issue details
after memory compaction, making it hard to create good PRs at the end of
a debugging session.
**Changes:**
`$ISSUE` → `$1` across all command files so MastraCode can substitute
the argument properly. Also fixes `$\{ISSUE_NUMBER\}` references.
Adds durable context strategies to the gh-debug-issue command: agents
now record the issue number/title in task state immediately, create an
ISSUE_SUMMARY file early as an on-disk reference, and get a reminder in
Stage 3 to re-read the summary if they've lost track.
Same $ISSUE fix applied to make-moves.md.
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit
* **Improvements**
* Debugging workflow now requires capturing and persisting issue details
(number, title, short summary and key comments) so context is retained
across stages.
* Workflow updates ensure issue summaries are maintained and that
commits/PRs reference the related issue number and title for clearer
traceability.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
---------
Co-authored-by: Mastra Code (anthropic/claude-opus-4-6) <noreply@mastra.ai>
## Description
- Add docs styleguides
- Add AGENTS.md files and point CLAUDE.md file to it
- Add mastra-docs claude skill
- Improve prompts on writing docs
## Related Issue(s)
Fixes DEVED-110
## Type of Change
- [ ] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to change)
- [X] Documentation update
- [ ] Code refactoring
- [ ] Performance improvement
- [ ] Test update
## Checklist
- [ ] I have made corresponding changes to the documentation (if
applicable)
- [ ] I have added tests that prove my fix is effective or that my
feature works
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit
* **Documentation**
* Added comprehensive docs and styleguides (DOC, STYLEGUIDE, GUIDE_* ,
REFERENCE) and new AGENTS.md; reorganized docs content and contributor
workflow.
* Replaced extensive CLAUDE.md content with pointer to AGENTS.md;
cleared docs changelog and removed some legacy guideline files.
* Updated CLI/pr/changeset prompts and guidance to require multiple
changesets for multi-package changes and warn against very long
changesets.
* **Community**
* Updated Code of Conduct with expanded scope and clearer enforcement
guidance.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
---------
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
## Description
Improve agent instructions and add `changeset` command
## Related Issue(s)
<!-- Link to the issue(s) this PR addresses, using hashtag notation:
Fixes#123 -->
## Type of Change
- [ ] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to change)
- [ ] Documentation update
- [ ] Code refactoring
- [ ] Performance improvement
- [ ] Test update
## Checklist
- [ ] I have made corresponding changes to the documentation (if
applicable)
- [ ] I have added tests that prove my fix is effective or that my
feature works
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit
* **Documentation**
* Expanded changeset and commit message guidelines with clearer
formatting and tone requirements.
* Added structured guidance for PR workflows to improve documentation
consistency.
* Introduced changeset writing standards to project documentation.
* **Chores**
* Updated configuration metadata across prompt files for consistency.
* Fixed code formatting in documentation.
<sub>✏️ Tip: You can customize this high-level summary in your review
settings.</sub>
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
## Description
<!-- Provide a brief description of the changes in this PR -->
## Related Issue(s)
<!-- Link to the issue(s) this PR addresses, using hashtag notation:
#123 -->
## Type of Change
- [ ] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to change)
- [ ] Documentation update
- [ ] Code refactoring
- [ ] Performance improvement
- [ ] Test update
## Checklist
- [ ] I have made corresponding changes to the documentation (if
applicable)
- [ ] I have added tests that prove my fix is effective or that my
feature works
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit
## Release Notes
* **Documentation**
* Updated command workflow documentation with stricter validation of
working directory state before branch operations
* Enhanced error handling and messaging for improved user guidance
* Reorganized workflow steps for improved clarity and usability
<sub>✏️ Tip: You can customize this high-level summary in your review
settings.</sub>
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
## Description
<!-- Provide a brief description of the changes in this PR -->
## Related Issue(s)
<!-- Link to the issue(s) this PR addresses, using hashtag notation:
#123 -->
## Type of Change
- [ ] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to change)
- [ ] Documentation update
- [ ] Code refactoring
- [ ] Performance improvement
- [ ] Test update
## Checklist
- [ ] I have made corresponding changes to the documentation (if
applicable)
- [ ] I have added tests that prove my fix is effective or that my
feature works
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit
* **Documentation**
* Added procedural guide for automating lint and formatting fixes on
GitHub PR branches, including step-by-step instructions for retrieving
PR information, applying fixes, committing changes, and pushing updates.
<sub>✏️ Tip: You can customize this high-level summary in your review
settings.</sub>
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
Adds support for passing a custom fetch function to MastraClient,
similar to how ai-sdk handles it. This is useful for environments like
Tauri that require custom fetch implementations to avoid timeout errors
on macOS Safari webview.
You can now pass a custom fetch function when creating a MastraClient:
```typescript
const client = new MastraClient({
baseUrl: 'http://your-api-url',
fetch: customFetch, // Your custom fetch implementation
});
```
If no custom fetch is provided, it falls back to the global fetch
function, maintaining backward compatibility.
Fixes#10673
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit
* **New Features**
* MastraClient can be configured with a custom fetch implementation to
support environments requiring alternate HTTP request handling.
* **Tests**
* Added tests verifying custom fetch is used when provided and falling
back to the default fetch when not.
* **Documentation**
* Added a changeset documenting a minor package bump and a new PR
workflow guide.
<sub>✏️ Tip: You can customize this high-level summary in your review
settings.</sub>
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
## Description
<!-- Provide a brief description of the changes in this PR -->
## Related Issue(s)
<!-- Link to the issue(s) this PR addresses, using hashtag notation:
#123 -->
## Type of Change
- [ ] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to change)
- [ ] Documentation update
- [ ] Code refactoring
- [ ] Performance improvement
- [ ] Test update
## Checklist
- [ ] I have made corresponding changes to the documentation (if
applicable)
- [ ] I have added tests that prove my fix is effective or that my
feature works
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit
* **New Features**
* Shared workflow state added; accessible to steps, persisted across
suspend/resume and nested workflows.
* **Documentation**
* New "Workflow State" doc and updated workflow overview/reference with
guidance on initialization, propagation, and usage.
* Added contributor-facing issue/workflow guide describing a recommended
issue review workflow.
* **Tests**
* Added tests verifying state preservation across suspend/resume and
cross-step propagation.
<sub>✏️ Tip: You can customize this high-level summary in your review
settings.</sub>
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
---------
Co-authored-by: Taofeeq Oluderu <oluderutaofeeq@gmail.com>
## Description
<!-- Provide a brief description of the changes in this PR -->
## Related Issue(s)
<!-- Link to the issue(s) this PR addresses, using hashtag notation:
#123 -->
## Type of Change
- [ ] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to change)
- [ ] Documentation update
- [ ] Code refactoring
- [ ] Performance improvement
- [ ] Test update
## Checklist
- [ ] I have made corresponding changes to the documentation (if
applicable)
- [ ] I have added tests that prove my fix is effective or that my
feature works
## Description
- add multi-turn human-in-loop example
## Related Issue(s)
- https://github.com/mastra-ai/mastra/issues/6010
## Type of Change
- [ ] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to change)
- [x] Documentation update
- [ ] Code refactoring
- [ ] Performance improvement
- [ ] Test update
## Checklist
- [ ] I have made corresponding changes to the documentation (if
applicable)
- [ ] I have added tests that prove my fix is effective or that my
feature works
## Description
- Supports the full spec for resources
- Server -> Client notifications
- `notifications/resources/list_changed`, server sends the client a
notification alerting that the list of resources has changed (updated
metadata, created new entry, or deleted an entry)
- `notifications/resources/updated`, server sends the client a
notification alerting that a specific resource that was subscribed to
has changed its content
- Client -> Server Requests
- `resources/list`, get full list of available resources
- `resources/read`, gets the content from a specific resource
- `resources/templates/list`, gets the full list of resource templates
- `resources/subscribe`/`resources/unsubscribe`, subscribe/unsubscribe
to updates from a specific resource
- Adds tests to both MCPClient and MCPServer testing all these new
capabilities
- Updates the example agent to use these new APIs
- Added reference docs updates
<!-- Provide a brief description of the changes in this PR -->
## Related Issue(s)
<!-- Link to the issue(s) this PR addresses, using hashtag notation:
#123 -->
## Type of Change
- [ ] Bug fix (non-breaking change that fixes an issue)
- [x] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to change)
- [ ] Documentation update
- [ ] Code refactoring
- [ ] Performance improvement
- [x] Test update
## Checklist
- [ ] I have made corresponding changes to the documentation (if
applicable)
- [ ] I have added tests that prove my fix is effective or that my
feature works
---------
Co-authored-by: Daniel Lew <daniellew@Daniels-MacBook-Pro.local>