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
The sensitive data filter now parses string values that contain JSON
and redacts sensitive fields within them. This fixes cases where tool
outputs are serialized as JSON strings in MODEL_STEP spans, which
previously bypassed redaction.
## Related Issue(s)
Fixes https://github.com/mastra-ai/mastra/issues/9846
## Type of Change
- [x] 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
- [x] I have made corresponding changes to the documentation (if
applicable)
- [x] 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
* **Bug Fixes**
* Fixed redaction so sensitive data embedded inside JSON strings is
properly masked in observability spans, including tool results within
model-step messages.
* **Tests**
* Added tests to validate redaction of JSON-embedded sensitive data and
to ensure graceful handling of invalid JSON.
* **Chores**
* Added an internal prompt to standardize issue triage and reproduction
workflows.
<sub>✏️ Tip: You can customize this high-level summary in your review
settings.</sub>
<!-- end of auto-generated comment: release notes by coderabbit.ai -->