docs: simplify agent context and resolve conflicting guidance - #2287
Open
thymikee wants to merge 2 commits into
Open
docs: simplify agent context and resolve conflicting guidance#2287thymikee wants to merge 2 commits into
thymikee wants to merge 2 commits into
Conversation
Member
Author
|
The new Please narrow it: user requests define task intent and override discretionary guidance only; system/developer requirements and repository hard rules remain binding, except where a rule explicitly makes user authorization the condition for proceeding. On conflict, identify the exact constraint rather than silently bypassing it. |
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.
Summary
Remove generic execution advice, basic CLI tutorials, duplicated checklists, and rhetorical explanations from contributor context. Apply the GPT-6 Astra guidance by narrowing instructions to repository-specific constraints and resolving conflicting rules.
Seven context files changed. Scope covers contributor guidance; the reviewed glossary and packaged skills remain unchanged. Compared with main, AGENTS.md shrinks from 9,994 to 7,805 bytes, and root context plus routed procedures shrink 11.7%. Existing context budgets and gate definitions are unchanged.
Validation
Validated commit:
501426464c587f4efb6ff6028ba4ffc34b99821c.Repository formatting, diff checks, referenced local-path checks, and the required affected gate passed (all four guidance contracts). The gate ran with host process-inspection access required by its harness. Manually reviewed instruction scope and cross-file consistency against the glossary, four packaged skills, and all nine routed procedures; checked affected-selector behavior against code. Documentation only, so runtime tests do not apply. CI on the updated PR head remains authoritative.