Merged
Conversation
Each of the 6 patterns repeated the same "Your goal" / "How to state it in your workflow" / "What the agent will implement" label structure. Removed these labels and condensed prose — content and examples unchanged. Also tightened the tip box and security considerations section. 301 → 244 lines (−19%). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
pelikhan
approved these changes
Mar 30, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
Removes repetitive scaffolding text from the MemoryOps guide to make the patterns more concise while keeping examples and structure intact.
Changes:
- Condensed the “How to Use These Patterns” TIP box into a single, direct instruction.
- Removed repeated “Your goal / How to state it / What the agent will implement” label blocks across all patterns, replacing them with brief connective prose.
- Simplified the Security Considerations section into a single paragraph above the existing example.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| - Consider encryption for sensitive but non-secret data | ||
|
|
||
| **Safe practices**: | ||
| Memory stores are visible to anyone with repository access. Never store credentials, API tokens, PII, or secrets — only aggregate statistics and anonymized data. |
There was a problem hiding this comment.
The previous guidance to "Consider encryption for sensitive but non-secret data" was removed when condensing this section. That advice is still useful (e.g., for customer identifiers or internal metrics) even if secrets are excluded; consider re-adding it as a sentence here so the security guidance remains complete.
Suggested change
| Memory stores are visible to anyone with repository access. Never store credentials, API tokens, PII, or secrets — only aggregate statistics and anonymized data. | |
| Memory stores are visible to anyone with repository access. Never store credentials, API tokens, PII, or secrets — only aggregate statistics and anonymized data. For sensitive but non-secret data (such as customer identifiers or internal metrics), consider using encryption in line with your organization's security policies. |
This was referenced Mar 30, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Removes structural bloat from
docs/src/content/docs/guides/memoryops.mdwhile preserving all content and examples.What was removed
All 6 pattern sections repeated an identical 3-label structure:
These labels added friction without adding information. The pattern title + description already convey the goal; the code block speaks for itself.
Also condensed:
Changes
All code examples, real-world file references, frontmatter, and section structure are preserved.
Screenshots
Screenshots could not be captured — the docs dev server requires Node.js ≥ 22 (
astro devexits immediately on v20.20.1). No visual regression is expected since only prose and labels were removed from existing sections.References: