Add instruction altitude guidance and context engineering reference#1297
Open
eanders-tdy wants to merge 1 commit intogithub:stagedfrom
Open
Add instruction altitude guidance and context engineering reference#1297eanders-tdy wants to merge 1 commit intogithub:stagedfrom
eanders-tdy wants to merge 1 commit intogithub:stagedfrom
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the repository’s instruction authoring guidance by adding “instruction altitude” (right-sizing specificity) recommendations and refining anti-patterns/resources to help contributors write more effective, resilient instruction files.
Changes:
- Added an “Instruction Altitude (Goldilocks Zone)” subsection with actionable principles and a summary table.
- Added a new “Hypothetical-rule inflation” anti-pattern under “Patterns to Avoid”.
- Updated the “Additional Resources” list with a context-engineering reference link.
e4294cd to
9c366ad
Compare
9c366ad to
d107d25
Compare
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.
Pull Request Checklist
I have read and followed the Guidance for submissions involving paid services.N/A — no paid services involved.npm startand verified thatREADME.mdis up to date.stagedbranch for this pull request.Description
Adds guidance on instruction altitude (the Goldilocks zone for writing effective instructions) to
instructions/instructions.instructions.md.The addition includes:
Content Guidelineswith three actionable principles and a summary table showing the three altitude levels (over-specified, under-specified, right altitude) and their failure modes.Patterns to Avoid, discouraging rules added for failures that have not actually occurred.These additions are grounded in Anthropic's published guidance on system prompt design and help contributors write instruction files that are specific enough to guide behavior without becoming brittle.
Type of Contribution
Additional Notes
The "right altitude" concept is sourced from Anthropic's Effective Context Engineering for AI Agents, specifically the section on system prompt design. The full article also covers tool design, compaction, and sub-agent architectures — topics more relevant to agent files — so only the instruction-file-relevant portion is referenced here.
By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.